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.

Prior to performing a RPM upgrade, the default certificate should be uploaded to all endpoints either through a profile or directly from an endpoint AWI.

Upgrading Management Console with Internet Access

Upgrade from Management Console 23.01 or older to Management Console 23.08

RPM upgrades may require new certificates uploaded to your endpoints

Before an in-place RPM upgrade to Management Console 23.08, and if you are not using custom certificates, you must upload the new Management Console certificate to your endpoints. For the new Management Console certificate SHA-256 & SHA-512 values, see the release notes.

For instructions on how to upload your certificate see Updating PCoIP Management Console Certificates after Endpoint Discovery

Prior to upgrading Management Console you can:

  • Clear the management state on all your endpoints before the upgrade and rediscover them after the upgrade.

  • Ensure that the new certificate is uploaded to your endpoints before you upgrade to Management Console 23.08.

  1. Upload the Management Console default self-signed certificate to all endpoints either through a profile or directly from an endpoint AWI if you are using the Management Console default certificate.

    1. Login to your existing Management Console, create a profile with the provided default certificate (cert.pem) file uploaded in the Certificate Store.

    2. Apply the profile to all the endpoints discovered in Management Console. Once the profile is applied successfully, the endpoint will have the new default certificate uploaded.

  2. Download the available RPM and applicable online dependency file for this release from the support site and ensure they are located 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.

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

    • CentOS 7.9 and RHEL 7.9

      sudo sh ./teradicimc_<mc_verion>-online-dependency-centos-rhel7.9.tar

    • RHEL 8.6

      sudo sh ./teradicimc_<mc_verion>-online-dependency-rhel8.8.tar

  4. Verify the PostgreSQL version is 14.5.

    psql -V

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

    sudo yum install teradicimc-<version>.rpm

  6. Verify Java 8 version

    java -version

    Example:

    Java Version Output

Upgrading from Management Console 23.04 or newer to Management Console 23.08

RPM upgrades may require new certificates uploaded to your endpoints

Before an in-place RPM upgrade to Management Console 23.08, and if you are not using custom certificates, you must upload the new Management Console certificate to your endpoints. For the new Management Console certificate SHA-256 & SHA-512 values, see the release notes.

For instructions on how to upload your certificate see Updating PCoIP Management Console Certificates after Endpoint Discovery

Prior to upgrading Management Console you can:

  • Clear the management state on all your endpoints before the upgrade and rediscover them after the upgrade.

  • Ensure that the new certificate is uploaded to your endpoints before you upgrade to Management Console 23.08.

  1. Upload the Management Console default self-signed certificate to all endpoints either through a profile or directly from an endpoint AWI if you are using the Management Console default certificate.

    1. Login to your existing Management Console, create a profile with the provided default certificate (cert.pem) file uploaded in the Certificate Store.

    2. Apply the profile to all the endpoints discovered in Management Console. Once the profile is applied successfully, the endpoint will have the new default certificate uploaded.

  2. Download the Management Console RPM and online dependency files from the support site and ensure it is located in the <logged in user directory> on the Management Console Linux VM.

  3. 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. Upload the Management Console default self-signed certificate to all endpoints either through a profile or directly from an endpoint AWI if you are using the Management Console default certificate.

    1. Login to your existing Management Console, create a profile with the provided default certificate (cert.pem) file uploaded in the Certificate Store.

    2. Apply the profile to all the endpoints discovered in Management Console. Once the profile is applied successfully, the endpoint will have the new default certificate uploaded.

  2. Download the dark site package (that includes PostgreSQL, Python 3 dependencies, Java 8 upgrade package, 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.

  3. Use the dark site package to install or upgrade Management Console and all dependencies in your offline environment. Execute the commands where the dark site package file is located for your Linux environment.

    • 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.8.tar.gz

  4. Verify the PostgreSQL version is 14.5.

    psql -V

  5. Verify the Java version is 1.8.0_362 or newer.

    java -version