Installing 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 as shown here and then remove the internet connection.
If you cannot connect to the internet at all, you must obtain dependencies and License Server software via a temporary internet-connected machine and transfer the files yourself, as shown here.

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

The PCoIP License Server 2.x 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:
```
sudo yum install wget
```

Configure the Teradici yum repository:

sudo wget -O /etc/yum.repos.d/pcoip.repo https://downloads.teradici.com/rhel/pcoip.repo

Install the license server:

sudo yum install -y pcoip-license-server

Set the PCoIP License Server administrative password:
```
sudo pcoip-set-password
```
The default system password is 1P@ssw0rd!, where the leading 1 is a numeral one and 0 is a zero.

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.
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 2.7+ (pre-installed in RHEL 7 and CentOS 7)
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-connect RHEL (or CentOS) 7 machine for downloading and inspecting packages. This machine should be identical to the license server machine.
SSH into the new temporary machine.
Run the following command:
```
sudo yum install -y yum-utils
```
Create a new directory to hold downloaded package manager files:
```
mkdir ~/rpms/
```

Download required updates to the new RPM folder:

sudo yum update --downloadonly --downloaddir=./rpms/

Download dependency packages:

sudo repotrack -a x86_64 -p ~/rpms/ python curl java-1.8.0-openjdk redhat-lsb-core

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 (~/):
```
cd ~/rpms/
sudo yum 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/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:
```
sudo yum install pcoip-license-server-2.0.x-xxx.xxxxxxxx.el7.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.
Immediately change the default PCoIP License Server administrative password.
```
sudo pcoip-set-password
```
The default system password is 1P@ssw0rd!, where the leading 1 is a numeral one and 0 is a zero.

Caution: 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.
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/flextnetls/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.