zac(1)
Name
zac - Interface de gestion de ligne de commande pour les satellites Linux Novell.
Syntaxe
zac command options
Description
L'utilitaire zac exécute des fonctions de gestion de ligne de commande sur les périphériques
ZENworks non gérés, y compris la configuration du satellite, ainsi que l'enregistrement du périphérique et sa suppression du registre.
Guide d'utilisation
La plupart des commandes possèdent une forme longue et une forme courte :
Forme longue : add-reg-key
Forme courte : ark
Quand l'utilisation des deux formes est possible, la commande est listée comme indiqué ci-après : add-reg-key (ark) options
Lorsque vous utilisez une commande, saisissez soit la forme longue, soit la forme courte : zac add-reg-key options zac ark options
Si une option inclut un espace, saisissez-la entre guillemets : zac ark "option 1"
Commandes d'aide
/? ou --help
Affiche l'aide du système.
COMMAND /?
Affiche la description d'une commande spécifiée.
/g ou --group
Affiche les commandes du groupe spécifié.
90
Référence des utilitaires de ligne de commande de ZENworks 10 Asset Management
Commandes de transfert en amont de collecte
collection-clients (crc)
Affiche les périphériques qui ont téléchargé des fichiers dans le cadre de cette collecte.
Exemple : zac crc
collection-queued (crq)
Affiche les fichiers collectés qui n'ont pas encore été transférés en amont.
Exemple : zac crq
collection-state (crs)
Affiche l'état en cours du rôle de collecte du satellite.
Exemple : zac crs
collection-upload-orphans (cuo)
Recherche les fichiers orphelins sur le périphérique satellite et les transfère en amont au serveur de collecte parent ou les supprime s'ils ont déjà été transférés en amont.
Cette commande crée une liste des fichiers dans les dossiers sous
/var/opt/novell/ zenworks/work/collection
(sauf pour le dossier collectionStatsDB
), puis essaie de rechercher les informations du téléchargement d'origine pour chaque entrée dans la base de données des statistiques de collecte.
Si une entrée existe dans la base de données pour un fichier et qu'elle indique que le fichier n'a pas été transféré en amont, alors, ce transfert est exécuté. Si l'entrée indique que le fichier a déjà
été transféré en amont, elle le supprime du périphérique satellite. En l'absence d'entrée dans la base de données, le fichier est transféré en amont. Cette commande répertorie également les fichiers qui n'ont pas été téléchargés ni supprimés.
Avant d'exécuter cette commande, vous devez exécuter la commande zac crw
pour envoyer les fichiers en attente au serveur parent.
Exemple : zac cuo
collection-wake (crw)
Envoie des fichiers collectés au serveur parent.
Exemple : zac crw
Commandes de distribution de contenu
distribution-info (cdi) [option]
Affiche les informations statistiques sur le rôle Contenu. Vous pouvez utiliser les options suivantes : all
: exécute toutes les options marquées d'un *.
Utilitaires de lignes de commande pour satellites Linux
91
ss
: affiche l'état sync *.
rs
: obtient la taille de l'espace de stockage du contenu *.
da
: répertorie les périphériques ayant récupéré des données de ce périphérique *.
ne
: obtient le nombre d'erreurs de distribution de contenu *.
ds
: obtient la taille des données traitées par ce périphérique *.
fs
: obtient le nombre de fichiers traités *.
ah [n]
: affiche n (toutes par défaut) entrées depuis l'historique d'accès.
ch
: efface l'historique.
eh <fichier>
: exporte l'historique d'accès dans le <fichier>, qui ne doit pas exister et dont le chemin d'accès est inclus.
Exemples : zac cdi zac cdi rs
distribution-state (cds)
Affiche l'état du rôle de contenu satellite. Affiche l'activation/désactivation du rôle, l'état
(Démarrage, Actif, Arrêt, Arrêté), les URL parentes et la planification de réplication.
Exemple : zac cds
distribution-wake (cdp) [replicate | cleanup]
Réveille le thread de travail du point de distribution de contenu. Vous pouvez utiliser l'une des options suivantes : replicate : télécharge tout nouveau contenu ou contenu modifié à partir du serveur ZENworks parent du point de distribution de contenu.
cleanup : supprime tout contenu qui ne doit plus être stocké sur le point de distribution de contenu.
Exemples : zac cdp zac cdp replicate
Commandes principales
get-settings (gs) <clé d'enregistrement>
Répertorie les paramètres effectifs associés à la clé d'enregistrement spécifiée.
Exemple : zac gs key1
get-pref (get) <nom de préférence>
Affiche les préférences actuellement définies.
Exemple d'affichage de toutes les préférences pouvant être définies : zac get-pref
Exemple d'affichage de toutes les préférences dont le nom commence par abc : zac get-pre abc
92
Référence des utilitaires de ligne de commande de ZENworks 10 Asset Management
set-pref (set) <nom de préférence> <valeur de préférence>
Définit la valeur d'une préférence.
Exemple de définition de la valeur de préférence abc sur 123 : zac set-pref abc 123
Commandes de création d'image
file-system-guid (fsg)
[-d] [-r]
Supprime et restaure le GUID du poste de travail dans le système de fichiers en vue de prendre une image.
Exemple de suppression du GUID du système de fichiers : zac file-system-guid -d
Exemple de restauration du GUID sur le système de fichiers : zac file-system-guid -r
Exemple d'impression de la valeur du GUID : zac fsg
Commandes de consignation
logger [resetlog | level [MANAGED|ERROR|WARN|INFO|DEBUG] |managedlevel
]
Modifie la configuration de l'enregistreur.
Vous pouvez utiliser les options suivantes : resetlog : réinitialise le journal.
level : si aucun niveau n'est spécifié, affiche le niveau de consignation géré actuel. Si un des niveaux est spécifié, celui-ci remplace le niveau de consignation précédent.
managedlevel : affiche le niveau de consignation géré actuel.
Exemple de réinitialisation du fichier journal : zac logger resetlog
Exemple d'affichage du niveau de consignation actuel : zac logger level
Exemple de définition du niveau de consignation sur DÉBOGAGE et supérieur : zac logger level DEBUG MANAGED
Commandes d'enregistrement
add-reg-key (ark) <clé d'enregistrement>
Enregistre le périphérique à l'aide de la clé spécifiée. L'enregistrement avec des clés est additif.
Si le périphérique a été enregistré au préalable avec une clé et que vous l'enregistrez avec une nouvelle clé, le périphérique reçoit toutes les assignations de groupes associées aux deux clés.
Exemple : zac ark key12
Utilitaires de lignes de commande pour satellites Linux
93
register (reg) [-k <key>] [-u <nom d'utilisateur> -p <mot de passe>] <adresse du serveur ZENworks:port>
Enregistre le périphérique dans une zone de gestion.
Exemples : zac reg -k key1 https://123.456.78.90
zac reg -k key1 -u administrator -p novell https:// zenserver.novell.com:8080
Le numéro de port est uniquement requis si le serveur ZENworks n'utilise pas le port HTTP standard (80). Si vous ne spécifiez pas de nom d'utilisateur ou de mot de passe, une invite apparaît vous permettant de les saisir.
reregister (rereg)[-u <nom_utilisateur> -p <mot_de_passe>] <nouveau guid>
Enregistre un périphérique dans la zone en cours et lui assigne le GUID d'un objet Périphérique existant. L'objet Périphérique actuellement sélectionné est supprimé.
Par exemple, si vous créez l'image d'un périphérique après avoir remplacé le disque dur, le périphérique est susceptible d'avoir un nouveau GUID. Par contre, grâce à la commande reregister, vous pouvez assigner le même GUID que celui que le périphérique avait avant que vous ne remplaciez le disque dur.
Exemples :
Vous devez spécifier un nom d'utilisateur et un mot de passe : zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4
Pour être invité à fournir un nom d'utilisateur et un mot de passe : zac reregister eaa6a76814d650439c648d597280d5d4
unregister (unr) [-f] [-u <nom d'utilisateur> -p <mot de passe>]
Supprime l'enregistrement du périphérique de la zone de gestion.
Exemple : zac unr -u administrator -p novell
Les paramètres
-f
,
-u
et
-p
sont facultatifs. Si vous n'utilisez pas les paramètres
-u
et
-p
, vous
êtes invités à saisir un nom d'utilisateur et un mot de passe. Le paramètre
-f
ignore la base de données ZENworks et force l'annulation de l'enregistrement local du périphérique. Cette option est nécessaire uniquement si l'objet Périphérique a déjà été supprimé de la base de données
ZENworks ou si le périphérique ne peut pas se connecter à la base.
Commandes de rôle de satellite
satellite-cachecfg (satcfg)
Lit les rôles de satellite à partir du cache.
Exemple : zac satcfg
satellite-clearcache (satcc)
Efface les informations de configuration satellite du cache.
94
Référence des utilitaires de ligne de commande de ZENworks 10 Asset Management
Exemple : zac satcc
satellite-refreshcfg (satrc)
Rafraîchit les rôles de satellite.
Exemple : zac satrc
satellite-roles (satr)
Signale les rôles de satellite actuels et leur état.
Exemple : zac satr
imgsatserver status (état iss)
Affiche les propriétés de rôle de création d'image du périphérique, y compris son état actuel, l'état du service PXE, les fichiers image et les statistiques de création d'image.
État actuel: indique si votre périphérique est actuellement configuré pour effectuer des opérations de création d'image. L'état en cours estActif lorsque le périphérique est promu au rang de satellite avec un rôle de création d'image.
État de service PXE: indique si le service Proxy DHCP est activé sur le périphérique.
Requêtes PXE : nombre de demandes de création d'images de toutes sortes qui ont été reçues par le serveur de création d'image depuis son dernier démarrage. Cela inclut les demandes qui n'ont pas abouti, qui ont été refusées ou qui faisaient référence à d'autres serveurs de création d'image. Les informations à propos de chacune de ces requêtes, telles que la source, le type, la date/l'heure et les résultats, sont enregistrées sur le serveur de création d'image.
Images envoyées : images que le serveur de création d'image a envoyées aux clients de création d'image depuis son dernier démarrage. Cela inclut uniquement les images qui ont été récupérées sur le serveur de création d'image.
Images reçues : nouvelles images reçues et stockées sur le serveur de création d'image depuis son dernier démarrage. Cela inclut les images reçues par l'intermédiaire des renvois du client.
Exemple : zac iss status
Commandes d'état
agent-properties (agp)
Fournit des informations sur l'agent adaptatif ZENworks. Les champs suivants fournissent des informations sur l'agent adaptatif ZENworks :
Adresse du périphérique. L'adresse IP de votre périphérique.
Nom du périphérique. Nom d'ordinateur de votre périphérique.
État du périphérique. État du périphérique (Géré, Non géré, Retiré ou Inconnu). L'état
Inconnu ne s'affiche qu'en cas d'erreur.
Dernier contact avec le serveur. Dernière fois que l'agent adaptatif a contacté le serveur
ZENworks.
Utilitaires de lignes de commande pour satellites Linux
95
Prochain contact avec le serveur. Prochain contact prévu entre l'agent adaptatif et le serveur
ZENworks.
Utilisateur primaire. Utilisateur actuellement logué.
cache-clear (cc)
Efface le cache ZENworks sur le périphérique. Cette opération supprime toutes les entrées dans la base de données du cache et efface tous les fichiers du cache associés avec ces entrées.
Exemple : zac cc
refresh (ref)[general | partial][bypasscache]
Initie un rafraîchissement général ou partiel pour tous les paramètres d'enregistrement et de configuration.
Pour ignorer le cache du serveur, transmettez l'option bypasscache à la commande zac ref
.
Exemples : zac ref general
zenhttp-status(zhs)
Permet de répertorier les ports et les étiquettes pour les gestionnaires enregistrés.
Exemple : zac zhs
zone-config (zc) [-l]
Affiche des informations au sujet du serveur ZENworks auquel le périphérique accède pour obtenir des informations de configuration (le serveur de configuration) ou affiche les informations du serveur de configuration.
Exemples : zac zc zac zc -l
Auteurs
Copyright 2009, Novell, Inc. Tous droits réservés. http://www.novell.com
96
Référence des utilitaires de ligne de commande de ZENworks 10 Asset Management
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 Novell
®
ZENworks
®
:
« Impossible d'enregistrer le rapport sur SLES 10 SP1 à l'aide de la commande zman rpgn » page 98
« Les commandes zman ne fonctionnent pas pour les utilisateurs non root sur un serveur
zman se fige lorsque la sortie d'une commande est redirigée vers un fichier via des opérateurs de redirection de ligne de commande tels que > ou >>
Source : ZENworks 10 Asset Management; 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.
Action : spécifiez les références au sein de la commande grâce aux options
-U|--User et
-P|--Password
.
Action : stockez les références à l'aide de la commande admin-store-credential
, puis exécutez la commande.
Action : 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-staginggroup-create.
Source : ZENworks 10 Asset Management, zman.
Explication : zman affiche le message incorrect suivant si l'argument facultatif du nom de groupe provisoire n'est pas transmis à la commande system-updatestaging-group-create
:
Successfully created the object "null"
3
Dépannage des utilitaires de ligne de commande ZENworks
97
Action : 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.
Impossible d'enregistrer le rapport sur SLES 10 SP1 à l'aide de la commande zman rpgn
Source : ZENworks 10 Asset Management; zman.
Opération : aucune.
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 10 Asset Management; 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.
Action : 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 serverrefresh|srf
.
Sur le périphérique géré, cliquez avec le bouton droit sur l'icône , puis cliquez sur Rafraîchir.
Les commandes zman ne fonctionnent pas pour les utilisateurs non root sur un serveur ZENworks Linux.
Source : ZENworks 10 Asset Management; 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
.
Action : 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 racine
.
2 À l'invite de la console du serveur, exécutez la commande suivante : useradd -G zmanusers non-rootusername
3 Loguez-vous au serveur ZENworks en tant qu'utilisateur non root
.
98
Référence des utilitaires de ligne de commande de ZENworks 10 Asset Management
Conseils d'utilisation de zman
Suivez ces conseils lorsque vous travaillez avec l'utilitaire de ligne de commande zman de Novell
®
ZENworks
®
10 Asset Management :
Si un fichier XML exporté à l'aide d'une commande zman telle que bundle-create
ou policy-create
contient des caractères ASCII étendus ou diacritiques, par exemple ñ, ë ou Ä, vous devez ouvrir le fichier dans un éditeur avec le codage UTF-8. Si vous apportez des modifications au fichier, vous devez l'enregistrer au format UTF-8.
Si vous voulez rediriger la sortie d'une commande contenant des caractères ASCII étendus vers un fichier Windows
*
, vous ne devez pas utiliser l'opérateur de redirection de ligne de commande (>). En effet, la page de code d'une invite MS-DOS
*
est différente de celle utilisée pour écrire dans les fichiers et ce, pour la plupart des langues.
Par exemple, pour des langues d'Europe occidentale telles que l'anglais, le français, l'allemand ou l'espagnol, la page de code de l'invite DOS est cp437 ou cp850, alors que le reste du système d'exploitation Windows utilise cp1252.
Pour rediriger la sortie vers un fichier et conserver les caractères ASCII étendus, utilisez l'option globale
-R|--Redirect
.
Quand vous vous connectez à des serveurs Linux depuis une machine Windows à l'aide de clients tels que PuTTY, vous devez définir le jeu de caractères utilisé pour la conversion en
UTF-8. Les caractères autres que les caractères ASCII standard sont alors correctement convertis.
Pour définir la conversion au format UTF-8 du jeu de caractères dans PuTTY :
1. Ouvrez le client PuTTY.
2. Dans la fenêtre de configuration de PuTTY, cliquez sur Window > Translation
(conversion).
3. Dans la liste déroulante Received Data Assumed to be in Which Character Set (Les
données reçues doivent être dans le jeu de caractères), sélectionnez UTF-8.
Remarque : cette démarche n'est pas nécessaire si les entrées ou les sorties de commandes contiennent uniquement les caractères a-z ou A-Z.
zman utilise normalement la langue par défaut du serveur. Vous pouvez paramétrer zman pour qu'il utilise une langue spécifique :
Sous Windows, spécifiez la langue appropriée pour l'utilisateur, ainsi que le type de codage des fichiers, sous forme de valeur pour la propriété JVM_STARTUP_OPTIONS dans
Répertoire_Installation_ZENworks\Novell\ZENworks\conf\zman
\properties\zman-config.properties
.
Ainsi, pour exécuter zman en anglais, définissez la valeur de
JVM_STARTUP_OPTIONS
sur
-Duser.language=en -Dfile.encoding=cp850
. Après avoir modifié le fichier, remplacez la page de code de l'invite de commande par cp850
à l'aide de la commande chcp 850
.
Sous Linux, modifiez
/opt/novell/zenworks/bin/zman
pour ajouter
-Duser.language=<langue> après/opt/novell/zenworks/lib/java/bin/java
.
4
Conseils d'utilisation de zman
99
Par exemple, pour exécuter zman en anglais, modifiez le fichier de script de zman comme suit :
/opt/novell/zenworks/lib/java/bin/java -Duser.language=en -
Djava.library.path="${LD_LIB_PATH}" .....
100 Référence des utilitaires de ligne de commande de ZENworks 10 Asset Management
Public link updated
The public link to your chat has been updated.