.. include:: /guided-inst.subst

.. _upgrade-from-7.3-label:

=====================
Upgrade v7.3 auf v7.4
=====================

.. attention::

   Vor dem Upgrade auf linuxmuster.net v7.4 solltest Du unbedingt Snapshots Deiner VMs anlegen (Server und Firewall).

Ablauf
------

1. Bringe zuerst den lmn7.3 Server auf den aktuellsten Paketstand.

Führe dazu in der Konsole folgende Befehle aus:

.. code::

   sudo apt update
   sudo apt dist-upgrade

2. Falls Du OPNsense |reg| als Firewall einsetzt, aktualisiere diese zunächst auf eine Version >= 26.1.

3. Hast Du die OPNsense |reg| aktualisiert, werden Deine bisherigen Firewall-Regeln mitgenommen. Diese musst Du nun unbedingt auf das neue Format für Firewall-Regeln migrieren. Dies erfolgt wie hier beschrieben:   https://www.thomas-krenn.com/en/wiki/OPNsense_26.1_Firewall_Rule_Migration

4. Führe das Upgrade auf die linuxmuster.net v7.4 - wie nachstehend beschrieben - durch.

Upgrade
-------

Nachdem Du als Benutzer ``linuxadmin`` angemeldet bist, wechselst Du zum Benutzer root mit:

.. code::

   sudo -i

**a) Upgrade auf lmn74 durchführen**

Für das Upgrade von linuxmuster.net v7.3 auf die Version v7.4 findest Du ein Upgrade-Skript, das Ubuntu Server von 24.04 LTS auf 26.04 LTS aktualisiert, neue Paketquellen für linuxmuster.net einträgt und danach linuxmuster.net auf die Version 7.4 bringt.

Rufe das Skript wie folgt auf:

.. code::

   /usr/sbin/linuxmuster-release-upgrade

.. attention::

   Falls Du Dich via SSH auf dem Server anmeldest, stelle sicher, dass Du als user ``root`` eine tmux-Session startest, damit das Upgrade nicht die SSH-Verbindung unterbricht.

Das Upgrade dauert eine ganze Zeit. Du erhälst zu Beginn auf der Konsole den Hinweis, dass Du vor dem Upgrade einen Snapshot Deiner VM anlegen solltest. Zum Start des Upgrades musst Du dann den in der Konsole angezeigten Text eingeben und dies mit ENTER bestätigen. Danach startet das Upgrade.

Prüfe während des Upgrades, ob Fehler ausgegeben werden. Im Nachgang kannst Du zudem in der mitgeschriebenen Log-Datei ggf. nach Fehlern suchen.

.. code::

   less /var/log/linuxmuster/linuxmuster-release-upgrade.log

**b) Firewall & Server neu starten** 

Starte nach dem Upgrade sowohl die Firewall als auch den Server neu.

Melde Dich am Server an, Du solltest den Hinweis auf linuxmuster.net 7.4 sehen:

.. todo::

   Screenshot erneuern

.. figure:: media/02-login-lmn-7.3.png
   :align: center
   :alt: linuxmuster.net v7.4 Pakete an der Anmeldung.

   linuxmuster.net v7.4

Prüfe nun, ob alle Dienste korrekt gestartet wurden.

.. code::

   sudo systemctl list-units --state=failed
   
Du siehst ggf. einen Hinweis auf `quotaon.service`, der sich allerdings nur auf die Root-Partition bezieht, für die keine Quota gesetzt werden kann. Dies entspricht dem erwarteten Verhalten.