Managing Online Licenses¶
Online 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.
Caution: Licenses can be lost
If a system hosting a HP Anyware License Server is destroyed or becomes corrupted, any licenses registered to it can no longer be returned and are effectively lost. If this happens, open a ticket with HP Anyware Support Services.
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.
-
List your HP Anyware license servers by selecting License Servers. You should see a server with the alias “Default hosted server”.
-
Click the license server ID of this server.
-
Click the Remove Add-Ons link, which displays the current license codes and their quantity.
-
In the Qty to Remove box associated with the code, enter the number of licenses to be removed.
-
Select Remove Add-Ons. The status "Copies decreasing" is displayed, indicating that unmapping is in progress.
-
To save your changes, click the Download capability Response link.
-
Delete the *.bin file that is downloaded.
-
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¶
PCoIP session licenses can be activated directly when the license server is connected to the internet by using the pcoip-activate-online-license
command. When running this command, you will be prompted for the HP Anyware License Server's administrative password.
-
SSH into your HP Anyware License Server machine.
-
Invoke
pcoip-activate-online-license
, and supply the following arguments:-a
followed by the activation code to use-c
followed by the number of licenses to activate under the specified activation code.- Provide the license server password on the command line with
-p
followed by the password. If you omit this option, you will be prompted for the password.
For example, this command activates 50 licenses with the activation code 1234-ABCD-EF12-5678. Since the
-p
option is not used, you will be prompted for the password:pcoip-activate-online-license -a 1234-ABCD-EF12-5678 -c 50
Note: License count (
-c
) sets the total number of active licenses for each activation codeThe 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 thenpcoip-activate-online-license -a 1234567890 -c 10
, you will have 10 active licenses—not 15. -
If you have licenses belonging to multiple activation codes, invoke
pcoip-activate-online-license
again for each license pool. -
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.
Note: Migrating Licenses
A license may only be used on one license server instance at a time. To migrate licenses, you must return them on the first HP Anyware License Server and then activate them on the second.
-
Use
pcoip-list-licenses
to view information about your current license usage.pcoip-list-licenses
-
Use
pcoip-return-online-license
to return licenses for an activation code. This will return all the licenses belonging to the given activation code on this license server; if there are activated licenses belonging to the same code on a different license server, they must be returned on that server.pcoip-return-online-license -a 1234-ABCD-EF12-3456
Returning a subset of licenses
pcoip-return-online-license
returns all licenses associated with an activation code. If you want to return a portion of the licenses instead, you can usepcoip-activate-online-license
with a reduced total license count (-c), which effectively returns the remainder.