Red Hat Enterprise Linux

UCS je podporováno na RHEL verze 8.x a 9.x, architektury x86_64. Pro instalaci postupujte následovně:

Instalace

1. Stáhněte Boot iso a spusťte instalaci. Nainstalujte server bez grafického rozhraní, v sekci Base Environment vyberte Minimal Install.

2. Zaregistrujte RHEL, přidejte repozitáře a nainstalujte UCS:

warning

UCS vyžaduje k běhu postgresql 13 nebo vyšší, proto insoft-repo-rhel8 zapíná modul postgresql 13.

#!/bin/bash

timedatectl set-timezone Europe/Prague
dnf install postfix

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

info

Observability stack (Grafana, Loki, Tempo, Prometheus, OpenTelemetry Collector) se neinstaluje automaticky. Nainstalujte ho ručně na hostech, kde chcete lokální sběr telemetrie:

dnf install insoft-telemetry

Tím se nainstaluje všech pět komponent a nakonfigurují se. Grafana je pak dostupná na https://<adresa-serveru>/grafana/ — viz Observabilita pro detaily přístupu, konfigurace a odesílání telemetrie.

RHEL má ve výchozím nastavení zapnutý firewall, proto je nutné povolit přístup ke službám, které poskytuje 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

Pokračujte: Prvotní nastavení

Provoz

Zamknutí verze UCS

Pokud je vyžadována pravidelná aktualizace OS, ovšem UCS má být aktualizováno pouze na vyžádání, pak je možné zamknout nainstalovanou verzi UCS:

Jednorázová instalace podpory zamykání verzí:

dnf -y install python3-dnf-plugin-versionlock

Zamknutí aktuálně nainstalované verze UCS:

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

Odemknutí pro aktualizaci UCS:

dnf versionlock clear

Kontrola které balíčky jsou zamknuté:

dnf versionlock list

Příklad aktualizací:

# Po prvotní instalaci UCS bylo zadáno:
dnf versionlock 'insoft-*'
dnf versionlock 'ucs-*'

Aktualizace pouze systémových balíčků

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

Aktualizace INSOFT a UCS balíčků (vč. systémových) a jejich opětovné zamknutí

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

info

RedHad má ve výchozím nastavení 48 hodinovou cache na repozitáře. Pokud chcete nainstalovat verzi, která se ještě nezobrazuje v seznamu, zadejte příkaz dnf update --refresh, případně dnf clean expire-cache.

Povýšení OS

Pro aktualizaci RHEL z verze 8 na 9 se využívá nástroj Leapp.

Nejdříve je nutné aktualizovat všechny stávající balíčky na aktuální verzi, restartovat server a odstranit balíčky bez závislostí. Před samotným povýšením verze RHEL je nutné vypnout EPEL a INSOFT repozitáře. Následně se provede kontrola připravenosti na upgrade:

# Pokud není v systému nainstalován Leapp
dnf install leapp-upgrade

# Aktualizace balíčků
dnf versionlock clear
dnf upgrade

reboot

# Odstranění balíčků bez závislostí
dnf autoremove

# Vypnutí custom repozitářů
dnf repolist
dnf config-manager --set-disabled epel insoft-ucs

# Kontrola, zda je možné provést upgrade
leapp preupgrade

Bude to trvat cca. 10 minut. Pokud je REPORT OVERVIEW zobrazen červeně, pak není upgrade možný a je potřeba vyřešit blokující problémy (Inhibitors). Následně se znovu spustí leapp preupgrade, pro ověření, že byly problémy opravdu vyřešeny.

Následně je možné spusit samontý upgrade pomocí:

# Upgrade selhává se zapnutým SELinuxem, proto je nutné ho vypnout
setenforce 0

# Stáhne balíčky a připraví systém na upgrade
leapp upgrade

# Po rebootu se provede samotný upgrade
reboot

Ověření výsledku aktualizace, znovuzapnutí custom repozitářů.

# Aktuální verze RHEL
cat /etc/redhat-release

# Instalace aktuální verze Python
dnf install python3.12 python3.12-setuptools

# Instalace aktuálních EPEL a INSOFT repozitářů
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

# Aktualizace balíčků EPEL
dnf upgrade

# INSOFT balíčky nemají v názvu verzi RHEL, proto se musí reinstallovat
dnf reinstall ucs-* insoft-* uauth* traefik-proxy