Management Console as an RPM¶

The Management Console RPM allows administrators an opportunity to manage and control Linux packages in a way that complies to their individual corporate IT policies. The teradicimc-<version>.rpm package, when connected to the internet, will automatically update any required dependencies not available on your Linux VM so you can be operational quickly. The RPM is provided as a file for download. A public RPM repository will be available for seamless installs in a future release.

By introducing this RPM package into your network, you accept that there are risks involved in deploying the system, and you acknowledge that you have reviewed the default PCoIP Management Console and CentOS configuration and have performed any other changes to make the security level appropriate for your deployment.

Management Console RPM Installation and Removal¶

Management Console and additional dark site and online downloads are provided with everything needed in order to get Management Console to work except the firewall exceptions. After installation, make sure that you have configured your firewall and that it complies to your corporate security policies. If you don't have a security policy, you can review the firewall reference that will allow you to get an understanding of what firewall requirements Management Console needs to be operational. Once the firewall exceptions are made, you can upgrade or remove the Management Console as required.

Directions for upgrades are described in Upgrading Management Console Using RPM.

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.

Offline (Dark Site) Installation using RPM¶

1. 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.

2. 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

3. Verify the PostgreSQL version is 14.5.

   psql -V

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

   java -version

5. Configure your firewall.

   • IPv4

   See the firewall reference on how to configure Management Console firewall for use in an IPv4 environment perform the following steps:.

   • IPv6

   See the firewall reference on how to configure Management Console firewall for use in an IPv6 environment perform the following steps:

6. If applicable, enable your HSTS policy. See HTTP Strict Transport Security.

7. If installing Management Console Enterprise, license your installation.

   • See Managing Licenses Online.

   • If applicable see Managing Licenses Offline.

Online Installation using RPM¶

These instructions apply to the first time installation of Management Console on a host Linux machine that contains the RPM and any required packages for this release. The administrator installing the RPM should have sudo privileges.

1. 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.

2. Install the online dependency file from the directory where the online dependency file is located.

   • CentOS 7.9 and RHEL 7.9

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

   • RHEL 8.6 and RHEL 8.8

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

3. Verify PostgreSQL version is 14.5

   psql -V

   Example:

   

4. Install the RPM using the commands of your Linux distribution.

   • CentOS 7.9

     sudo yum install teradicimc-<version>.rpm from the directory where the rpm file is located.

   • RHEL 7.9

     sudo subscription-manager repos --enable rhel-7-server-optional-rpms --enable rhel-7-server-extras-rpms

     sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

     sudo yum install teradicimc-<version>.rpm from the directory where the rpm file is located.

   • RHEL 8.6 and RHEL 8.8

     sudo subscription-manager repos --enable rhel-8-for-x86_64-baseos-rpms --enable rhel-8-for-x86_64-appstream-rpms

     sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

     sudo yum install teradicimc-<version>.rpm from the directory where the rpm file is located.

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

   java -version

   Example:

   

6. Configure your firewall.

   • IPv4

   See the firewall reference on how to configure Management Console firewall for use in an IPv4 environment perform the following steps:.

   • IPv6

   See the firewall reference on how to configure Management Console firewall for use in an IPv6 environment perform the following steps:

7. If applicable, enable your HSTS policy. See HTTP Strict Transport Security.

8. If installing Management Console Enterprise, license your installation.

   • See Managing Licenses Online.

   • If applicable see Managing Licenses Offline.

Remove Management Console¶

To remove Management Console, you will have two choices, remove Management Console or remove Management Console with all its dependencies.

Remove Only Management Console¶

To remove Management Console only run the following command:

sudo yum remove teradicimc

Remove Management Console with all Dependencies¶

To remove Management Console and any package that was required by Management Console, run the following command:

sudo yum autoremove teradicimc

Remove PostgreSQL14.5¶

To remove PostgreSQL14.5, run the following command:

psql -U <username>
drop database <mc_database_name>;
\q
sudo yum remove postgresql\*