Skip to content

Managing Licenses Offline

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 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 darksite), 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 https://techsupport.teradici.com 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 Teradici 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.

  1. Enable SSH if using PCoIP Management Console in OVA format. See: Temporarily Enabling SSH Access

  2. 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.

  3. Upload the ASR file provided in your ticket to the administrative home directory (/home/admin/).

  4. Connect a Secure Shell (SSH) client to to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.

  5. Change directories to the licensing directory.
    [admin@localhost ~]$ cd /opt/teradici/licensing/

  6. Set the LD_LIBRARY_PATH variable.
    [admin@localhost licensing]$ export LD_LIBRARY_PATH=/opt/teradici/licensing

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

  8. 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.

  1. 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

  2. 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.

  3. Upload the response text file provided in your ticket to the administrative home directory (/home/admin).

  4. Change directories to the licensing directory.
    [admin@localhost ~]$ cd /opt/teradici/licensing/

  5. Set the LD_LIBRARY_PATH variable.
    [admin@localhost licensing]$ export LD_LIBRARY_PATH=/opt/teradici/licensing

  6. 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:

  1. Enable SSH. See: Temporarily Enabling SSH Access

  2. Connect a Secure Shell (SSH) client to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.

  3. Change directories to the licensing directory.
    [admin@localhost ~]$ cd /opt/teradici/licensing/

  4. Set the LD_LIBRARY_PATH variable
    [admin@localhost licensing]$ export LD_LIBRARY_PATH=/opt/teradici/licensing

  5. 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:

  1. Enable SSH. See: Temporarily Enabling SSH Access

  2. 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.

  3. Upload the ASR file provided in your ticket to the administrative home directory.

  4. Connect a Secure Shell (SSH) client to the PCoIP Management Console virtual machine using the PCoIP Management Console virtual machine administrative credentials.

  5. Change directories to the licensing directory.
    [admin@localhost ~]$ cd /opt/teradici/licensing/

  6. Set the LD_LIBRARY_PATH variable
    [admin@localhost licensing]$ export LD_LIBRARY_PATH=/opt/teradici/licensing

  7. 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"
        --------------------------------------------------------------------
    
  8. 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

  9. Send the return short code returned in step 8 as a text file to Teradici.

  10. Teradici 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.