Skip to end of metadata
Go to start of metadata

Dec 14, 2018 17:33

PBX Licensing and Activation

This document helps you understand Wildix licensing and explains how to activate a Wildix PBX (Hardware, Virtual, Cloud) Per-User or Per-Service.

Minimum WMS version: 3.88

Date: June 2018


Understanding Licensing

Wildix currently offers two types of licensing:

  • Per User

  • Per Service

PBX Per User

If you choose Per User licensing, you can add as many users of each profile as you need and add more users whenever you need. You pay per user / per period of time. 

Here are the steps to activate a Per User PBX:

  1. Choose the platform: Hardware, Virtual, Cloud
  2. Choose the recurrent payment cycle: Monthly / Yearly / 5 years / Lifetime (lifetime is not available for Cloud)
  3. Choose the number of users of each Profile: Basic / Essential / Business / Premium

Note: you first select the period of time and then the number of users, this means you cannot select different recurrent payment periods for different types of user profiles, e.g. if the recurrent period is 1 year, it means the users of all types (Basic, Business, Premium) are added for 1 year. You can increase the number of users any time (add more users of any type).

Example: you need 10 users with basic phone services, 30 users with access to Collaboration and only 5 users with access to CDR-View. You activate 10 PBX-BASIC users, 30 UC-ESSENTIAL users and 2 UC-PREMIUM users. At any moment, you can add more users of any type.

Details on each user profile:

Per User licensing is available for any PBX type:

  • Hardware

  • Virtual

  • Cloud

PBX Per Service

If you choose Per Service licensing, you need to purchase one Activation license based on the maximum number of PBX users you need and accordingly purchase UC&C licenses which will be then available for all PBX users.

Example: you need a license for 90 users with access to Collaboration and CDR-View: WGW90-lic (Activation license) + WGW90-COLLABORATE + WGW90-CDR. As a result, all of your users have access to Collaboration and CDR-View.

Per Service licensing is available only for the following PBX types:

  • Hardware

  • Virtual

Activation of Per User PBX | Cloud, Virtual, Hardware


  • For Hardware PBX you need first to purchase a Hardware PBX in WMP → Cart (code: WPBX-HW)

Step 1. Add a new Per User PBX on WMP

Proceed as follows:

  • Connect to WMP using your credentials

  • Go to PBX per user tab

  • You are now under Customers tab; to create a new PBX, you first need to add a customer (if it does not exist yet); click Add

  • Create a new customer (company): fill in the fields and click Save

  • You need to create at least one contact: fill in the fields and click Add

  • Now you can proceed with adding a new PBX: go to PBXs tab

  • You are now under PBXs tab, click + to add a new PBX

  • Fill in the fields:

    • Model: select WPBX-CLOUD for Cloud / WPBX-VM/HW for Virtual or Hardware

    • Region (only for Cloud PBX): select the datacenter region

    • Name: PBX domain name by which your PBX is accessible via the browser; in the example provided below, the PBX can be accessed by URL

    • Expire: select the recurring billing period: monthly / yearly / lifetime (lifetime is not available for Cloud PBX)

    • PBX-BASIC / UC-Essential / UC-Business / UC-Premium: add the number of users of each profile (more about each profile:

    • Storage size (only for Cloud PBX): increase Cloud instance storage size . Refer to this chapter for more details

Increasing / decreasing the amount of Per User accounts: it is possible to increase the number of accounts any time. The operation of decreasing a number of accounts is not automatic and must be approved by Wildix: in this case a request is sent to the Wildix Manager for a review. Partner is notified via email after the request has been approved.

  • Click Add; your PBX has been added:

Note: after the PBX has been added, you can see its Software Serial (SW Serial):

You can use SW Serial to activate new HW PBX in case of RMA or you can replace HW with VM PBX and vice versa. In this case new PBX will take Name, Licenses and attached Devices of the SW serial.

Please note, next activation of HW PBX will automatically convert HW Serial to SW Serial preserving its Name, Licenses and attached Devices. So HW Serial will disappear from portal and new SW Serial will appear instead.

Step 2. Activate PBX from WMS

For Virtual PBX: before proceeding, follow the guide to deploy PBX image: 

Proceed as follows:

  • Connect to PBX via HTTPS to access WMS using credentials admin : wildix

  • Change admin user password:

    • Select admin user and click Set passwords

    • Generate or create a new WEB password, click Ok

  • Upgrade WMS to the latest stable release

    • go to WMS Settings -> Tools and utilities -> Upgrade

    • In case there is a new version available, click Perform Upgrade

  • Copy PBX key from WMP:

    • go to the tab PBX per user, select your company, then select the PBX that you have created on step 1

    • click the Copy icon (Copy PBX key to clipboard)

  • Insert the PBX key on WMS side:

    • open WMS Settings -> Tools and utilities -> Activation & licenses

    • Paste the PBX key copied on the previous step into the field User Mode and click Activate

Your PBX is now activated:

Sharing of Per User Licenses between PBXs over WMS Network

It is possible to share licenses over other PBXs in the WMS Network. Normally this scenario is used for Failover configuration. In this scenario you add UC profiles (users) only on Server PBX and then you can share the licenses enabled on Server PBX with Client PBX(s). 

Prerequisites for this scenario:

  • The PBXs must belong to the same customer

  • WMS Network must be enabled between the PBXs

  • Cloud PBX can only be the Server PBX

  • All PBXs must be of Per User type

  • There must be no licenses enabled on the Client PBX

To enable WMS Network license sharing, proceed as follows:

  • Go to WMP -> PBX per user

  • Select your company and your customer

  • Select the Client PBX -> click Edit

  • Select WMS Network License and select the Server PBX from the drop-down list

  • Click Save

Note: after you click Save, an automated email is sent to a corresponding Wildix Administration manager who must manually apply this change; please mind that the WMS Network License sharing will be activated during working hours.

Periodic License Check

As stated here: all Virtual and Hardware systems update their license information daily connecting via port 443 to:

(this doesn’t apply to Cloud systems)

If connection to the license server is not available, a Hardware / Virtual Per User PBX will continue working for 14 days only. After which the PBX will support only one call for emergency purposes.

In case any of your customer's PBXs was not able to renew its license, you will be notified via email containing the following information:

  • the name of the customer (company)
  • PBX serial and model
  • how many days have passed since the PBX couldn't renew the license

If case this PBX should continue working, all you need to do is to make sure the PBX is connected to the Internet again, and in this way it will be able to renew its licenses.

How to increase storage on Cloud PBX

Increase of Cloud instance storage size is available starting from WMS Version 3.88. 

To perform it, proceed as follows:

  • Go to PBX Per user
  • Select the customer and choose the Cloud PBX (or add a new one)
  • Click Options button (Three dots) and select Edit

  • Increase the storage size: 1 license=10 GB

  • Confirm the operation by clicking Yes

Note: The change will be applied at 1AM.

Important: After you have increased the storage size, it will not be possible to decrease it.

Activation of Per Service PBX | Hardware, Virtual


  • You need to purchase the following items via WMP → Cart:

    • Hardware PBX: code WPBX-HW (only in case of Hardware PBX)

    • PBX Activation license: codes WGWXX-LIC (from 08 to 5000, based on the number of users you need)

    • Additional Unified Communication licenses: code WGWXX-COLLABORATE (for Collaboration), WGWXX-CDR (for CDR-View)

Before proceeding with PBX activation:

For PBX activation, proceed as follows:

  • Go to WMP -> More -> Licenses

  • Copy the serial number and the activation code of the PBX activation license

  • Go to WMS Settings -> Tools and Utilities -> Activation / Licenses

  • Enter the License serial and the License code into the field Service Mode and click Activate:

PBX is now activated and so are the trial licenses (for the period of three months):

To activate permanent UC&C licenses (non-trial), proceed as follows:

  • Go to WMP -> PBXs

  • Select your PBX and click Details


  • Click Register

  • Select the licenses from the list and click Submit


Video Tutorials

Activation of Per User PBX (Hardware, Virtual)

Video tutorial - Starting from 2:07 (2m07s)


Activation of Per Service PBX (Hardware)

Video tutorial:

Not finding the help you need?
Join the Facebook group to ask a question!

  • No labels