You are here: Administration > Platform configuration > License installation and usage

Pexip Infinity license installation and usage

Before you can place calls to Pexip Infinity services (Virtual Meeting Rooms, Virtual Auditoriums, Virtual Receptions and the Pexip Distributed Gateway), you must install a license.

Pexip Infinity can be licensed in a number of different ways. However, regardless of the type of license you have purchased, it will ultimately permit use of the Pexip Infinity software, and specify the total number of calls that can be made to any Pexip Infinity service (Virtual Meeting Rooms, Virtual Auditoriums, Virtual Receptions or the Pexip Distributed Gateway) across the entire Pexip Infinity deployment at any one time.

License allocation

When a Conferencing Node receives a request from a participant to join a Virtual Meeting Room, Virtual Auditorium or Virtual Reception, or to interwork a call using the Pexip Distributed Gateway, it contacts the Management Node to see whether there is a license available. If so, the call will be allowed and one concurrent call license will be allocated to that participant for the duration of the call. When the call is terminated, the license is returned to the pool.

  • Infinity Connect clients and all other endpoints consume one call license per connection when sending or receiving media (video, audio, and/or full-motion HD presentation). This is regardless of whether the call is HD, SD or audio-only - each will consume a single license.
  • Control-only participants who are only sending slides (images or PDF) or receiving non-HD presentations do not consume a license.
  • Lync / Skype for Business participants who are sending or receiving presentations will consume an additional license.
  • Gateway (point-to-point) calls consume two licenses: one for the inbound leg of the call and one for the outbound leg.

If the Conferencing Node is unable to contact the Management Node, the call will be permitted on the assumption that a license is available. After the Management Node has been out of contact for a grace period of 14 days, all calls will be rejected.

If there are no licenses available, or the existing license is not valid, the participant will be advised that they are not permitted to join the conference along with the reason why, and a corresponding message will appear in the support log.

For more information about license usage, contact your authorized Pexip representative for assistance.

Insufficient licenses

If your Pexip Infinity reports insufficient licenses, this means that there are valid licenses installed on the system, but at the point at which a participant tried to join a conference, all of the existing call licenses were in use. To remedy this, either wait until one or more existing conferences have completed, thus freeing up some call licenses, or add more call licenses to your system.

In some cases your licenses may include an overdraft. This is intended to cover instances where the number of concurrent calls temporarily exceeds the number of available licenses.

Invalid license

If your Pexip Infinity reports an invalid license, this could mean that:

  • the license has not been activated
  • the existing license has expired
  • the existing license has become corrupt.

Viewing existing licenses and current usage

To see the licenses that are installed on your system, and the number of licenses currently being consumed, go to Platform configuration > Licenses.

The Licensing section lists the licenses that have been activated successfully. You can select a license to see further information, including the maximum number of Concurrent calls that can be made.

The Stored license request section lists any licenses that were not activated automatically, and are awaiting manual activation.

Adding licenses

To add a new license:

  1. On the Pexip Infinity Administrator interface, go to Platform configuration > Licenses.
  2. Select Add License.
  3. In the License entitlement key field, enter the activation key provided by your authorized Pexip representative.
  4. Leave the Manually activate checkbox clear (unless you have been instructed to select this option by your Pexip support representative).
  5. Select Save.

Pexip Infinity will automatically generate an XML file containing the license request (for more information, see Content of the license request XML file). It will then attempt to contact the Pexip licensing server and send it this file in order to activate the license. To enable this, you must have an active internet connection from the Management Node, and your firewall must be configured to allow a connection from the Management Node to pexip.flexnetoperations.com (64.14.29.85) on HTTPS (port 443).

  • If the license is activated successfully, you will be returned to the Licensing page and will see the new license under the Licensing section.
  • If the activation attempt is unsuccessful (for example, if the Management Node was unable to establish a connection to the Pexip licensing server), or you selected Manually activate, the license will be saved as a Stored license request. You must then activate it manually.

Moving a license (e.g. when redeploying a Management Node)

You may need to move a license from one Management Node to another. You would typically need to do this if you are redeploying a Management Node, such as when setting up a new test or demonstration environment, or changing the Management Node's IP address.

To move a license between Management Nodes, you must deactivate the existing license on your 'old' Management Node before reactivating it on the 'new' Management Node.

On the old Management Node:

  1. Go to Platform configuration > Licenses.
  2. Select the license you want to deactivate.
  3. Make a note of the License entitlement key.
  4. Select Return license.

The system will attempt to contact the Pexip licensing server to automatically deactivate the license:

  • If successful, the license will no longer appear in the list of licenses.
  • If unsuccessful, you must manually deactivate the license by following the same steps as described in Manually activating a stored license request.

On the new Management Node:

  1. Go to Platform configuration > Licenses.
  2. Select Add License.
  3. In the License entitlement key field, enter the entitlement key from the 'old' Management Node that you noted previously.
  4. Select Save.

The system will attempt to activate the license on the 'new' Management Node:

  • If the license is activated successfully, you will be returned to the Licensing page and will see the new license under the Licensing section.
  • If the activation attempt is unsuccessful (for example, if the Management Node was unable to establish a connection to the Pexip licensing server), or you selected Manually activate, the license will be saved as a Stored license request. You must then activate it manually.

Manually activating a stored license request

To manually activate a stored license request:

  1. Go to Platform configuration > Licenses.

    The Stored license request section lists the licenses that were not able to be activated automatically, and are awaiting manual activation.

  2. Select the license you wish to activate.
  3. Select Export stored license request.

    This generates an XML file containing the request (for more information, see Content of the license request XML file).

  4. Download the XML file and send it to your authorized Pexip representative for activation. They will respond with an XML activation file.
  5. When you receive the XML file, go back to Platform configuration > Licenses, select the stored license request, and select Complete stored license request.
  6. Browse to the location of the XML activation file you have received.
  7. Select Save.

The license should now be activated and appear in the Licensing section.

Repairing a license

If it appears that a license has become corrupt (for example if the Management Node MAC address has changed), a Repair button will appear under the license information. To reactivate the license, select Repair and then follow the steps outlined in Adding licenses.

Content of the license request XML file

During both automatic and manual license activation, the same license request XML file is set to the Pexip licensing server. The content of this file includes:

  • the license request information (i.e. the detail of what is being requested)
  • opaque machine identifiers (computed from various information sources, but not exposing the actual values).

© 2016 Pexip AS - software version 11