EasyUC
Deutsch
Aurora

Design auswählen

Software, Updates und Lizenzdateien finden Sie im Kundenbereich. Zu den Downloads

Updates einspielen

Ablauf eines EasyUC-Updates ab 4.8.7, Verhalten der Dienste währenddessen und der Weg zurück.

Gilt für: EasyUC 4.8.7 Stand: Oktober 2026

Vor dem Update

  • Voraussetzungen für 4.8.7 prüfen: EasyUC ab 4.8.5, EasyUC Manager ab 1.15.0, K3s ab 1.34.0, alle Nodes amd64 und im Status Ready. Ältere Systeme bringen Sie zuerst auf 4.8.5.
  • Paketdatei easyuc-<version>-amd64.eucpkg bereithalten und die Prüfsumme des Downloads vergleichen.
  • Freien Speicherplatz auf allen Nodes prüfen. Die Grenze zeigt der Manager nach dem Hochladen an.
  • Wartungsfenster planen. Die gesamte Anwendung ist während der Installation 5 bis 10 Minuten nicht erreichbar. Rechnen Sie für den Fehlerfall mit etwa 1 Stunde 45 Minuten.
  • Empfohlen: eine eigene Vollsicherung und einen VM-Snapshot anlegen, siehe Backup und Wiederherstellung.

Wichtig

Der Manager sichert die Datenbank vor der Installation selbst. Diese Sicherung dient dem Zurücksetzen auf die vorherige Version und erscheint nicht in der Liste Ihrer Backups. Ein eigenes Backup ersetzt sie nicht.

Ablauf

  1. Paketdatei hochladen

    Öffnen Sie im Manager die Seite EasyUC-Update und ziehen Sie die Datei auf die Fläche. Ein unterbrochener Upload lässt sich fortsetzen.

  2. Prüfung und Vorbereitung abwarten

    Der Manager prüft Signatur und Inhalt und zeigt Version, Release Notes und den Stand der Nodes. Danach verteilt er das Image im Hintergrund auf alle Nodes. Das dauert etwa 15 Minuten je Node. EasyUC läuft währenddessen normal weiter.

  3. Installation starten

    Wählen Sie Installieren…, geben Sie Ihr Manager-Passwort ein und bestätigen Sie mit Jetzt installieren.

  4. Installation läuft

    Der Manager sichert die Datenbank, schaltet auf die neue Version um, führt die Datenbankmigrationen aus, startet die Dienste neu und prüft jeden Dienst einzeln. Das dauert 10 bis 20 Minuten.

  5. Status prüfen

    Unter Versionen sehen Sie die installierte Version und die vorherige, auf die Sie zurücksetzen können.

Was intern passiert

Die Paketdatei enthält ein einziges Image für alle Anwendungskomponenten und trägt eine Signatur. Pakete ohne gültige Signatur nimmt der Manager nicht an. Die Datendienste MariaDB, Elasticsearch und RabbitMQ werden bei einem normalen EasyUC-Update nicht ersetzt.

Ablauf eines EasyUC-Updates Fünf Schritte: signierte Paketdatei hochladen, der Manager prüft sie und verteilt das Image auf alle Nodes, er sichert die Datenbank, der Initialisierungsjob führt die Migrationen aus, alle Dienste starten gemeinsam neu und sind dabei 5 bis 10 Minuten nicht erreichbar. MariaDB, Elasticsearch und RabbitMQ werden nicht ersetzt. 1 Paket signierte Datei (.eucpkg) 2 Vorbereitung Prüfung, Verteilung auf alle Nodes 3 Sicherung Datenbank, vor dem Umschalten 4 Init-Job Migrationen, Suchindizes 5 Dienste gemeinsamer Neustart 5–10 Minuten Ausfall MariaDB, Elasticsearch und RabbitMQ werden bei einem normalen Update nicht ersetzt.
Ablauf eines Updates ab 4.8.7. Die Datendienste werden nicht ersetzt.

Verhalten während des Updates

Jeder Dienst läuft in einer Instanz, und alle Dienste starten gemeinsam neu. Vom Umschalten bis alle Dienste wieder bereit sind, ist die gesamte EasyUC-Anwendung nicht erreichbar. Erwartet sind 5 bis 10 Minuten.

acd-media, teams-sbc und teams-ps starten mit 4.8.7 einmalig neu. Laufende Gespräche über Teams und ACD werden dabei getrennt. Bei späteren Updates starten diese Dienste nur neu, wenn sich ihr Inhalt geändert hat.

Scheitert die Installation, verlängert das automatische Zurücksetzen die Unterbrechung. Als Richtwert für diesen Fall gelten etwa 1 Stunde 45 Minuten.

Warnung

Planen Sie Updates in einem Wartungsfenster, das auch den Fehlerfall abdeckt. Laufende Gespräche über Teams und ACD werden getrennt, Oberflächen und Dienste sind in dieser Zeit nicht erreichbar.

Zurück zur vorherigen Version

Der Manager hält die Images der letzten zwei Versionen auf allen Nodes vor. Zurückgesetzt wird immer zusammen mit der Datenbank, auf den Stand unmittelbar vor dem Umschalten.

  • Automatisch: Scheitert die Installation bei Migration, Neustart oder Prüfung, setzt der Manager Programm und Datenbank auf die vorherige Version zurück. Unter Versionen starten Sie danach einen neuen Versuch.
  • Manuell: Nach einer erfolgreichen Installation setzen Sie unter Versionen auf die vorherige Version zurück, solange deren Images auf allen Nodes liegen. Der Dialog nennt den Datenstand, der wiederhergestellt wird. Vorher legt der Manager eine Sicherheitskopie an.
  • Daten, die nach der Sicherung in die Datenbank geschrieben wurden, gehen beim Zurücksetzen verloren. Suchindizes, Dateien auf dem Anwendungsvolume und die übrigen Einstellungen der Installation setzt der Manager nicht zurück.
  • Scheitert auch das Zurücksetzen, bleibt EasyUC stillgelegt, bis der Stand geklärt ist. Wenden Sie sich dann an unseren Support. Ein VM-Snapshot bleibt als zusätzlicher Weg zurück sinnvoll.

Den Manager selbst aktualisieren

Der Manager wird getrennt von EasyUC aktualisiert. EasyUC 4.8.7 setzt Manager 1.15.0 oder neuer voraus. Nach der Installation von 4.8.7 dürfen Sie den Manager nicht mehr auf eine Version unter 1.15.0 zurücksetzen. Ältere Manager kennen das gemeinsame Image nicht und würden die laufende Installation unbrauchbar machen.

Das Manager-Update und die Anleitung dazu erhalten Sie mit dem Release. Beim Einspielen passiert Folgendes:

  1. Die Custom Resource Definition des Managers wird aktualisiert.

  2. Der Manager startet neu.

Updates ohne Internetzugang

Die Paketdatei enthält alles, was das Update braucht. Sie laden sie im Browser in den Manager hoch, ein Zugriff auf registry.easy-uc.com ist nicht nötig. Der Ablauf ist mit und ohne Internetzugang derselbe.

Das Paket ist ein Vollpaket mit etwa 1,6 bis 2,2 GB. Der Manager nimmt Pakete bis 4 GiB an.