Managing PCoIP Management Console Enterprise Licenses

Licensing Overview

PCoIP Management Console Enterprise is enabled through subscription licensing provided on a per managed device basis for terms of one and three years. Licenses can be added together to achieve the total number of necessary managed devices, with packages available in sizes of 100, 500, and 1000 managed devices.

Licenses come by email after you order them and contain one activation code for each license SKU ordered. Activation codes (also known as entitlement IDs) have an alphanumeric format of 0123-4567-89AB-CDEF.

The following is an example of the email content for 3x100 license SKUs:

Note: The license keys shown below do not contain real activation codes.

Description: Teradici PCoIP® Management Console Enterprise – 1 year, 100 devices

Activation Code: 0123-4567-89AB-CDEF

Quantity: 1

SKU: MCE1Y0100

Valid Until: 12/31/2016

________________________________________

Description: Teradici PCoIP® Management Console Enterprise – 1 year, 100 devices

Activation Code: 4567-89AB-CDEF-0123

Quantity: 1

SKU: MCE1Y0100

Valid Until: 12/31/2016

________________________________________

Description: Teradici PCoIP® Management Console Enterprise – 1 year, 100 devices

Activation Code: 89AB-CDEF-0123-4567

Quantity: 1

SKU: MCE1Y0100

Valid Until: 12/31/2016

Please contact your reseller to obtain your license key for PCoIP Management Console Enterprise or go to http://connect.teradici.com/tryMC to request a free trial license. For more information on license options and packaging, please see http://www.teradici.com/products-and-solutions/pcoip-products/management-console or one of Teradici’s resellers,

License Requirements and Restrictions

The following requirements and restrictions apply for PCoIP Management Console Enterprise:

• If your PCoIP Management Console appliance will be moved to another server or replaced with an upgrade, you must return all the PCoIP Management Console licenses before the migration and then re-activate the licenses after the migration.

  Note: The PCoIP Management Console will run in Standard Edition mode when all its licenses are deactivated.

• Licenses are installed on a per PCoIP Management Console appliance basis. If multiple PCoIP Management Consoles will be used in a deployment, the SKUs should be ordered with that in mind. For example, if you will be managing 500 devices over two PCoIP Management Consoles, you will want to order 5x100 license SKUs as opposed to 1x500 license SKU. In this scenario, two licenses (2x100 license SKUs) would enable 200 endpoints on one PCoIP Management Console and three licenses (3x100 license SKUs) would enable 300 licenses on the second PCoIP Management Console.
• As of PCoIP Management Console 2.1, if no licenses are installed, the PCoIP Management Console will operate in Standard Edition mode.
• Internet access to https://teradici.flexnetoperations.com/ on port 443 is required for the PCoIP Management Console to activate the license against the license server. The PCoIP Management Console may also require the ability to contact this server from time to time to keep the license activated. There is currently no support for offline activation for PCoIP Management Consoles installed in locations without Internet access.
• Licenses can be returned multiple times. If the system prevents activation after returning a license, contact Teradici support for assistance.
• Licenses can only be used on one PCoIP Management Console at a time.

Notifications

The Management Console interface displays a notification when licenses are about to expire, when they have expired, when you are approaching your licensed device count limit, and when you have reached the limit.

Support and Maintenance

In the email containing the activation codes for your license(s), you will also receive your product support identifier (PSI #), which entitles you to support and maintenance from Teradici. The PSI # is in the alphanumeric format of 0123-4567-89AB-CDEF, with the SKU name of SMMCE. It will appear in the email in a format similar to this:

Activation Code: 8576-B583-DCF3-4622

Description: Teradici PCoIP® Management Console Enterprise – Support and Maintenance (PSI#)

Quantity: 1

SKU: SMMCE

Valid Until: 10/15/2015

Note: This code cannot be entered into the Management Console and will not activate the Management Console. It is for entry into the Teradici Technical Support site to request support.

For more information on Teradici support and maintenance, see http://www.teradici.com/products-and-services/global-support-services/pcoip-product-support-maintenance.

License Scripts

Teradici provides shell scripts that let you activate, view information about, and deactivate PCoIP Management Console Enterprise licenses. All scripts are located in the PCoIP Management Console VM console’s /opt/teradici/licensing directory and require you to connect to your PCoIP Management Console VM console.

Activating Licenses

Before you can activate your license, you will need your activation key. If you are activating from behind a proxy, you will also need the IP address and port number of your proxy server.

Activating Your PCoIP Management Console License

To activate your PCoIP Management Console Enterprise license:

1. Connect to your PCoIP Management Console VM console and log in using the admin user account and password.
2. Run the following command:
   /opt/teradici/licensing/mc_activate_lic.sh -k <entitlementID>
   
   where <entitlementID> is the activation key you received via email.
   
   Example: /opt/teradici/licensing/mc_activate_lic.sh -k 1234-5678-90AB-CDEF
   

Activating Your PCoIP Management Console License from behind a Proxy Server

To activate your PCoIP Management Console Enterprise license when the PCoIP Management Console is located behind a proxy server, append a -p parameter that defines the proxy parameters:

1. Connect to your PCoIP Management Console VM console and log in using the admin user account and password.
2. Run the following command:
   /opt/teradici/licensing/mc_activate_lic.sh -k <entitlementId> -p [<user:password>@] <proxyhost:port>
   
   where:
   <entitlementID> is the activation key you received via email.
   <user:password>] is optional. If user is provided, password must also be provided.
   <proxyhost:port> is the IP address and port number of your proxy server.
   
   Examples:
   • If the proxy requires a user name and password:
     /opt/teradici/licensing/mc_activate_lic.sh -k 1234-5678-90AB-CDEF -p bob:bobpasswd@192.168.45.23:3128
     
     
   • If the proxy does not require a user name and password:
     /opt/teradici/licensing/mc_activate_lic.sh -k 1234-5678-90AB-CDEF -p 192.168.45.23:3128
     

Viewing Installed Licenses

Once your license is activated, its information is stored on the PCoIP Management Console VM. To view this information:

1. Connect to your PCoIP Management Console VM console and log in using the admin user account and password.
2. Run the following command:
   /opt/teradici/licensing/mc_view_lic.sh

The script will output the following information:

• Fulfillment ID: XXXXXXXX: An ID assigned to a license after it is activated. This ID is required if you deactivate the license. The fulfillment ID will be different each time you reactivate a license after it has been deactivated.
  
• Entitlement ID: XXXX-XXXX-XXXX-XXXX: The license key you received via email that you use to activate your license.
  
• Expiration date: DD-MMM-YYYY: The day, month, and year your license expires.
  

Deactivating Licenses

It is important to deactivate a license when you no longer need it, for example, when you decommission a VM. This frees up the license and makes it available for a different PCoIP Management Console Enterprise deployment.

Note: The PCoIP Management Console will run in Standard Edition mode when all its licenses are deactivated.

Deactivating Your PCoIP Management Console License

To deactivate your PCoIP Management Console Enterprise license:

1. Connect to your PCoIP Management Console VM console and log in using the admin user account and password.
2. Run the following command:
   /opt/teradici/licensing/mc_return_lic.sh -f <fulfillment_ID>
   
   where <fulfillment_ID> is the ID assigned to the license after it was activated.
   
   Example: /opt/teradici/licensing/mc_return_lic.sh -f 12345678
   

   Note: To find your fulfillment ID, see Viewing Installed Licenses.
   

Deactivating Your PCoIP Management Console License from behind a Proxy Server

To deactivate your PCoIP Management Console Enterprise license when the PCoIP Management Console is located behind a proxy server, append a -p parameter that defines the proxy parameters:

1. Connect to your PCoIP Management Console VM console and log in using the admin user account and password.
2. Run the following command:
   /opt/teradici/licensing/mc_return_lic.sh -f <fulfillmentId> -p [<user:password>@] <proxyhost:port>
   
   where:
   <fulfillmentID> is the ID assigned to the license after it was activated.
   [<user:password>] is optional. If user is provided, password must also be provided.
   <proxyhost:port> is the IP addess and port number of your proxy server.
   
   Example:
   • If the proxy requires a user name and password:
     /opt/teradici/licensing/mc_return_lic.sh -f 12345678 -p bob:bobpasswd@192.168.45.23:3128
     
     
   • If the proxy does not require a user name and password:
     /opt/teradici/licensing/mc_return_lic.sh -f 12345678 -p 192.168.45.23:3128
     

     Note: To find your fulfillment ID, see Viewing Installed Licenses.
     

© 2016 Teradici Corporation. All rights reserved. Intellectual Property Rights.
TER1401005 Issue 9, Version 2.2, 10 August 2016.