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 a new directory to store downloaded package manager files:

   mkdir ~/packages/
   cd ~/packages/
   mkdir ~/packages/cm_sg
   mkdir ~/packages/updates
   mkdir ~/packages/authbind
   

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

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

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

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

8. 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.
9. Transfer the packages directory to the target machine through any method, for example via SCP or USB drive for on-premise machines.
10. 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
    

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