Skip to content

Updating the PCoIP Connection Manager and PCoIP Security Gateway

The PCoIP Connection Manager and the PCoIP Security Gateway components can be installed in an offline or online deployment, depending on your environment. The procedure for updating these components is different for both scenarios.

Note: Load Balancer

If you have a load balancer in front of a group of PCoIP Connection Manager and PCoIP Security Gateway virtual machines, you can configure the load balancer to stop sending new connections to the PCoIP Connection Manager and PCoIP Security Gateway while you are updating.

Updating an Offline Installation

If your deployment is offline (dark site), use this procedure.

  1. Download a new installation bundle .

  2. Transfer the installation bundle to the production machine using any acceptable method, such as a USB flash drive or SCP.

  3. Extract the bundle and move into the newly-created teradici-pcoip-cmsg-bundle directory:

    • RHEL 8

      tar xzvf pcoip-cmsg-setup_darksite-<version>.el8.tar.gz
cd teradici-pcoip-cmsg-bundle/dependencies
      - RHEL 9

      tar xzvf pcoip-cmsg-setup_darksite-<version>.el9.tar.gz
cd teradici-pcoip-cmsg-bundle/dependencies

  4. Install the PCoIP Connection Manager

    sudo dnf install --allowerasing pcoip-cmsg-setup*.rpm --disablerepo="*" -y

  5. Move back up one directory level and then install the PCoIP Connection Manager and PCoIP Security Gateway:

    cd ../../
sudo pcoip-cmsg-setup install --darksite-bundle-path teradici-pcoip-cmsg-bundle <installation_flags>

Updating an Online Installation

To upgrade a PCoIP Connection Manager and PCoIP Security Gateway that can reach the public internet:

Important: Installation flags are required

If installation flags are absent, or are different from the original installation, the configuration on the new machine will be different.

  1. Update the package: 

    dnf upgrade pcoip-cmsg-setup -y

  2. Reinstall the package:

    pcoip-cmsg-setup install <installation_flags>

To downgrade to an earlier version:

  1. Downgrade the package: 

    dnf downgrade pcoip-cmsg-setup -y

  2. Reinstall the package:

    pcoip-cmsg-setup install <installation_flags>