Skip to content

Configuring the PCoIP License Server

The PCoIP License Server requires minimal configuration. This section describes the configuration settings and options available.

Important: Configure PCoIP Agents and Connection Managers

The PCoIP License Server URL must be provided to the Connection Manager managing your PCoIP agents, or to each of your PCoIP Agents if you are not using a Connection Manager. The License Server URL format is:

http://<license-server-address>:<port>/request

Setting the License Server's Administrator Password

The License Server administrator's password is set using the pcoip-set-password command. You must have superuser (sudo) permissions to use pcoip-set-password.

To set the PCoIP License Server Password:

  1. Invoke pcoip-set-password with no arguments:

    sudo pcoip-set-password
    
  2. When prompted, provide the old password. The default password in new installations is 1P@ssw0rd!, where the leading 1 is a numeral one and 0 is a zero.

  3. When prompted, provide the new password.

    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.

Configuring the License Server's Listening Port

The PCoIP License Server listens for communication from PCoIP agents in your deployment on a defined listening port. By default, this listening port is set to 7070, but can be changed by specifying the PORT setting in the /opt/flexnetls/TERADICI/local-configuration.yaml configuration file.

Important: PCoIP agents and License Server must use the same port

PCoIP agents are configured to use port 7070 by default. If you change the license server port, you must also change the configuration of all PCoIP agents that use it.

To change the license server listening port:

  1. Open /opt/flexnetls/TERADICI/local-configuration.yaml in a text editor.
  2. Locate the port assignment line:

    # HTTP listening port. Default is 7070. You can bind to an interface with this syntax: '[127.0.0.1].7070'.
    
    port: 7070
    
  3. Change the value of port to the new value. The port number must be an integer between 1 and 65535.

    Note: Reserved port numbers

    Port numbers below 1024 are reserved for processes running as root unless you are using port forwarding, or tools like setcap, setuid, or authbind.

  4. Save the file and exit the editor.

  5. Restart the license server for the new value to take effect:

    sudo systemctl restart flexnetls-TERADICI
    
  6. Update the configuration of any PCoIP agents that communicate with this PCoIP License Server. For instructions, see one of the following guides: