Elektrokid: Die Seite wurde neu angelegt: „ '''RHEL Major Upgrade Guide''' RHEL 7.9 → RHEL 8 → RHEL 9 ''Offline-Umgebung mit lokalem Repo-Server'' Version 1.0 | April 2026 = 1. Übersicht und Voraussetzungen = Dieses Dokument beschreibt den In-Place-Upgrade-Prozess von RHEL 7.9 auf RHEL 8 und anschließend auf RHEL 9 in einer Offline-Umgebung ohne direkten Internetzugang. Als Upgrade-Werkzeug wird Leapp verwendet. == 1.1 Upgrade-Pfad == {| class="wikitable" |- valign="top" |'''Schritt''…“

2026-04-08T16:00:05Z

Die Seite wurde neu angelegt: „ '''RHEL Major Upgrade Guide''' RHEL 7.9 → RHEL 8 → RHEL 9 ''Offline-Umgebung mit lokalem Repo-Server'' Version 1.0 | April 2026 = 1. Übersicht und Voraussetzungen = Dieses Dokument beschreibt den In-Place-Upgrade-Prozess von RHEL 7.9 auf RHEL 8 und anschließend auf RHEL 9 in einer Offline-Umgebung ohne direkten Internetzugang. Als Upgrade-Werkzeug wird Leapp verwendet. == 1.1 Upgrade-Pfad == {| class="wikitable" |- valign="top" |'''Schritt''…“

Neue Seite

'''RHEL Major Upgrade Guide'''

RHEL 7.9 → RHEL 8 → RHEL 9

''Offline-Umgebung mit lokalem Repo-Server''

Version 1.0 | April 2026

= 1. Übersicht und Voraussetzungen =
Dieses Dokument beschreibt den In-Place-Upgrade-Prozess von RHEL 7.9 auf RHEL 8 und anschließend auf RHEL 9 in einer Offline-Umgebung ohne direkten Internetzugang. Als Upgrade-Werkzeug wird Leapp verwendet.

== 1.1 Upgrade-Pfad ==
{| class="wikitable"
|- valign="top"
|'''Schritt'''
|'''Von'''
|'''Nach'''
|'''Methode'''
|- valign="top"
|1
|RHEL 7.9
|RHEL 8.10
|Leapp (el7toel8)
|- valign="top"
|2
|RHEL 8.10
|RHEL 9.x
|Leapp (el8toel9)
|- valign="top"
|3
|RHEL 9.x
|RHEL 9.7
|dnf update -y
|}

== 1.2 Allgemeine Voraussetzungen ==

* System vollständig auf aktuellem Patch-Stand (yum/dnf update -y)
* VM-Snapshot oder Backup vor jedem Upgrade-Schritt
* Lokaler Repo-Server mit RHEL 8 und RHEL 9 Paketen erreichbar
* Ausreichend freier Speicher auf /usr (mindestens +1 GB Puffer empfohlen)
* Konsolen-Zugang (iDRAC/ILO) für den Fall dass SSH nach Reboot nicht verfügbar ist

🔴 '''Ein Rollback nach gestartetem Upgrade ist NICHT möglich! Snapshot/Backup ist zwingend erforderlich.'''

= 2. Upgrade RHEL 7.9 → RHEL 8 (ohne Satellite Server) =

== 2.1 System vorbereiten ==
<nowiki>#</nowiki> Version bestätigen

cat /etc/redhat-release

<nowiki>#</nowiki> System vollständig patchen

yum update -y && reboot

== 2.2 Kernel-Module blacklisten ==
Folgende Kernel-Module sind mit RHEL 8 nicht kompatibel und müssen vor dem Upgrade geblacklisted werden:

cat > /etc/modprobe.d/leapp-blacklist.conf << 'EOF'

blacklist pata_acpi

blacklist BusLogic

EOF

<nowiki>#</nowiki> Initramfs neu bauen

dracut -f --kver $(uname -r)

<nowiki>#</nowiki> Falls Blacklist nicht greift - zusaetzlich per GRUB

<nowiki>#</nowiki> In /etc/default/grub die Zeile GRUB_CMDLINE_LINUX ergaenzen:

<nowiki>#</nowiki> rd.blacklist=pata_acpi rd.blacklist=BusLogic

<nowiki>#</nowiki> BIOS:

grub2-mkconfig -o /boot/grub2/grub.cfg

<nowiki>#</nowiki> UEFI:

grub2-mkconfig -o /boot/efi/EFI/redhat/grub.cfg

reboot

<nowiki>#</nowiki> Nach Reboot prüfen - keine Ausgabe = korrekt

lsmod | grep pata_acpi

lsmod | grep BusLogic

⚠ ''pata_acpi und BusLogic sind in RHEL 8 nicht mehr vorhanden. BusLogic ist ein alter VMware SCSI-Adapter-Treiber der auf modernen Systemen nicht genutzt wird.''

== 2.3 Leapp installieren ==
<nowiki>#</nowiki> RHEL 7 Extras Repo aktivieren

subscription-manager repos --enable rhel-7-server-extras-rpms

<nowiki>#</nowiki> Alternativ bei lokalem Repo - Extras muessen im lokalen Repo verfuegbar sein

yum install leapp leapp-upgrade -y

== 2.4 Leapp Repo-Konfiguration (Offline) ==
Da kein Internetzugang besteht, muessen die RHEL 8 Repos explizit fuer Leapp konfiguriert werden. Die Repo-IDs in dieser Datei muessen sich von den IDs in /etc/yum.repos.d/ unterscheiden um Duplikate zu vermeiden:

cat > /etc/leapp/files/leapp_upgrade_repositories.repo << 'EOF'

[leapp-rhel8-BaseOS]

name=Local RHEL 8 BaseOS (Leapp)

baseurl=<nowiki>http://REPO-SERVER-IP/RHEL8/BaseOS/</nowiki>

enabled=1

gpgcheck=0

module_hotfixes=1

[leapp-rhel8-AppStream]

name=Local RHEL 8 AppStream (Leapp)

baseurl=<nowiki>http://REPO-SERVER-IP/RHEL8/AppStream/</nowiki>

enabled=1

gpgcheck=0

module_hotfixes=1

[leapp-rhel8-HighAvailability]

name=Local RHEL 8 HighAvailability (Leapp)

baseurl=<nowiki>http://REPO-SERVER-IP/RHEL8/HighAvailability/</nowiki>

enabled=1

gpgcheck=0

module_hotfixes=1

EOF

🔴 '''Die baseurl muss per IP-Adresse angegeben werden, nicht per Hostname - der Leapp-Container loest DNS moeglicherweise nicht auf. URLs mit curl -I testen!'''

== 2.5 DNF Konfiguration anpassen ==
Auf RHEL 7 existiert /etc/dnf/dnf.conf oft nicht oder ist leer. Leapp benoetigt diese Datei mit korrektem [main] Header:

cat > /etc/dnf/dnf.conf << 'EOF'

[main]

gpgcheck=1

installonly_limit=3

clean_requirements_on_remove=True

best=False

skip_if_unavailable=True

exclude=*.i686

EOF

<nowiki>#</nowiki> Kopie fuer Leapp erstellen

cp /etc/dnf/dnf.conf /etc/leapp/files/dnf.conf

== 2.6 Repo-Server vorbereiten ==
Der Repo-Server darf nur jeweils eine (die neueste) Version eines Pakets enthalten. Mehrere Versionen fuhren zu DNF-Resolver-Konflikten:

<nowiki>#</nowiki> Auf dem Repo-Server: Alte Pakete entfernen

<nowiki>#</nowiki> WICHTIG: Erst nur anzeigen, dann loeschen!

cd /pfad/zum/repo/Packages

repomanage --old .

<nowiki>#</nowiki> Wenn Ausgabe korrekt: loeschen

repomanage --old . | xargs rm -f

<nowiki>#</nowiki> Metadaten neu erstellen (im Verzeichnis mit repodata/)

cd ..

createrepo --update .

⚠ ''repomanage arbeitet nicht rekursiv. Bei alphabetischen Unterordnern (Packages/a/, Packages/b/ ...) muss eine Schleife verwendet werden: for dir in Packages/*/; do repomanage --old "$dir" | xargs rm -f; done''

<nowiki>#</nowiki> Auf dem RHEL7-System: Cache leeren und pruefen

yum clean all

yum --disablerepo='*' --enablerepo='local-rhel8-BaseOS' \

list --showduplicates perl-libs 2>/dev/null

== 2.7 Netzwerkroute pruefen ==
<nowiki>#</nowiki> Ist der Repo-Server erreichbar?

curl -I <nowiki>http://REPO-SERVER-IP/RHEL8/BaseOS/repodata/repomd.xml</nowiki>

<nowiki>#</nowiki> Falls nicht erreichbar - Route setzen

ip r a NETZ/MASKE via GATEWAY

<nowiki>#</nowiki> Route persistent machen

cat >> /etc/sysconfig/network-scripts/route-INTERFACE << 'EOF'

NETZ/MASKE via GATEWAY

EOF

== 2.8 Pakete auf Remove-Liste setzen ==
Folgende Pakete aus RHEL 7 koennen nicht direkt auf RHEL 8 aktualisiert werden und muessen vor dem Upgrade entfernt werden:

cat >> /etc/leapp/transaction/to_remove << 'EOF'

pcs

ruby-libs

perl-B-Debug

perl-ExtUtils-Command

EOF

<nowiki>#</nowiki> Inhalt pruefen

cat /etc/leapp/transaction/to_remove

💡 ''pcs (Pacemaker/Corosync) kann nach dem Upgrade neu installiert werden: dnf install pcs -y && systemctl enable --now pcsd''

== 2.9 Pre-Upgrade Assessment ==
leapp preupgrade --no-rhsm --target 8.10

Den Report auswerten:

cat /var/log/leapp/leapp-report.txt
{| class="wikitable"
|- valign="top"
|'''Symbol'''
|'''Bedeutung'''
|'''Aktion'''
|- valign="top"
|inhibitor
|Blockiert den Upgrade
|Muss behoben werden
|- valign="top"
|high/medium
|Warnung
|Sollte geprueft werden
|- valign="top"
|info
|Hinweis
|Kein Handlungsbedarf
|}

== 2.10 Upgrade durchfuehren ==
leapp upgrade --no-rhsm --target 8.10

Das System rebooted mehrfach automatisch. Dauer: 30-90 Minuten. Fortschritt per Konsole (iDRAC/ILO) beobachten.

🔴 '''Nicht eingreifen waehrend der Upgrade laeuft - auch bei laengerer Inaktivitaet!'''

== 2.11 Post-Upgrade Aufgaben (RHEL 8) ==
<nowiki>#</nowiki> Version bestaetigen

cat /etc/redhat-release

<nowiki>#</nowiki> Alte RHEL 7 Kernel entfernen

dnf remove $(rpm -q kernel | grep el7)

<nowiki>#</nowiki> Leapp Pakete entfernen und neu installieren (WICHTIG!)

dnf remove leapp* -y

dnf install leapp leapp-upgrade -y

<nowiki>#</nowiki> System vollstaendig patchen

dnf update -y && reboot

🔴 '''Nach dem Upgrade auf RHEL 8 muessen die Leapp-Pakete unbedingt neu installiert werden! Die RHEL 7 Version (python2-leapp) ist nicht fuer den el8toel9 Upgrade geeignet.'''

= 3. Upgrade RHEL 8 → RHEL 9 (ohne Satellite Server) =

== 3.1 Leapp fuer RHEL 9 vorbereiten ==
<nowiki>#</nowiki> Korrekte Leapp Version pruefen (muss el8 sein!)

rpm -q leapp leapp-upgrade python3-leapp

<nowiki>#</nowiki> Python-Abhaengigkeiten pruefen

python3 -c "import pyudev; print(pyudev.__version__)"

<nowiki>#</nowiki> Falls pyudev fehlt - Symlink erstellen

ln -s /usr/lib/python3.6/site-packages/pyudev \

/usr/lib/python2.7/site-packages/pyudev

== 3.2 RHEL 9 Repo-Konfiguration ==
Die leapp_upgrade_repositories.repo muss fuer RHEL 9 aktualisiert werden:

cat > /etc/leapp/files/leapp_upgrade_repositories.repo << 'EOF'

[leapp-rhel9-BaseOS]

name=Local RHEL 9 BaseOS (Leapp)

baseurl=<nowiki>http://REPO-SERVER-IP/RHEL9/BaseOS/</nowiki>

enabled=1

gpgcheck=0

module_hotfixes=1

[leapp-rhel9-AppStream]

name=Local RHEL 9 AppStream (Leapp)

baseurl=<nowiki>http://REPO-SERVER-IP/RHEL9/AppStream/</nowiki>

enabled=1

gpgcheck=0

module_hotfixes=1

[leapp-rhel9-HighAvailability]

name=Local RHEL 9 HighAvailability (Leapp)

baseurl=<nowiki>http://REPO-SERVER-IP/RHEL9/HighAvailability/</nowiki>

enabled=1

gpgcheck=0

module_hotfixes=1

EOF

🔴 '''Das RHEL 9 HighAvailability Repo darf keine Rocky Linux Pakete enthalten! Pruefen mit: find /pfad/repo/ -name '*rocky*''''

== 3.3 VDO Paket installieren ==
VDO (Virtual Data Optimizer) ist in RHEL 9 in den Kernel integriert. Das Paket muss vor dem Upgrade installiert sein:

dnf install vdo -y

systemctl status vdo

== 3.4 Leapp DNF Plugin pruefen ==
<nowiki>#</nowiki> Plugin muss vorhanden sein

find / -name 'rhel_upgrade.py' 2>/dev/null

<nowiki>#</nowiki> Falls Symlink fehlt - erstellen

mkdir -p /var/lib/leapp/el9userspace/lib/python3.9/site-packages/dnf-plugins/

ln -s /usr/share/leapp-repository/repositories/system_upgrade/common/files/rhel_upgrade.py \

/var/lib/leapp/el9userspace/lib/python3.9/site-packages/dnf-plugins/rhel_upgrade.py

== 3.5 Pre-Upgrade Assessment ==
leapp preupgrade --no-rhsm

<nowiki>#</nowiki> Report auswerten

cat /var/log/leapp/leapp-report.txt | grep -E 'inhibitor|Risk Factor: high'

== 3.6 Upgrade durchfuehren ==
leapp upgrade --no-rhsm

Das System rebooted mehrfach automatisch. Dauer: 30-90 Minuten.

== 3.7 Post-Upgrade auf RHEL 9.7 ==
<nowiki>#</nowiki> Version bestaetigen

cat /etc/redhat-release

<nowiki>#</nowiki> Alte Kernel entfernen

dnf remove $(rpm -q kernel | grep el8)

<nowiki>#</nowiki> Auf RHEL 9.7 aktualisieren

dnf update -y

reboot

<nowiki>#</nowiki> Finale Version pruefen

cat /etc/redhat-release

uname -r

= 4. Haeufige Fehler und Loesungen =

== 4.1 DNF execution failed - Paket-Konflikte ==
Ursache: Mehrere Versionen eines Pakets im Repo oder inkompatible Pakete.

<nowiki>#</nowiki> Alte Pakete im Repo finden

yum --disablerepo='*' --enablerepo='REPO-ID' list --showduplicates PAKET

<nowiki>#</nowiki> Auf Remove-Liste setzen

echo 'PAKETNAME' >> /etc/leapp/transaction/to_remove

<nowiki>#</nowiki> YUM Cache leeren

yum clean all

== 4.2 Repository mehrfach definiert ==
Ursache: Gleiche Repo-IDs in /etc/yum.repos.d/ und /etc/leapp/files/leapp_upgrade_repositories.repo.

<nowiki>#</nowiki> Losung: Andere Praefixe in leapp_upgrade_repositories.repo verwenden

<nowiki>#</nowiki> z.B. 'leapp-rhel8-BaseOS' statt 'local-rhel8-BaseOS'

== 4.3 Failed to synchronize cache for repo im Leapp-Container ==
Ursache: Der Leapp-Container kann den Repo-Server nicht erreichen.

<nowiki>#</nowiki> URL testen

curl -I <nowiki>http://REPO-SERVER-IP/RHEL8/BaseOS/repodata/repomd.xml</nowiki>

<nowiki>#</nowiki> Route pruefen und ggf. setzen

ip route

ip r a NETZ/MASKE via GATEWAY

<nowiki>#</nowiki> Hostname durch IP ersetzen in leapp_upgrade_repositories.repo

== 4.4 Not enough space on filesystem ==
Ursache: Zu wenig freier Speicher auf /usr oder anderen Partitionen.

<nowiki>#</nowiki> LV erweitern

lvextend -L +2G /dev/VGNAME/usr

xfs_growfs /usr # XFS

resize2fs /dev/VGNAME/usr # ext4

== 4.5 ImportError: No module named X (Python 2) ==
Ursache: Leapp-Version ist noch die RHEL 7 Version (python2-leapp) auf einem RHEL 8 System.

<nowiki>#</nowiki> Alte Leapp Version entfernen und neu installieren

dnf remove leapp* -y

dnf install leapp leapp-upgrade -y

rpm -q leapp # muss el8 sein!

== 4.6 Rocky Linux Pakete im Repo ==
Ursache: Der Repo-Server enthaelt Rocky Linux Pakete die nicht mit RHEL kompatibel sind.

<nowiki>#</nowiki> Rocky Pakete finden und entfernen

find /pfad/zum/repo/ -name '*rocky*'

find /pfad/zum/repo/ -name '*rocky*' -exec mv {} /tmp/rocky-backup/ \;

createrepo --update /pfad/zum/repo/

== 4.7 $osversion Variable in Repo-Dateien ==
Ursache: Repo-Dateien enthalten $osversion als Variable die nicht aufgeloest wird.

<nowiki>#</nowiki> Variable ersetzen

grep -rl '\$osversion' /etc/yum.repos.d/

sed -i 's/\$osversion/7Server/g' /etc/yum.repos.d/DATEI.repo

= 5. Schnellreferenz: Wichtige Dateien und Pfade =
{| class="wikitable"
|- valign="top"
|'''Datei / Pfad'''
|'''Zweck'''
|- valign="top"
|/etc/leapp/files/leapp_upgrade_repositories.repo
|RHEL Ziel-Repos fuer Leapp (muss andere IDs als yum.repos.d haben)
|- valign="top"
|/etc/leapp/files/dnf.conf
|DNF Konfiguration fuer Leapp-Container
|- valign="top"
|/etc/leapp/transaction/to_remove
|Pakete die vor Upgrade entfernt werden
|- valign="top"
|/etc/leapp/transaction/to_install
|Pakete die beim Upgrade installiert werden
|- valign="top"
|/etc/modprobe.d/leapp-blacklist.conf
|Kernel-Module Blacklist
|- valign="top"
|/var/log/leapp/leapp-report.txt
|Leapp Pre-Upgrade Report
|- valign="top"
|/var/log/leapp/leapp-upgrade.log
|Leapp Upgrade Log
|- valign="top"
|/var/lib/leapp/el9userspace/
|Leapp RHEL 9 Container-Umgebung
|- valign="top"
|/etc/dnf/dnf.conf
|DNF Hauptkonfiguration (muss [main] Header haben)
|}

= 6. Leapp Befehle Schnellreferenz =
{| class="wikitable"
|- valign="top"
|'''Befehl'''
|'''Beschreibung'''
|- valign="top"
|leapp preupgrade --no-rhsm --target 8.10
|Pre-Upgrade Assessment RHEL 7->8
|- valign="top"
|leapp upgrade --no-rhsm --target 8.10
|Upgrade starten RHEL 7->8
|- valign="top"
|leapp preupgrade --no-rhsm
|Pre-Upgrade Assessment RHEL 8->9
|- valign="top"
|leapp upgrade --no-rhsm
|Upgrade starten RHEL 8->9
|- valign="top"
|leapp answer --list
|Alle ausstehenden Fragen anzeigen
|- valign="top"
|cat /var/log/leapp/leapp-report.txt
|Report anzeigen
|- valign="top"
|tail -f /var/log/leapp/leapp-upgrade.log
|Upgrade-Log live verfolgen
|}

RedHat Updates - Versionsgeschichte