Skip to content

Updating the PCoIP Connection Manager and PCoIP Security Gateway

The PCoIP Connection Manager can be deployed with or without the PCoIP Security Gateway, depending on your environment. The procedure for updating this component is different for both scenarios.

Important: Powering off the PCoIP Connection Manager and PCoIP Security Gateway

When you power off the existing PCoIP Connection Manager and PCoIP Security Gateway, any PCoIP sessions that are active and using the security gateway will be dropped and will need to be re-established.

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:

    tar xzvf pcoip-cmsg-setup_darksite-<version>.el8.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>