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 7 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
httpdservice (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¶
Download the PCoIP Connection Manager and Security Gateway package from Teradici and copy it into a temporary working directory.
Extract the archive:
You'll see a new folder called CM-19.08.0_SG-1.14.1, containing the product EULA and a subfolder called Connection_Manager_Security_Gateway.
Note: Included files
The Connection_Manager_Security_Gateway directory contains three files:
- cm_sg-19.08.0-<build number>.x86_64.rpm
- cm_third_party_dependencies-19.08.0-<build number>.x86_64.rpm
Run the installation script:
sudo sh ./CM-19.08.0_SG-1.14.1/Connection_Manager_Security_Gateway/cm_setup.sh
You can also navigate into ./CM-19.08.0_SG-1.14.1/Connection_Manager_Security_Gateway and run
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.