Managing PCoIP Session Licenses¶

PCoIP session licenses are purchased in bundles from Teradici. 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 PCoIP 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.

Licenses can be lost

If a system hosting a PCoIP 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 Teradici Global Support Services at the Teradici Support Center.

Activating Licenses in an Online Environment¶

PCoIP session licenses can be activated directly when the license server is connected to the internet by using the pcoip-activate-online-license command. To activate licenses, you must supply the activation code for a group of licenses and the total number of licenses to activate under that activation code.

This command requires the PCoIP License Server's administrative password. You will be prompted for it.

For example:

pcoip-activate-online-license -a <activation-code> -c <license count>

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.

To activate licenses:

SSH into your PCoIP License Server machine.
Invoke pcoip-activate-online-license, supplying 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.
- Optionally, 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 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
```
If you have licenses belonging to multiple activation codes, invoke pcoip-activate-online-license again for each license pool.
Verify your license activations:
```
pcoip-list-licenses
```

Returning Licenses in Online Environments¶

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.

Return all the licenses for a given activation code by invoking pcoip-return-online-license.

This command requires the PCoIP License Server's administrative password. You can provide the password inline using -p. If you do not provide the password on the command line, you will be prompted for it.

To return licenses:

Use pcoip-list-licenses to view information about your current license usage.
```
pcoip-list-licenses
```
Use pcoip-return-online-license to return all of the 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 use pcoip-activate-online-license with a reduced total license count (-c), which effectively returns the remainder.

Viewing License Information¶

To view the current status of your managed licenses, use pcoip-list-licenses. This command provides information about the PCoIP session licenses that have been activated on the Teradici PCoIP License Server.

This command requires the PCoIP License Server's administrative password. You can provide the password inline using -p. If you do not provide the password on the command line, you will be prompted for it.

pcoip-list-licenses

The information returned by pcoip-list-licenses includes:

The number of licenses that have been activated
The number of licenses that have been used
The expiration dates of features or session licenses.

Migrating Licenses to Another Server¶

A license may only be used on one license server instance at a time. To migrate licenses, you must return them on the first PCoIP License Server and then activate them on the second.