zac pour Linux (1)

Name

zac - Interface de gestion de ligne de commande de l'agent Micro Focus ZENworks installé et exécuté sur des périphériques gérés Linux.

Syntaxe

zac command options

Description

L'utilitaire zac effectue les fonctions de gestion de ligne de commande sur le périphérique géré ZENworks, y compris l'installation et la suppression d'ensembles logiciels, l'application de stratégies et l'enregistrement et l'annulation de l'enregistrement du périphérique.

Guide d'utilisation

Cette section présente la mise en forme et les conventions adoptées pour les commandes générales.

La plupart des commandes possèdent une forme longue et une forme courte :

  • Forme longue : add-reg-key
  • Forme courte : ark

Lorsque les deux formes sont disponibles, la commande est répertoriée comme suit :

add-reg-key (ark)options

Lorsque vous utilisez la commande, ne saisissez que sa forme longue ou sa forme courte :

zac add-reg-key options

zac ark options

Si une option comprend un espace, faites-le apparaître entre guillemets :

zac ark "option 1"

Arguments obligatoires et facultatifs

Les arguments entre parenthèses ( ) sont obligatoires, tandis que ceux entre crochets [ ] sont facultatifs.

Points de suspension (…)

Les points de suspension indiquent qu'une commande accepte plusieurs entrées du type du dernier argument. Les arguments doivent être séparés par un espace ou par une virgule, selon la commande. Par exemple :

zac <commande> [options] (serveur) (ensemble) [...]

Les points de suspension indiquent que <commande> peut accepter plusieurs ensembles. Dans l'aide au niveau de la commande, l'aide de l'argument à plusieurs entrées est fournie sous la forme [(ensemble) (ensemble) ... (ensemble)] pour plus de clarté.

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é.

Commandes de serveur satellite d'authentification

authentication server reconfigure (asr) [-t all|config|jetty|casa] [-u nom_utilisateur] [-p mot_de_passe]

Reconfigure un satellite d'authentification activé.

Exemples :

Pour récupérer les fichiers de configuration du serveur :

zac asr -t config

Pour reconfigurer le certificat de signature CASA :

zac asr -t casa

Pour reconfigurer le serveur Web Jetty :

zac asr -t jetty -u Administrateur -p mot de passe

Pour reconfigurer tout le satellite :

zac asr -t all -u Administrateur -p mot de passe

Si vous n'indiquez pas votre nom d'utilisateur et votre mot de passe sur la ligne de commande alors que ceux-ci sont requis, vous serez invité à les entrer.

import-authentication-cert(iac)[-pk <clé_privée.der>] [-c <certificat_serveur_signé.der>] [-ca <certificat_public_autorité_signature.der>] [-ks <keystore.jks>] [-ksp <phrase_secrète_keystore>] [-a <alias_certificat_signé>] [-ks <phrase_secrète_certificat_signé>] [-u nom_utilisateur] [-p mot_de_passe] [-rc]

Configure un périphérique satellite d'authentification avec des certificats signés en externe.

  • rc : confirme la reconfiguration du serveur satellite d'authentification pour que l'administrateur ne soit plus invité à procéder à la reconfiguration.

Chaque satellite doit avoir un certificat de serveur et une clé privée qui lui sont propres. Pour plus d'informations sur la génération de certificats externes, reportez-vous au manuel ZENworks Server Installation Guide (Guide d'installation du serveur ZENworks).

Commandes d'ensemble

bundle-install (bin) [options] [nom_de_l'ensemble | GUID | Modèle]

Installe les ensembles spécifiés selon le nom d'affichage qui correspond à l'expression ou la chaîne régulière ou au GUID d'ensemble. Utilisez la commande bundle-list pour obtenir une liste des ensembles disponibles et leurs noms d'affichage.

Les expressions régulières suivantes sont prises en charge :

Expression normale

Fonction

^abc

Correspond à une chaîne commençant par « abc ».

[abc]

Correspond à une chaîne contenant « a », « b » ou « c ».

a*c

Correspond à zéro « a » ou plus suivi(s) de « c », « ac », « aac », « aaac » ou « c ».

Accepte les options suivantes :

  • -N,‑‑dryrun : teste et affiche, mais n'effectue pas l'opération demandée. Vous ne pouvez procéder qu'une seule fois à une exécution directe sur une version d'ensemble. Cette option s'applique uniquement aux opérations d'installation de RPM de l'ensemble.

Exemple pour installer un ensemble en fonction de son nom :

zac bin bundle1

bundle-launch (bln) [nom d'affichage de l'ensemble] [-noSelfHeal]

Lance l'ensemble spécifié. Les opérations de l'ensemble d'opérations de lancement sont exécutées.

Si vous tentez de lancer un ensemble qui n'est pas encore installé, ce dernier est d'abord installé puis lancé.

Utilisez la commande bundle-list pour obtenir une liste des ensembles disponibles et leurs noms d'affichage.

Exemple pour lancer un ensemble en fonction de son nom d'affichage :

zac bln bundle1

Exemple pour lancer un ensemble en fonction de son nom d'affichage en désactivant l'auto-dépannage si l'opération de lancement échoue (l'auto-dépannage est activé par défaut) :

zac bln bundle1 -noSelfHeal

bundle-list (bl) [options]

Affiche la liste des ensembles assignés au périphérique et à l'utilisateur connecté.

Le résultat de cette commande s'affiche en colonnes et fournit les détails de chaque ensemble assigné ou disponible pour le périphérique géré. Les colonnes Nom d'affichage, Version et Type d'ensemble représentent respectivement le nom d'affichage, le numéro de version de l'ensemble ou du sandbox si l'ensemble est une version en sandbox, ainsi que le type d'ensemble. La colonne État affiche les états suivants :

  • Disponible : affiche cet état si l'ensemble est installé.
  • Non installé : affiche cet état si la version particulière de l'ensemble n'est pas installée.
  • Téléchargé : affiche cet état si le contenu est téléchargé mais que l'opération dans l'ensemble d'opérations d'installation n'a pas été exécutée.

Cette commande accepte les options suivantes :

  • -a, ‑‑all : répertorie les ensembles filtrés et non filtrés. Les ensembles filtrés sont des ensembles de chaînes. Par défaut, les ensembles non filtrés sont affichés.
  • -g, ‑‑show-guid : affiche le GUID de l'ensemble.

Exemple pour répertorier tous les ensembles :

zac bl -a

bundle-lock-add (bla) [options] [nom ensemble] [[relation] […]

Verrouille les ensembles spécifiés qui correspondent à l'expression ou chaîne régulière indiquée pour empêcher leur mise à niveau ou leur suppression.

Les expressions régulières suivantes sont prises en charge :

Expression normale

Fonction

^abc

Correspond à une chaîne commençant par « abc ».

[abc]

Correspond à une chaîne contenant « a », « b » ou « c ».

a*c

Correspond à zéro « a » ou plus suivi(s) de « c », « ac », « aac », « aaac » ou « c ».

Accepte les options suivantes :

  • -li, ‑‑lock-install : verrouille l'ensemble et empêche l'installation de l'ensemble spécifié dans le verrou.

REMARQUE :les verrous d'ensembles ne sont applicables que pour l'ensemble d'opérations d'installation.

  • -t, ‑‑type : spécifiez le type d'ensemble à verrouiller. Les types disponibles sont Linux et Correctif. Si aucun type n'est spécifié, le type Ensemble est sélectionné.
bundle-lock-list (bll)

Répertorie les verrous d'ensembles. Les verrous d'ensembles sont triés par numéro ID.

Exemple :

zac bll

bundle-lock-remove (blr) [options] [bundleindex] […]

Supprime le verrou de l'ensemble spécifié par le numéro. Vous pouvez trouver le numéro de chaque verrou grâce à la commande bundle-lock-list (bll).

Accepte les options suivantes :

  • -n : supprime les verrous d'ensembles spécifiés par nom. Assurez-vous que le nom ne contient aucun modèle.
  • ‑‑remove-all : supprime tous les verrous d'ensembles.

Exemple pour supprimer un verrou d'ensemble abc :

zac blr -n abc

Exemple pour supprimer tous les verrous d'ensembles :

zac blr ‑‑remove-all

bundle-refresh (br) [nom d'affichage de l'ensemble | GUID]

Rafraîchit les informations sur l'ensemble spécifié.

Exemple :

zac br bundle1

bundle-search (bse) [options] pattern

Recherche des ensembles qui correspondent à une chaîne ou une expression régulière spécifiée.

Les expressions régulières suivantes sont prises en charge :

Expression normale

Fonction

a+bc

Correspond à un ou plusieurs « a » suivi de « bc ».

Correspond, par exemple, à un ou plusieurs « a » suivis de « abc » ou « aabc ».

[a-z]\*

Correspond à la chaîne vide et aux chaînes dont les noms ne contiennent que des caractères alphabétiques.

Correspond, par exemple, à la chaîne vide "" ou aux chaînes de type abc et xyz comportant uniquement des caractères alphabétiques.

a*bc

Correspond à zéro « a » ou plus suivi(s) de « bc ».

Correspond, par exemple, à zéro « a » ou plus suivi de « abc », « aabc », « aaabc » ou « bc ».

Le résultat de cette commande est semblable à celui de la commande zac bl.

Accepte les options suivantes :

  • -i,‑‑installed-only - Ne recherche que la liste des ensembles installés.
bundle-uninstall (bu) [nom d'affichage de l'ensemble | GUID]

Désinstalle l'ensemble spécifié. Les opérations qui prennent en charge l'opération d'annulation sont exécutées lors de la désinstallation de l'ensemble. Une fois la désinstallation de l'ensemble terminée, l'état de l'ensemble affiché est Non installé.

Utilisez la commande bundle-list pour obtenir une liste des ensembles installés et leurs noms d'affichage.

Exemple :

zac bu bundle1

bundle-verify (bv) [nom d'affichage de l'ensemble]

Réinstalle l'ensemble et exécute les ensembles d'opérations de vérification pour garantir qu'aucun fichier n'a été supprimé ou corrompu. Utilisez la commande bundle-list pour obtenir une liste des ensembles installés et leurs noms d'affichage.

Exemple :

zac bv bundle1

Commandes de certificat

cert-info (ci) [chemin du fichier du certificat ca] [-u <nom_utilisateur> -p <mot_de_passe>]

Répertorie les informations de certificat de clé publique pour chaque serveur ZENworks connu ou ajoute un certificat racine approuvé à la zone de stockage approuvée de périphériques. Le fichier peut être au format ASN.1 DER ou codé en base 64 délimité par --‑‑BEGIN CERTIFICATE---- et --‑‑END CERTIFICATE--.

Exemple :

Pour répertorier le certificat de chaque serveur ZENworks connu :

zac ci

Pour ajouter un certificat racine approuvé à la zone de stockage de périphériques approuvée :

zac ci c:\certs\mytrustcacert.der -u myuser -p mypassword

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-point (cp)

Affiche l'état et la configuration du rôle de collecte.

Exemple :

collection-point [wake]

wake - Réveille les modules qui effectuent la collecte (inventaire, état MD, expéditeur de message)

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

cdp-checksum (cchk) [-l:<chemin d'accès au journal>]

Valide le contenu du satellite en calculant la somme de contrôle sur chaque fichier.

Le fichier journal optionel détaille les résultats de la comparaison de ces sommes de contrôle.

Exemple :

zac cchk -l:"/var/opt/novell/zenworks/logs/cchk.log"

cdp-verify-content (cvc) [-c] [-l:<chemin d'accès au journal>]

Compare la liste des ID de contenu et leur état de synchronisation sur ce CDP avec les valeurs attendues par les serveurs primaires.

Vous pouvez utiliser les options suivantes :

  • c - Effectue la somme de contrôle sur le contenu local.

Exemple :

zac cvc -l:"/var/opt/novell/zenworks/logs/cvc.log"

cdp-import-content (cic) <chemin d'accès au contenu> [<chemin d'accès au journal>]

Importe le contenu manquant depuis le répertoire spécifié par <chemin d'accès au contenu>, avec consignation des messages dans le fichier spécifié par <chemin d'accès au journal>.

Exemple :

zac cic /usr/répertoire_contenu /var/opt/novell/zenworks/logs/cic.log

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 *.
  • 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 des serveurs parents 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 contenu nouveau ou modifié à partir du serveur ZENworks parent du point de distribution de contenu.
  • cleanup : supprime tout contenu qui ne devrait plus être conservé sur le point de distribution de contenu.

Exemples :

zac cdp

zac cdp replicate

Commandes principales

get-settings (gs) <clé>

Les paramètres sont téléchargés par le module de paramètres dans le cache local à chaque rafraîchissement. Cette opération renvoie les paramètres effectifs associés à la clé donnée.

Exemple :

zac gs key1

Exemple de liste des paramètres de gestion à distance :

zac gs RemoteManagement

Toutes les clés de paramètres ZENworks valides sont stockées dans le répertoire /var/opt/novell/zenworks/zmd/cache/settings/.

get-pref (get) <nom de préférence>

Affiche les préférences actuellement définies.

Exemple pour afficher toutes les préférences définies :

zac get-pref

Exemple d'affichage de toutes les préférences dont le nom commence par abc :

zac get-pre abc

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

REMARQUE :si vous souhaitez configurer un serveur proxy pour un périphérique géré, assurez-vous que les préférences proxy-host et proxy-port sont configurées sur ce dernier. Si le serveur proxy nécessite une authentification, les préférences proxy-username et proxy-password doivent aussi être configurées sur le périphérique géré.

set-proxy (sp) [options] <adresse_IP/nom_hôte:port>

Spécifie un proxy à contacter plutôt que de contacter directement le serveur ZENworks.

Les options sont les suivantes :

  • ‑‑default : paramétrez un proxy qui peut être neutralisé par des paramètres de proxy provenant de la zone de gestion.
  • ‑‑clear : supprime le proxy actuel, mais utilise ensuite des paramètres de proxy provenant de la zone de gestion.

Exemples :

IPv4 :

zac sp 123.456.78.90:2349 administrator novell

zac sp /default 123.456.78.90:2349

zac sp /clear

Si le nom d'utilisateur et le mot de passe ne sont pas spécifiés, vous serez invité à les entrer.

Commandes de mise à jour système

zac zeus-refresh / zeus-ref

Récupère la mise à jour système lorsqu'elle est assignée à un périphérique.

Commandes de service externe

Ces commandes permettent de gérer les services externes.

external-service-add (esa) ‑‑type (type) (URL) (Nom du service) [Propriétés]

Ajoute des espaces de stockage de paquetages externes comme YUM, ZYPP ou le répertoire Local qui contient les RPM. Toutes les propriétés spécifiques au type doivent commencer par -D.

Vous pouvez répertorier les types de service que vous pouvez ajouter à l'aide de la commande zac est.

Elle prend en charge les types suivants :

  • YUM : ajoute un espace de stockage de type YUM. Accepte les propriétés suivantes :

    • -Dusername=valeur -Dpassword=valeur : cette propriété est facultative et est utilisée lors de l'ajout d'un espace de stockage YUM authentifié.
    • -DsyncExternal=vrai : cette propriété est facultative et est utilisée pour la synchronisation avec l'outil de gestion locale des paquetages.

    Par exemple, exécutez la commande suivante pour ajouter un type de service YUM :

    zac esa ‑‑type YUM -Dusername=nom_utilisateur -Dpassword=mot_de_passe https://nu.novell.com/sles11 sles11-yum-repo

  • ZYPP : ajoute un espace de stockage de type ZYPP. Accepte les propriétés suivantes :

    • -DsyncExternal=vrai : cette propriété est facultative et est utilisée pour la synchronisation avec l'outil de gestion locale des paquetages.

    Par exemple, exécutez la commande suivante pour ajouter un type de service ZYPP :

    zac esa ‑‑type ZYPP http://zypp.source.com/sles11/x86_64 sles11-zypp-repo

  • Mount : ajoute un espace de stockage de type Mount. Un type Mount ajoute un service du répertoire Local qui contient les RPM. Accepte les propriétés suivantes :

    • -Drecursive=(Valeur) : cette propriété est facultative. Les valeurs valides sont true ou false. Si la valeur est true, les RPM sont ajoutés de manière récursive depuis tous les répertoires sous le chemin d'accès absolu spécifié.
    • -DsyncExternal=vrai : cette propriété est facultative et est utilisée pour la synchronisation avec l'outil de gestion locale des paquetages.

    Par exemple, exécutez la commande suivante pour ajouter des paquetages de manière récursive depuis tous les répertoires à l'aide du type de service Mount :

    zac esa ‑‑type mount -Drecursive=true file:///mnt/sles11-cd/i586 sles11-rpms

REMARQUE :les services ZYPP ou Mount ne sont pas synchronisés avec l'outil de gestion des paquetages YUM sur les périphériques Red Hat.

external-service-delete (esd) (index | nom | url | ‑‑all)

Supprime les services externes spécifiés.

L'option ‑‑all supprime tous les services externes.

external-service-list (esl)

Répertorie tous les services externes.

La colonne Source affiche les agents ZENworks ajoutés à l'aide de la commande zac ainsi que le serveur ZENworks ajouté via une stratégie de service externe.

La colonne État indique si le service externe est actif ou inactif. Vous ne pouvez pas rafraîchir les services externes qui affichent un état Inactif.

La colonne État indique si le service externe est activé ou désactivé.

external-service-refresh (esr) (index | nom | url | ‑‑all)

Rafraîchit les services externes spécifiés.

L'option ‑‑all rafraîchit tous les services.

external-service-state (ess) (enable | disable) (index | nom | url | ‑‑all)

Active ou désactive les services externes spécifiés.

L'option ‑‑all modifie l'état de tous les services.

external-service-types (est)

Répertorie les types de service disponibles.

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 d'inventaire

inventory (inv) [scannow | cdf]

Exécute une analyse d'inventaire ou ouvre le formulaire des données de collecte.

Exemple d'exécution d'une analyse d'inventaire :

zac inv scannow

Exemple d'ouverture du formulaire de données de collecte :

zac inv cdf

Commandes pour les agents Inventaire uniquement

Ces commandes ne sont utilisées que pour les agents Inventaire uniquement (IOA).

zac ioa cfg <adresse IP de serveur>

Configure le périphérique IOA Linux sur l'adresse IP de serveur mentionnée.

Exemple d'exécution d'une analyse d'inventaire uniquement :

zac ioa cfg 10.70.13.124

zac ioa version

Affiche la version de l'agent Inventaire uniquement.

inventory (inv) [scannow]

Exécute une analyse d'inventaire.

Exemple pour l'exécution d'une analyse d'inventaire :

zac inv scannow

Commandes de gestion des utilisateurs locaux

Ces commandes servent à gérer les utilisateurs locaux et leurs privilèges.

user-add (ua) (nom_utilisateur)

Ajoute un utilisateur local à la zone de stockage de privilèges ZENworks.

Exemple :

zac ua nom_utilisateur

user-delete (ud) (nom_utilisateur)

Supprime un utilisateur local de la zone de stockage de privilèges ZENworks.

Exemple :

zac ud nom_utilisateur

user-list (ul)

Répertorie les éléments suivants :

  • - Noms d'utilisateur et privilèges des utilisateurs locaux ajoutés à la zone de stockage de privilèges ZENworks.
  • - Privilèges des utilisateurs locaux non ajoutés à la zone de stockage de privilèges ZENworks (utilisateur par défaut). L'utilisateur par défaut est représenté par * (astérisque).

Exemple :

zac ul

user-edit (ue) (nom_utilisateur) [+/-Privilège]

Modifie les privilèges de l'utilisateur local. Utilisez + (plus) pour ajouter un privilège et - (moins) pour supprimer un privilège existant.

Par défaut, un utilisateur local récemment créé dispose du privilège Afficher. Les utilisateurs locaux non ajoutés à la zone de stockage héritent du privilège assigné à l'utilisateur par défaut représenté par * (astérisque). Vous pouvez modifier les privilèges assignés à n'importe quel utilisateur local et attribuer les privilèges suivants à l'utilisateur :

Privilège

Fonction

Afficher

Afficher ou répertorier les informations sur les ensembles, stratégies, configuration, etc.

Installez

Installer ou désinstaller des ensembles, stratégies, paquetages, etc.

Configurer

Exécuter les commandes de configuration.

Superutilisateur

Exécuter toutes les commandes zac car tous les privilèges sont assignés à un superutilisateur. Par défaut, le privilège Superutilisateur est assigné à l'utilisateur root, qui ne peut pas être modifié.

Exemples :

si vous souhaitez autoriser les utilisateurs locaux de la zone de stockage de privilèges ZENworks à afficher, installer et désinstaller des ensembles ainsi que des stratégies, vous pouvez assigner les privilèges Afficher et Installer à ces utilisateurs en exécutant la commande suivante :

zac ue nom_utilisateur +Installer

Si vous souhaitez autoriser les utilisateurs locaux qui n'ont pas été ajoutés à la zone de stockage de privilèges ZENworks à afficher, installer et désinstaller des ensembles ainsi que des stratégies, vous pouvez assigner les privilèges Afficher et Installer à l'utilisateur * en exécutant la commande suivante :

zac ue '*' +Installer

user-privilege-export (upe) (nom_fichier_.xml)

Exporte une liste d'utilisateur locaux et de leurs privilèges vers un fichier .xml afin de la réutiliser sur d'autres périphériques gérés.

Exemple :

zac upe /tmp/privilèges.xml

Après avoir exporté la liste, vous pouvez l'importer sur d'autres périphériques gérés en exécutant la commande user-privilege-import (upi).

user-privilege-import (upi) (nom_fichier_.xml)

Importe une liste d'utilisateurs locaux ainsi que de leurs privilèges vers d'autres périphériques gérés à partir d'un fichier .xml spécifié. Cette liste peut être exportée vers le fichier .xml en exécutant la commande user-privilege-export (upe).

Exemple :

zac upi /tmp/privilèges.xml

Commandes relatives à l'emplacement

config-location (cl)

Affiche l'emplacement de configuration. L'emplacement de configuration détermine le ou les serveurs ZENworks auxquels le périphérique se connecte à des fins d'authentification, de configuration, de contenu et de collecte.

Exemples :

zac config-location

zac cl

Commandes de consignation

logger [resetlog | level [GÉRÉ|ERREUR|AVERTISSEMENT|INFO|DÉBOGAGE] |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 global de la zone.

Exemple de réinitialisation du fichier journal :

zac logger resetlog

Exemple d'affichage du niveau de consignation actuel :

zac logger level

Exemple de paramétrage du niveau de log à DEBUG et au-dessus :

zac logger level DEBUG

Commandes de gestion des paquetages

checkpoint-add (cpa) (nom) [date]

Ajoute un point de contrôle. Si la date n'est pas indiquée, ajoute un point de vérification avec la date du jour.

checkpoints-list

Répertorie les points de contrôle enregistrés.

checkpoint-remove (cpr) (nom) […]

Supprime les points de contrôle spécifiés.

dist-upgrade (dup) [options] [nom de l'ensemble|nom du service] […]

Effectue une mise à niveau de distribution. Cette commande effectue une mise à jour de tous les paquetages avec un algorithme résolveur spécifique qui prend en charge les modifications d'architecture et les divisions de paquetages, les mises à jour de modèles et de produits, etc. Si aucun argument n'est spécifié, les paquetages de tous les services externes et ensembles ZENworks sont pris en compte pour la mise à niveau de distribution.

Accepte les options suivantes :

  • -d, ‑‑download-only : ne télécharge que les paquetages.
  • -N, ‑‑dry-run : teste et affiche les opérations demandées mais ne les effectue pas.
  • -y, ‑‑no-confirm : ne demande pas confirmation.

Par exemple, vous pouvez mettre à niveau la distribution de SLES 10 SP2 vers SLES 10 SP3.

info (info) [option] pattern

Affiche des informations pour le paquetage spécifié qui correspond au modèle spécifié.

Les expressions régulières suivantes sont prises en charge :

Expression normale

Fonction

^abc

Correspond à une chaîne commençant par « abc ».

[abc]

Correspond à une chaîne contenant « a », « b » ou « c ».

a*c

Correspond à zéro « a » ou plus suivi(s) de « c », « ac », « aac », « aaac » ou « c ».

La commande affiche le nom, la version, l'architecture et la description des paquetages.

Accepte les options suivantes :

  • ‑‑provides : répertorie les paquetages et les fichiers fournis par le paquetage qui correspond au modèle spécifié.
  • ‑‑requires : répertorie les paquetages et les fichiers requis par le paquetage qui correspond au modèle spécifié.
install (in) [options] (nom de paquetage) […]

Installe les paquetages spécifiés. Si vous spécifiez un paquetage avec une version, cette version précise du paquetage est installée. Si vous spécifiez un paquetage avec un nom, la meilleure version du paquetage est installée.

REMARQUE :si vous souhaitez mettre à niveau un paquetage vers une version antérieure, spécifiez la version vers laquelle effectuer cette opération.

Accepte les options suivantes :

  • -b, ‑‑bundle [nom de l'ensemble] : installe un paquetage depuis l'ensemble spécifié. L'ensemble que vous spécifiez peut aussi être un ensemble de dépendances Linux. Toutefois, pour installer un ensemble de dépendances Linux, l'option Paquetages de publication doit être définie sur Vrai. Pour plus d'informations sur les paquetages de publication, reportez-vous à la section Création d'ensembles de dépendance Linux.
  • -d, ‑‑download-only : télécharge les paquetages dans le répertoire cache zen. Par défaut, le répertoire cache zen est situé dans /var/opt/novell/zenworks/zmd/cache.
  • -N, ‑‑dry-run : teste et affiche les opérations demandées mais ne les effectue pas.
  • -y, ‑‑no-confirm : ne demande pas confirmation.
  • -f, ‑‑freshen : n'installe des paquetages que si une version antérieure du paquetage existe.
  • -s, ‑‑service [nom du service] : installe un paquetage depuis le service spécifié.
  • -p, ‑‑pattern [nom du modèle] : installe un paquetage d'un modèle spécifique. Toutefois, seule la partie de paquetage obligatoire du modèle est installée.
  • ‑‑entire-bundle [nom de l'ensemble] […] : installe tous les paquetages depuis les ensembles spécifiés. Vous pouvez indiquer un seul ensemble ou plusieurs.
  • ‑‑ignore-dependency : ne vérifie pas les dépendances. Les paquetages dépendants sont ignorés et seuls les paquetages sont installés.
  • -r, ‑‑regex-pattern <modèle regex> [<modèle regex>] : installe l'ensemble des paquetages correspondant à l'expression régulière spécifiée.

Les expressions régulières suivantes sont prises en charge :

Expression normale

Fonction

^abc

Correspond à une chaîne commençant par « abc ».

[abc]

Correspond à une chaîne contenant « a », « b » ou « c ».

a*c

Correspond à zéro « a » ou plus suivi(s) de « c », « ac », « aac », « aaac » ou « c ».

En outre, cette commande répertorie les paquetages dépendants pour mener à bien l'installation.

list-updates (lu) [options] [nom de l'ensemble|nom du service] […]

Affiche les mises à jour disponibles dans les ensembles et les services spécifiés. Vous pouvez spécifier un seul ou plusieurs ensembles ou services dont vous souhaitez afficher les mises à jour. Si aucun ensemble ou service n'est spécifié, la commande affiche toutes les mises à jour disponibles.

Accepte les options suivantes :

  • -t, ‑‑type [type] : répertorie les mises à jour du type de service spécifié.
lock-add (la) (nom ou modèle)[version]

Ajoute une règle de verrouillage de paquetage. Cette commande verrouille les paquetages spécifiés qui, s'ils correspondent à la chaîne ou à l'expression régulière spécifiée, ne sont ni mis à niveau ni supprimés. Le nom du paquetage peut être spécifié de façon individuelle, avec des caractères jokers, voire avec des relations de numéros de versions. Le numéro de version doit être spécifié entre guillemets simples ou doubles.

Opérateur relationnel

Fonction

=

Ne verrouille que la version de paquetage spécifique.

<

Verrouille toutes les versions du paquetage plus anciennes que la version spécifiée, en excluant la version spécifiée.

>

Verrouille toutes les versions du paquetage ultérieures à la version spécifiée, en excluant la version spécifiée.

<=

Verrouille toutes les versions du paquetage plus anciennes que la version spécifiée, y compris la version spécifiée.

>=

Verrouille toutes les versions du paquetage ultérieures à la version spécifiée, y compris la version spécifiée.

Si vous voulez installer une version spécifique du paquetage, cette commande vérifie d'abord si cette version a été verrouillée et ne l'installe que si ce n'est pas le cas. Supposons, par exemple, que toutes les versions ultérieures du paquetage « X 1.7 » aient été verrouillées par la commande zac la X '>' 1.7. Si vous tentez d'installer le paquetage X 1.9 à l'aide de la commandezac in X (1.9), l'installation échoue.

lock-delete (ld) (numéro du verrou) […]

Supprime le verrou de paquetage spécifié par le numéro. Vous pouvez rechercher le numéro de chaque verrou à l'aide de la commande lock-list (ll).

lock-list (ll)

Répertorie les verrous de paquetages.

packagehistory (ph) [options] […]

Répertorie l'historique des transactions de paquetages constitué à l'aide de ZENworks. Cette commande affiche le nom, la date, l'opération, la version et l'édition du paquetage.

Accepte les drapeaux d'option suivants :

  • -n, ‑‑search-name [nom_paquetage] : effectue une recherche par nom de paquetage.
  • -a, ‑‑search-action [nom_action] : effectue une recherche par nom d'action. Les noms d'opération valides sont Aucune, Installation, Suppression et Mise à niveau.
  • -d, ‑‑days-back [jours] : nombre maximum de jours pour la recherche (30 par défaut).
  • -c, ‑‑clean-history : nettoie l'historique des paquetages.
  • -o, ‑‑search-operation [opération] : lance une recherche selon l'opération effectuée. L'opération effectuée peut être Installation, Suppression ou Mise à niveau.
remove (rm) [options] (nom du paquetage) […]

Supprime les paquetages spécifiés.

Accepte les options suivantes :

  • ‑‑entire-bundle [nom de l'ensemble] : supprime tous les paquetages de l'ensemble spécifié.
  • -N, ‑‑dry-run : teste et affiche les opérations demandées, mais ne les effectue pas.
  • -y, ‑‑no-confirm : ne demande pas confirmation.
  • -r, ‑‑regex-pattern <modèle regex> [<modèle regex>] : supprime l'ensemble des paquetages correspondant à l'expression régulière spécifiée.

Les expressions régulières suivantes sont prises en charge :

Expression normale

Fonction

^abc

Correspond à une chaîne commençant par « abc ».

[abc]

Correspond à une chaîne contenant « a », « b » ou « c ».

a*c

Correspond à zéro « a » ou plus suivi(s) de « c », « ac », « aac », « aaac » ou « c ».

La commande reprend également les paquetages dépendants pour mener à bien la suppression du paquetage spécifié.

rollback (ro) [options] [date ou point de contrôle]

Rétablit les transactions de paquetages dans leur état du jour et de l'heure que vous spécifiez, si la préférence de retour à l'état initial est définie. Par défaut, cette préférence est désactivée. Vous pouvez activer la préférence de retour à l'état initial en exécutant la commande zac set rollback true.

Si vous souhaitez revenir à l'état initial d'une version particulière du paquetage, cette version et ses dépendances doivent être disponibles et faire partie du service ou de l'ensemble assigné. Si la version du paquetage ou ses dépendances ne sont pas disponibles, le retour à l'état initial échoue.

En outre, la commande répertorie les paquetages dépendants requis pour effectuer un retour à l'état initial.

Accepte les options suivantes :

  • -d, ‑‑download-only : ne télécharge que les paquetages.
  • -N, ‑‑dry-run : teste et affiche les opérations demandées, mais ne les effectue pas.
  • -y, ‑‑no-confirm : ne demande pas confirmation.
  • -p, ‑‑package (nom du paquetage) : nom du paquetage qui doit revenir à son état initial.
search (se) [options] [modèle]

Recherche les paquetages qui correspondent au modèle spécifié. Si aucun argument n'est fourni, tous les paquetages sont affichés. Cette commande affiche le nom de source, le type de source, le nom de paquetage, la version et l'architecture.

Accepte les options suivantes :

  • -b, ‑‑bundle [nom de l'ensemble] : recherche des paquetages dans l'ensemble spécifié.
  • -d, ‑‑search-in-description : effectue une recherche dans les descriptions des paquetages et non dans les noms des paquetages.
  • -i, ‑‑installed-only : n'affiche que les paquetages installés.
  • -u, ‑‑uninstalled-only : n'affiche que les paquetages désinstallés.
  • -s, ‑‑service [nom de service] : recherche des paquetages dans le service spécifié.
  • -t, ‑‑type [type de service] : recherche des paquetages selon le type de service spécifié.
  • -p, ‑‑pattern [nom de modèle] : affiche les modèles disponibles.
  • ‑‑sort-by-bundle : trie les paquetages par ensemble et non par nom. Par défaut, le tri s'opère en fonction du nom de paquetage.
  • ‑‑Show-nevra : affiche les détails NEVRA des paquetages.
update (up) [options] [nom de l'ensemble|nom de service] […]

Met à jour les paquetages installés. Vous pouvez spécifier un ou plusieurs noms d'ensemble ou de service pour lesquels mettre à jour les paquetages. Si aucun nom d'ensemble ou de service n'est spécifié, tous les paquetages sont mis à jour.

Si des paquetages ayant le même nom et la même architecture mais des versions différentes sont installés, seuls les paquetages de la version supérieure sont mis à niveau.

Accepte les options suivantes :

  • -d, ‑‑download-only : ne télécharge que les paquetages.
  • -N, ‑‑dry-run : teste et affiche les opérations demandées, mais ne les effectue pas.
  • -y, -‑‑no-confirm : ne demande pas de confirmation.
  • -t, ‑‑type [type de service] : met à jour des paquetages à partir du type de service externe spécifié.
what-provides (wp) pattern

Affiche les paquetages qui sont fournis par la bibliothèque, le programme ou le paquetage selon un modèle spécifié. Seul le modèle de caractère générique* est pris en charge.

Exemple pour afficher les paquetages se terminant par « a » :

zac wp *a

what-requires (wr) pattern

Répertorie les paquetages qui sont exigés par la bibliothèque, le programme ou le paquetage selon un modèle spécifié.

Exemple pour afficher les paquetages commençant par « a » :

zac wr a*

Commandes de gestion des correctifs

patch-scan (ps)

Analyse le périphérique à la recherche des correctifs qui n'ont pas encore été appliqués, à l'aide du fichier (DAU) de signature du correctif actuel du périphérique. Les résultats sont ensuite téléchargés sur le serveur.

Exemple pour l'exécution d'une analyse des correctifs :

zac ps

patch-scan ‑‑quick (ps ‑‑quick)

Télécharge les résultats de la dernière analyse sur le serveur sans exécuter de nouvelle analyse de détection.

Exemple pour l'exécution d'une analyse rapide des correctifs :

zac ps ‑‑quick

patch-apply-policy (pap)

Met les périphériques à jour avec la dernière version de toutes les stratégies de correctifs.

Exemple pour l'exécution d'une stratégie d'application des correctifs :

zac pap

patch-quarantine-release (pqr)

Sort de la quarantaine tous les correctifs mis en quarantaine sur chaque périphérique sur lequel la commande est exécutée de manière à permettre une tentative d'installation unique, à partir soit d'une planification de stratégie de correctif, soit d'une planification du traitement.

Exemple pour l'exécution d'une libération des correctifs mis en quarantaine :

zac pqr

Commandes de stratégies

policy-list (pl)

Répertorie les stratégies qui sont actuellement appliquées au périphérique (stratégies effectives). Pour répertorier toutes les stratégies (effectives et non effectives), utilisez l'option ‑‑all.

Exemples :

zac pl

zac pl ‑‑all

policy-refresh (pr)

Applique toutes les stratégies assignées au périphérique et à l'utilisateur.

Exemple :

zac pr

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 déjà été enregistré avec une clé et que vous l'enregistrez avec une nouvelle clé, le périphérique reçoit toutes les assignations de groupe associées aux deux clés.

Exemple :

zac ark key12

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. Pour exécuter cette commande, vous devez disposer de droits de périphérique Créer/supprimer sur le dossier que vous tentez d'enregistrer.

Exemples :

zac reg -k key1 https://123.456.78.90

zac reg -k key1 https://zenserver.novell.com:8080

Le numéro de port n'est requis que si le serveur ZENworks n'utilise pas le port standard HTTP (80). Si aucun nom d'utilisateur ni mot de passe ne sont fournis, vous êtes invité à les indiquer.

REMARQUE :l'option -k ne sera pas exécutée si l'objet de périphérique correspondant se trouve déjà sur le serveur et si le rapprochement a lieu avec cet objet de périphérique.

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é. Pour exécuter cette commande, vous devez disposer de droits de périphérique Créer/supprimer pour le dossier que vous tentez de réenregistrer.

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] [-s] [-a] [-u <nom d'utilisateur> -p <mot de passe>]

Supprime l'enregistrement du périphérique de la zone de gestion. Pour exécuter cette commande, vous devez disposer de droits de périphérique Créer/supprimer pour le dossier dont vous tentez d'annuler l'enregistrement.

Exemple :

Pour forcer l'annulation de l'enregistrement d'un périphérique lorsqu'un serveur ne peut pas être contacté :

zac unr -f -u myuser -p mypassword

Pour annuler l'enregistrement en local et supprimer la demande de spécification d'un nom d'utilisateur et d'un mot de passe :

zac unr -s

Utilisez l'option -a pour annuler l'enregistrement de manière asynchrone. Si vous utilisez cette option, le serveur supprime le périphérique de manière asynchrone.

Les paramètres -a, -f, -u et -p sont facultatifs. Si vous n'utilisez pas les paramètres -u et -p, vous êtes invité à saisir un nom d'utilisateur et un mot de passe. Si vous spécifiez l'option -a, le serveur ZENworks renvoie rapidement l'appel d'annulation d'enregistrement, mais ne supprime, que par la suite l'objet de périphérique de la base de données de manière asynchrone. Si la suppression de votre périphérique n'est pas terminée et que vous essayez de le réenregistrer, le serveur ZENworks affiche une erreur. Si le périphérique est associé à un important volume de données dans la base de données, sa suppression peut prendre un certain temps. Si la suppression du périphérique du serveur prend du temps et que le délai d'attente d'exécution de la commande d'annulation de l'enregistrement de l'agent arrive à expiration, veillez à utiliser l'option -a.

REMARQUE :l'exécution de la commande UNR peut entraîner une utilisation élevée de la base de données. Cela peut être dû à l'une des raisons suivantes :

  • La commande UNR est en cours d'exécution sur le serveur.

  • La zone contient un nombre élevé de périphériques gérés.

  • Les périphériques gérés ont un historique volumineux.

  • Patch Management est activé.

reestablish-trust (retr) [-u <nom_utilisateur> -p <mot_de_passe>]

Rétablit la confiance vis-à-vis de la zone de gestion actuelle. Le nom d'utilisateur et le mot de passe utilisés doivent être ceux de l'administrateur de zone.

Exemple :

zac retr -u myuser -p mypassword

Les paramètres -u et -p sont facultatifs. Si vous n'utilisez pas les paramètres -u et -p, vous êtes invité à saisir un nom d'utilisateur et un mot de passe.

Commandes de rôle de satellite

remint-satellite-cert (rsc)

Renouvelle le certificat SSL du satellite.

Exemple : zac rsc

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.

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 (iss status)

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 est Actif 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 ZENworks Agent. Les champs suivants fournissent des informations sur ZENworks Agent :

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 ZENworks a contacté le serveur ZENworks.

Prochain contact avec le serveur. Heure du prochain contact prévu entre l'agent et le serveur ZENworks.

Utilisateur primaire. Utilisateur actuellement connecté.

Exemple :

zac agp

zac agent-properties

cache-clear (cc)

Efface le cache ZENworks sur le périphérique. Cela supprime toutes les entrées de la base de données du cache ainsi que tous les fichiers du cache associé à ces entrées.

Exemple :

zac cc

refresh (ref)[general [bypasscache] | partial [bypasscache] | bypasscache]

Initie un rafraîchissement général ou partiel pour tous les paramètres d'enregistrement et de configuration.

Utilisez bypasscache pour éviter l'emploi des données du cache du serveur lors du rafraîchissement. Cette option est utile pour les tests ou le dépannage.

Exemples :

zac ref general bypasscache

zac ref partial bypasscache

zac ref bypasscache

zenhttp-status(zhs)

Répertorie les ports et les étiquettes pour les gestionnaires enregistrés.

Exemple :

zac zhs

zone-config (zc)

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

get-settings (gs) <clé>

Les paramètres sont téléchargés par le module de paramètres dans le cache local à chaque rafraîchissement. Cette opération renvoie les paramètres effectifs associés à la clé donnée.

Exemple :

zac gs key1

Toutes les clés de paramètres ZENworks valides sont stockées dans le répertoire /var/opt/novell/zenworks/cache/zmd/settings.

Exemple de liste des paramètres de gestion à distance :

zac gs RemoteManagement

statussender (sts)

Cette commande transfère en amont les informations d'état vers le serveur primaire. Vous pouvez soit transférer en amont des informations qui ont été mises à jour depuis le dernier transfert en amont de l'état ou vous pouvez transférer en amont les informations d'état terminé.

Exemples :

Pour transférer en amont les informations d'état qui ont été mises à jour depuis la dernière réussite du transfert en amont de l'état :

zac sts rollup

Pour transférer en amont les informations d'état terminé :

zac sts rollup full