3.0 Risoluzione dei problemi relativi alle utility da riga di comando di ZENworks

Nelle sezioni che seguono sono illustrate le soluzioni ai problemi riscontrabili nell'utilizzo delle utility da riga di comando di Micro Focus ZENworks:

Quando si esegue il comando zman db, è possibile che si verifichi un errore dello spazio heap di Java

Origine: ZENworks 2017 Update2
Spiegazione: quando si esegue il comando zman db, è possibile che si verifichi OutOfMemoryError: errore dello spazio heap di Java.
Possibile causa: la memoria heap di Java configurata per il processo zman è limitata.
Azione: la nuova azione di configurazione UpdateZManConfigPropertiesConfigureAction permette di configurare le dimensioni dell'heap. Le dimensioni massime sono impostate per default su 512.

Per aumentare le dimensioni della memoria heap:

Nel prompt dei comandi, eseguire il seguente comando:

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

Dove <user-input> per max.heapSize: può essere un valore compreso tra 512 (default) e 1024 (upper-bound)

Oltre a max.heapSize, è possibile configurare altri parametri come min.heapSize, scrollSize e debugLevel.

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>

Dove <user-input> per min.heapSize può essere un valore compreso tra 64 (default) e 512 (upper-bound)

scrollSize accetta qualsiasi valore intero (default: -1)

debugLevel accetta i valori 1, 2, 3 (default) e 4

NOTA:se il file zman-config.property file è danneggiato o è stato eliminato, eseguire il comando novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction senza specificare parametri per ottenere i valori di default nel file.

zman si blocca quando l'output di un comando viene reindirizzato a un file usando gli operatori di reindirizzamento della riga di comando > o >>

Origine: ZENworks; zman.
Possibile causa: zman necessita del nome utente e della password dell'amministratore ZENworks per l'esecuzione di ogni comando. Se insieme al comando non vengono indicate le credenziali, verrà chiesto di specificarle. Tuttavia, se l'output del comando viene reindirizzato a un file, non verrà chiesto di immettere le credenziali perché le richieste di nome utente e password vengono a loro volta reindirizzate al file. Di conseguenza zman si blocca in attesa che vengano immesse le credenziali.
Azione: specificare le credenziali come parte del comando usando le opzioni -U|--User e -P|--Password.
Azione: memorizzare le credenziali usando il comando admin-store-credential e poi eseguire il comando.
Azione: reindirizzare l'output a un file utilizzando l'opzione -R|--Redirect anziché l'operatore di reindirizzamento > o >>.

Quando non viene eseguito il comando "system-update-staging-group-create" sull'argomento opzionale "nome gruppo provvisorio", viene visualizzato un messaggio di conferma errato

Origine: ZENworks; zman.
Spiegazione: zman visualizza il seguente messaggio errato se l'argomento opzionale “nome gruppo provvisorio” non viene inviato al comando system-update-staging-group-create: 
Successfully created the object "null"
Azione: per visualizzare l'elenco dei gruppi provvisori che comprenderebbero il gruppo provvisorio appena creato, eseguire il comando system-update-staging-group-list (susgl) al prompt della console.

Il ruolo di Imaging aggiunto al satellite mediante il comando zman ssaimg non viene subito applicato al server

Origine: ZENworks; zman.
Spiegazione: se si configura il ruolo di imaging mediante il comando zman ssaimg, il ruolo viene subito aggiunto al dispositivo. Se il ruolo non viene aggiunto immediatamente, verrà aggiunto alla successiva pianificazione di aggiornamento del dispositivo.
Azione: tuttavia, se si desidera applicare immediatamente il ruolo al dispositivo, è necessario aggiornare quest'ultimo manualmente in uno dei seguenti modi:

  • Al prompt dei comandi, eseguire il comando zman workstation-refresh|wrf. Se il dispositivo gestito è un server, eseguire il comando zman server-refresh|srf.

  • Sul dispositivo gestito, fare clic con il tasto destro del mouse sull'icona di ZENworks, quindi scegliere Aggiorna.

I comandi zman non operano per un utente non root su un server Linux di ZENworks

Origine: ZENworks; zman.
Spiegazione: se un utente non root esegue i comandi zman su un server Linux di ZENworks, viene visualizzato il seguente messaggio di errore:

Non si dispone di sufficienti privilegi per eseguire i comandi zman. Come utente non root in Linux, bisogna far parte del gruppo zmanusers per eseguire i comandi zman.

Azione: aggiungere l'utente non root al gruppo zmanusers prima di eseguire comandi zman.

  1. Effettuare il login al server ZENworks come utente root.

  2. Al prompt della console del server:

    • Se l'utente esiste già sul dispositivo Linux, eseguire il seguente comando:

      groupmod -A non-rootusername zmanusers

    • Se l'utente non esiste sul dispositivo Linux, eseguire il seguente comando:

      useradd -G zmanusers non-rootusername

  3. Eseguire il login al server di ZENworks come utente non root.

Un utente non root non riesce a configurare un ruolo di un satellite utilizzando il comando zman ssc

Origine: ZENworks; zman.
Spiegazione: se un utente non root prova a configurare un ruolo di un satellite utilizzando il comando zman ssc in un server primario Linux, viene visualizzato il messaggio seguente: 
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
Azione: effettuare le seguenti operazioni:

  1. Assicurarsi che l'utente non root sia stato aggiunto al gruppo zmanusers.

    1. Effettuare il login al server ZENworks come utente root.

    2. Al prompt della console del server:

      • Se l'utente esiste già sul dispositivo Linux, eseguire il seguente comando:

        groupmod -A non-rootusername zmanusers

      • Se l'utente non esiste sul dispositivo Linux, eseguire il seguente comando:

        useradd -G zmanusers non-rootusername

  2. Aggiungere l'utente non root al gruppo di utenti ZENworks utilizzando il comando usermod -A nomeutente_non_root. Grazie a questa operazione, l'utente non root potrà configurare i ruoli di satellite.

Il comando zac cuo non effettua l'upload dei file di revisione dell'agente dal server satellite al server principale se il database collectionStatsDB è danneggiato

Origine: ZENworks; zac.
Spiegazione: quando viene effettuato l'upload dei file di revisione sul server satellite, il server mantiene i riferimenti ai file di revisione nel database collectionStatsDB. Se il database è danneggiato, tutti i riferimenti vanno persi e il file diventa orfano. Di conseguenza, se si esegue il comando zac cuo per effettuare l'upload dei file di revisione sul server principale, viene visualizzato un errore.
Azione: per effettuare l'upload dei file di revisione sul server principale, è necessario eseguire la seguente procedura sul server satellite:

  1. Interrompere il servizio agente.

  2. Cancellare la cartella/var/opt/novell/zenworks/work/collection/collectionStatsDB con riferimenti ai file di revisione orfani.

  3. Avviare il servizio agente.

  4. Eseguire il comando zac cuo.

Alcuni comandi zman non riescono e generano un errore OutOfMemoryError

Origine: ZENworks; zman.
Spiegazione: alcuni comandi zman potrebbero non riuscire e generare OutOfMemory.
Azione: aumentare la dimensione max della memoria heap per zman:

Windows: nel file %ZENWORKS_HOME%\conf\zman\properties\zman-config.properties aumentare il valore della dimensione max della memoria heap di JVM_STARTUP_OPTIONS da 128 m a 512 m.

Linux: nel file /opt/novell/zenworks/bin/zman aumentare la dimensione max della memoria heap di MEM_OPTS da 256 m a 512 m.

Il comando zman ssd utilizzato per rimuovere un ruolo satellite ha esito negativo

Origine: ZENworks; zman
Spiegazione: il comando zman ssd ha esito negativo con il seguente errore:

Si è verificato un errore interno. Controllare il registro zman per avere ulteriori dettagli

Quando si utilizza ssd, il comando zman per rimuovere un ruolo dal satellite, tale comando rimuove il ruolo, ma non riesce a inviare il task rapido di aggiornamento satellite.

Possibile causa: ciò avviene perché il task rapido di aggiornamento satellite è già in corso per il satellite o sta per essere elaborato.
Azione: nessuna

I comandi zac restano in sospeso sui server satellite RHEL quando la pianificazione replica del contenuto è configurata per una breve durata

Origine: ZENworks; zac
Spiegazione: quando si eseguono comandi zac su un server satellite RHEL, il processo resta in sospeso indefinitamente.
Possibile causa: la pianificazione replica del contenuto è configurata per una breve durata. Ad esempio, 5 minuti.

NOTA:si consiglia di configurare la pianificazione replica del contenuto per 12 ore.

Azione: eseguire il login a Centro di controllo ZENworks, aggiungere una variabile di sistema della zona, enable.cdp.cleanup.thread.wait.time, e impostarne il valore su True.

L'azione di configurazione ha esito negativo con l'eccezione ZEN configure action container is not responding

Origine: ZENworks
Spiegazione: l'azione di configurazione viene completata con il seguente avviso:

com.novell.zenworks.configure.NonFatalConfigureException: ZEN configure action container is not responding

Possibile causa: questo problema si verifica poiché l'inizializzazione del container ZENConfigure non viene completata entro il tempo di attesa.
Azione: incrementare il tempo di attesa del container ZENConfigure mediante la proprietà di configurazione max-retries-for-configure-server=<numero di tentativi> nella directory /etc/opt/microfocus/zenworks/host-configure-action.properties. Il valore di default per max-retries-for-configure-server è 60.

NOTA:creare il file con la voce, se non esiste.