

Updating the PCoIP Connection Manager and PCoIP Security Gateway¶

The PCoIP Connection Manager and PCoIP Security Gateway cannot be updated in place. To move to a new version, you must create a new machine, install and configure the software on it, then stop and destroy the old machine.

The method used to update the software differs by environment; follow the instructions for:

On-Premises PCoIP Connection Manager with an enabled PCoIP Security Gateway
On-Premises PCoIP Connection Manager with a disabled PCoIP Security Gateway
Public Cloud PCoIP Connection Manager and PCoIP Security Gateway

Updating On-Premises PCoIP Connection Managers¶

On-premises systems can be deployed with or without the PCoIP Security Gateway. Follow the appropriate procedure for your environment.

Updating On-Premises Installations With PCoIP Security Gateway¶

If your system is located on-premises and the PCoIP Security Gateway is enabled, use this procedure.

To upgrade an on-premises PCoIP Connection Manager with the PCoIP Security Gateway enabled:

Build a new RHEL or CentOS VM and install the PCoIP Connection Manager and PCoIP Security Gateway software on it.
Configure the new PCoIP Connection Manager and PCoIP Security Gateway to match the old PCoIP Connection Manager and PCoIP Security Gateway:
- Recreate the /etc/ConnectionManager.conf file on the new machine with identical settings.
- Recreate the /etc/SecurityGateway.conf file on the new machine with identical settings.
Install your custom certificates on the new machine.
- Install the custom certificate for the PCoIP Connection Manager.
- Install the custom certificate for the PCoIP Security Gateway.
Disconnect the new PCoIP Connection Manager and PCoIP Security Gateway from the network and configure the local IP address to match the existing PCoIP Connection Manager and PCoIP Security Gateway.
Shut down the existing PCoIP Connection Manager and PCoIP Security Gateway.
Connect the new PCoIP Connection Manager and PCoIP Security Gateway to the network using the IP of the legacy PCoIP Connection Manager and PCoIP Security Gateway.
Test a connection directly to the PCoIP Connection Manager and PCoIP Security Gateway external IP.

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.

Load Balancer

If you have a load balancer in front of a group of PCoIP Connection Manager and PCoIP Security Gateway virtual machines, then you can reconfigure the load balancer to stop sending new connections to a PCoIP Connection Manager and PCoIP Security Gateway virtual machine.

Updating On-Premises Installations Without PCoIP Security Gateway¶

If your system is located on-premises and the PCoIP Security Gateway is disabled, use this procedure.

To upgrade an on-premises PCoIP Connection Manager with the PCoIP Security Gateway disabled:

Build a new RHEL or CentOS VM and install the PCoIP Connection Manager and PCoIP Security Gateway software on it.
Recreate the /etc/ConnectionManager.conf file on the new machine with identical settings.
Install your custom certificates on the new PCoIP Connection Manager.
Add the IP address of the new PCoIP Connection Manager and PCoIP Security Gateway to the load balancer or round robin DNS.
Remove the IP address of the legacy PCoIP Connection Manager and PCoIP Security Gateway from the load balancer or round robin DNS.

Updating Public Cloud PCoIP Connection Managers¶

If your system is located in the public cloud, use this procedure. Public cloud deployments will always have the PCoIP Security Gateway enabled.

To upgrade the PCoIP Connection Manager and PCoIP Security Gateway in the public cloud:

Build a new RHEL or CentOS VM and install the PCoIP Connection Manager and PCoIP Security Gateway software on it.
Assign a new external IP to the VM and install any custom certificates required.
Configure the new PCoIP Connection Manager and PCoIP Security Gateway to match the old PCoIP Connection Manager and PCoIP Security Gateway:
- Recreate the /etc/ConnectionManager.conf file on the new machine with identical settings.
- Recreate the /etc/SecurityGateway.conf file on the new machine with identical settings.
Establish a new connection directly to the external IP to test that the PCoIP Connection Manager and PCoIP Security Gateway is correctly configured.
Add the new PCoIP Connection Manager and PCoIP Security Gateway to the cloud load balancer.
Repeat this process for each PCoIP Connection Manager and PCoIP Security Gateway that is being replaced.
Remove the legacy PCoIP Connection Manager and PCoIP Security Gateway from the load balancer.