Management Console as an RPM¶

RPM Overview¶

The Teradici Technology Preview program gives you pre-release access to new product improvements, enabling you to test features and functionality in your environment and provide feedback to our engineering teams.

Technology preview software is not fully supported by Teradici, and may be incomplete or unstable. It is not intended for use in production systems. Teradici Support may create bug reports or feature requests based on feedback from participating customers, which will be evaluated by Teradici engineering and considered for inclusion in a future release.

Because Technology Preview features are under active development, Teradici cannot guarantee their stability or a clean upgrade path to new releases. If you are using Technology Preview features, you may not be able to upgrade seamlessly to new versions of those features.

While Teradici intends to fully support Technology Preview features in future releases, it is possible that we may determine that some or all of a Technology Preview feature does not meet our standards for a supported release. Teradici cannot guarantee that these Technology Preview features will be released under full support.

Management Console RPM Overview¶

The Management Console RPM Technology Preview 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 will install the Management Console complete with all Linux dependancies so you can get up and operational quickly.

Linux Proficiency

It is expected that administrators of Linux operating systems are proficient at using the Linux OS. Different Linux distributions may require different procedures. Teradici uses the Linux CentOS distribution for instructional information.

Hardware and Virtual Machine Requirements¶

Item	Requirements
CPU	Minimum 4 CPUs or vCPUs
Disk Space	Minimum 20 GB FREE disk space dedicated to the Managment Console Increase this size by the required space for the CentOS operating system and any other files on your Linux system
RAM	Minimum of 12 GB
OS	Centos 7.x
User	Username and Password of user with sudo access

Minimum Requirements Validation

Disabling the minimum requirements check is not recommended! Lowering minimums may reduce Management Console performance, particularly in large deployments.

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 either of the following commands:

sudo MC_NO_CHECK=1 rpm -Uvh teradicimc-<version>.rpm
sudo MC_NO_CHECK=1 yum install teradicimc-<version>.rpm

Management Console Installation, Upgrade and Removal¶

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.

With the teradicimc-<version>.rpm package, the installation process will create everything that Management Console needs in order to work properly. You can then upgrade or remove the Management Console as required.

iptables Rules

If your host Linux OS currently has an iptables configuration you will need to re-add your configuration after the Management Console installation or upgrade. Installation of Management Console replaces the iptables rules with ones that allow Management Console to work properly. If adding rules required by your security policy, ensure not to change the Management Console required rules or you may prevent it from operating correctly.

Upgrades

The RPM format of Management Console allows for upgrades from this version of Management Console. During an upgrade, the database will be automatically be migrated if moving to a newer version of Management Console.
This does not occur for versions of Management Console prior to 19.05.

Installation¶

Prior to installing PCoIP Managment Console, upgrade your Operating system with the sudo yum update command.

The Technology Preview RPM is provided in a compressed file for download.

To install Management Console for the first time enter:
sudo yum install teradicimc-<version>.rpm

If your NIC is not eth0, you will have to edit the config-firewall script so your firewall is properly configured.

Edit config-firewall.sh located in the /opt/teradici/scripts directory by replacing all the eth0 occurences with < your nic name >.

To find your nic's name use the nmcli comand. This will list all your nic cards.
After saving your edits, run the script by issuing the following command:
./opt/teradici/scripts/config-firewall.sh

Removal¶

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

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

Folder Structure¶

The directory structure for the RPM release of Management Console is the same as the OVA version, however the directory structure is slightly modified in release 19.05. Aministrators running scripts and commands should be aware of this as some folders have been removed and others have had their locations changed. All files and folders used by Management Console RPM can be found under /opt/teradici.