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.
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
-
Off-line Installation¶
The following steps outline how to install the PCoIP Connection Manager and PCoIP Security Gateway in an off-line environment:
- Create a disposable internet-connected RHEL or CentOS 8 machine for downloading and inspecting packages. This machine should be identical to the PCoIP Connection Manager machine.
- SSH into this new temporary machine. As the PCoIP Connection Manager and PCoIP Security Gateway now supports CentOS 8, Teradici recommends using
dnf
instead ofyum
for terminal commands. - Run the following command:
sudo dnf install -y wget
- Create a new directory to store downloaded package manager files:
mkdir ~/packages/ cd ~/packages/ mkdir ~/packages/cm_sg mkdir ~/packages/updates mkdir ~/packages/authbind
- Download the required updates to the new packages/updates folder:
sudo dnf update -y --downloadonly --downloaddir=/root/packages/updates
- Download the dependencies that are available in the package manager:
sudo dnf download --resolve --downloadonly --arch x86_64 annobin unzip wget gcc redhat-lsb java-1.8.0-openjdk.x86_64 expat --downloaddir=/root/packages
- Download authbind and boost using the following commands.
- Authbind:
curl --output ~/packages/authbind/authbind_2.1.2.tar.gz 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:
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 sudo dnf download --resolve --downloadonly boost169 --downloaddir=/root/packages rm epel-release-*.noarch.rpm
- Authbind:
- Download the PCoIP Connection Manager and PCoIP Security Gateway package from Teradici and transfer it to the off-line machine using SCP. Move files cm_* into the folder ~/packages/cm_sg.
- 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:
# install dependencies cd ~/packages/updates sudo dnf install --disablerepo="*" -y *.rpm cd ~/packages sudo dnf install --disablerepo="*" -y *.rpm # install authbind cd ~/packages/authbind tar -xvf authbind_2.1.2.tar.gz cd authbind sudo make sudo make install sudo mkdir /etc/authbind sudo mkdir /etc/authbind/byport sudo touch /etc/authbind/byport/443 sudo chmod 500 /etc/authbind/byport/443 sudo chown connection_manager:root /etc/authbind/byport/443 sudo chmod 550 ~/packages/cm_sg/cm_setup.sh sudo chown connection_manager:root ~/packages/cm_sg/cm_setup.sh
- Refer to steps 2 and 3 from the Install PCoIP Connection Manager and PCoIP Security Gateway section to complete the installation.