Skip to content

Managing Offline Licenses

Offline Environments

Unmapping Licenses Prior to Activation

By default, license codes are mapped to a default cloud license server provided by HP Anyware. If you are using an offline Local License Server, the license code must be unmapped first from the cloud license server before it becomes available for your Local License Server.

Unmap license codes on the HP Anyware License Portal.

  1. List your HP Anyware license servers by selecting the License Servers menu.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 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.

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

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

If you cannot transfer files to an internet-connected machine, create a ticket with support for assistance. HP Global Support Services will facilitate license activation for you.

Select Licensing in your ticket as the case reason and include the HOST-ID(VM_UUID or ETHERNET) of the HP Anyware License Server in your description. Run the following command to get the HOST-ID.

pcoip-get-license-server-id

Important: Required Access

Access to HP.flexnetoperations.com is required.

Before activating licenses with an offline license server, you need access to https://HP.flexnetoperations.com. To request access, create a ticket with support. Be prepared to provide a valid activation key, the name, and email address of a contact person who should have access.

To activate licenses:

  1. Login to HP Anyware License Server as a Windows administrator user.

  2. Open Command Prompt.

  3. Invoke pcoip-activate-offline-license with -g, the activation code, and the number of licenses. Use -p to provide administrator password. If not provided, you will be prompted for a password later. This will generate a file named request.bin, which is stored in the current working directory.

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

    Note: About License Count

    License count (-c) sets the total number of active licenses for each activation code. It does not add 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.

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

  5. Submit request.bin to FlexNet Operations:

    1. Log in to https://HP.flexnetoperations.com on the internet-connected machine with the email you set up on FlexNet Activations.

      Note: First-time only password reset

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

      Important: Resolving login difficulties

      If you experience difficulties logging in, get in touch with the owner of the email with which the license code is associatedto add you as a user on that account. Alternatively, contact HP for help.

    2. In the side bar, find the Served Licenses section and click Upload Capability Request:

      Upload Capability Request

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

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

      Important: Flexnet Errors

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

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

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

  8. 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 the License Server rejects it. If this occurs, repeat this procedure from the beginning with fresh request.bin and response.bin files.

  9. Verify the activation:

    pcoip-list-licenses

Returning Licenses

Licenses are registered on a license server where they are activated. To activate these licenses on a different license server, they must be returned or released first back into the available license pool.

You can return licenses by executing pcoip-activate-offline-license which decreases the active license count and returns the remaining license count by activating them. To do this, follow the procedure for the Activating Licenses in an Offline Environment and supply the reduced license count for pcoip-activate-offline-license in Step 3.

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

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

Return all the active licenses by supplying a count of 0 (zero):

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