Deploying WMS 5.0 on Hardware, Virtual, Cloud PBXs

Deploy WMS 5 on Hardware, Virtual and Cloud PBXs.

Created: July 2020

Updated: October 2022

Permalink: https://wildix.atlassian.net/wiki/x/sxXOAQ

If your WMS version is lower than WMS4, first upgrade your PBX to WMS4, please follow the document: Deploying WMS 4.0 on Hardware, Virtual, Cloud PBXs

Upgrade to WMS 5 is supported on: Per User PBXs updated to the latest WMS 4 version with monthly, yearly or 5 year subscriptions. Lifetime per user systems bought  onwards.

Upgrade to WMS 5 is NOT SUPPORTED on: Per Service PBXs and Lifetime Per User PBXs , licenses for these PBXs must be regenerated.

How to update an unsupported system to WMS5: 

  • If your system is a LifeTime or a Per Service PBX, you can convert it to Cloud, follow the procedure present in the guide PBX Licensing and Activation (chapter Move PBX to Cloud)

Install or upgrade VM PBX

Upgrade a VM PBX from WMS4 to WMS5

  1. Reboot the PBX
  2. Update it to the latest WMS4 version (using repository rel40)
  3. Update it to the first WMS5 version (using repository rel50)

Update of VM PBXs with Lifetime licenses is not supported. Follow the guide Deploying WMS 4.0 on Hardware, Virtual, Cloud PBXs to move your PBX to Cloud if you wish to use WMS5.

Install a new WMS5 VM PBX 

Requirements

Any kind of VM hypervisor capable of importing OVF/OVA templates for deploying, is supported.

Recommended requirement for VM systems:
2vCPU, 4GB -> PBX managing up to 1000 users
4vCPU, 8GB -> PBX managing up to 5000 users
8vCPU, 16GB -> PBX managing up to 10000 users

Requirements may differ depending on the system usage (i.e. additional integrations, burst load, etc).

Deployment

OVFTool command example
ovftool WMS_5.04_x64_20220706.ova WMS_5.04_x64_20220706.ovf 


  • In case if you're running VMWare version lower than 6.5, please run this command in order to reduce VMWare HW Compatibility Level:
OVFTool hw compatibility change (example for ESXi 6.0)
ovftool --maxVirtualHardwareVersion=11 wms_5.04_x64_20220706.ova wms_5.04_x64_20220706_v11.ova


Once the VM is installed, follow PBX Licensing and Activation Admin Guide (chapter PBX Activation) to activate your PBX and add user licenses.


Note: If you install the system using Hyper-V, download VHD archive from here: https://files.wildix.com/images/wms5/WMS_5.04_x64_20220706_vhd.zip

Upgrade HW PBX 

Requirements

  • Upgrade to WMS5 is supported on Per User PBXs with recurring subscriptions (monthly/ yearly/ five years) running WMS4 

Upgrade a HW PBX from WMS4 to WMS5

  1. Reboot the PBX
  2. Update it to the latest WMS4 version (using repository rel40)
  3. Update it to the first WMS5 version (using repository rel50)

Update of HW PBXs with Lifetime licenses is not supported. Follow the guide Deploying WMS 4.0 on Hardware, Virtual, Cloud PBXs to move your PBX to Cloud if you wish to use WMS5.

Upgrade a HW PBX from WMS3 to WMS5

Warning:

  • Веfore the upgrade, remove all external USB storages
  • Backup is required before upgrading as all data (excluding USB stored date) will be deleted
  • Do not turn off the PBX during the upgrade

Requirements

  • CPU: Atom D2550, Celeron J1800, Celeron J1900

  • Supported starting from WMS version 3.88.41071 and higher

For example:


Preparing USB flash drive for upgrade/ restore of HW PBX

Requirements:

USB flash drive - 4GB or more; without any partitions that may prevent the booting process (MBR partitions in particular)

For upgrade/restore procedure, you need to prepare special USB flash drive:

  • Download image
  • Write image to USB flash drive 

    Warning:

    This will irrevocably delete all files on your USB flash drive, so make sure you do not have any important files on the flash drive before doing this. Be absolutely sure that you are directing dd to the correct drive before executing.

Windows: Use Etcher GUI tool.

Mac OSUse Etcher GUI tool or command line utility dd as below.

Run the following commands, replacing /dev/diskX with your drive, e.g. /dev/disk2. A USB device is normally auto-mounted in macOS, and you have to unmount (not eject) it before block-writing to it with dd:

# diskutil unmountDisk /dev/diskX
# dd if=PATH_TO_IMAGE of=/dev/rdiskX bs=1m

Linux

Run the following command, replacing /dev/sdX with your drive, e.g. /dev/sdb (Do not append a partition number, so do not use something like /dev/sdb1):

# dd if=PATH_TO_IMAGE of=/dev/sdX bs=512K status=progress oflag=sync

Deployment

To deploy HW PBX, proceed with the following steps:

  • Connect to PBX via serial cable (speed 19200)
  • Insert a special prepared USB flash drive as described in the previous section
  • Turn on or reboot PBX
  • Press a key on the keyboard within three seconds to be able to move inside the boot menu (e.g. Up/ Down key)
  • Select Upgrade to version 5 in GRUB menu
  • Select Upgrade


  • Wait for the system to be updated and turned off automatically


Once the system has started, follow PBX Licensing and Activation Admin guide and reactivate the existing licenses, upload the backup saved previously. Connect the existing USB storage and configure it if needed, DO NOT RE-INIT the storage as all data will be lost.

Activate or upgrade Cloud PBX

Add a new Cloud PBX

  • Go to PBX Per user
  • Select a customer and go PBXes tab
  • Click + to add a new PBX
  • Select WPBX-CLOUD (WMS5) in Model field

  • Fill in all other fields
  • Click Add


Note: Wait for approximately 3 minutes before proceeding. Your PBX will be activated. 

Upgrade your Cloud PBX 

Requirement:

  • Cloud PBX running WMS version 4

To upgrade your newly created or existing Cloud PBX to WMS 5 version, proceed with the following steps:

  1. Reboot the PBX
  2. Update it to the latest WMS4 version (using repository rel40)
  3. Update it to the first WMS5 version (using repository rel50)