3.0 Fehlerbehebung für die ZENworks-Befehlszeilenprogramme

Die folgenden Abschnitte enthalten Lösungen für Probleme, die bei der Arbeit mit Micro Focus ZENworks-Befehlszeilenprogrammen auftreten können:

Beim Ausführen des Befehls „zman db“ wird möglicherweise der Fehler „Java heap space error“ angezeigt

Ursprung: ZENworks 2017 Update 2
Erklärung: Beim Ausführen des Befehls „zman db“ wird möglicherweise der Fehler „OutOfMemoryError: Java heap space error“ angezeigt.
Mögliche Ursache: Es wurde ein begrenzter Java-Heap-Speicher für den zman-Prozess konfiguriert.
Aktion: Mit der neuen Konfigurationsoption „UpdateZManConfigPropertiesConfigureAction“ können Sie die Heap-Größe konfigurieren. Standardmäßig ist die Heap-Größe auf 512 festgelegt.

So steigern Sie die Heap-Größe:

Führen Sie in der Eingabeaufforderung den folgenden Befehl aus:

novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction -Dzman.jvm.max.heapSize=<user-input>

<user-input> entspricht dabei einem Wert zwischen max.heapsize: 512 (Standard) und 1024 (Obergrenze)

Neben „max.heapsize“ können Sie auch Parameter wie „min.heapsize“, „scrollsize“ und „debugLevel“ konfigurieren.

novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction -Dzman.jvm.max.heapSize=<user-input> -Dzman.jvm.min.heapSize=<user-input> -Dzman.renderer.scrollSize=<user-input> -Dzman.debugLevel=<user-input>

Der Parameter <user-input> für „min.heapsize“ entspricht dabei einem Wert zwischen 64 (Standard) und 512 (Obergrenze).

Der Parameter „scrollSize“ kann einen beliebigen ganzzahligen Wert annehmen (Standard ist -1).

Der Parameter „debugLevel“ kann die Werte 1, 2, 3 (Standard) und 4 annehmen.

HINWEIS:Sollte die Datei „zman-config.property“ beschädigt oder gelöscht werden, führen Sie den Befehl novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction ohne Parameter aus, um die Standardwerte der Datei abzurufen.

zman bleibt hängen, wenn die Ausgabe eines Befehls mit Befehlszeilen-Umleitungsoperatoren wie > oder >> in eine Datei umgeleitet wird

Ursprung: ZENworks; zman.
Mögliche Ursache: Zur Ausführung der Befehle durch zman ist die Eingabe des Benutzernamens und Passworts des ZENworks-Administrators erforderlich. Wenn mit dem Befehl kein Berechtigungsnachweis angegeben wird, werden Sie aufgefordert, diesen einzugeben. Falls die Ausgabe des Befehls jedoch in eine Datei umgeleitet wird, werden Sie nicht zur Eingabe des Berechtigungsnachweises aufgefordert, da die Eingabeaufforderungen für Benutzername und Passwort ebenfalls in die Datei umgeleitet werden . Folglich bleibt zman hängen und wartet auf die Eingabe des Berechtigungsnachweises.
Aktion: Geben Sie die Berechtigungsnachweise direkt im Befehl mit den Optionen -U|‑‑User und -P|‑‑Password ein.
Aktion: Speichern Sie die Berechtigungsnachweise mit dem Befehl admin-store-credential und führen Sie den fehlgeschlagenen Befehl danach erneut aus.
Aktion: Leiten Sie mithilfe der Option -R|‑‑Redirect die Ausgabe in eine Datei um, statt einen Umleitungsoperator wie > oder >> zu verwenden.

Eine falsche Erfolgsmeldung wird angezeigt, wenn das optionale Argument „Name der Staging-Gruppe“ nicht an den Befehl „system-update-staging-group-create“ weitergegeben wird

Ursprung: ZENworks; zman.
Erklärung: zman zeigt die folgende falsche Meldung an, wenn das optionale Argument „Name der Staging-Gruppe“ nicht an den Befehl system-update-staging-group-create weitergegeben wird: 
Successfully created the object "null"
Aktion: Führen Sie zur Anzeige der Liste der Staging-Gruppen, die die neu erstellte Staging-Gruppe enthalten würde, bei Eingabeaufforderung der Konsole den Befehl system-update-staging-group-list (susgl) ein.

Die Imaging-Rolle, die einem Satellitenserver mithilfe des Befehls „zman ssaimg“ hinzugefügt wurde, wird nicht sofort auf dem Server angewendet

Ursprung: ZENworks; zman.
Erklärung: Wenn Sie die Imaging-Rolle mithilfe des Befehls zman ssaimg konfigurieren, wird die Rolle umgehend dem Gerät hinzugefügt. Ist dies nicht der Fall, wird die Rolle bei der nächsten geplanten Geräteaktualisierung hinzugefügt.
Aktion: Wenn die Rolle auf dem Gerät jedoch sofort angewendet werden soll, müssen Sie das Gerät auf eine der folgenden Weisen manuell aktualisieren:

  • Führen Sie bei Aufforderung zur Eingabe eines Befehls den Befehl zman workstation-refresh|wrf aus. Wenn es sich bei dem verwalteten Gerät um einen Server handelt, führen Sie den Befehl zman server-refresh|srf aus.

  • Klicken Sie auf dem verwalteten Gerät mit der rechten Maustaste auf das ZENworks-Symbol und wählen Sie Aktualisieren aus.

Die zman-Befehle funktionieren nicht für Nicht-Root-Benutzer auf einem ZENworks Linux-Server

Ursprung: ZENworks; zman.
Erklärung: Wenn ein Nicht-Root-Benutzer die zman-Befehle auf einem ZENworks Linux-Server ausführt, wird die folgende Fehlermeldung angezeigt:

Ihre Privilegien reichen nicht aus, um zman-Befehle auszuführen. Als Nicht-Root-Benutzer in Linux sollten Sie zu einer zmanusers-Gruppe gehören, um zman-Befehle ausführen zu können

Aktion: Fügen Sie den Nicht-Root-Benutzer zur zmanusers-Gruppe hinzu, bevor Sie zman-Befehle ausführen.

  1. Melden Sie sich beim ZENworks-Server als root an.

  2. An der Eingabeaufforderung der Serverkonsole:

    • Wenn der Benutzer bereits auf dem Linux-Gerät vorhanden ist, führen Sie folgenden Befehl aus:

      groupmod -A non-rootusername zmanusers

    • Wenn der Benutzer noch nicht auf dem Linux-Gerät vorhanden ist, führen Sie folgenden Befehl aus:

      useradd -G zmanusers non-rootusername

  3. Melden Sie sich am ZENworks-Server als Nicht-Root-Benutzer an.

Nicht-root-Benutzer können keine Satellitenrolle mit dem Befehl „zman ssc“ konfigurieren

Ursprung: ZENworks; zman.
Erklärung: Wenn ein Nicht-root-Benutzer versucht, eine Satellitenrolle mit dem Befehl „zman ssc“ auf einem Linux-Primärserver zu konfigurieren, wird folgende Fehlermeldung angezeigt: 
The role you specified (Satellite_role_name) is not a valid satellite server role. Valid roles are:
ZoneConfig.ROLE_COLLECTION
ZoneConfig.ROLE_CONTENT
ZoneConfig.ROLE_AUTHENTICATION
Aktion: Führen Sie folgende Schritte aus:

  1. Vergewissern Sie sich, dass der Nicht-root-Benutzer zur Gruppe „zmanusers“ hinzugefügt wurde.

    1. Melden Sie sich beim ZENworks-Server als root an.

    2. An der Eingabeaufforderung der Serverkonsole:

      • Wenn der Benutzer bereits auf dem Linux-Gerät vorhanden ist, führen Sie folgenden Befehl aus:

        groupmod -A non-rootusername zmanusers

      • Wenn der Benutzer noch nicht auf dem Linux-Gerät vorhanden ist, führen Sie folgenden Befehl aus:

        useradd -G zmanusers non-rootusername

  2. Fügen Sie den Nicht-root-Benutzer mit dem Befehl usermod -A Nicht-root-Benutzername zur ZENworks-Benutzergruppe hinzu. Anschließend kann der Nicht-root-Benutzer Satellitenrollen konfigurieren.

Wenn die Datenbank „collectionStatsDB“ beschädigt ist, werden die Agenten-Auditdateien mit dem Befehl „zac cuo“ nicht vom Satellitenserver auf den Primärserver hochgeladen

Ursprung: ZENworks; zac.
Erklärung: Wenn die Agenten-Auditdateien auf den Satellitenserver hochgeladen werden, behält der Server die Verweise auf die Auditdateien in der Datenbank collectionStatsDB bei. Ist die Datenbank beschädigt, gehen alle Verweise auf die Dateien verloren; die Dateien werden nicht mehr verwendet. Wenn Sie also die Agenten-Auditdateien mit dem Befehl zac cuo auf den Primärserver hochladen, erhalten Sie einen Fehler.
Aktion: Zum Hochladen der Agenten-Auditdateien au den Primärserver führen Sie die folgenden Schritte auf dem Satellitenserver aus:

  1. Halten Sie den Agentendienst an.

  2. Löschen Sie den Ordner /var/opt/novell/zenworks/work/collection/collectionStatsDB, in dem sich die Verweise auf die nicht mehr verwendeten Auditdateien befinden.

  3. Starten Sie den Agentendienst.

  4. Führen Sie den Befehl „zac cuo“ aus.

Bei einigen zman-Befehlen tritt der Fehler „OutOfMemory“ auf

Ursprung: ZENworks; zman.
Erklärung: Bei bestimmten zman-Befehlen kann der Fehler OutOfMemory auftreten.
Aktion: Erhöhen Sie die Heap-Größe für zman:

Windows: Erhöhen Sie in der Datei %ZENWORKS_HOME%\conf\zman\properties\zman-config.properties den Wert für die maximale Heap-Größe für JVM_STARTUP_OPTIONS von 128.000 auf 512.000.

Linux: Erhöhen Sie in der Datei /opt/novell/zenworks/bin/zman den Wert für die maximale Heap-Größe für MEM_OPTS von 256.000 auf 512.000.

Der zman-Befehl „ssd“ zum Entfernen einer Satellitenrolle wird nicht ausgeführt

Ursprung: ZENworks; zman
Erklärung: Der zman-Befehl ssd verursacht den folgenden Fehler:

Es ist ein interner Fehler aufgetreten. Prüfen Sie das zman-Protokoll auf weitere Informationen.

Wenn Sie den zman-Befehl ssd zum Entfernen einer Satellitenrolle verwenden, wird zwar die Rolle entfernt, es wird jedoch keine QuickTask zum Aktualisieren des Satelliten gesendet.

Mögliche Ursache: Die QuickTask zum Aktualisieren des Satelliten wird bereits ausgeführt oder wird gleich gestartet.
Aktion: Keine

zac-Befehle bleiben auf RHEL-Satellitenservern hängen, wenn der Zeitplan für die Inhaltsreproduktion nur für einen kurzen Zeitraum konfiguriert wird

Ursprung: ZENworks; zac
Erklärung: Wenn Sie zac-Befehle auf einem RHEL-Satellitenserver ausführen, bleibt der Prozess für unbestimmte Zeit hängen.
Mögliche Ursache: Der Zeitplan für die Inhaltsreproduktion wird nur für einen kurzen Zeitraum konfiguriert. Beispiel: 5 Minuten.

HINWEIS:Es wird empfohlen, den Zeitplan für die Inhaltsreproduktion für 12 Stunden zu konfigurieren.

Aktion: Melden Sie sich beim ZENworks-Kontrollzentrum an, fügen Sie eine Zonensystemvariable, enable.cdp.cleanup.thread.wait.time, hinzu und legen Sie den Wert auf True fest.

Die Konfigurationsaktion schlägt mit der Ausnahme ZEN-Konfigurationsaktions-Container reagiert nicht fehl

Ursprung: ZENworks
Erklärung: Die Konfigurationsaktion wird mit der folgenden Warnung abgeschlossen:

com.novell.zenworks.configure.NonFatalConfigureException: ZEN-Konfigurationsaktions-Container reagiert nicht

Mögliche Ursache: Dieses Problem ist eingetreten, da der ZENConfigure-Container nicht innerhalb der Wartezeit initialisiert werden konnte.
Aktion: Erhöhen Sie die Wartezeit für den ZENConfigure-Container in der Konfigurationseigenschaft max-retries-for-configure-server=<number of retries> im Verzeichnis /etc/opt/microfocus/zenworks/host-configure-action.properties. Der Standardwert für max-retries-for-configure-server liegt bei 60.

HINWEIS:Erstellen Sie eine Datei mit dem Eintrag, falls sie noch nicht vorhanden ist.