Managing Online Licenses¶

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

List your HP Anyware license servers by selecting the License Servers menu.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 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. To activate licenses, you must supply the activation code for a group of licenses and the total number of licenses along with the command.

Note: About License Count

The license count (-c) sets the total number of licenses that will be active for a given 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.

Login to HP Anyware License Server as Administrator and open Windows PowerShell.
Invoke pcoip-activate-online-license by supplying the following arguments:
- -a followed by the activation code.
- -c followed by the number of licenses to activate.
- Optionally, -p followed by the license server password. If you omit this option, you will be prompted for the password later.
For example, this command would activate 50 licenses with the activation code 1234-ABCD-EF12-5678. Since the -p option is not used, you would be prompted for the password:
```
pcoip-activate-online-license -a 1234-ABCD-EF12-5678 -c 50
```
For license pools with their activation codes, invoke pcoip-activate-online-license again for each license pool.
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.

Login to HP Anyware License Server as Administrator and open Windows PowerShell.
Execute pcoip-list-licenses to view information about your license usage.
```
pcoip-list-licenses
```
Execute pcoip-return-online-license to return all the licenses for an activation code. You can provide the password inline using -p. If you do not, it will prompt you for a password later.

This returns all the licenses related to that activation code on this license server; if there are activated licenses related to the same code on a different license server, they must be returned on that server as well.
```
pcoip-return-online-license -a 1234-ABCD-EF12-3456
```
Note: Returning a subset of licenses

pcoip-return-online-license returns all licenses associated with an activation code. If you want to return some of the licenses, you can execute pcoip-activate-online-license which decreases the total license count (-c) and effectively returns the remaining count.