Skip to content

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-<mc_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 OS configuration and have performed any other changes to make the security level appropriate for your deployment.

Update your software to the current release

From time to time, updates may be made available from support, or the OS developers. 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.

Linux Proficiency

It is expected that administrators of Linux operating systems are proficient at using the Linux OS and have an account with sudo access. Different Linux distributions may require different procedures. We use the Linux OS distribution for instructional information.

Dedicated Host

It is recommended that the Management Console host be dedicated for Management Console use only.

Minimum Requirements Validation

The Management Console RPM package will check for the minimum hardware resource requirements (CPU, disk, ram) and fail if it is not met. To disable the minimum requirement check, enter the following command:
sudo MC_NO_CHECK=1 rpm -Uvh teradicimc-<mc_version>.rpm
Disabling the minimum requirements check is not recommended! Lowering minimums may reduce Management Console performance, particularly in large deployments.

Management Console RPM Installation and Removal

Management Console is 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.

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 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 RHEL/Rocky Linux host operating system.

  2. Install the RPM package using the following commands for your Linux distribution.

    Download the appropriate rpm file for RHEL and Rocky Linux

    To install on RHEL 8 or Rocky Linux 8, download the teradicimc-<mc_version>.el8.x86_64.rpm file.
    To install on RHEL 9 or Rocky Linux 9, download the teradicimc-<mc_version>.el9.x86_64.rpm file.

    1. Rocky Linux 8 and 9 users, follow these steps:

      1. sudo dnf -y module disable postgresql && sudo dnf -y module enable postgresql:15

      2. sudo dnf install teradicimc-<mc_version>.rpm from the directory where the rpm file is located.

    2. RHEL 8 users, follow these steps:

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

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

      3. sudo dnf -y module disable postgresql && sudo dnf -y module enable postgresql:15

      4. sudo dnf install teradicimc-<mc_version>.rpm from the directory where the rpm file is located.

    3. RHEL 9 users, follow these steps:

      1. sudo subscription-manager repos --enable rhel-9-for-x86_64-baseos-rpms --enable rhel-9-for-x86_64-appstream-rpms

      2. sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

      3. sudo dnf -y module disable postgresql && sudo dnf -y module enable postgresql:15

      4. sudo dnf install teradicimc-<mc_version>.rpm from the directory where the rpm file is located.

  3. Configure your firewall.

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

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

New default self-signed certificate

Management Console began using a new default self-signed certificate as of 23.08. Certificate details can be verified in SETTINGS > SECURITY under CERTIFICATES.

Self-signed certificate details

Remove Management Console

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

Ignore warning message

Please ignore the following warning message as it does not have any impact on the Management Console removal process.

warning: file remove failed: No such file or directory.

Remove Only Management Console

To remove Management Console only run the following command:

sudo dnf 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 dnf autoremove teradicimc

Remove PostgreSQL

To remove PostgreSQL, run the following command:

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