Utilitaires de lignes de commande pour satellites Linux
La section suivante fournit des informations sur les utilitaires de ligne de commande pour les satellites Linux :
« zac(1) » page 90
2
Utilitaires de lignes de commande pour satellites Linux
89
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