Upgrading Management Console Using RPM

The PCoIP Management Console RPM is provided as a file for download. Windows users may have to use a third party tool such as the latest version of WinSCP to copy the file to the Management Console Linux VM. A public RPM repository will be available for seamless installs in a future release.

Upgrading using an RPM is supported from PCoIP Management Console release 19.05 and newer. During an upgrade, the database will be automatically migrated if moving to a newer version of Management Console.

Update your software to the current release

From time to time, updates may be made available, either from Teradici or the developers of CentOS. While Teradici recommends staying current on releases, it is also recommended that you test updates on a test system prior to upgrading your production system or back up a snapshot of the PCoIP Management Console before running the update.

Backup Your Database

Always ensure you have a working backup of your Management Console data when performing a Management Console removal, upgrade, or installation. Considerations should include:

  • having a current snapshot of your virtual machine

  • having a complete backup or clone of your Linux PC

  • having a current backup of your Management Console database.

Installations without Internet Access

If you are a customer without internet access (sometimes referenced as a dark site), you must have all dependencies installed in the Management Console host operating system prior to using the RPM. See Dark Site Deployments for any required dependencies for this release.

To upgrade a Management Console installation:

Upgrading to Management Console 20.10 or newer will require SSH Access to the Management Console host operating system.

  1. Download the required files from the Teradici support site and ensure they are located on the Management Console Linux VM.

    • If the site where you will upgrade Management Console has internet access, you are only required to download the RPM file.

    • If the site where you will upgrade Management Console does not have internet access, you are required to download the RPM and dependency file.

  2. Login to the Management Console host operating system console. See Accessing the PCoIP Management Console Virtual Machine Console.

  3. If your site has internet access move on to step 4. If your site does not have internet access, first install the dependencies package downloaded in step 1 by following these steps.

    1. This step is required if versions 20.10 or newer of the Management Console VM does not have Python3 pre-installed. Place the Python3 offline dependency package in a new home directory folder called offline_dependencies (/home/admin/offline_dependencies).

    2. From the offline_dependencies directory extract the tarball file.

      sudo tar xvf teradicimc-offline-dependencies_<version>.tgz

    3. Install Python3 dependencies from this directory.

      sudo yum -y install *.rpm

      Verify Python Installed Version

      You can verify the installed version by issuing the following command.

      python3 --version

  4. From the command prompt change directories to where the RPM is located and install the RPM.

    sudo yum install teradicimc-<version>.rpm