Skip to content

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:

  1. SSH into your License Server machine.

  2. Install wget and yum-utils:

    sudo yum install wget
    sudo yum install yum-utils
    
  3. Install the Teradici yum repository:

    sudo yum install https://downloads.teradici.com/rhel/teradici-repo-latest.noarch.rpm
    
  4. 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
    
  5. Install the license server:

    sudo yum install -y pcoip-license-server
    
  6. 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.

  7. If possible, enable HTTPS/TLS for communication with the PCoIP License Server, as described here.

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

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