

Installing the PCoIP License Server¶

The method you will use to install the PCoIP License Server depends on whether you can open a temporary internet connection to the License Server machine.

If you can open a temporary connection to the internet, you can install the software and dependencies directly and then remove the internet connection.
If you cannot connect to the internet, you must obtain dependencies and License Server software via a temporary internet-connected machine and transfer the files yourself.

Important: Migrating from RHEL/CentOS 7 to RHEL/CentOS 8

If you have currently deployed a PCoIP License Server on RHEL/CentOS 7 and wish to upgrade to RHEL/CentOS 8, do not upgrade the operating system in place. Updating the operating system could invalidate your PCoIP licenses. See Migrating from RHEL/CentOS 7 to RHEL/CentOS 8 for a supported migration path.

Caution: Don't install more than one type of license server on the same machine

The PCoIP License Server version 20.10 cannot be installed on the same machine as the PCoIP License Server 1.x or an NVIDIA GRID License Server.

Installing With a Temporary Internet Connection¶

To install the software with a temporary internet connection:

Open the internet connection on the License Server machine.
SSH into your License Server machine.
Install wget and yum-utils (skip this step for RHEL/CentOS 8):
```
sudo yum install wget
sudo yum install yum-utils
```

Install the Teradici yum repository:

For RHEL/CentOS 7:

sudo yum install https://downloads.teradici.com/rhel/teradici-repo-latest.noarch.rpm

For RHEL/CentOS 8:

sudo dnf install https://downloads.teradici.com/rhel/teradici-repo-latest.noarch.rpm

Install the license server:

For RHEL/CentOS 7:

sudo yum install -y pcoip-license-server

For RHEL/CentOS 8:

sudo dnf install -y pcoip-license-server

Set your PCoIP License Server administrative password with pcoip-set-password.

Change the default password immediately

Until the default password is changed, commands can be issued to the license server without your knowledge.
Info: Password Rules

Passwords must conform to the following rules:
- Must be between 8 and 30 characters long
- Must contain at least one lowercase letter
- Must contain at least one uppercase letter
- Must contain at least one digit
- Must contain at least one symbol, excluding ' (single quote), " (double quote), \ (backslash), and spaces.
Note: Default password

The default password in new installations is 1P@ssw0rd!, where the leading 1 is a numeral one and 0 is a zero. When setting the password on a clean installation, use this as your curent password.
- Set the new password:
```
sudo pcoip-set-password -p <current password> -n <new password>
```
  If you omit the -p and -n flags, you will be prompted for the old and new passwords.
Remove the internet connection.
If you need to change the PCoIP License Server's listening port, see Configuring the License Server's Listening Port.

The PCoIP License Server starts automatically when it is installed.

Installing With No Internet Connection¶

If you cannot open an internet connection on the License Server machine, you must create a temporary machine to download the License Server software and its dependencies and then manually transfer and install them.

Install Dependencies¶

The PCoIP License Server depends on these software packages:

Python 3.6+
curl 7.29+ (pre-installed in RHEL 7+ and CentOS 7+)
Java 1.8.x
redhat-lsb-core

To install dependencies without an internet connection:

Create a disposable internet-connected RHEL (or CentOS) machine for downloading and inspecting packages. This machine should be identical to the license server machine.
SSH into the new temporary machine.
If you are installing on RHEL/CentOS 7, run the following command (skip this step in RHEL/CentOS 8):
```
sudo yum install -y yum-utils
```
Install which, if not already installed on your system:
- For RHEL 7 and CentOS 7
```
sudo yum install -y which
```
- For RHEL 8 and CentOS 8
```
dnf install -y which
```
Create a new directory to hold downloaded package manager files:
```
mkdir ~/rpms/
cd ~/rpms/
```
Download required updates to the new RPM folder:
- For RHEL 7 and CentOS 7
```
sudo yum update -y --downloadonly
```
- For RHEL 8 and CentOS 8
```
sudo dnf update -y --downloadonly
```

Download dependency packages:

For RHEL 7 and CentOS 7

sudo repotrack --arch x86_64 python3 curl java-1.8.0-openjdk redhat-lsb-core openssl

For RHEL 8 and CentOS 8

sudo dnf download --downloadonly --resolve --arch x86_64 python3 java-1.8.0-openjdk redhat-lsb-core openssl

Transfer the RPMs directory containing the packages to your license server machine using any acceptable method, such as a USB flash drive.
Connect to the license server machine using a console.
Navigate to the RPMs directory and install the packages. The following example assumes the rpms/ directory is in the user home directory (~/):
- For RHEL 7 and CentOS 7
```
cd ~/rpms/
sudo yum install --disablerepo="*" -y *
```
- For RHEL 8 and CentOS 8
```
cd ~/rpms/
sudo dnf install --disablerepo="*" -y *
```

Install the PCoIP License Server Software¶

Once the dependencies are present, the license server software can be installed.

To Install the License Server:

Using an internet-connected machine, browse to the following directory:
```
https://downloads.teradici.com/rhel/8/stable/
```
Download the latest pcoip-license-server-* RPM file. The file with the highest build number is the latest. The build number immediately follows the full version number in the file name; in the following example, the full version number is 1.2.3 and the build number is 456: application-name-1.2.3.456.7890
Transfer the RPM file to the license server machine using any acceptable method, such as a USB flash drive.
Navigate to the directory where you placed the RPM file, and install the PCoIP License Server using yum:
- For RHEL 7 and CentOS 7
```
sudo yum install --disablerepo="*" pcoip-license-server-20.10.x-xxx.xxxxxxxx.el8.x86_64.rpm
```
- For RHEL 8 and CentOS 8
```
sudo dnf install --disablerepo="*" pcoip-license-server-20.10.x-xxx.xxxxxxxx.el8.x86_64.rpm
```
Important: Long installation times are possible

When installing the PCoIP License Server offline, installation times of up to 10 minutes are possible. This is expected behavior.
Set your PCoIP License Server administrative password with pcoip-set-password.

Change the default password immediately

Until the default password is changed, commands can be issued to the license server without your knowledge.

Info: Password Rules

Passwords must conform to the following rules:
```
* Must be between 8 and 30 characters long
* Must contain at least one lowercase letter
* Must contain at least one uppercase letter
* Must contain at least one digit
* Must contain at least one symbol, excluding **'** (single quote), **"** (double quote), **\\** (backslash), and spaces.
```
Note: Default password

The default password in new installations is 1P@ssw0rd!, where the leading 1 is a numeral one and 0 is a zero. When setting the password on a clean installation, use this as your curent password.
- Set the new password:
```
sudo pcoip-set-password -p <current password> -n <new password>
```
If you omit the -p and -n flags, you will be prompted for the old and new passwords.
If you need to change the PCoIP License Server's listening port, see Configuring the License Server's Listening Port.

The PCoIP License Server starts automatically when it is installed.

Do not modify the trusted storage database

The PCoIP License Server installs a trusted storage database in /var/opt/flexnetls/TERADICI.

If the contents of this directory are moved or modified, the license server will consider the trusted storage corrupted. The server will log an error and refuse to start.

Migrating from RHEL/CentOS 7 to RHEL/CentOS 8¶

If you have an exisitng PCoIP License Server on RHEL/CentOS 7 and wish to upgrade to RHEL/CentOS 8, you must create a new machine and transfer the license activations to it. You cannot upgrade the operating system in place.

To migrate licenses from a RHEL/CentOS 7 to a RHEL/CentOS 8 PCoIP License Server:

On the existing RHEL/CentOS 7 machine, record the number of activated licenses using the pcoip-list-licenses command, replacing <password> with your PCoIP License Server password:
```
sudo pcoip-list-license -p <password>
```
Note the number of licenses returned by this command; we will use it to verify the migration in the last step.
Create a new offline RHEL/CentOS 8 machine.
Follow the instructions above to install the PCoIP License Server on the new machine.
Return the licenses on the RHEL/CentOS 7 machine, using the instructions here.

The command will provide the number of licenses returned; note this value. We'll use it in the next step.
On the new RHEL/CentOS 8 machine, activate the same number of licenses that were returned in the previous step, using the instructions here. When following these instructions, use the number returned in the previous step for <license count>.
Repeat steps 4 and 5 for each of your activation codes, until all licenses have been returned from the old machine and re-activated on the new one.
On the new machine, verify that all the licenses have been successfully activated with the pcoip-list-licenses command, replacing <password> with your PCoIP License Server password:
```
sudo pcoip-list-license -p <password>
```
The value returned by this command should match the total number of licenses returned on the old license server.