Skip to content

Upgrading Management Console Using RPM

The PCoIP Management Console RPM is provided as a file for download. 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.

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

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 Management Console will require SSH Access to the Management Console host operating system.

To upgrade from Management Console 22.04 or newer

  1. From your home directory, upgrade the Management Console.

    sudo yum install teradicimc-<version>.rpm

To upgrade from Management Console 22.01 or older

  1. Download the RPM, dependency, and script files from the Teradici support site and ensure they are 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. Login to the Management Console host operating system and create a new directory named postgresql14_dependencies under the logged in user directory.

    cd ~
    mkdir postgresql14_dependencies
    
  3. Move the teradicimc-postgresql14-offline-dependencies.tgz file into the new postgresql14_dependencies directory.

  4. Give permission to teradicimc-postgresql14-upgrade.sh file and run the script.

    chmod +x ./teradicimc-postgresql14-upgrade.sh
    sudo sh ./teradicimc-postgresql14-upgrade.sh teradicimc-postgresql14-offline-dependencies.tgz
    

    Verify upgrade

    Verify the installed PostgreSQL version is 14.1.

    psql -V

    Sample output

    PostgreSQL Version Verification

  5. From your home directory, upgrade the Management Console.

    sudo yum install teradicimc-<version>.rpm

  6. Delete the teradicimc-postgresql14-upgrade.sh file.

    rm teradicimc-postgresql14-upgrade.sh