Installing the PCoIP License Server¶
To get up and running quickly with the PCoIP License Server in an online (internet-connected) environment, follow these instructions.
Caution: Don't install more than one type of license server on the same machine
The PCoIP License Server version 20.04 cannot be installed on the same machine as the PCoIP License Server 1.x or an NVIDIA GRID License Server.
To install the PCoIP License Server:
-
SSH into your License Server machine.
-
Install wget and yum-utils:
sudo yum install wget sudo yum install yum-utils
-
Install the Teradici yum repository:
sudo yum install https://downloads.teradici.com/rhel/teradici-repo-latest.noarch.rpm
-
To use the beta channel, change the repo configuration on this machine:
sudo yum-config-manager --disable pcoip-stable sudo yum-config-manager --enable pcoip-beta
-
Install the license server:
sudo yum 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 leading1
is a numeral one and0
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 possible, enable HTTPS/TLS for communication with the PCoIP License Server, as described here.
-
Configure your firewalls:
- Configure your corporate firewall to block all incoming external connections. The PCoIP License Server does not need to accept incoming connections from the outside internet.
-
On the PCoIP License Server machine, first block all incoming TCP connections, then allow incoming connections only on these specific ports:
-
Allow PCoIP agent subnets to connect on your configured listening port
By default, the PCoIP License Server listens on port 7070 using HTTP. If you have not modified the default and have not enabled HTTPS/TLS, then open port 7070; if you have modified the default installation then adjust the port number accordingly.
If you change the default listening port for the PCoIP License Server, you must also change the port configuration on all PCoIP agents that use it.
-
If using SSH to administer the server, allow your administrative subnet to connect on port 22.
-
-
Open port 443 to outgoing connections. If you are using a proxy server, this requirement may be different; review your proxy server configuration.
-
If you block outgoing connections over the internet, you will need to whitelist our licensing service addresses.
Restart the system after making changes
If you make changes to the PCoIP License Server configuration settings, you will have to restart the server to apply your changes. To restart the server, use the following command:
sudo systemctl restart flexnetls-TERADICI.service