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
-
Download the Boot iso and start the installation. Install the server without a graphical interface, in the Base Environment section select Minimal Install.
-
Register RHEL, add the repositories and install UCS:
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.
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-*'
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