Skip to content

Using your Virtual Machine Console to Administer Licenses when Connected to the Internet

Info: Virtual machine console

The use of the vm console is required for license management on PCoIP Management Console releases 2.0 to 3.0. From MC 3.1 onwards, a UI is present for managing licenses when connected to the internet.

Activating Licenses

Using your virtual machine console to activate your PCoIP Management Console Enterprise license:

  1. Connect to your PCoIP Management Console virtual machine console and log in using the admin account and password. See Logging in to the PCoIP Management Console OVA Virtual Machine Console.

  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

Using your virtual machine console to activate your PCoIP Management Console Enterprise license from behind a proxy server:

Info: Proxy parameter

Activating PCoIP Management Console Enterprise license when the PCoIP Management Console is located behind a proxy server requires appending the -p parameter that defines the proxy parameters.

  1. Connect to your PCoIP Management Console virtual machine console and log in using the admin 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 virtual machine.

You can view the installed licenses via the command prompt on the vm console.

View installed licenses via the command prompt:

  1. Connect to your PCoIP Management Console virtual machine console and log in using the admin account and password. See Logging in to the PCoIP Management Console OVA Virtual Machine Console.
  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 virtual machine. This frees up the license and makes it available for a different PCoIP Management Console Enterprise deployment.

Note: Deactivating license reverts PCoIP Management Console to PCoIP Management Console Free

PCoIP Management Console will run in Free mode when all its licenses are deactivated.

!!! warning "Warning: Internet Access Required" When deactivating a license, an internet connection to the licensing server is required unless the offline license activation steps are used.

Deactivating Your PCoIP Management Console License

Using your virtual machine console to deactivate PCoIP Management Console Enterprise license:

  1. Connect to your PCoIP Management Console console and log in using the admin 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: Finding fulfillment ID

To find your fulfillment ID, see Viewing Installed Licenses.

To deactivate your PCoIP Management Console Enterprise license when the PCoIP Management Console is located behind a proxy server:

  1. Connect to your PCoIP Management Console Enterprise virtual machine console and log in using the admin account and password. See Logging in to the PCoIP Management Console OVA Virtual Machine Console.

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