Reference13r3:Concept myApps Redundancy
From innovaphone-wiki
The myApps client handles the failure of a single PBX by failover to a secondary PBX.
Contents |
[edit] Applies to
- innovaphone devices with a PBX from version 13r3
- innovaphone myApps (all platforms)
[edit] General concept
The innovaphone PBX has implemented a mechanism, that by adding a single PBX to an installation, from the failure of any single PBX can be recovered.
- For a single PBX a standby PBX can be configured
- For a slave PBX the master can act as standby
- For a master PBX any slave PBX can act as standby
The myApps client can connect to any PBX in the system. If it does not match the PBX on which the user is configured on, the client follows a number of rediects until it ends up at the user's PBX.
- Slave PBXes redirect to their master PBX.
- The master PBX redirects to the slave PBX of the user.
[edit] Handling of standby cases
If the current PBX has no registration to the PBX it would redirect to, it acts as a standby and keeps the myApps connection.
For cases in which the initial PBX is unavailable the myApps client tries to connect to two PBXes in an alternating manner:
- Primary PBX
- This is the PBX where the client tries to connect first.
- Secondary PBX
- This is the PBX, where the client tries to connect, when the connection to the primary PBX failed.
[edit] Handling of connection loss
If the connection to the current PBX is lost:
- myApps tries to re-connect to the current PBX first.
- If the current PBX is unavailable it restarts connecting to the primary and secondary PBX in an alternating manner.
[edit] Determination of primary and secondary PBX
On each successful login, myApps determines the primary and secondary PBX automatically and stores the information for handling standby cases.
[edit] Primary PBX
The PBX configured in the myApps client is used as the primary PBX.
[edit] Secondary PBX
There are different cases to be considered to determine the secondary PBX:
- In case the client was redirected to the PBX the user is configured on, this PBX is used as secondary PBX.
- In case the client was not redirected, the normal rules for standby PBXes apply, which means if there is an explicit standby available for this PBX, it is used as secondary PBX. If no standby is available, but this is a slave PBX, the master is used.
[edit] Published information for the softphone app
The myApps client publishes the determined configuration along with other connection details in the API model of com.innovaphone.client inside the connInfo
object.
This information is used by the softphone app. See Reference13r3:Concept_Softphone_Redundancy for details.
Example:
"connInfo": { "up": true, "standby": false, "cur": "slave.example.com/PBX0", "pri": "master.example.com/PBX0", "sec": "slave.example.com/PBX0", "phys": "master" }
Values:
- up
- true, if the connection is up. false if myApps is offline.
- standby
- true, if the myApps client is connected to a standby PBX. false, if the myApps client is connected to the user's PBX.
- cur
- the current PBX in the format host/pbx-module
- pri
- the primary PBX in the format host/pbx-module
- sec
- the secondary PBX in the format host/pbx-module
- phys
- the physical location, if configured explicitly
[edit] Configuration
For configuration in the myApps launcher, see Reference13r3:Concept_myApps_platform_services#Server_configuration.
In the browser the PBX specified by the URL is used as the primary PBX. An explicit physical location can be set using a URL parameter, see Reference13r3:Concept_myApps#Supported_URL_Parameters.
[edit] Tracing
Trace flags
- Browser Console
- to see the connection flow including redirects and determined configuration