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-.rpm package, when connected to the internet, will automatically update any required dependencies not 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.

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.

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. Teradici uses the Linux CentOS 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-<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

With the teradicimc-<version>.rpm package and an internet connection, the installation process will create everything that Management Console needs in order 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.

RPM Installation

These instructions apply to the first time installation of Management Console on a host Linux machine that has an internet connection and contains the RPM build. Windows users that have downloaded the RPM file may have to use a third party tool such as WinSCP to copy the file to the Linux VM.

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.

  1. Download the required files from the Teradici support site and ensure they are located on the Management Console Linux VM.

    • If the site where you will install Management Console has internet access, you are only required to download the RPM file.

    • If the site where you will install Management Console does not have internet access, you are required to download and install the RPM dependencies available for download.

  2. If your site has internet access move on to step 3. If your site does not have internet access, first install the dependencies package downloaded in step 1 by following these steps.

    1. This step is required if versions 20.10 or newer of the Management Console VM does not have Python3 pre-installed. Place the Python3 offline dependency package in a new home directory folder called offline_dependencies (/home/admin/offline_dependencies).

    2. From the offline_dependencies directory extract the tarball file.

      sudo tar xvf teradicimc-offline-dependencies_<version>.tgz

    3. Install Python3 dependencies from this directory.

      sudo yum -y install *.rpm

      Verify Python Installed Version

      You can verify the installed version by issuing the following command.

      python3 --version

  3. Install the rpm following the commands of your Linux distribution.

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

    • RHEL users perform the following steps:

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

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

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

  4. Configure your firewall.

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

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

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

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

Removal

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

  • To remove Management Console only, enter:

    sudo yum remove teradicimc

  • To remove Management Console and any package that was required by Management Console including the database, enter:

    sudo yum autoremove teradicimc