3.0 Dépannage des utilitaires de ligne de commande ZENworks

Les sections suivantes décrivent les solutions aux problèmes susceptibles de se produire lorsque vous travaillez avec les utilitaires de ligne de commande Micro Focus ZENworks :

zman attend lorsque le contenu sortant d'une commande est redirigé vers un fichier à l'aide des opérateurs de transfert de ligne de commande comme > ou >>

Source : ZENworks ; zman.
Cause possible : zman a besoin du nom d'utilisateur et du mot de passe de l'administrateur ZENworks pour exécuter chaque commande. Si les références ne sont pas fournies avec la commande, vous êtes invité à les saisir. Par contre, si la sortie de la commande est redirigée vers un fichier, vous n'êtes pas invité à saisir les références : les invites de saisie du nom d'utilisateur et du mot de passe sont en effet également redirigées vers le fichier. zman se fige donc et attend que les références soient saisies.
Opération : Spécifiez les références comme faisant partie intégrante de la commande à l'aide des options -U|‑‑User et -P|‑‑Password.
Opération : Enregistrez les références à l'aide de la commande admin-store-credential, puis exécutez la commande.
Opération : Redirigez la sortie vers un fichier à l'aide de l'option -R|‑‑Redirect au lieu d'un opérateur de réacheminement tel que > ou >>.

Un message de réussite s'affiche à tort lorsque l'argument facultatif « nom de groupe provisoire » n'est pas transmis à la commande system-update-staging-group-create

Source : ZENworks ; zman.
Explication : zman affiche le message incorrect suivant si l'argument facultatif du nom de groupe provisoire n'est pas transmis à la commande system-update-staging-group-create : 
Successfully created the object "null"
Opération : Pour afficher la liste des groupes provisoires, y compris celui qui vient d'être créé, exécutez la commande system-update-staging-group-list (susgl) à l'invite de la console.

Le rôle de création d'image ajouté à un satellite à l'aide de la commande zman ssaimg n'est pas appliqué immédiatement au serveur

Source : ZENworks ; zman.
Explication : Si vous configurez le rôle Création d'image à l'aide de la commande zman ssaimg, le rôle est immédiatement ajouté au périphérique. Si le rôle n'est pas ajouté immédiatement, il ne le sera que lors du rafraîchissement suivant du périphérique.
Opération : Si vous voulez appliquer immédiatement le rôle au périphérique, vous devez rafraîchir manuellement ce dernier en procédant de la façon suivante :

  • À l'invite de commande, exécutez zman workstation-refresh|wrf. Si le périphérique géré est un serveur, exécutez zman server-refresh|srf.

  • Sur le périphérique géré, cliquez avec le bouton droit sur l'icône ZENworks, puis cliquez sur Rafraîchir.

Les commandes zman ne fonctionnent pas pour les utilisateurs non root sur un serveur ZENworks Linux

Source : ZENworks ; zman.
Explication : Si un utilisateur non root exécute les commandes zman sur un serveur ZENworks Linux, le message d'erreur suivant s'affiche :

Vous ne disposez pas des privilèges suffisants pour exécuter des commandes zman. En tant qu'utilisateur non root dans Linux, vous devez faire partie du groupe zmanusers pour exécuter des commandes zman.

Opération : Ajoutez l'utilisateur non-root au groupe zmanusers avant d'exécuter les commandes zman.

  1. Connectez-vous au serveur ZENworks en tant qu'utilisateur root.

  2. À l'invite de la console du serveur :

    • Si l'utilisateur existe déjà sur le périphérique Linux, exécutez la commande suivante :

      groupmod -A nom_utilisateur_non-root zmanusers

    • Si l'utilisateur n'existe pas sur le périphérique Linux, exécutez la commande suivante :

      useradd -G zmanusers nom_utilisateur_non-root

  3. Connectez-vous au serveur ZENworks en tant qu'utilisateur non-root.

Un utilisateur non-root ne peut pas configurer de rôle de satellite à l'aide de la commande zman ssc

Source : ZENworks ; zman.
Explication : Si un utilisateur non-root tente de configurer un rôle de satellite à l'aide de la commande zman ssc sur un serveur Linux primaire, le message d'erreur suivant s'affiche : 
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
Opération : procédez comme suit :

  1. Vérifiez que l'utilisateur non-root a bien été ajouté au groupe zmanusers.

    1. Connectez-vous au serveur ZENworks en tant qu'utilisateur root.

    2. À l'invite de la console du serveur :

      • Si l'utilisateur existe déjà sur le périphérique Linux, exécutez la commande suivante :

        groupmod -A nom_utilisateur_non-root zmanusers

      • Si l'utilisateur n'existe pas sur le périphérique Linux, exécutez la commande suivante :

        useradd -G zmanusers nom_utilisateur_non-root

  2. Ajoutez l'utilisateur non-root au groupe d'utilisateurs ZENworks à l'aide de la commande usermod -A nom_utilisateur_non-root. L'utilisateur non-root peut alors configurer des rôles de satellite.

La commande zac cuo ne télécharge pas les fichiers d'audit de l'agent depuis le serveur satellite vers le serveur primaire lorsque la base de données collectionStatsDB est corrompue.

Source : ZENworks ; zac.
Explication : Lorsque les fichiers d'audit d'agent sont téléchargés sur le serveur satellite, le serveur conserve les références aux fichiers d'audit dans la base de données collectionStatsDB. Si la base de données est corrompue, toutes les références sont perdues et les fichiers deviennent orphelins. Dès lors, lorsque vous exécutez la commande zac cuo pour télécharger les fichiers d'audit de l'agent sur le serveur primaire, vous recevez une erreur.
Opération : Pour télécharger les fichiers d'audit de l'agent sur le serveur primaire, vous devez exécutez la procédure suivante sur le serveur satellite.

  1. Arrêtez le service d'agent.

  2. Supprimez le dossier /var/opt/novell/zenworks/work/collection/collectionStatsDB qui comporte des références aux fichiers d'audit orphelins.

  3. Démarrez le service d'agent.

  4. Exécutez la commande zac cuo.

Certaines commandes zman échouent avec une erreur OutOfMemory

Source : ZENworks ; zman.
Explication : Certaines commandes zman risquent d'échouer avec une erreur OutOfMemory.
Opération : Augmentez la taille de tas maximale pour zman :

Windows : dans le fichier %ZENWORKS_HOME%\conf\zman\properties\zman-config.properties, augmentez la valeur de la taille de tas maximale de l'élément JVM_STARTUP_OPTIONS de 128 Mo à 512 Mo.

Linux : dans le fichier /opt/novell/zenworks/bin/zman, augmentez la taille de segment maximale de l'élément MEM_OPTS de 256 Mo à 512 Mo.

La commande zman ssd permettant de supprimer un rôle de satellite échoue

Source : ZENworks ; zman
Explication : La commande zman ssd échoue et le message d'erreur suivant s'affiche :

Il s'est produit une erreur interne. Pour plus d'informations, consultez le journal zman.

La commande zman ssd qui permet de supprimer un rôle du satellite, supprime le rôle mais ne parvient pas à envoyer la tâche permettant un rafraîchissement rapide du satellite.

Cause possible : En effet, cette tâche est déjà en cours de traitement ou sur le point d'être traitée.
Opération : Aucune

Les commandes zac se bloquent sur les serveurs satellites RHEL lorsque la planification de réplication du contenu est configurée pour une courte durée

Source : ZENworks ; zac
Explication : Lorsque vous exécutez des commandes zac sur un serveur satellite RHEL, le processus se bloque indéfiniment.
Cause possible : La planification de réplication du contenu est configurée pour une courte durée. Par exemple, 5 minutes.

REMARQUE :il est recommandé de configurer la planification de réplication du contenu pour 12 heures.

Opération : Connectez-vous au centre de contrôle ZENworks, ajoutez une variable système de zone, enable.cdp.cleanup.thread.wait.time, puis définissez la valeur sur True.