Reference16r1:Concept App Service Conference Scaler: Difference between revisions
| Line 19: | Line 19: | ||
Furthermore, the conference interface to be used can be configured if the Devices API is available. | Furthermore, the conference interface to be used can be configured if the Devices API is available. | ||
=== Conference === | === Conference === | ||
In the conference settings, the menu item "Additional Features" appears for Conference objects. With this setting you can enable the use of the Conference Scaler within the | In the conference settings, the menu item "Additional Features" appears for Conference objects. With this setting you can enable the use of the Conference Scaler within the Conference object. Additionally, you can activate the use of PBX channels licenses. | ||
== More information == | == More information == | ||
Revision as of 09:21, 24 April 2026
|
FIXME: This product is in the beta phase and is not yet finished |
The Conference Scaler app is required to use multiple conference interfaces within one conference.
Applies to
- Conference Scaler app
Requirements
- innovaphone PBX (V16r1)
- innovaphone Application Platform
- At least one innovaphone Gateway with SCNF Interfaces (V16r1)
- The Devices API must be available for the settings plugin therefore the gateways have to be connected to devices
Settings Plugins
Conference Scaler
With settings plugin of the Conference Scaler a Conference Scaler app object can be created, edited and deleted on the PBX. Furthermore, the conference interface to be used can be configured if the Devices API is available.
Conference
In the conference settings, the menu item "Additional Features" appears for Conference objects. With this setting you can enable the use of the Conference Scaler within the Conference object. Additionally, you can activate the use of PBX channels licenses.
More information
Conference Scaler App (innovaphone-conference-scaler)
The hidden app offers an interface via the Service API (com.innovaphone.conference-scaler), that is used by the conference object.
Parameters:
- URL
http://<ap.domain.tld>/<domain.tld>/<instance-name>/innovaphone-conference-scaler
Features
- Allows the use of multiple conference interfaces within multiple conference.
- This removes previous participant limits.
- Adds flexibility to existing infrastructure.
- The Conference Scaler app nominates one conference interface which will manage the control for voice streams. This conference interface will then receive and distribute the audio streams to all interfaces which are connected to the Conference Scaler app.
- The Conference Scaler app will split the participants in a Round Robin maner, therefore the load will be evenly distributed to the interfaces.
- If a conference interface has reached its limit for participants, the Conference Scaler app will select another free conference interface for a new incoming call.
Configuration
To set up the Conference Scaler for a single cluster of conference interfaces, follow these steps:
- Download the Conference Scaler app via the App Store (or use the settings plugin "app installer" to install the app and instance automatically and skip to step 4).
- Install the Conference Scaler app on the App Platform.
- Create an instance in the Conference Scaler app on the App Platform and make sure the instance is running.
- Create via the settings plugin of the Conference Scaler a new Conference Scaler app object.
- Select the conference interfaces to be used by the Conference Scaler app inside the settings plugin of the Conference Scaler.
- Allow the use of the Conference Scaler app on the Conference settings.
To run multiple clusters, you need additional app instances. Repeat steps 3 through 6 to add them. Ensure there are no overlaps between the selected conference interface across the settings plugins of the Conference Scaler. Each Conference object should activate only one Conference Scaler app object to guarantee everything works as expected. Also, make sure that when adding app objects, this is done via the settings plugin of the new instance.
Restrictions / Known issues
- Using the Conference Scaler app generates an overhead depending on usage patterns, so the increase in the number of participants does not correspond to a multiple of x interfaces. One participant will take up an estimation of 1,5x CPU-Load as the usual conference flow (because data is additionally send to a different interface). So for an interface with max. 100 Video participants this amount will decrease to a maximum participant limit of 66 (as 100/1,5=66). Therefore if you want to achieve a maximum of X video participants you need to take that information into account for calculating the needed interfaces.
- In case of failure of the App Platform the Conference Scaler app will not be available as well. Therefore it will not be possible to join or continue an ongoing conference.
- Room reservations are not needed anymore and are therefore not possible.
- Video sharing between the conference interfaces is handled via multicast and this requires that the interfaces are on the same network (Multicast addresses differs between 239.0.0.0 - 239.255.255.255).
- Only SCNF interfaces are currently supported.
Troubleshooting
If you can reproduce the problem, clear the contents of the current app log, reproduce the issue, take a screenshot (depending on the issue), save the browser logs and the app logs, and send them as an attachment to your support ticket. For the app, please make sure that following trace flags are enabled:
- App
- App Websocket
No Channel free
If you get a „No Channel free“ Error when trying to join a Conference Room after setting up the Conference, check if the desired room has any reserved channel configured, if so then remove the reservation of channels. The Conference Scaler does not consider channel reservations and therefore rejects the caller.