Managing Licenses Offline¶

License Scripts

HP 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 virtual machine console’s /opt/teradici/licensing directory and require you to connect to your PCoIP Management Console virtual machine console. See Logging in to the PCoIP Management Console OVA Virtual Machine Console.

Activating Your PCoIP Management Console License from a Location Without Internet Access¶

To activate your PCoIP Management Console Enterprise license when the PCoIP Management Console is located on a site without Internet access (sometimes referred to as a dark site), you will need to create a ticket for Offline License Activation. A support site account will be required to create this ticket. The ticket must include your license activation code that was provided by email when you requested a trial license or when your Enterprise license was purchased. Once the ticket is created, you will be provided with an offline activation .asr file allowing you to produce an offline activation short code to return to support. Support will in turn provide you with a response text file which you will use to activate PCoIP Management Console Enterprise. Activating and deactivating licenses from a site without Internet access must be done using the virtual machine console.

Requesting Offline Activation¶

Go to the support site, sign in and create a ticket for Offline License Activation. Include your PCoIP Management Console Enterprise license activation code that was provided by email when your trial license was requested or when your Enterprise license was purchased.

Producing an Offline Activation Short Code¶

The ticket will first be updated by support with an ASR file which you have to upload to your PCoIP Management Console. Once you have the ASR file, perform the following steps from your PCoIP Management Console virtual machine console.

Enable SSH if using PCoIP Management Console in OVA format. See: Temporarily Enabling SSH Access
Connect a Secure Copy Protocol (SCP) client such as Putty or WinSCP to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.
Upload the ASR file provided in your ticket to the administrative home directory (/home/admin/).
Connect a Secure Shell (SSH) client to to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.
Change directories to the licensing directory.
[admin@localhost ~]$ cd /opt/teradici/licensing/
Set the LD_LIBRARY_PATH variable.
[admin@localhost licensing]$ export LD_LIBRARY_PATH=.
Process offline_activation.asr with appactutil.
[admin@localhost licensing]$ ./appactutil -shortcode ~/offline_activation.asr
Activation short code output example:
Activation short code: 216360-082292-891921-316997-475492-227533-740186-228152
Copy your Activation short code into a text file and enter it into your ticket. Wait for the response code text file to be returned from support.

Completing the Offline Activation¶

Once the support ticket has been updated with a response code text file, you can then follow these steps to activate your PCoIP Management Console Enterprise with the response code file.

From the PCoIP Management Console virtual machine console enable SSH. See: Temporarily Enabling SSH Access

Info: PCoIP Management Console AMI format

Enabling SSH is not required for the AMI
Connect a Secure Copy Protocol (SCP) client such as Putty or WinSCP to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.
Upload the response text file provided in your ticket to the administrative home directory (/home/admin).
Change directories to the licensing directory.
[admin@localhost ~]$ cd /opt/teradici/licensing/
Set the LD_LIBRARY_PATH variable.
[admin@localhost licensing]$ export LD_LIBRARY_PATH=/opt/teradici/licensing

Process response.txt with appactutil.
[admin@localhost licensing]$ ./appactutil -process ~/response.txt

Reading response from /home/admin/response.txt
SUCCESSFULLY PROCESSED RESPONSE
ProductID MC, FulfillmentID FID-CUSTNAME-2016-1

Viewing Installed Licenses¶

To view your installed licenses:

Enable SSH. See: Temporarily Enabling SSH Access
Connect a Secure Shell (SSH) client to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.
Change directories to the licensing directory.
[admin@localhost ~]$ cd /opt/teradici/licensing/
Set the LD_LIBRARY_PATH variable
[admin@localhost licensing]$ export LD_LIBRARY_PATH=/opt/teradici/licensing

View the installed licenses and note the Fullfillment ID of the license to return.
[admin@localhost licensing]$ ./appactutil -view

    --------------------------------------------------------------------
    Trust Flags: FULLY TRUSTED
    Fulfillment Type: SHORTCODE
    Status: ENABLED
    Fulfillment ID: FID-OFFLINE-12345678-1
    Entitlement ID: ENTL-OFFLINE-12345678-2-1
    Product ID: MC
    Suite ID: NONE
    Expiration date: 30-may-2017
    Feature line(s):
    INCREMENT MC_nDevices TERADICI 2.00000 30-may-2017 1 \
    VENDOR_STRING="nDev=500, FNO=90, SN=19137747" ISSUER=Teradici \
    ISSUED=13-mar-2017 NOTICE="Teradici - Dev Ops" TS_OK \
    SIGN="00D0 A25F 78FB A9C4 7093 EB1A 2744 8500 DF9B 8201 9CFE \
    F024 08A5 67DE CD45"
    --------------------------------------------------------------------

Deactivating Your PCoIP Management Console Enterprise License from a Location Without Internet Access¶

To deactivate your PCoIP Management Console Enterprise license when the PCoIP Management Console is located in a site without Internet access:

Enable SSH. See: Temporarily Enabling SSH Access
Connect a Secure Copy Protocol (SCP) client such as Putty or WinSCP to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.
Upload the ASR file provided in your ticket to the administrative home directory.
Connect a Secure Shell (SSH) client to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.
Change directories to the licensing directory.
[admin@localhost ~]$ cd /opt/teradici/licensing/
Set the LD_LIBRARY_PATH variable
[admin@localhost licensing]$ export LD_LIBRARY_PATH=/opt/teradici/licensing

View the installed licenses and note the Fullfillment ID of the license to return.
[admin@localhost licensing]$ ./appactutil -view

    --------------------------------------------------------------------
    Trust Flags: FULLY TRUSTED
    Fulfillment Type: SHORTCODE
    Status: ENABLED
    Fulfillment ID: FID-OFFLINE-12345678-1
    Entitlement ID: ENTL-OFFLINE-12345678-2-1
    Product ID: MC
    Suite ID: NONE
    Expiration date: 30-may-2017
    Feature line(s):
    INCREMENT MC_nDevices TERADICI 2.00000 30-may-2017 1 \
    VENDOR_STRING="nDev=500, FNO=90, SN=19137747" ISSUER=Teradici \
    ISSUED=13-mar-2017 NOTICE="Teradici - Dev Ops" TS_OK \
    SIGN="00D0 A25F 78FB A9C4 7093 EB1A 2744 8500 DF9B 8201 9CFE \
    F024 08A5 67DE CD45"
    --------------------------------------------------------------------

Generate the return request code by using appactutil. The ASR file referenced must be the one used to activate the license. The -return parameter is the Fulfillment ID noted in the previous step.
[admin@localhost licensing]$ ./appactutil -shortcode ~/offline_activation.asr -return FID-OFFLINE-12345678-1
Return short code: 163698-563854-292262-189561-853089-634323-881517-668156
Send the return short code returned in step 8 as a text file to HP.
Support will return a response file where you must finish the deactivation by following the Completing the Offline Activation

Note: Finding fulfillment ID

To find your fulfillment ID, see Viewing Installed Licenses.