Skip to content

Installing PCoIP Connection Manager and PCoIP Security Gateway

The PCoIP Connection Manager and PCoIP Security Gateway are bundled together in one package, available from Teradici. The installation package includes:

  • A setup script to install the RPMs and additional prerequisites.

  • An RPM containing the PCoIP Connection Manager and PCoIP Security Gateway.

  • An RPM containing third-party dependencies.

The PCoIP Connection Manager and the PCoIP Security Gateway must be installed together on a RHEL or CentOS 8 server with a single network interface.

Before You Begin

Before you proceed with installation, note the following:

  • The PCoIP Connection Manager and the PCoIP Security Gateway do not support IPv6.

  • If your connection broker is configured to identify resources by host name, then DNS must be available and configured as follows:

    • Host names must be resolvable from the PCoIP Connection Manager server

    • Host names must be resolvable from PCoIP client machines

  • Teradici highly recommends that you use NTP to synchronize the time between components such as the PCoIP Connection Manager, PCoIP Security Gateway, PCoIP License Server, agents, and clients.

    This enables logs to record a synchronized time across servers and sessions, which is extremely helpful in debugging and troubleshooting.

  • You must have sudo (root) privileges to install the software.

  • A text editor is required to configure the Connection Manager and Security Gateway. Any text editor will work.

Prepare the System Environment

First, verify that the following system environment requirements are met on your RHEL/CentOS 7 server:

  • Your system meets or exceeds the system requirements

  • Networking is configured to start on boot.

  • NTP is enabled.

  • Port 443 is available during installation.

    Important: Uninstall the httpd service

    Teradici highly recommends that you uninstall the httpd service (or any service or process that is bound to port 443) before installing the PCoIP Connection Manager. If Port 443 is in use by another service, PCoIP clients may not be able to connect to the PCoIP Connection Manager.

Install PCoIP Connection Manager and PCoIP Security Gateway

  1. Download the PCoIP Connection Manager and Security Gateway package from Teradici and copy it into a temporary working directory.

  2. Extract the archive:

    unzip pcoip-cmsg_<version number>_el8.zip
    

    Note: Included files

    The pcoip-cmsg__el8.zip contains three files:

    • cm_setup.sh
    • cm_sg-21.03.0-<build number>.x86_64.rpm
    • cm_third_party_dependencies-21.03.0-<build number>.x86_64.rpm
  3. Run the installation script:

    sudo sh ./cm_setup.sh
    

    You can also navigate into the folder where the files have been extracted and run cm_setup.sh directly.

    Setup script sets the system default to Java 8

    The setup script will set the system default Java version to Java 8.

The cm_setup.sh script prepares the environment by installing compatible versions of OpenSSL, OpenJDK 8 (Runtime Environment), and Tomcat 8 with the Tomcat supporting libraries; then, it installs the RPM containing both the PCoIP Connection Manager and the PCoIP Security Gateway.

Some software is built from source during the setup procedure. To see exactly what the script does, open cm_setup.sh in a text editor and review the script content. You can customize this setup script for your system if required.

For a complete list of files and directories created during installation and operation of the PCoIP Connection Manager and PCoIP Security Gateway, see PCoIP Connection Manager and PCoIP Security Gateway RPM Package Contents.

Important: Third-party dependencies

Currently-supported versions of included third-party components are listed in /opt/Teradici/thirdparty/README. Changing the version of any of these third-party components later might cause compatibility issues with other components.