Skip to content

Installing the PCoIP Graphics Agent for Linux on RHEL or CentOS

Before you proceed with installation, a few prerequisites must be met.

Prerequisites

These instructions assume you have already built the remote desktop machine, and that the machine meets the agent's requirements.

Before proceeding with Graphics Agent for Linux installation, install a desktop environment. To install a desktop environment in RHEL or CentOS, use the following command:

sudo yum groupinstall 'Server with GUI'

The Graphics Agent for Linux has additional requirements for GPU acceleration. Make sure your machine is configured with a supported card before you start (we'll install the correct driver as part of this process).

A few other things to confirm before proceeding:

  • SSH must be enabled.

  • You must have a license registration code for the agent instance from Teradici (as part of a Teradici Cloud Access subscription).

  • The desktop machine requires the following ports to be open: TCP 443, TCP 60443, TCP 4172, and UDP 4172.

  • Your GPUs must be licensed with their manufacturers (if required).

  • You must have super user (root) privileges and be able to issue sudo commands.

  • If you are using a PCoIP Local License Server, PCoIP Local License Server, you'll need to know it's URL and port numbers.

Important: Protect your license registration code

The license registration code you receive from Teradici is unique to your organization, and should be protected as you would any sensitive data.

Be careful that you do not inadvertently expose your registration code in forums or other public areas by pasting log messages without redacting sensitive information.

Installation Overview

Once your prerequisites are in place, you can proceed with installation. Here's a brief overview of the process:

  1. Connect to the machine using SSH.

  2. Install the appropriate GPU drivers for your system.

  3. Install the PCoIP Agent.

  4. If required, configure the agent software.

  5. Disconnect the SSH session.

  6. Connect to the desktop using a PCoIP client.

If you're ready to start, connect to your machine with an SSH client and proceed to Installing GPU Drivers.