Installing the Graphics Agent for Linux on Ubuntu

To install the PCoIP Graphics 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
   

4. Install the PCoIP Graphics Agent for Linux:

   sudo apt update
   sudo apt install pcoip-agent-graphics
   

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 Graphics 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 Linux instance.

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