Skip to main content

Red Hat Enterprise Linux

UCS is supported on RHEL versions 10 and 9, x86_64 architecture. Use RHEL 10 for new installations. To install, follow these steps:

Installation​

  1. Download the Boot iso and start the installation. Install the server without a graphical interface, in the Base Environment section select Minimal Install.

  2. Register RHEL, add the repositories and install UCS:

note

UCS requires PostgreSQL 16. On RHEL 10 it is the default version; on RHEL 9 the insoft-repo package enables the postgresql:16 module during installation.

#!/bin/bash

timedatectl set-timezone Europe/Prague
dnf install postfix

subscription-manager register
dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm
dnf -y install https://repo.insoft.cz/yum/rhel/10/stable/insoft-repo/insoft-repo-1.0.0-0.el10.noarch.rpm
dnf repolist
dnf update
dnf install insoft-ucs

The insoft-repo package configures the INSOFT and Grafana repositories. On RHEL 9, use epel-release-latest-9 and insoft-repo-1.0.0-0.el9.noarch.rpm.

info

The observability stack (Grafana, Loki, Tempo, Prometheus, OpenTelemetry Collector) is not installed automatically. Install it per host where you want local telemetry collection:

dnf install insoft-telemetry

This pulls in all five components and configures them. Grafana then becomes available at https://<server-address>/grafana/ — see Observability for details on access, configuration, and telemetry ingestion.

RHEL has a firewall enabled by default, so it is necessary to allow access to the services provided by UCS:

#!/bin/bash

firewall-cmd --permanent --new-service=rtp
firewall-cmd --permanent --service=rtp --set-description="RTP audio and video streams plus STUN/ICE support"
firewall-cmd --permanent --service=rtp --set-short="RTP+STUN"
firewall-cmd --permanent --service=rtp --add-port=10000-20000/udp
firewall-cmd --permanent --service=rtp --add-port=3478/udp
firewall-cmd --permanent --zone=public --add-service=rtp
firewall-cmd --permanent --zone=public --add-service=sip
firewall-cmd --permanent --zone=public --add-service=http
firewall-cmd --permanent --zone=public --add-service=https
firewall-cmd --reload

Continue: First Settings

Operation​

Locking the UCS version​

If regular OS updates are required, but UCS should only be updated on demand, then it is possible to lock the installed version of UCS:

One-time installation of version locking support:

dnf -y install python3-dnf-plugin-versionlock

Lock the currently installed version of UCS:

dnf versionlock 'insoft-*'
dnf versionlock 'ucs-*'

Unlock to update UCS:

dnf versionlock clear

Check which packages are locked:

dnf versionlock list

Update examples:

# After the initial UCS installation, the following was entered:
dnf versionlock 'insoft-*'
dnf versionlock 'ucs-*'

Updating only system packages​

dnf versionlock 'insoft-*'
dnf versionlock 'ucs-*'
dnf update

Updating INSOFT and UCS packages (incl. system packages) and locking them again​

dnf versionlock clear
dnf update
dnf versionlock 'insoft-*'
dnf versionlock 'ucs-*'
info

By default, Red Hat caches repository metadata for 48 hours. If you want to install a version that is not listed yet, run dnf update --refresh or dnf clean expire-cache.

OS upgrade​

To upgrade RHEL from version 8 to 9, use the Leapp tool.

First update all installed packages to the current version, reboot the server and remove packages without dependencies. Before upgrading RHEL itself, disable the EPEL and INSOFT repositories. Then check whether the system is ready for the upgrade:

# If Leapp is not installed on the system
dnf install leapp-upgrade

# Update packages
dnf versionlock clear
dnf upgrade

reboot

# Remove packages without dependencies
dnf autoremove

# Disable custom repositories
dnf repolist
dnf config-manager --set-disabled epel insoft-ucs

# Check whether the upgrade is possible
leapp preupgrade

This takes about 10 minutes. If the REPORT OVERVIEW is shown in red, the upgrade is not possible and the blocking problems (Inhibitors) must be resolved first. Then run leapp preupgrade again to verify that the problems really are resolved.

Then start the upgrade itself:

# The upgrade fails with SELinux enforcing, so it has to be turned off
setenforce 0

# Downloads the packages and prepares the system for the upgrade
leapp upgrade

# The upgrade itself runs after the reboot
reboot

Verify the result of the upgrade and re-enable the custom repositories:

# Current RHEL version
cat /etc/redhat-release

# Install the current Python version
dnf install python3.12 python3.12-setuptools

# Install the current EPEL and INSOFT repositories
rm /etc/yum.repos.d/epel.repo
rm /etc/yum.repos.d/insoft.repo
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
dnf install https://repo.insoft.cz/yum/rhel/9/stable/insoft-repo-rhel9/insoft-repo-rhel9-1.0.0-0.x86_64.rpm

# Update EPEL packages
dnf upgrade

# INSOFT packages do not have the RHEL version in their names, so they must be reinstalled
dnf reinstall ucs-* insoft-* uauth* traefik-proxy