Skip to content

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.

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

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

    Note: This installs the stable repository

    This will install the stable repository for the Remote Workstation Card Agent for Linux. The stable repo contains officially supported releases and is recommended for production systems.

  3. Install wget:

    sudo yum install wget

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

  5. Install the PCoIP Remote Workstation Card Agent for Linux:

    sudo yum install pcoip-agent-standard

    Note: About the package name

    pcoip-agent-standard is the correct package for the Remote Workstation Card Agent.

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

  8. Reboot the desktop.