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:

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

An account is required to download

A Teradici account is required to access this repository. You can create one from the login screen if you do not already have one.
Install wget:
```
sudo yum install wget
```

Install the EPEL repository:

sudo wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo rpm -i epel-release-latest-7.noarch.rpm

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
```
Install the PCoIP Standard Agent for Linux:
```
sudo yum install pcoip-agent-standard
```
Note your machine's local IP address. Clients connecting directly to the host workstation will need this number to connect.
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>
```
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 an offline environment (with no connection to the public internet). To do this, you'll create a temporary internet-connected machine, download the agent RPM and its dependencies, then transfer the downloaded files to the permanent machine and install them.

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

Create a temporary RHEL or CentOS machine with a connection to the internet and SSH into it.

On the temporary machine, install the Teradici repository:

sudo yum install https://downloads.teradici.com/rhel/teradici-repo-latest.noarch.rpm

On the temporary machine, use repotrack to obtain the agent RPM and all dependencies (replace <dir> in this command with a directory path that will receive the files):
```
repotrack -p <dir> pcoip-agent-graphics
```
This command recursively resolves dependencies and downloads the RPMs into <dir>.
Important: USB dependencies are not installed by default

By default, the Standard Agent for Linux does not install USB dependencies, and USB devices other than keyboards, mice, and pointer devices will not work. If you intend to support USB devices, add usb-vhci to the repotrack command:
```
repotrack -p <dir> pcoip-agent-graphics usb-vhci
```
Note: does not provide a desktop

This command does not provide a fully-functioning desktop. The RPMs necessary to install the desktop environment must be obtained separately, via a similar command.
Transfer the RPMs directory containing the packages to your Standard Agent for Linux machine using any acceptable method, such as a USB flash drive.
SSH into the offline machine.
Navigate to the RPMs directory, where you transferred the files, and install the packages.
```
sudo yum install --disablerepo="*" -y *
```
License the agent using this procedure
Reboot the offline machine.