Skip to content

Installing the Standard Agent for Linux on Ubuntu

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. If a Teradici signing key already exists on the desktop, delete it:

    sudo apt-key del 4E45878267D7ADA8
    
  2. Download the Teradici repo:

    sudo wget -O teradici-repo-latest.deb https://downloads.teradici.com/ubuntu/teradici-repo-$(lsb_release -cs)-latest.deb
    
  3. Install the Teradici repo:

    sudo apt install --reinstall ./teradici-repo-latest.deb
    

    Beta software is available

    Users who wish to test pre-release versions of software can do so by selecting the beta distribution channel before installing. To switch to the beta channel, edit pcoip.list and comment the appropriate lines:

    sudo vi /etc/apt/sources.list.d/pcoip.list
    

    Teradici does not recommend installing beta software in production systems.

  4. 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 apt install usb-vhci-dkms
    
  5. Install the PCoIP Standard Agent for Linux:

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

  7. 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>
    
  8. Reboot the desktop.

Installing on stock Ubuntu 18.04 installations

When connecting to the Standard Agent for Linux installed on a stock Ubuntu 18.04 installation, users may not be able to establish PCoIP sessions. You can work around this issue by setting the pcoip.desktop_session value in pcoip-agent.conf:

  1. Open /etc/pcoip-agent/pcoip-agent.conf in a text editor

  2. Add the following line:

    pcoip.desktop_session = ubuntu
    
  3. Save and close the editor.

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.