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:

1. 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.
2. SSH into this new temporary machine. As the PCoIP Connection Manager and PCoIP Security Gateway now supports CentOS 8, Teradici recommends using dnf instead of yumfor terminal commands.
3. Run the following command:

   sudo dnf install -y wget
   

4. Create new directories to store downloaded package manager files:

   Switch to root user: sudo -i

   mkdir /root/packages/
   cd /root/packages/
   mkdir /root/packages/cm_sg
   mkdir /root/packages/updates
   mkdir /root/packages/authbind
   mkdir /root/packages/boost169
   

   5. Download the required updates to the new packages/updates folder:

   dnf update -y --downloadonly --downloaddir=/root/packages/updates
   

   6. Download the dependencies that are available in the package manager:

   dnf download --resolve --downloadonly --arch x86_64 annobin unzip wget gcc gcc-c++ redhat-lsb java-1.8.0-openjdk.x86_64 expat --downloaddir=/root/packages
   

   7. Download authbind using the following command:

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

   8. Download the Boost169 tar file using the following command:

   wget -O /root/packages/boost169/boost_1_69_0.tar.gz http://sourceforge.net/projects/boost/files/boost/1.69.0/boost_1_69_0.tar.gz
   

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

   1. Transfer the packages directory to the target machine through any method, for example via SCP or USB drive for on-premise machines.

   2. In the target machine, navigate to the packages folder and run the following commands for installing all dependencies: Switch to root user: sudo -i

      # install updates and dependencies
      cd /root/packages/updates
      dnf install --disablerepo="*" -y *.rpm
      cd /root/packages
      dnf install --disablerepo="*" -y *.rpm
      
      # install boost169
      cd /root/packages/boost169
      gunzip boost_1_69_0.tar.gz
      tar -xvf boost_1_69_0.tar
      cd boost_1_69_0
      
      ./bootstrap.sh --with-libraries=all --with-toolset=gcc
      
      ./b2 toolset=gcc --prefix=/usr/local
      # it might take more than 15 min to compile
      
      ./b2 install --with=all
      
      cp /usr/local/lib/lib* /usr/lib64
      
      # install authbind
      cd /root/packages/authbind
      tar -xvf authbind_2.1.2.tar.gz
      cd authbind
      make
      make install
      
      touch /etc/authbind/byport/443
      chmod 500 /etc/authbind/byport/443
      
      cd /root/packages/cm_sg
      # If you have pcoip_cmsg_<current_verson>.zip, run unzip command
      unzip -j pcoip_cmsg_<current_version>.zip
      
      chmod 550 /root/packages/cm_sg/cm_setup.sh
      

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