Skip to content

Installing the Standard Agent for Linux on RHEL or CentOS

Important: Required ports will be automatically opened

The Standard Agent for Linux installer will add firewall exceptions for the following required PCoIP ports during installation: TCP 443, TCP 4172, UDP 4172, and TCP 60443.

To install the Standard Agent for Linux software:

  1. Download and install the Teradici pcoip-agent repository, via the shell script provided here.

    Note: This installs the stable repository

    This will install the stable repository for the Standard Agent for Linux. The stable repo contains officially supported releases and is recommended for production systems.

  2. Install the EPEL repository:

    sudo yum install epel-release 
    
  3. Optionally install USB dependencies, if you intend to support USB devices other than keyboards, mice, and pointer devices. If you skip this step, USB redirection will be completely disabled and bridged USB devices will not work.

    sudo yum install usb-vhci
    
  4. Install the PCoIP Standard Agent for Linux:

    sudo yum install pcoip-agent-standard
    
  5. Note your machine's local IP address. Clients connecting directly to the host workstation will need this number to connect.

  6. Enter the license registration code you received from Teradici.

    Note: These instructions are for Cloud Licensing

    These instructions assume you are using Teradici Cloud Licensing to activate your PCoIP session licenses. If you are using the Teradici License Server instead, see Licensing the Standard Agent for Linux.

    For unproxied internet connections, type:

    pcoip-register-host --registration-code=<XXXXXX@YYY-YYYY-YYY>
    

    For proxied internet conections, type:

    pcoip-register-host --registration-code=<XXXXXX@YYY-YYYY-YYY> --proxy-server=<serverURL> --proxy-port=<port>
    
  7. Reboot the desktop.

Once you've installed the software, you can configure it, register licenses, or connect to it.

Note: Desktop user interfaces will only be available using PCoIP

Once installed and running, the PCoIP Standard Agent for Linux takes over the graphics subsystem which is then unavailable to hypervisors. You can only view the graphical user interface when connecting with a PCoIP client.

For example, you cannot view an ESXi virtual machine console through VSphere; you must connect to the machine using PCoIP.

Installing the Standard Agent for Linux in a Dark Site

The Standard Agent for Linux can be installed in dark site environments, also referred to as offline environments, that do not have a connection to the public internet. Teradici provides archived bundles (tar.gz archives) for each supported operating system, which includes the core application and all dependencies.

Important: Install GPU drivers before proceeding

The appropriate GPU driver must be downloaded, transferred, and installed before installing the Standard Agent for Linux. The procedure for downloading GPU drivers varies by manufacturer and environment; a list of resources is located in Installing GPU Drivers on Linux Machines.

To install the Standard Agent for Linux in an offline environment:

  1. From an internet-connected machine, open a browser and navigate to Teradici's documents and downloads site. Look in the sidebar for documentation and download links.

  2. Click the Downloads and scripts button.

    Downloads and scripts

    Note: An account is required

    If you are not logged in, you will see a log in prompt instead:

    Log in to download

    You can create an account when you click this button if you do not already have one.

  3. Read and accept the Teradici End User License Agreement.

  4. Under Darksite packages, find the download that matches your operating system, and click to download it.

    For brevity, this example shows only the Centos 7.8 package; all supported operating systems have an available download.

    Darksite download screenshot

  5. Transfer the downloaded file to the production Linux machine using any acceptable method, such as a USB drive.

  6. On the production machine, open a console window and navigate to the directory where you placed the installer.

  7. Run install-pcoip-agent.sh to install the agent:

    install-pcoip-agent.sh
    

    You will be prompted for the following:

    • Agent type: choose Standard Agent for Linux.

    • USB device support: If you will be allowing USB devices (other than keyboards, mice, and pointers), accept this option. If you install the agent without USB device support, only keyboards, mice, and pointers will work, and more sophisticated devices like Wacom tablets will act as pointing devices without any advanced functionality.

    Tip: specifying installation parameters inline

    You can provide the required parameters inline instead:

    • To install with USB device support:

      ./install-pcoip-agent.sh pcoip-agent-standard usb-vhci
      
    • To install without USB device support, omit the usb-vhci parameter:

      ./install-pcoip-agent.sh pcoip-agent-standard
      
  8. Register your Standard Agent for Linux's license with your PCoIP License Server. See Licensing PCoIP Agents With a Local License Server for details.

  9. Reboot the desktop.