Installing the Remote Workstation Card Agent for Linux on RHEL or CentOS¶

Important: Required ports will be automatically opened

The Remote Workstation Card 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 Remote Workstation Card Agent for Linux:

Before you begin, confirm that your Remote Workstation Card and Remote Workstation Card Software are properly installed.

Confirm that you can create a direct connection from a PCoIP Zero Client to the Remote Workstation Card machine. After verifying, disconnect the session.

Install wget:
```
sudo yum install wget
```
Install the Teradici repository:
```
sudo yum install https://downloads.teradici.com/rhel/teradici-repo-latest.noarch.rpm
```
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:
```
sudo yum-config-manager --disable pcoip-stable
sudo yum-config-manager --enable pcoip-beta
```
Teradici does not recommend installing beta software in production systems.

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

Install the PCoIP Remote Workstation Card 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 Remote Workstation Card 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>
```
Open /etc/pcoip-agent/pcoip-agent.conf with root privileges in a text editor.
Add the following line:
```
pcoip.server_type = "RWC"
```
Save the file and close the editor.
Reboot the desktop.
On your PCoIP Zero Client (or Management Console), configure the Zero Client Session Connection as follows:
- Session Connection Type: PCM or AutoDetect
- Server URI: <Host IP address or fqdn>
- Confirm your configuration by establishing a brokered connection.