EasyUC-Update einspielen

Wozu dient das

Ab Version 4.8.7 kommt ein EasyUC-Release als eine einzige Datei: easyuc-<version>-amd64.eucpkg. Sie enthält das Container-Image mit allen Anwendungsdiensten und die Signatur. Auf der Manager-Seite EasyUC-Update legen Sie die Datei ab. Der Manager prüft Signatur und Inhalt und verteilt das Image im Hintergrund auf alle Knoten, während EasyUC normal weiterläuft.

Erst mit Installieren… beginnt die Umstellung: Der Manager sichert die Datenbank, schaltet auf die neue Version um, führt die Datenbank-Migrationen aus, startet die Dienste neu und prüft jeden Dienst einzeln. Scheitert einer dieser Schritte nach dem Umschalten, setzt der Manager von selbst auf die vorherige Version zurück.

Der Weg funktioniert ohne Internetzugang der Appliance. Sie laden die Datei auf einem Arbeitsplatzrechner aus dem Kundenportal und übertragen sie im Browser an den Manager. Der Manager selbst wird dabei nicht verändert.

Voraussetzungen

EasyUC Manager 1.15.0 oder neuer. Ältere Manager kennen die Seite EasyUC-Update nicht, siehe Kapitel „Manager aktualisieren“.
Installierte EasyUC-Version ab 4.8.5. Ältere Systeme bringen Sie zuerst auf 4.8.5.
K3s 1.34.0 oder neuer, alle Knoten mit Architektur amd64 und im Zustand Ready.
Freier Speicher je Knoten: entpacktes Image plus Paketgröße plus 5 GiB. Die Prüfkarte zeigt je Knoten, wie viel Platz bis zur Grenze bleibt.
Die Paketdatei easyuc-<version>-amd64.eucpkg aus dem Kundenportal. Daneben liegt eine .sha256-Datei zur Prüfung des Downloads. Größe eines Vollpakets: etwa 1,6 bis 2,2 GB, Obergrenze für den Upload 4 GiB.
Anmeldung am Manager und das Manager-Passwort. Die Installation fragt es erneut ab.
Empfohlen: eine aktuelle Vollsicherung und VM-Snapshots vor dem Wartungsfenster.

Schritt für Schritt: Paket hochladen und prüfen lassen

Öffnen Sie im Manager die Seite EasyUC-Update. Oben rechts steht unter Installiert die laufende Version.
Ziehen Sie die Datei auf die Fläche EasyUC-Update-Datei hierher ziehen oder wählen Sie klicken zum Auswählen.
Warten Sie den Upload ab. Die Seite zeigt übertragene Menge, Geschwindigkeit und Restzeit. Mit Anhalten unterbrechen Sie ihn; zum Fortsetzen legen Sie dieselbe Datei erneut ab.
Nach dem Upload erscheint die Prüfkarte mit „Signatur und Inhalt werden geprüft …“. Warten Sie, bis der Zustand auf geprüft wechselt.
Kontrollieren Sie auf der Prüfkarte Signatur (gültig, mit Namen des Schlüssels), die Zeile zum Neustart von Teams/ACD, den Hinweis zu Datenbank-Migrationen und die Release Notes.
Beobachten Sie die Tabelle Server: Spalten Ready, Platz bis zur Grenze und Vorbereitet. Die Verteilung startet von selbst. Richtwert: etwa 15 Minuten je Knoten, bei drei Knoten 45 bis 60 Minuten.

Schritt für Schritt: Installieren

Wählen Sie auf der Prüfkarte Installieren…. Das ist schon während der Vorbereitung möglich; die Installation wartet dann, bis alle Server vorbereitet sind.
Lesen Sie im Dialog EasyUC <version> installieren die Angaben Version, Signatur, Paket und Dauer nach dem Klick.
Lesen Sie den Abschnitt „Unterbrechung aller EasyUC-Dienste“ und den Abschnitt Ungünstigster Fall.
Tragen Sie das Manager-Passwort ein. Die Bestätigung gilt fünf Minuten und nur für diese eine Installation.
Wählen Sie Jetzt installieren.
Verfolgen Sie den Zeitstrahl: Vorprüfung, Sicherung, Umschalten, Datenbank-Migration, Neustart der Dienste, Prüfung, Fertig. Die Manager-Seite bleibt währenddessen erreichbar.
Warten Sie auf die Meldung „EasyUC <version> ist installiert, alle Prüfungen sind bestanden.“ Darunter steht die gemessene Unterbrechung.
Melden Sie sich an der Admin-Oberfläche an und prüfen Sie die wichtigsten Funktionen (Anmeldung, CUCM-Verbindung, ein Testanruf über ACD oder Teams).

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Installiert	Laufende EasyUC-Version.
Zustand des Pakets	wird geprüft, geprüft, abgelehnt, Server werden vorbereitet, bereit zur Installation, Vorbereitung unvollständig.
Vorabversion	Kennzeichnung eines Pakets aus dem Vorabkanal. Manager mit Standardeinstellungen nehmen solche Pakete nicht an.
Signatur	„gültig“ mit Schlüsselname und Art. Nicht berücksichtigte Signaturen stehen mit Grund darunter, zum Beispiel „unbekannter Schlüssel“.
Teams/ACD-Neustart	„ja“: ACD-Media, Teams-SBC oder Teams-PS starten neu, laufende Gespräche über Teams/ACD werden getrennt. „nein“: Diese Dienste laufen unverändert weiter. Mit 4.8.7 starten sie einmalig neu.
Datenbank-Migrationen	„ja“: Ein späteres Zurücksetzen stellt auch die Datenbank auf den Stand unmittelbar vor der Installation zurück. „nein“: Zurücksetzen ist auch ohne Datenbank möglich.
Platz bis zur Grenze	Freier Platz des Knotens bis zur zulässigen Belegung, daneben der Bedarf des Imports.
Vorbereitet	Stand je Knoten: wartet, wird vorbereitet (mit Phase wie Herunterladen, Prüfen, Importieren, Entpacken), vorbereitet, fehlgeschlagen.
Erneut verteilen	Stößt die Verteilung auf die fehlenden Knoten erneut an.
Verwerfen	Löscht das Paket und entfernt Images, die nur dieses Paket betreffen, von allen Knoten.
Abbrechen (im Lauf)	Nur vor dem Umschalten möglich. EasyUC bleibt dann unverändert auf der bisherigen Version.
Ohne Rückkehrmöglichkeit installieren…	Erscheint nur, wenn die Images der installierten Version auf mindestens einem Knoten fehlen. Dann gibt es nach einem Fehler kein automatisches Zurücksetzen.
Dauer	Laut Release Notes 4.8.7: Installation 10 bis 20 Minuten nach dem Klick, Unterbrechung erwartet 5 bis 10 Minuten. Mit automatischem Zurücksetzen bis etwa 1 Stunde 45 Minuten; die Zeitlimits lassen im Extremfall etwa 4 Stunden zu.

Ergebnis prüfen und Fehler eingrenzen

Der Bereich Versionen führt die neue Version mit „aktuell“ und Status „installiert“. Der Abschnitt „Prüfung je Dienst“ zeigt jeden Dienst mit Ergebnis.
„Paket abgelehnt – es wird nicht installiert.“ mit Grund: Signatur, Version oder Inhalt passen nicht. Laden Sie die Datei erneut aus dem Kundenportal und vergleichen Sie die SHA-256-Prüfsumme.
„… ist keine EasyUC-Update-Datei. Erwartet wird eine Datei easyuc-<version>-amd64.eucpkg aus dem Kundenportal.“: falsche Datei gewählt.
„Nicht genug Platz für das Update: …“: Auf dem Knoten des Managers fehlt Speicher. Verwerfen Sie alte Pakete oder vergrößern Sie den Datenträger.
„Vorbereitung unvollständig (n von m Servern)“: Ein Knoten ist nicht bereit oder hat zu wenig Platz. Ursache in der Zeile des Knotens lesen, beheben und Erneut verteilen wählen.
„Verteilung pausiert: …“: Der Manager wartet, zum Beispiel wegen eines nicht bereiten Knotens. Die Verteilung läuft von selbst weiter.
„Es gibt bereits einen angefangenen Upload … Der Manager nimmt nur einen Upload gleichzeitig an.“: Dieselbe Datei zum Fortsetzen ablegen oder Verwerfen wählen.
„Passwort falsch.“ oder „Zu viele Fehlversuche. Bitte in … Sekunden erneut versuchen.“: Passwort prüfen und die Wartezeit abwarten.
„Installation fehlgeschlagen – vorheriger Stand wiederhergestellt.“: Der Manager hat automatisch zurückgesetzt. Der Fehlergrund steht darunter. Unter Versionen startet Erneut installieren einen neuen Versuch.
„Fehlgeschlagen – Eingriff nötig.“: Die Seite nennt die nächsten Schritte und die Namen der internen Sicherungen. Wenden Sie sich mit diesen Angaben an den EasyUC-Support.
„EasyUC-Update ist in diesem Manager nicht aktiviert“: Die Funktion ist in der Manager-Konfiguration abgeschaltet.