EasyUC Manager aktualisieren

Wozu dient das

Der EasyUC Manager ist ein eigenes Produkt mit eigener Versionsnummer. Er besteht aus der Manager-Oberfläche, der Manager-API mit dem eingebauten Operator und der Definition der EasyUC-Ressource. Ein EasyUC-Update verändert den Manager nicht; er wird getrennt aktualisiert.

Für EasyUC 4.8.7 ist Manager 1.15.0 oder neuer nötig, weil erst dieser Stand die Seite EasyUC-Update und das Einheits-Image kennt. Aktualisieren Sie deshalb zuerst den Manager und danach EasyUC.

Es gibt drei Wege: das Offline-Paket für den Manager, das an der Konsole des ersten Knotens eingespielt wird, das Operator-Update in der Manager-Oberfläche und das signierte Offline-Paket auf der Seite System-Updates für Cluster mit genau drei Knoten.

Voraussetzungen

Das Manager-Paket Ihres Release von EasyUC. Welcher Weg für Ihr Paket gilt, steht in den Begleitunterlagen des Release.
Für das Offline-Paket: Konsolenzugang mit Administratorrechten auf dem ersten Knoten.
Für das Operator-Update: Anmeldung am Manager. Die Images des neuen Managers müssen bereits auf den Knoten liegen.
Für das signierte Offline-Paket: genau drei Knoten im Zustand Ready, synchronisierte Zeit auf allen Knoten und VM-Snapshots aller Knoten.
In Clustern mit mehreren Knoten muss das Manager-Image auf allen Knoten vorhanden sein, damit der Manager bei einem Knotenausfall auf einem anderen Knoten starten kann.

Schritt für Schritt: Offline-Paket an der Konsole

Kopieren Sie das Manager-Paket auf den ersten Knoten.
Entpacken Sie es und starten Sie das enthaltene Skript apply-manager-update.sh mit Administratorrechten, wie in den Begleitunterlagen beschrieben.
Das Skript importiert die Images, verteilt das Manager-Image auf die übrigen Knoten, aktualisiert die Definition der EasyUC-Ressource und führt das Update des Managers aus.
Warten Sie die Abschlussprüfung des Skripts ab. Schlägt das Update fehl, nimmt das Skript die Änderung selbst zurück.
Melden Sie sich neu am Manager an. Die Version steht in der Navigation unter dem Logo („Version …“).

Schritt für Schritt: Operator-Update in der Oberfläche

Öffnen Sie im Manager oben rechts das Benutzermenü und wählen Sie Operator-Update.
Wählen Sie im Dialog Operator Self-Update unter Select Helm Chart die Chart-Datei des Managers (.tgz oder .tar.gz).
Wählen Sie Start Upgrade.
Verfolgen Sie die Zustände „Uploading Chart...“, „Upgrading Operator...“ und „Pod Restarting...“ sowie das Progress Log.
Warten Sie auf „Upgrade Completed“. Die Seite lädt sich danach neu.

Schritt für Schritt: signiertes Offline-Paket (drei Knoten)

Öffnen Sie im Manager die Seite System-Updates. Oben steht die Karte EasyUC-Update (signiertes Offline-Paket).
Ziehen Sie die .run-Datei und die zugehörige .run.sig gemeinsam in die Ablagefläche.
Wählen Sie Hochladen und prüfen und bestätigen Sie mit dem Manager-Passwort. Der Upload ist fortsetzbar.
Warten Sie auf „Signatur gültig“. Bei „Signatur ungültig – Paket nicht verwenden“ brechen Sie ab.
Wählen Sie Auf allen Knoten vorladen. Die Knoten werden nacheinander vorbereitet; laufende Dienste ändern sich dabei nicht.
Kontrollieren Sie in der Knotentabelle die Spalten Ready, Datei, Vorladen, Vorbereitet, Zeit synchron, Frei und Vertrauensanker.
Wählen Sie im Abschnitt Einspielen die Schaltfläche Prüfen (--ha-check).
Legen Sie VM-Snapshots aller Knoten an und setzen Sie im Gefahrenbereich: Update einspielen den Haken VM-Snapshots aller Knoten erstellt.
Tippen Sie das angezeigte Bestätigungswort ein und wählen Sie Update einspielen.
Lassen Sie die Seite geöffnet. Der Manager startet während des Laufs neu; die Seite fragt den Stand weiter ab und zeigt danach Ergebnis und Log.
Wählen Sie zum Abschluss Hochgeladene Dateien löschen.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Manager-Version	Laufende Version des Managers. Der Zusatz „von der Vorabprüfung nicht unterstützt“ bedeutet, dass das Paket diesen Stand nicht als Ausgangsversion kennt.
Koordinator	Der Knoten, auf dem der Manager läuft. Dorthin wird das Paket hochgeladen, von dort wird es verteilt.
HA-Cluster	Die Schritte des signierten Offline-Pakets setzen genau drei Knoten voraus.
Vorladen	Importiert die Inhalte des Pakets auf einem Knoten, ohne laufende Dienste zu ändern.
Zeit synchron	Zeigt, ob die Uhr des Knotens per NTP synchronisiert ist. Ohne Synchronisation lässt sich das Update nicht einspielen.
Vertrauensanker	Zeigt, ob der öffentliche Schlüssel zur Signaturprüfung auf dem Knoten installiert ist.
Anhalten / Erneut versuchen	Unterbricht bzw. wiederholt die Verteilung und das Vorladen.
Cluster prüfen (--ha-verify)	Prüft den Cluster nach dem Einspielen erneut.
Log	Ausgabe des gewählten Schritts, während eines Laufs alle drei Sekunden aktualisiert.

Ergebnis prüfen und Fehler eingrenzen

Die Navigation des Managers zeigt unter dem Logo die neue Version, und alle Seiten des Managers sind erreichbar.
Die Seite EasyUC-Update ist vorhanden. Fehlt sie, läuft noch ein Manager vor 1.15.0.
„Upgrade Failed – An error occurred during the upgrade process. Check logs below.“: Meldung im Progress Log lesen. Häufige Ursache: Die Images des neuen Managers liegen nicht auf dem Knoten.
„Noch nicht möglich, es fehlt: …“ beim Einspielen: Die Liste nennt die offenen Voraussetzungen, zum Beispiel nicht vorbereitete Knoten oder fehlende Zeitsynchronisation.
„Auf den Knoten läuft gerade schwere I/O … Hochladen erst danach“: Warten Sie, bis der laufende Import beendet ist.
„Manager nicht erreichbar. Neuer Versuch in wenigen Sekunden …“ während des Einspielens ist erwartet. Der Lauf geht auf den Knoten weiter.
Das Operator-Update prüft nicht, ob ein Rückschritt zulässig ist. Verwenden Sie es nach der Installation von EasyUC 4.8.7 nicht für eine ältere Manager-Version.
Nach einem Wechsel des Managers kann eine erneute Anmeldung nötig sein, weil ältere Anmeldungen ungültig werden.