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



<span class="page-title-pdf">PBX Licensing and Activation</span>



<div class="fb-like" data-href="https://confluence.wildix.com/x/twM8AQ" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>


 <div class="lang-box-pdf">
	<div>
		<div class="google-lang">
			<div id="google_translate_element">
			</div>
			<script type="text/javascript">
					function googleTranslateElementInit() {
						new google.translate.TranslateElement({pageLanguage: 'en', includedLanguages: 'de,es,fr,it,nl', autoDisplay: false}, 'google_translate_element');
						}
			</script>
			<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
		</div>
		
		<div class="pdf-button">
			<a href="https://confluence.wildix.com/spaces/flyingpdf/pdfpageexport.action?pageId=20710327" alt="Convert to .pdf" title="Convert to .pdf"><img src="https://confluence.wildix.com/download/attachments/14549012/pdf-button-download-wildix-documentation.png"></a>
		</div>
	</div>
</div>


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

Date: June 2018

Updated: February 2020

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

Useful links:

Other documents related to WMP (Wildix Management Portal):

Understanding Per User Licensing

Wildix currently offers Per User licensing. It means that 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/ Wizyconf/ Service

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 (fax machines, unattended phones, doorphones), 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 5 UC-PREMIUM users. At any moment, you can add more users of any type.

Details on each user profile: https://www.wildix.com/licensing/

Per User licensing is available for any PBX type:

PBX Activation

Prerequisites:



Step 1. Add a new Per User PBX on WMP 

Proceed as follows:




If you made a mistake during the system activation, please contact immediately your Area Manager. Issue must be reported within 1 (one) business day.


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:

For Cloud PBX: wait for approximately 3 minutes before proceeding. Your PBX will be activated. 

Proceed as follows:



Your PBX is now activated:

Assign correct license type to each user 

Assigning licenses to users in WMS is supported starting from WMS version 4.01.44168.28.

After you have purchased the licenses on WMP and activated the PBX, please follow WMS Start Guide to configure the system and add users. 

This chapter explains how to assign the license type to each user. 

The "Admin" user is not included into the total count of users.


Since "Park orbit" type of users has no SIP registration, it is required to assign PBX-Service License (free of charge).

About license types

General recommendations regarding assigning license types to different types of users:

For more details, please refer to the page https://www.wildix.com/licensing/

Upgrade instruction in case of WMS network

Please follow the instruction provided below when you upgrade for the first time to the WMS version that supports assigning of licenses (if your current WMS version is inferior to 4.01.44168.28).

In case of WMS network:

After the upgrade all the users are assigned the maximum license type purchased for this PBX. E.g. if at least one Premium license is present, all users become Premium. It will be necessary to manually set the correct license type for each user.

In case you are using WMS Network Sharing of licenses (described in chapter Share Per User Licenses between PBXs over WMS Network), the number of licenses will be counted only on the "Server" PBX in the WMS network

License usage exceeded

Currently in case the number of licenses used is exceeded, users do not lose access to any functionality. Hard enforcement of licensing is planned in March 2020.

In case the number of licenses used was exceeded, users do not lose access to any functionality, but the system administrator is informed:

You can also check the number of licenses bought and used in WMS Settings ->  Tools and utilities -> Activation / Licenses:


The "Admin" user is not included into the total count of users. 

Assigning license type to each user

By default after the upgrade to the version that supports license assignment all users are set to the maximum license level purchased for this PBX. E.g. in case at least one Premium is present, all users become Premium. You need to manually assign the correct license type to each user.

Restrictions and privileges of each license type (Basic, Essential, Business, Premium) are applied only after you assign the correct license type to each user. 

Currently not all restrictions for each license type are fully implemented. Full implementation of restrictions, as well as hard enforcement of licensing is planned in March 2020.

You can assign the correct type of license to each user in WMS -> Users:

  1. Select one or multiple users and click Edit
  2. Scroll down to the field License type and select the type of the License type from the drop-down list:


  3. Click Ok to apply the changes


Newly created or exported users by default are assigned Essential license. It is necessary to manually set the correct license type. 

Changes to the license - upgrade, downgrade, increase, decrease, change the term

Increase / decrease, upgrade/ downgrade of licenses

It is possible to increase/ decrease the number of accounts any time.       

  1. Go to WMP -> Customers
  2. Select your company and customer
  3. Select the PBX -> click Edit
  4. Add/ remove the number of users of a required profile
  5. Click Save and Ok to confirm the operation

If you need an upgrade/ downgrade of the existing licenses: any upgrade or downgrade has to be done through the Portal by the Partner only. There will be no money back for the prepaid licenses. 


Licenses will be automatically renewed and invoiced on the last day of their expiration term. 

We recommend to carry out all of the license changes 2 days before the license expiration date.

IMPORTANT: No license decrease can be done on the last day of the month!

But licenses can be removed at any moment with no money back for prepaid ones.


If the Partner has made a mistake during the system activation, please report it to your Area Manager within 1 (one) business day, include the following details:

  1. partner’s name
  2. customer’s PBX S/N
  3. quantity and type of licenses that should be on the PBX

IMPORTANT: Partners should not change anything by themselves! Only report a mistake to the account manager.


Change the term of the license

To change the expiration period, follow the steps below:

  1. Go to WMP -> Customers
  2. Select your company and customer
  3. Select the PBX -> click Edit
  4. Decrease the number of user licenses to zero
  5. Click Save and Ok to confirm the operation
  6. Select the PBX again and click Edit
  7. Change the expiration period (term of the license) 
  8. Add back user licenses
  9. Click Save and Ok to confirm the operation


If the Partner has made a mistake during the system activation, it has to be reported within 1 (one) business day, by sending an e-mail to the area manager with the following details:

  1. partner’s name
  2. customer’s PBX S/N
  3. quantity and type of licenses that should be on the PBX
  4. expiration term to be set

IMPORTANT: Partners should not change anything by themselves! Only report a mistake to the account manager.


Licenses will be automatically renewed and invoiced on the last day of their expiration term.

We recommend to carry out all of the license changes 2 days before the license expiration date.

IMPORTANT: No license decrease can be done on the last day of the month!

But licenses can be removed at any moment with no money back for prepaid ones.

Scheduled deletion of Cloud PBXs

Once all user licenses are deleted (decreased to zero) from a Cloud PBX, the PBX is scheduled for deletion: will be stopped in five calendar days and irrevocably deleted in 14 calendar days.

What if I don't want this PBX to be deleted?

The PBX owner (the Partner) has five calendar days to revert this process. They should add back at least one user license and the PBX will no longer be scheduled for deletion.

What if I changed my mind after the PBX was stopped?

Starting from the day when user licenses have been decreased to zero, the PBX owner (the Partner) has 14 calendar days until the PBX is irrevocably deleted. Once the PBX is stopped (after five calendar days), the Partner still has five working days (9 calendar days) until the PBX is irrevocably deleted. If the Partner changes their mind regarding PBX deletion during this time span, they should add back at least one user license and get in touch with their Area Manager ASAP to notify them about this change.

The process:

  1. Once all user licenses are deleted from a Cloud PBX, it is scheduled for deletion. On the second day notification is sent to the PBX owner (the Partner). 
  2. In five calendar days (since the PBX has been scheduled for deletion) the PBX is stopped. 
  3. In 14 calendar days (since the PBX has been scheduled for deletion) the PBX is irrevocably deleted. 



Move PBX to Cloud

Limitations:

  • Only MySQL/ SQLite3 Database is supported for migration (WMS 4.0X)
  • Only SQLite3 Database is supported for migration (WMS 3.XX)
  • DB size for migration is limited by the root partition size on Cloud PBX: about ~6-7G

Move a Subscription-based PBX to Cloud (1 month/ 1 year/ 5 years)

Step 1 - Create a new Cloud instance on WMP 

To move Per User subscription-based (1 month/ 1 year/ 5 years) PBX to Cloud, you need to access WMP where you have a button that allows creating a new Cloud instance instead of your current PBX. The licenses active on this PBX and the PBX serial will be moved to the new Cloud instance. 

Important notes:

  • PBX will not be reachable for up to 20 minutes, during which the DNS record will be updated (the migration time depends on the migrated DB size), remember to update/remove any local DNS proxies; phones/media gateways must use the DNS name for provisioning or they will not switch automatically to the Cloud PBX
  • The old PBX will stop working as soon as the licence will be synced 


How-to:

  1. Access WMP using your credentials
  2. Select your company and your customer
  3. Click Options button (Three dots) and select Edit
  4. Click Advanced features
  5. Click Migrate to new WCloud PBX

Step 2 - Run the script on old PBX to move all the data 

Min supported WMS version (make sure your PBX is updated to this version before proceeding):

  • WMS 3.88: 3.88.44723.49
  • WMS 4.x: 4.03.44693.48

Now when you've create a new Cloud instance for your HW/ VM PBX, you need to launch the script on your old PBX that will move all the data from your old PBX to the new one.

Run the script:

  1. Access WMS, Open Terminal on the PBX, select the option 10 (Shell), access as root (su - wildix)
  2. Run the command: 


    migrate2cloud 


Move a Per-Service or a LifeTime PBX to Cloud 

Min supported WMS version (make sure your PBX is updated to this version before proceeding):

  • WMS 3.88: 3.88.44763.50
  • WMS 4.x: 4.03.44733.50

Step 1 - Create a new Cloud instance on WMP 

Create a new Cloud PBX as described in chapter Add a new Per User PBX on WMP.

Step 2 - Run the script on old PBX to move all the data 

  1. Access WMS, Open Terminal on the PBX, select the option 10 (Shell), access as root (su - wildix)
  2. Run the command: 


    migrate2cloud -s <serial of cloud pbx> 


You will be prompted to enter the password of your new cloud PBX. During the script execution you will be prompted to confirm, which data you would like to be moved. As soon as the script finishes its execution, the data will be moved and you will be able to access the Cloud PBX using the password of your old PBX. 

Enable SSH port on Cloud PBXs (optional) 

Direct access to SSH port on Cloud PBXs is blocked for security reasons. Now it’s up to you to temporarily enable/ disable SSH port 2222 via WMP:

If there is a need to block the port, it can be deactivated via Disable SSH option.

Share 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:

To enable WMS Network license sharing, proceed as follows:


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 is activated during working hours.

Periodic License Check

As stated here: https://www.wildix.com/licensing/, 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 are not able to renew its license, you are notified via email containing the following information:

In 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 is able to renew its licenses.

Increase storage on Cloud PBX

By default you have 10 GB of storage available on one Cloud PBX. You can increase the storage size.

To perform it, proceed as follows:



Note: The change will be applied at 1AM.


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

Video Tutorials

Activation of Per User PBX (Hardware, Virtual)

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

Watch the video: https://wildix.wistia.com/medias/04u4ifq6np?wtime=2m7s


<div class="container">
    <div class="video"><script src="https://fast.wistia.com/embed/medias/04u4ifq6np.jsonp" async></script><script src="https://fast.wistia.com/assets/external/E-v1.js" async></script><div class="wistia_embed wistia_async_04u4ifq6np" style="height:315px;width:560px">&nbsp;</div></div>

</div>

WMP Intro Video

Video tutorial:

https://fast.wistia.com/embed/medias/vpvdep1bwe


<div class="container">
    <div class="video">
<iframe width="560" height="315" src="https://fast.wistia.com/embed/medias/vpvdep1bwe" frameborder="0" gesture="media" allow="encrypted-media" allowfullscreen></iframe>
</div>
</div>



<div class="fb-like" data-href="https://confluence.wildix.com/x/twM8AQ" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>



<div class="ask-question">
		<div class="text-before-buttons">
			<span style="font-size: 24px; text-align: center;">Not finding the help you need?</span><br>
Join the Facebook group to ask a question!
		</div>
<div class="fb-buttons">
<span style="align: center;"><a href="https://www.facebook.com/groups/wildixtechwizards" target="_blank"><img src="https://manuals.wildix.com/wp-content/uploads/2017/03/facebook_tech-wizards.png" alt="facebook_tech-wizards" width="282" height="80" align="center"/></a></span></div>
	</div>
</div>



<div id="fb-root"></div>
<script>(function(d, s, id) {
  var js, fjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = 'https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.11';
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>