Upgrade durchführen
Übersicht
Das Upgrade-Skript wird von Hand auf der VM Server gestartet. Es führt automatisiert das Upgrade des UCS-Betriebssystems auf der VM Server und der VM opsi-Server durch.
Zunächst wird die VM Server, danach die VM opsi-Server auf UCS v5.2-4 aktualisiert. Danach müssen beide VMs auf die aktuellste UCS 5.2-Version aktualisiert werden. Wenn beide VMs auf dem aktuellen UCS 5.2-Stand sind, ist der UCS-Teil des Upgrades der paed.ML Linux abgeschlossen.
Danach müssen Nacharbeiten durchgeführt werden.
Zeitaufwand
Nach drei Stunden mit einer Internetgeschwindigkeit von mind. 16 Mbit und sehr guter I/O-Perfomance (z.B. Enterprise-SSDs) ist der erste Teil des Upgrades - das Upgrade auf UCS 5.2-4 - abgeschlossen. Der zweite Teil des Upgrades - das Update auf die aktuellste UCS 5.2-Version - dauert pro Patch-Level-Update (z.B. UCS 5.2-7) ca. 30 Minuten.
Bei langsamer Internetanbindung oder schlechter I/O-Performance kann sich diese Zeit auch verdoppeln.
Hinweise
Die meisten Internetanbieter führen nach einer gewissen Zeit (z.B. nach 24 Stunden) eine Zwangstrennung der Internetverbindung durch. Bitte beachten Sie, dass Unterbrechungen der Internetverbindung maximal 2 Minuten dauern dürfen. Wird diese Zeit überschritten, bricht das Upgrade ab.
Abbruch des Upgrade-Skripts
Wird das Skript z.B. aufgrund eines Fehlers abgebrochen, so macht es beim erneuten Starten dort weiter, wo es beim Abbruch aufgehört hat.
Es gibt dann einen Stage aus (z.B.: Stage=419) – dieser zeigt, bei welchem Schritt abgebrochen wurde. Der Wert ist im Supportfall interessant (vgl. Upgrade-Stages).
Wenn Sie sich nach einem Abbruch des Upgrade-Skripts an die Hotline am LMZ wenden, so geben Sie bitte den Stage an und senden Sie die unter Logdateien genannten Dateien mit.
Parameter des Upgrade-Skripts
Folgende Parameter können dem Upgrade-Skript (lmz-upgrade-paedml82.sh) übergeben werden:
Parameter des Upgrade-Skripts
| Parameter | Beschreibung |
|---|---|
| -c | --check | Es werden nur Systemprüfungen durchgeführt, es findet kein Upgrade auf paed.ML Linux 8.2 statt. |
| -f | --force | Aktualisierungen erneut von Beginn an ausführen: Das Upgrade wird von vorne gestartet, der aktuelle Fortschritt wird verworfen. Der „Stage“ wird resettet. |
Logdateien
Es werden folgende Logdateien angelegt:
| Beschreibung | Pfad |
|---|---|
| Logdatei des Upgrade-Skripts auf dem Server | /var/log/paedml-upgrade-80to82.log |
| Logdatei der UCS-Updatevorgänge auf dem Server / opsi-Server | /var/log/univention/updater.log |
| Logdatei von „univention-app“ Befehlen (App Upgrades) auf dem Server | /var/log/univention/appcenter.log |
| Logdatei der Join-Skripte auf dem Server / opsi-Server | /var/log/univention/join.log |
| Logdatei des PostgreSQL-Updates auf dem Server | /var/log/paedml-upgrade-to-postgres15.log |
Durchführen des Upgrades
Upgrade-Prüfung auf Server ausführen
Melden Sie sich als root an der Konsole des Servers an (bitte nicht über eine ssh-Verbindung).
Führen Sie die Upgrade-Prüfung durch:
Upgrade-Prüfung durchführen
Upgrade auf Server ausführen
Melden Sie sich als root an der Konsole des Servers an (bitte nicht über eine ssh-Verbindung).
Führen Sie nun das Upgrade mit diesem Befehl aus:
Lesen Sie die Hinweise und starten Sie das Upgrade danach mit der Eingabetaste.
Nach erfolgreicher Beendigung des Upgrade-Vorgangs der VM Server und opsi-Server erscheint die Ausgabe:
Upgrade abgeschlossen
Durch Drücken der Eingabetaste werden die VMs Server und opsi-Server neu gestartet.
Das Upgrade des Servers ist erfolgreich abgeschlossen:
Das Upgrade des Servers auf UCS 5.2-4 war erfolgreich.
Das Upgrade des opsi-Servers ebenfalls:
Das Upgrade des opsi-Servers auf UCS 5.2-4 war erfolgreich.
Update auf die aktuellste UCS 5.2-Version
Der obige Arbeitsschritt aktualisiert die VM Server und die VM opsi-Server auf UCS v5.2-4.
Nun müssen beide VMs auf die aktuellste UCS 5.2-Version aktualisiert werden - momentan ist das Version 5.2-7.
Update des Servers
Wegen möglicher Abhängigkeiten muss das Update des Servers in zwei Schritten erfolgen.
Melden Sie sich als root an der Konsole des Servers an und führen Sie ein UCS-Update ohne Apps (z.B. UCS@school) durch:
Bestätigen Sie alle Nachfragen mit der Enter-Taste.
Update auf UCS 5.2-5 durch Drücken der Enter-Taste bestätigen
Danach führen Sie erneut ein UCS-Update mit Apps aus:
Bestätigen Sie alle Nachfragen mit der Enter-Taste.
Bei App-Updates kann es Fragen nach Username und Password geben.
Bei Fragen nach Username übernehmen Sie den Vorgabewert durch Drücken der Enter-Taste.
Bei Password geben Sie das Passwort des Administrators ein und drücken dann Enter.
Update des opsi-Servers
Melden Sie sich als root an der Konsole des opsi-Servers an und führen Sie ein UCS-Update durch:
Bestätigen Sie alle Nachfragen mit der Enter-Taste.
Eintragen der statischen Routen
Bei den Vorbereitungen wurden für Server und opsi-Server die in der Univention Configuration Registry definierten statischen Routen notiert.
Diese sind jetzt wieder auf den beiden VMs in die Univention Configuration Registry einzutragen.
Die beiden nachfolgenden Befehle beziehen sich auf die im Auslieferungszustand gesetzen Routen - diese können auf Ihren Systemen anders aussehen.
Passen Sie die Befehle entsprechend der Routen auf Ihren Systemen an.
Ggf. kann ein Ergänzen des Befehls "ucr set" um den Parameter "--force" notwendig sein, um die Einstellung zu setzen.
Für den Server melden Sie sich als root an der Konsole des Servers an und führen Sie aus:
ucr set "interfaces/eth0/route/10.1.2.0=net 10.1.2.0/24 gw 10.1.0.10"
ucr set "interfaces/eth0/route/10.2.0.0=net 10.2.0.0/16 gw 10.1.0.10"
Für den opsi-Server melden Sie sich als root an der Konsole des opsi-Servers an und führen Sie aus:
ucr set "interfaces/eth0/route/10.1.2.0=net 10.1.2.0/24 gw 10.1.0.10"
ucr set "interfaces/eth0/route/10.2.0.0=net 10.2.0.0/16 gw 10.1.0.10"
Abschluß des Upgrades
Nachdem beide VMs auf die aktuellste UCS 5.2-Version aktualisiert wurden, müssen diese wie folgt neu gestartet werden:
- Fahren Sie den opsi-Server herunter.
- Sobald der opsi-Server heruntergefahren ist, starten Sie den Server neu.
- Wenn der Server hochgefahren ist (Login-Prompt), starten Sie den opsi-Server wieder.
Führen Sie nun die weiteren Nacharbeiten aus.
