UCware auf Version 6.3 aktualisieren

Achtung:
Dieser Artikel richtet sich an erfahrene Ubuntu-Administratoren, die eine Aktualisierung des UCware Servers auf Version 6.3 planen. Lesen Sie den Artikel vollständig, bevor Sie mit der Aktualisierung beginnen. Um Fragen und Probleme während der Aktualisierung zu vermeiden, empfehlen wir zudem eine vorherige Rücksprache mit dem UCware Support.

In diesem Artikel erfahren Sie, wie Sie Ihren UCware Server von Version 6.2.x auf Version 6.3 aktualisieren. Dies setzt ein Upgrade des zugrundeliegenden Betriebssystems auf Ubuntu 22.04 LTS (Jammy Jellyfish) voraus. Die dafür erforderlichen Schritte finden Sie ebenfalls hier.

Aktualisierung vorbereiten

Lesen Sie die Versionshinweise zu UCware 6.3.
Greifen Sie per SSH auf den UCware Server zu.
Löschen Sie ältere Paketversionen aus dem Paketcache:
```
sudo apt clean
```
Lesen Sie die Paketquellen neu ein:
```
sudo apt update
```
Laden Sie neue Paketversionen herunter und installieren Sie diese:
```
sudo apt full-upgrade
```
Starten Sie den UCware Server neu:
```
sudo reboot
```
Sichern Sie den Zustand des UCware Servers per Snapshot.

Ubuntu aktualisieren

UCware 6.3 setzt ein Upgrade des zugrundeliegenden Betriebssystems auf Ubuntu 22.04 LTS (Jammy Jellyfish) voraus. Die UCware-Paketquellen werden bei diesem Vorgang ignoriert, sodass Sie diese später manuell anpassen müssen.

Hinweis:
Die folgenden Schritte gehen von einem Ubuntu mit Systemsprache Englisch bzw. C.UTF-8 aus. Die Anzeige konkreter Abfragen während des Upgrades kann abhängig von Ihren eigenen Spracheinstellungen abweichen.

Upgrade anstoßen

Lesen Sie die Upgrade-Anleitung von Cannonical.
Greifen Sie per SSH auf den UCware Server zu.
Starten Sie das Upgrade-Skript:
```
sudo do-release-upgrade
```
Beantworten Sie die Frage Continue running under SSH? mit Y und bestätigen Sie den nächsten Hinweis.
Beantworten Sie die Frage Do you want to start the upgrade? mit Y.
Beantworten Sie die Frage Restart services during package upgrades without asking? mit Yes und bestätigen Sie den nächsten Hinweis.

Konfigurationsdateien auswählen

Configuration file '/etc/nginx/nginx.conf'
 ==> Modified (by you or by a script) since installation.
 ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer's version
    N or O  : keep your currently-installed version
      D     : show the differences between the versions
      Z     : start a shell to examine the situation
 The default action is to keep your current version.
*** nginx.conf (Y/I/N/O/D/Z) [default=N] ?

Im weiteren Verlauf müssen Sie entscheiden, ob das Uprade-Skript die Konfiguration Ihrer bisherigen Ubuntu-Installation übernehmen oder überschreiben soll.

Eine entsprechende Abfrage erfolgt nur, wenn die bisherige und die neuere Konfigurationsdatei der betroffenen Systemkomponente voneinander abweichen.

Konkrete Unterschiede können Sie in diesem Fall mit D anzeigen.

Abweichende Versionen einer Konfigurationsdatei ergeben sich aus den folgenden Gründen:

Die ursprüngliche Konfigurationsdatei wurde in der Vergangenheit manuell oder per Skript angepasst.

In diesem Fall ist es sinnvoller, die bisherige Version zu übernehmen.

Das Upgrade würde die bisherige Konfigurationsdatei um neue Einträge erweitern, ohne die vorhandenen anzupassen.

In diesem Fall ist es sinnvoller, die bisherige Version zu überschreiben.

Das Upgrade würde die ursprünglich bzw. standardmäßig gesetzten Einträge in der Konfigurationsdatei anpassen.

In diesem Fall ist es sinnvoller, die bisherige Version zu überschreiben.

Hinweis:
Übernehmen Sie im Zweifelsfall (z. B. wenn mehrere der o. g. Gründe zutreffen) die bisherige Konfigurationsdatei. Die neuere Version wird in diesem Fall mit der Endung .dpkg-dist im gleichen Verzeichnis abgelegt. Dadurch können Sie die alte Datei bei Bedarf auch zu einem späteren Zeitpunkt überschreiben oder mit der neueren zusammenführen.

Nachdem Sie die erforderlichen Konfigurationsdateien verglichen und ggf. übernommen haben, läuft das Upgrade automatisch weiter.

Upgrade abschließen

Verneinen Sie die Frage Remove obsolete packages? mit N.

Hinweis:
Andernfalls werden die vorhanden UCware-Pakete vom Server gelöscht.
Bestätigen Sie den Hinweis Restart required mit Y.
Sichern Sie nach dem Neustart den Zustand des Systems per Snapshot.

UCware aktualisieren

UCware-Paketquellen anpassen

Greifen Sie per SSH auf den UCware Server zu.
Öffnen Sie die Datei /etc/apt/sources.list.d/ucware.list in einem Editor, zum Beispiel Nano:
```
sudo nano /etc/apt/sources.list.d/ucware.list
```

Ersetzen Sie die Zeilen

deb https://packages.ucware.com/ubuntu/ucware-6 focal main
deb http://packages.ucware.de/ubuntu/ucware-firmware focal main

durch

deb https://packages.ucware.com/ubuntu/ucware-6 jammy main
deb http://packages.ucware.de/ubuntu/ucware-firmware jammy main

Speichern Sie die Datei und beenden Sie den Editor.

Neue UCware-Pakete einspielen

Löschen Sie ältere Paketversionen aus dem Paketcache:
```
sudo apt clean
```
Lesen Sie die Paketquellen neu ein:
```
sudo apt update
```
Laden Sie die neueste Version der Pakete herunter und installieren Sie diese:
```
sudo apt full-upgrade
```
Beantworten Sie die Frage Which services should be restarted? mit Ok.

Aktualisierung abschließen

Deinstallieren Sie nicht mehr benötigte Pakete:
```
sudo apt autoremove
```
Starten Sie den UCware Server neu:
```
sudo reboot
```
Melden Sie sich am Admin-Client an.
Prüfen Sie die Versionsnummer mitin der Kopfzeile.
Testen Sie die Funktionalität der Telefonanlage.
Sichern Sie den Zustand des Systems per Snapshot.