Vorbemerkungen

Opentext hat für sein ZENworks Configuration Management (ZCM) ein Update auf die Version ZENworks 24.4 veröffentlicht. Opentext stuft dieses Update als „Mandatory“ ein. Diese Anleitung beschreibt das Update von Version 23.3 (letzte LMZ-Auslieferungsversion) ausgehend bis zur Version 24.4. Von 23.3 aktualisieren Sie über Systemaktualisierungen auf 23.4. Von da aus können Sie, mit vorausgehendem Datenbankupdate, direkt auf 24.4 aktualisieren. Das Gleiche trifft auf 24.2 zu. Lassen Sie sich viel Zeit bei den einzelnen Schritten.

Dieses Update setzt mindestens ZENworks 23.3 voraus. Im ZCC-Anmeldefenster (https://10.1.1.33:7443) wird die ZCM-Version angezeigt. Falls Ihr Server noch den Stand 23.3 hat, so muss zunächst auf ZENworks 23.4 aufgerüstet werden. Danach kann auf höhere Versionen upgedated werden. Das Updateverfahren ist für alle Versionsupdates fast identisch.

Die Agents auf den Geräten müssen im Anschluss ebenfalls aktualisiert werden. OpenText empfiehlt die Arbeitsplätze über die Systemaktualisierung via ZENworks oder durch ein angepasstes Windows Image mit dem aktuellen ZENworks Agent zu versorgen.

Falls Sie mehrere ZCMServer betreiben, raten wir dazu, zuerst alle Updates auf die  Server anzuwenden und mit der Aktualisierung bei den Schulcomputern zu warten, bis alle ZCM Server auf Version 24.4 sind.

Auf dem ZServer müssen mindestens 30 GB freier Speicher unter /vastorage vorhanden sein. Auch /root sollte noch minestens 5 GB freien Speicher zur Verfügung haben. Weiterhin dürfen keine noch durchzuführenden Aktualisierungen auf Ihrem Server ausstehen. Im Bild wurden alle Aktualisierungen fehlerfrei durchgeführt.

ZCM 24.4 erwartet eine aktualisierte PostgreSQL Datenbank, mit mindestens PostgreSQL V.16.4. Andernfalls bricht das ZCM Update ab und verlangt eine aktuelle Datenbankversion. Falls Sie mit ZENworks Version 23.4 oder 24.2 in diese Anleitung starten, springen Sie zu Update der PostgreSQL Datenbank. Ab Version 24.4 können Sie das Update direkt ausführen.

Erstellen Sie auf jeden Fall eine Sicherung des ZServer (z.B. mit Veeam). Legen Sie außerdem im ESXi oder Proxmox einen Snapshot an, den Sie später, nach erfolgreichem Update, wieder zeitnah löschen sollten.

Melden Sie sich als root an der Appliance-Verwaltung über https://10.1.1.33:9443 an. Schauen Sie bei „Online Update“ nach, ob SLES Updates verfügbar sind und aktualisieren Sie gegebenenfalls die Appliance. Nach der Aktualisierung sollten Sie einen Neustart machen.

Versionsupdates werden über Konfiguration / Registerkarte „Systemaktualisierungen“ in ZCC heruntergeladen und bereitgestellt. Allerdings kann das manchmal etwas länger dauern, als über das Opentext Software Portal. Gehen Sie dann manuell vor.

Verfügbare Systemaktualisierungen und Download

Klicken Sie auf Aktion / Auf Aktualisierungen überprüfen. Nach kurzer Zeit erscheint „ZENworks 23.4“. Es kann sein, dass noch andere ZENworks Versionen angezeigt werden. Ein eventuelles PRUxxxx (Product Recognition Update) können Sie im Moment ignorieren, es kann auch später installiert werden.

Haken Sie „ZENworks 23.4“ an und über Aktion / Aktualisierung herunterladen aktivieren Sie den Download. Der Status wird mit grünen Punkten und einer Prozentzahl angezeigt. Nach einiger Zeit wird „Warten auf Autorisierung“ angezeigt. Dies hat bei unseren Versuchen teils über eine Stunde gedauert. Den Erfahrungen nach verharrt die Anzeige lange bei 23% und dann bei 60%. Erst dann ist der nächste Schritt möglich.

Autorisierung

Haken Sie „ZENworks 23.4“ an Aktion / Aktualisierung autorisieren.

Haken Sie „ZENworks 23.4“ an Aktion / Aktualisierung konfigurieren. Es erscheint ein Hinweis auf eine neue Registerkarte, siehe nächster Schritt.

Systemaktualisierungskonfiguration

Es wird eine neue Registerkarte im Browser geöffnet, auf der Sie die Systemaktualisierung konfigurieren müssen. Fahren Sie mit „OK“ fort. Manchmal wird die Seite nicht richtig angezeigt und öffnet stattdessen eine neue ZCC-Seite. Ersetzen Sie in diesem Fall in dem generierten Link die IP 10.1.1.33 durch Ihre Server URL. z. B. zserver.oes.ml-bw.de oder umgekehrt zserver.oes.ml-bw.de durch 10.1.1.33.

Sie sollten nun die Konfigurationsseite der Systemaktualisierung sehen. Falls es hier Probleme mit der Anzeige gibt, versuchen Sie einen anderen Browser.

Nachdem Sie diese Informationen durchgelesen haben, klicken Sie auf „Weiter“. Der Port für ZCC wird mit dem bestehenden Port 7443 vorgeschlagen. Bitte belassen Sie diesen Port bei 7443 damit ZCC weiterhin über https://10.1.1.33:7443 erreicht werden kann.

„Fertig stellen“. Schließen Sie die Systemaktualisierungskonfigurationsseite.

Aktualisierung bereitstellen

Gehen Sie in das noch offene ZCC Fenster und machen Sie einen Browser-Refresh. Haken Sie „ZENworks 23.4“ an Aktion / Aktualisierung auf Geräten bereitstellen.

In den folgenden Schritten weisen wir die ZENworks 23.4 Aktualisierung zunächst nur dem ZServer zu.

Schritt 1: Option für Systemaktualisierung und Bereitstellung auswählen

„Systemaktualisierungen auf ausgewählten Geräten in der Verwaltungszone bereitstellen“
„Weiter“

Schritt 2: Neustartverhalten für Bereitstellung auswählen

„Nach Anwendung der Aktualisierung Benutzer zum Neustart auffordern“ (ansonsten nichts anhaken)
 „Weiter“

Schritt 3: Geräte und Gruppen für Bereitstellung auswählen

Auf „Hinzufügen“ klicken

Wählen Sie den zserver aus, klicken Sie auf „OK“ und „Weiter“

Schritt 4: Bereitstellungszeitplan auswählen

Stellen Sie den Zeitplantyp auf „Jetzt“
"Weiter"
 Der Zeitplan wird bei nächster Aktualisierung des Gerätes ausgelöst und das Update sofort installiert.
 „Fertig stellen“

Status der Systemaktualisierung

Während der Systemaktualisierung ist das ZENworks-Kontrollzentrum vorübergehend nicht erreichbar. Mit der nachfolgenden URL können Sie den Status der Systemaktualisierung überprüfen.
https://zserver.oes.ml-bw.de:7444/systemupdate/sustatus

Kopieren und speichern Sie die URL, bevor Sie auf 'OK' klicken, um den Status dieser Systemaktualisierung in Zukunft zu prüfen. OK

Der System Update Status zeigt erst nach einiger Zeit den Fortschritt an. Wenn das Update erfolgreich war, wird bei „Abgeschlosen“ eine 1 angezeigt und „Aktualisierung durchgeführt“

Lassen Sie den Server noch ca. 30 min in diesem Zustand stehen. Im Hintergrund werden diverse Pakete erzeugt, auch wenn „Aktualisierung durchgeführt“ angezeigt wird. Starten Sie den ZServer neu und kontrollieren Sie auf eventuelle Fehler. Wenn alles passt, erstellen Sie einen weiteren Snapshot (in ausgeschaltetem Zustand). Fahren Sie anschließend den ZServer wieder hoch.

Update der PostgresqlDB

Wenn Ihr ZCM Server noch nicht auf die Version 24.4 angehoben wurde, benötigen Sie zuerst ein Datenbankupdate. Gehen Sie zum OpenText Portal https://sld.microfocus.com . Melden Sie sich mit Ihren Zugangsdaten an und suchen Sie „Softwarelizenzen und –Downloads“. Wählen Sie ZENworks Configuration Management und dann Version 24.4 aus. Suchen Sie nach „zenworks-postgres-migration-tool-1.zip“ und laden Sie es herunter.

Entpacken Sie die zip Datei. Es entsteht in 2. Ebene ein Unterordner „postgresql-migration-tool“. Kopieren Sie diesen Ordner z. B. mit WinSCP nach /vastorage/var/tmp. Melden Sie sich jetzt mit Putty, oder direkt an der Konsole des ZServer an.

Wechseln Sie nach /vastorage/var/tmp/postgresql-migration-tool. Starten Sie das Update mit

sh postgres-migration-tool.sh

Das Script fragt nach der ZENworks Administrator Authentisierung. Die Datenbank wird gesichert und wieder „restored“, das kann einige Minuten dauern. Am Ende werden normalerweise einige Erfolgsmeldungen angezeigt. Sie können den Ordner db-migration-tool anschließend löschen.

Falls in ZCC das Update 24.4 angezeigt wird, so können Sie, wie gewohnt, mit diesem Download das Update durchführen. OpenText veröffentlicht Updates als Download im Downloadcenter und wenn diese dort erscheinen, sind sie zum Einspielen freigegeben.

Im ZENworks Channel (Systemaktualisierungen in ZCC) erscheinen die Updates häufig aber mit Zeitverzögerung. Um unabhängig von dieser Zeitverzögerung zu sein, beschreiben wir den Weg mit einer zip-Datei. OpenText beschreibt diese Methode in seiner Update Dokumentation und wir benutzen sie hier für das Update auf ZENworks 24.4.

Melden Sie sich wieder mit Ihren Zugangsdaten am OpenText Portal https://sld.microfocus.com/ an. Suchen Sie in Downloads nach ZENworks Configuration Management (ZCM) innerhalb Version 24.4. Laden Sie das ZENworks_24.4_Update.zip herunter. Kopieren Sie die ca.17 GB große Datei  mit WinSCP nach /vastorage/var/tmp. Wechseln Sie in Putty oder der Konsole nach /vastorage/var/tmp

cd /vastorage/var/tmp

Starten Sie den Import mit

zman sui ZENworks_24.4_Update.zip

Username: Administrator
Password: (Ihr Passwort)
Do you want to continue (Y/N)? Y

Es kommt ein Hinweis, dass der Vorgang in ZCC unter Konfiguration -> Systemaktualisierungen verfolgt werden kann. An dieser Stelle können Sie jetzt auch die Aktualisierung auf Version 24.4 durchführen. 

Wenn das Update auf ZENworks 24.4 fertig ist, sollte die Datei /vastorage/var/tmp/ZENworks_24.4_Update.zip wieder gelöscht werden.

Update des Tuxera-Treibers für das Imaging

Nach jedem Update von ZENworks muss der Tuxera Treiber erneuert werden.
Melden Sie sich in ZCC an und klicken Sie auf Konfiguration / Geräteverwaltung / Preboot Services und scrollen Sie nach unten bis zum Menüpunkt „Einstellungen für Tuxera High Performance NTFS-Treiberintegration“. Klicken Sie dann auf den leicht zu übersehenden Link hier um die tntfs.zip Datei auf Ihren Admin-PC herunterzuladen.

Es öffnet sich das Download-Fenster um „tntfs.zip“ herunterzuladen. Im Anschluss daran können Sie diese Zip-Datei über das „Lupensymbol“ / Datei auswählen / OK auswählen.
Schließen Sie die Prozedur ganz unten auf der Seite mit „Anwenden“ UND „OK“ ab. Es wird nun im Dateisystem des ZServers unter /srv/tftp ein Ordner 24.4.0 angelegt. Es kann evtl. lange dauern, bis dieser Ordner erscheint. Wenn der Treiber verfügbar ist, zeigt ein Klick auf den Link Status, Verfügbar an.

Überprüfen Sie unter https://10.1.1.33:9443, ob die Updateaktivierung der Appliance noch gültig ist und spielen Sie evtl. vorhandene Updates ein.

Überprüfen Sie in ZCC unter https://10.1.1.33:7443, ob die Systemaktualisierungen noch funktionieren. Konfiguration / Systemaktualisierungen / Aktion / Auf Aktualisierungen überprüfen. Geben Sie gegebenenfalls den Activationkey neu ein.

Konfiguration / Infrastrukturverwaltung / Einstellungen für Systemaktualisierungen. Hier die bei Opentext registrierte E-Mail-Adresse und den Aktivierungsschlüssel eintippen. Sie finden die Daten im OpenText Customer Center unter (SLD) Aktivierungen:  ZENworks System Update Activation Code.

xvnc und x11vnc ausschalten

Die Appliance startet nach dem Update mit zwei Fehlern. Diese sollen laut Opentext Support auf der Appliance nicht gestartet werden. Hier der Workaround dazu:

Über Putty oder an der ZServer-Konsole geben Sie ein:

systemctl disable novell-rm-xvnc.socket
systemctl disable novell-rm-x11vnc.socket

Es kann auch vorkommen, dass versucht wird, noch einen weiteren Dienst zu starten:

Das können Sie auf folgende Weise per PuTTY oder Konsole beseitigen:

systemctl disable suseconnect-keepalive.service
systemctl disable suseconnect-keepalive.timer

Danach sollte der Befehl

systemctl --failed

keine fehlenden oder nicht startbaren Dienste mehr ausgeben.

Listen Port 54080 auslagern

PHP Skripte z. B. für den Workstationexport benötigen einen Extraport für Apache. Dieser Eintrag in der Datei listen.conf im Ordner /etc/apache-2 wurde bisher bei jedem Update von ZENworks überschrieben. Damit das Update zukünftig keine Auswirkungen auf die Apache Konfiguration hat, lagern wir diese listen Port Anweisung nun aus. Die Anleitung dazu ist hier.

Versionsstand aktualisieren

Passen Sie die Datei /etc/issue an Ihren aktuellen Versionsstand an. Am einfachsten geht das per WinSCP oder ähnlichen Programmen. Das ist auch für eventuelle Supportanfragen wichtig.