

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

Download the PCoIP Connection Manager and Security Gateway package from Teradici and copy it into a temporary working directory.
Extract the archive:
```
unzip pcoip-cmsg_21.01.0.zip
```
Note: Included files

The pcoip-cmsg_21.01.0.zip contains three files:
- cm_setup.sh
- cm_sg-21.01.0-<build number>.x86_64.rpm
- cm_third_party_dependencies-21.01.0-<build number>.x86_64.rpm
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.

Installing the PCoIP Connection Manager and PCoIP Security Gateway - Offline¶

If there is no internet connection in the target machine where PCoIP Connection Manager and PCoIP Security Gateway is going to be installed, you must create a temporary machine to download the PCoIP Connection Manager and PCoIP Security Gateway dependencies and then transfer them to the target machine. For information on these package dependencies, see System Requirements.

The following steps outline how to perform an installation of the PCoIP Connection Manager and PCoIP Security Gateway in an offline environment:

Create a disposable internet-connect RHEL or CentOS 7 or 8 machine for downloading and inspecting packages. This machine should be identical to the PCoIP Connection Manager machine.
SSH into the new temporary machine.
Run the following command:
- For RHEL 7 or CentOS 7:
```
sudo yum install -y yum-utils wget
```
- For RHEL 8 or CentOS 8:
```
sudo dnf install -y wget
```
Create a new directory to store downloaded package manager files:
```
mkdir ~/packages/
cd ~/packages/
```
Download the required updates to the new packages folder:
- For RHEL 7 or CentOS 7:
```
sudo yum update -y --downloadonly
```
- For RHEL 8 or CentOS 8:
```
sudo dnf update -y --downloadonly
```

Download dependencies that are available in the package manager:

For RHEL 7 or CentOS 7:

sudo repotrack --arch x86_64 unzip wget gcc redhat-lsb java-1.8.0-openjdk.x86_64 expat

For RHEL 8 or CentOS 8:

sudo dnf download --resolve --downloadonly --arch x86_64 unzip wget gcc redhat-lsb java-1.8.0-openjdk.x86_64 expat

Download authbind and boost

Authbind:

curl -O http://ftp.debian.org/debian/pool/main/a/authbind/authbind_2.1.2.tar.gz

Boost169: The latest version of epel-release-*.noarch.rpm needs to be installed prior to downloading the boost169 package from the following repo:

For RHEL 7 or CentOS 7:

export REPO_URL=https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/e/
wget $REPO_URL -r  -A "epel-release-*.noarch.rpm" -nd -l1
sudo yum install -y epel-release-*.noarch.rpm
rm epel-release-*.noarch.rpm
sudo repotrack -a x86_64 boost169

For RHEL 8 or CentOS 8:

export REPO_URL=https://download-ib01.fedoraproject.org/pub/epel/8/Everything/x86_64/Packages/e/
wget $REPO_URL -r  -A "epel-release-*.noarch.rpm" -nd -l1
sudo dnf install -y epel-release-*.noarch.rpm
rm epel-release-*.noarch.rpm
sudo dnf download --resolve --downloadonly boost169

Download the PCoIP Connection Manager and Security Gateway package from Teradici and transfer it to the offline machine using SCP.
Transfer the packages directory to the target machine through any method, for example via SCP or USB drive for on-premise machines.

In the target machine, navigate to the packages folder and run the following commands for installing all dependencies:

For RHEL 7 or CentOS 7:

cd packages
sudo yum install --disablerepo="*" -y *.rpm
tar -xzf authbind_2.1.2.tar.gz
cd authbind
sudo make
sudo make install

For RHEL 8 or CentOS 8:

cd packages
sudo dnf install --disablerepo="*" -y *.rpm
tar -xzf authbind_2.1.2.tar.gz
cd authbind
sudo make
sudo make install

Refer to steps 2 and 3 from the Install PCoIP Connection Manager and PCoIP Security Gateway section to complete the installation.