Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Failover service allows using one PBX as a backup for another one when the latter goes down. This guide describes the supported features and the procedure to set up the service.

WMS version: 3.86

Created: December 2017

Permalink: https://confluence.wildix.com/x/dABuAQ


Watch the video


Html
<div class="container">
    <div class="video">
<iframe width="560" height="315" src="https://www.youtube.com/embed/p9asYxk9eCw?rel=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</div>
</div>

Introduction

Terminology

  • Main PBX (Primary PBX) – PBX handling the load of a set of users / devices
  • Failover PBX (Backup PBX, Secondary PBX) – PBX which takes over the load of a set of users / devices when their Main PBX becomes unavailable
  • Configuration Source PBX – PBX which has the original configuration
  • Configuration Destination PBX – PBX which received a copy of the Source PBX configuration

Requirements

  • Minimal WMS version 3.86
  • WMS Network must be set up between the PBXs
  • Failover PBX must be capable of handling the max load (Main + Failover)
    • WPBX HW – Max 1000 users
    • VM – 1 Core – 2 threads of a Xeon Level CPU for each 500 users
  • Primary DNS Server set on devices must be different from Main PBX or an a Secondary DNS Server must be available

Currently supported features & scenarios

  • Hot Standby Mode: one Main PBX and one Failover PBX which usually has no load

...

  • Configuration sync: all changes must be applied only to Configuration Source PBX
  • Supported devices:
    • WP (WP600AXX starting from v. 2.8.22)
    • W24FXSR2/W04FXS/W02FXSR2 (except for W01FXS – pre 2015)
    • W04FXO
    • PRI
    • BRI
    • Collaboration (WEB phone) -> not supported in the current version
    • Incoming SIP trunks (remote operators / devices try to connect to both PBXs)
  • Failover PBX supports the following call scenarios:
    • Internal calls
    • Call groups (except for ‘Call All 32’ strategy)
    • Calls to/from Wildix gateways
    • Calls to/from incoming SIP trunks
    • Call transfer
    • Return from transfer
  • All devices have SIP registration on both main and failover servers simultaneously

Device configuration and switching timeout

DeviceMain SIP serverFailover SIP serverTimeouts (s)(switch to backup / main)
WPTCP / 443 (*)TCP / 443(*)60-105 / 60-105
WP2015TCP / 443 (*)TCP / 443 (*)30-60 / 10-60
W24FXSR2TCP / 443 (*)TCP / 443 (*)40-45 / 30-90
W04FXSTLS / 443 (*)TLS / 443 (*)30 / 45-300
W02FXSR2UDP / 5060UDP / 506030-60 / 10-30
W0XPRITCP / 443 (*)TCP / 443 (*)10 / 30-180
W01/02BRITCP / 443 (*)TCP / 443 (*)10-60 / 60-180
W04FX0TLS / 443 (*)TLS / 443 (*)30 / 45-300
WP600AXXTLS / 443 (*)TLS / 443 (*)-/-

(*) – Alternative or default secure port 443 can be used

Configuration

Note

Note: in case you’ve been using the old Failover, all the configuration previously set up, must be removed!

...

Load sharing scenario is coming in the next version.

Current (temporary) limitations/special configuration

  • No support for failover mode via /rw2/etc/phone_failover.conf
  • No support for failover mode via secondary DNS Configuration
  • No Full TLS Support (check the table provided in the Chapter “Device configuration and switching timeout”)
  • It’s necessary to configure separate DHCP server in the local network where phones and gateways are connected
  • Changes to configurations of the PBX which synchronizes its configuration from another one will be lost after each sync, Admin should apply all changes only on the source PBX
  • No notification present on phone’s display when switching to backup PBX in failover scheme
  • Unsupported devices (see the chapter “Failover by DNS”):
    • W-AIR
    • W04BRI
    • W01GSM
    • W01FXS (pre 2015)
    • Outgoing SIP trunks
    • iOS clients
  • No XML Browser-based services like history / phonebooks when connected to failover PBX
  • Call group with ‘Call All 32’ strategy – calls do not work for failover user
  • Call through remote PBXs of WMS network does not work if Main PBX is unavailable
  • Continuity feature does not work after switch to failover PBX
  • Pre-answer services do not work after switch to failover PBX
  • Call to the failover WP480 2015-2016 device can not be completed normally
  • Return from semi-attended transfer is not performed
    • after transfer from remote user to failover user
    • after transfer from failover user to remote user
  • BLF presence status of the local user is unavailable for failover user; call can’t be picked up via BLF key
  • BLF presence status of the failover user is unavailable for local user; call can’t be picked up via BLF key
  • Impossible to perform calls from Kite to failover user via WMS network Server PBX in case main PBX is unavailable
  • Email notifications are unavailable for failover user; user features are not available on failover PBX
  • Login/logout via 99 service is restricted for failover user
  • Language and region settings are not synced during sync_pbx script execution

...

  • No support for W01GSM calls and sms
  • No Chat/VM/user features/recordings/presence
  • History works only if a single remote MySQL or MSSQL backend is set up on all PBXs

Devices Failover by DNS

Unsupported device must use as primary DNS Server Main PBX and as secondary – Failover PBX.

...

This configuration will work only if auto.wildixin.com domain is used or another domain shared by both PBXs and inserted in Networking Settings – Hosts.

Appendix 1: Simplified configuration scenario (Primary and Failover PBXs in the same network)

Important: This simplified scenario can be used in case you set up Failover between two local PBXs, to allow a faster switch of phones from Primary to Failover PBXs and vice versa.

...