Managing Offline Licenses¶

Offline Environments

PCoIP session licenses are purchased in bundles from HP. Each bundle is given an activation code at purchase, which controls activation and return of its session licenses. Licenses are validated by Flexera FlexNet Operations, and stored on the HP Anyware License Server's trusted storage.

Activated licenses remain linked to their license server until they are returned. No other license server instance can activate licenses that are already allocated.

Unmapping Licenses Prior to Activation¶

By default, license codes are mapped to a default cloud license server provided by HP Anyware. This license code must be unmapped, and made available before it can be activated on your offline license server.

1. List your HP Anyware license servers by selecting License Servers. You should see a server with the alias “Default hosted server”.

2. Click the license server ID of this server.

3. Click the Remove Add-Ons link, which displays the current license codes and their quantity.

4. In the Qty to Remove box associated with the code, enter the number of licenses to be removed.

5. Select Remove Add-Ons. The status "Copies decreasing" is displayed, indicating that unmapping is in progress.

6. To save your changes, click the Download capability Response link.

   1. Delete the *.bin file that is downloaded.

   2. Refresh your browser.

The status displays "License generated", which indicates that licenses are now available to be used with your local license server.

Activating Licenses¶

Since offline environments have no access to the internet, PCoIP session license activation is done indirectly. To activate licenses, you must have an internet-connected machine available and a means of transferring licensing files between the connected machine and your offline HP Anyware License Server.

1. SSH into your HP Anyware License Server machine.

2. Navigate to your home directory (or another directory that you have write permissions for). To navigate to your home directory, type:

   cd ~
   

3. Invoke pcoip-activate-offline-license with -g, the activation code, and the number of licenses to activate. Use -p to provide the HP Anyware License Server's administrative password inline, or leave it off to be prompted for the password:

   pcoip-activate-offline-license -g -a <activation code> -c <license count>
   

   Important: Activation codes are case-sensitive

   The activation code you use here must exactly match the code you received from HP Anyware, including dashes and uppercase or lowercase letters.

   Note: License count (-c) sets the total number of active licenses for each activation code

   The license count (-c) sets the total number of licenses that will be active for a given activation code. It does not add c additional licenses.

   For example, if you use pcoip-activate-online-license -a 1234567890 -c 5 and then pcoip-activate-online-license -a 1234567890 -c 10, you will have 10 active licenses—not 15.

   This will generate a file named request.bin and store it in the current working directory.

4. Transfer request.bin to a computer that has an internet connection using any acceptable method, such as a USB flash drive.

5. Submit request.bin to Flexnet Operations:

   1. Browse to https://teradici.flexnetoperations.com using the internet-connected machine and log in.

   2. Log in with the email address you set up as your Flexnet Activation contact.

      Note: First-time only password reset

      The first time you log in to Flexnet Operations, you will need to reset your password. Click Password Finder on the login page to reset the password.

      Important: Resolving login difficulties

      If you experience difficulties logging in, contact HP Anyware for help. The owner of the activation code email address can also add you as a user on the account.

   3. In the sidebar, find the Devices section and click Upload Capability Request:

      

   4. Click Browse and provide the request.bin file you transferred from the HP Anyware License Server.

   5. Click Send to submit the request and download a response file.

      If FlexNet Operations returns an error instead of a response file, there is a problem with your request file. Generate a new request.bin file and try again.

6. Transfer the received response file to the License Server machine using any acceptable method, such as a USB flash drive.

   The response.bin file can only be used on the machine that generated the request.bin file.

7. Invoke pcoip-activate-offline-license again with -r and the response file received from Flexnet Operations:

   pcoip-activate-offline-license -r 'path/to/response.bin'
   

   Note: response.bin expires after 7 days

   The response.bin file expires after 7 days, after which it will be rejected by the License Server. If this occurs, repeat this procedure from the beginning with fresh request.bin and response.bin files.

8. Verify your activated licenses:

   pcoip-list-licenses
   

Returning Licenses¶

Licenses are registered to the license server where they are activated. In order to activate them on a different license server, they must first be returned, or released back into the available license pool.

Licenses are returned by using pcoip-activate-offline-license to reduce the active license count. This activates the new (smaller) number of licenses and returns the remainder.

1. Return the desired number of licenses using the pcoip-activate-offline-license command. For more information, see the Command Reference.

2. Note the reduced license count.

3. Follow the procedure for Activating Licenses in an Offline Environment and supply the reduced license count in step 3.

For example, if activation code 1234-ABCD-EF12-3456 has 25 active licenses and you want to return 5, you set the number of active licenses to 20:

pcoip-activate-offline-license -g -a 1234-ABCD-EF12-3456 -c 20

pcoip-activate-offline-license -g -a 1234-ABCD-EF12-3456 -c 0