Versions Compared

Key

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


Html
<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>

...




Html
<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>


Html
 <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>

...

Info

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

Toc

Understanding Per User Licensing

...

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

Per User licensing is available for any PBX type:

...

    • 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 https://elenatest2.wildixin.com

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

    • PBX-BASIC / UC-Essential / UC-Business / UC-Premium / UC-Wizyconf / PBX-Service: add the number of users of each profile (more about each profile: https://manuals.wildix.com/licensing)

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

    Click Add and


Note

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

  • Click Add and then Ok to confirm the subscription fee; your PBX has been added:

...

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

    Note

    Only for Virtual and Hardware PBXs. Cloud PBXs are activated automatically (wait for approximately 3 minutes after completing Step 1).


    • go to Customers tab, select your company, then select the PBX that you have created (Step 1)

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

...

Note

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

Move PBX to Cloud

Warning

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. 

Warning

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 

Warning

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:

...

Run the command: 

Code Block
migrate2cloud 

Move a Per-Service or a LifeTime PBX to Cloud 

Warning

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 

...

Increase / decrease the amount of Per User accounts

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
Warning

Limitation: Lifetime licenses cannot be decreased.  The operation of decreasing a number of accounts  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.


Note

All license changes recommended to be done on the last day before the expiration period.


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


Note

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

All license changes recommended to be done on the last day before the expiration period.

Move PBX to Cloud

Warning

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. 

Warning

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 

...

Run the command: 

Code Block
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. 

...

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:

  • Access WMP using your credentials
  • Select your company and your customer
  • Click Options button (Three dots) and select Edit
  • Click Advanced features
  • Select Enable SSH option

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

...

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 -> Customers

  • Select your company and customer

  • Select the Client PBX -> click Edit

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

  • Click Save

Note

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:

  • wmp.wildix.com – WMS version lower than 3.86

  • api.wildix.com – starting from WMS version 3.86

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

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

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:

...

Confirm the operation by clicking Yes

Note

Note: The change will be applied at 1AM.

Warning

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

Increase / decrease the amount of Per User accounts

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

  • Go to WMP -> Customers
  • Select your company and customer

  • Select the PBX -> click Edit

  • Add/ remove the number of users of a required profile
  • Click Save and Ok to confirm the operation
Limitation: Lifetime licenses cannot be decreased.  The operation of decreasing a number of accounts  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
Warning
Warning

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: 


    Code Block
    migrate2cloud 


Move a Per-Service or a LifeTime PBX to Cloud 

Warning

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: 


    Code Block
    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) 
Anchor
Sshport
Sshport

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:

  • Access WMP using your credentials
  • Select your company and your customer
  • Click Options button (Three dots) and select Edit
  • Click Advanced features
  • Select Enable SSH option

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 
Anchor
sharelicenseswmsnetwork
sharelicenseswmsnetwork

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 -> Customers

  • Select your company and customer

  • Select the Client PBX -> click Edit

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

  • Click Save


Note

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:

  • wmp.wildix.com – WMS version lower than 3.86

  • api.wildix.com – starting from WMS version 3.86

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

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

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:

  • 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

Note: The change will be applied at 1AM.


Warning

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)

...