Skip to content

Upgrading Management Console Using RPM

Update your software to the current release

From time to time, updates may be made available from support, or the developers of CentOS. While we recommend 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.

There are two different scenarios that require slightly different steps when installing or upgrading Management Console using the RPM. One scenario has Management Console deployed on a site that has access to the Internet and the other scenario is having Management Console deployed on a dark site where there is no internet access.

Upgrading Management Console with Internet Access

  1. Download the online dependency package for the supported Linux environment from the support site and ensure it is located in the <logged in user directory> on the Management Console Linux VM.

    You can use a third party tool such as WinSCP to copy and move files into the CentOS/RHEL host operating system.

  2. Upgrade Management Console dependencies using the online dependency package for your Linux deployment.

    • CentOS 7.9

      sudo sh ./teradicimc_<mc_version>-online-dependency-centos7.9.tar.gz

    • RHEL 7.9

      sudo sh ./teradicimc_<mc_version>-online-dependency-rhel7.9.tar.gz

    • RHEL 8.6

      sudo sh ./teradicimc_<mc_version>-online-dependency-rhel8.6.tar.gz

  3. Verify the PostgreSQL version is 14.5.

    psql -V

  4. Upgrade the Management Console from the directory where the RPM file is located.

    sudo yum install teradicimc-<version>.rpm

Upgrading Management Console without Internet Access (Dark Site)

  1. Download the dark site package (that includes PostgreSQL, Python 3 dependencies, and Management Console RPM) from the support site and ensure it is located in the <logged in user directory> on the Management Console Linux VM.

    You can use a third party tool such as WinSCP to copy and move files into the CentOS/RHEL host operating system.

  2. Use the dark site package to install or upgrade Management Console and all dependencies in one of the supported offline environments.

    • CentOS 7.9

      sudo sh ./teradicimc_<mc_version>-offline-centos7.9.tar.gz

    • RHEL 7.9

      sudo sh ./teradicimc_<mc_version>-offline-rhel7.9.tar.gz

    • RHEL 8.6

      sudo sh ./teradicimc_<mc_version>-offline-rhel8.6.tar.gz

  3. Verify the PostgreSQL version is 14.5.

    psql -V