zlmmirror (1)

Name

zlmmirror - Met en miroir les ensembles et les catalogues de logiciels, en tout ou en partie, depuis les serveurs distants ZENworks® Linux Management, YaST Online Updates, Novell Updates, YUM et Red Hat Network, vers votre serveur ZENworks Linux Management local ou vers un répertoire local. Pour obtenir des informations détaillées concernant la mise en miroir des paquetages de mise à jour Dell vers votre serveur ZENworks, consultez Logiciel de mise en miroir dans le Guide d'administration de ZENworks 7.3 Linux Management.

Syntaxe

zlmmirror [commande] [options] [arguments]

Cette commande lit les informations nécessaires à la connexion au serveur local et au serveur distant depuis un fichier de configuration XML. Des informations détaillées sur la création des fichiers de configuration zlmmirror sont incluses dans le Guide d'administration de ZENworks 7.3 Linux Management.

Description

zlmmirror permet de vous connecter à un serveur distant et de copier les catalogues de logiciels, les ensembles ou les paquetages depuis le serveur distant sur votre serveur à l'aide de quelques commandes simples. Les logiciels peuvent être mis en miroir à partir des serveurs suivants :

  • ZENworks Linux Management

  • Paquetages de mise à jour Dell (DUP)

  • YaST Online Updates

  • Red Hat* Network

  • Red Carpet® Enterprise ou ZENworks 6.x Linux Management

  • Novell Updates

  • YUM

Novell®, Dell, SUSE et Red Hat assurent la maintenance de chacun des serveurs de leur type respectif, ce qui permet de mettre simplement en miroir les catalogues et les ensembles qui vous intéressent sans avoir besoin de gérer ou de mettre à jour ces espaces de stockage. La mise en miroir est la méthode préférée pour obtenir la majeure partie des logiciels que vous distribuez sur les périphériques gérés.

Pendant son utilisation, zlmmirror se connecte au serveur distant, au serveur local et au programme zlman, en s'authentifiant à chaque fois. Il doit être exécuté sur le même système que zlman et le reste du serveur ZENworks Linux Management. il exige en outre des privilèges racine.

Commandes

Toutes les commandes ci-dessous acceptent les drapeaux d'option énumérés dans la section Options globales. Elles acceptent en outre des options individuelles, telles qu'énumérées avec chaque commande.

Commandes de configuration

Ces commandes permettent de créer, de convertir et de valider des fichiers de configuration zlmmirror.

conf-convert (cc) [options] [fichier à convertir] [nom du fichier converti]

Convertit le fichier de configuration rcmirror.conf spécifié au nouveau format XML.

conf-generate (cg) [options] [nom du fichier cible]

Crée un nouveau fichier de configuration vide, montrant tous les champs possibles.

conf-validate (cv) [options] [nom du fichier]

Consulte le fichier de configuration à la recherche d'erreurs et affiche les informations de configuration analysées.

Commandes de catalogue et d'ensemble

Ces commandes permettent d'afficher les catalogues, les ensembles et les paquetages sur le serveur distant.

bundle-list-packages (blp) [options] [ensemble] [catalogue]

Répertorie les paquetages disponibles dans l'ensemble spécifié. Accepte les drapeaux d'option suivants :

  • -c,--conf=[nom de fichier] - Indique le fichier de configuration à utiliser, faute de quoi le fichier par défaut (/etc/opt/novell/zenworks/zlmmirror.xml) est utilisé.
  • -t,--target - limite la liste à la cible spécifiée.
catalog-list-bundles(clb) [options] [catalogue]

Répertorie les ensembles disponibles dans le catalogue spécifié. Accepte les drapeaux d'option suivants :

  • -c,--conf=[nom de fichier] - Indique le fichier de configuration à utiliser, faute de quoi le fichier par défaut (/etc/opt/novell/zenworks/zlmmirror.xml) est utilisé.
  • -t,--target - limite la liste à la cible spécifiée.
catalog-list-packages (clp) [options] [catalogue]

Répertorie les paquetages disponibles dans le catalogue spécifié. Accepte les drapeaux d'option suivants :

  • -c,--conf=[nom de fichier] - Indique le fichier de configuration à utiliser, faute de quoi le fichier par défaut (/etc/opt/novell/zenworks/zlmmirror.xml) est utilisé.
  • -t,--target - limite la liste à la cible spécifiée.
server-list-bundles (slb) [options]

Répertorie les ensembles disponibles sur le serveur distant. Accepte les drapeaux d'option suivants :

  • -p,--packages - Pour les serveurs RCE, inclut les ensembles de correctifs uniquement. (Cela exclut les ensembles de paquetages).
  • -c,--conf=[nom de fichier] - Indique le fichier de configuration à utiliser, faute de quoi le fichier par défaut (/etc/opt/novell/zenworks/zlmmirror.xml) est utilisé.
  • -t,--target - limite la liste à la cible spécifiée.
server-list-catalogs (slc) [options]

Répertorie les catalogues disponibles sur le serveur distant. Accepte les drapeaux d'option suivants :

  • -c,--conf=[nom de fichier] - Indique le fichier de configuration à utiliser, faute de quoi le fichier par défaut (/etc/opt/novell/zenworks/zlmmirror.xml) est utilisé.
  • -t,--target - limite la liste à la cible spécifiée.
server-list-packages (slp) [options]

Répertorie les paquetages disponibles sur le serveur distant. Accepte les drapeaux d'option suivants :

  • -c,--conf=[nom de fichier] - indique le fichier de configuration à utiliser, faute de quoi le fichier par défaut (/etc/opt/novell/zenworks/zlmmirror.xml) est utilisé.
  • -t,--target - limite la liste à la cible spécifiée.

Commande de mise en miroir

La commande mirror permet d'exécuter l'opération de mise en miroir réelle contenue dans le fichier zlmmirror.xml.

mirror (m) [options]

Effectue une opération de mise en miroir. Accepte les drapeaux d'option suivants :

  • -n, --dryrun - Imprime les paquetages à mettre en miroir ou à ajouter. N'effectue aucune mise en miroir.
  • -r, --re-download - Télécharge de nouveau le contenu même s'il a déjà été mis en miroir.
  • -p, --packagesets - Pour les serveurs RCE et NU, inclut uniquement les ensembles de correctifs. (Cela exclut les ensembles de paquetages).
  • -s, --sync-local - Pour un serveur distant ZENworks Linux Management, synchronise l'espace de stockage du serveur local avec l'espace de stockage du serveur distant.
  • --force-nevra - Permet à un nouveau paquetage avec un conflit NEVRA (nom, période, version, release et architecture) de remplacer un paquetage existant.
  • -c, --conf=[nom de fichier] - Spécifie le fichier de configuration à utiliser. Si aucun fichier n'est spécifié, le fichier par défaut (/etc/opt/novell/zenworks/zlmmirror.xml) est utilisé.
  • --category=[valeur] - Spécifie des valeurs telles que security (sécurité), recommended (recommandé) ou optional (facultatif). Cette valeur prime sur les valeurs spécifiées dans le fichier de configuration de la mise en miroir. Cette commande s'applique aux serveurs RCE et NU.
  • -o, --remove-obsolete-patches - Supprime les ensembles de correctifs YOU mis en miroir du serveur ZENworks local si ceux-ci sont obsolètes dans l'espace de stockage YOU. Si les ensembles de correctifs YOU sont mis en miroir dans un dossier contenant des correctifs obsolètes, ces derniers sont supprimés du dossier. Cette option s'applique uniquement au serveur YOU.
  • -g, --retain-guid - Conserve le GUID des ensembles lors de la mise en miroir d'ensembles entre des serveurs ZENworks Linux Management situés dans différentes zones de gestion. Par défaut, les ensembles sont créés dans le répertoire Bundles/zlmmirror. Si un ensemble du même nom existe sur le serveur local, la mise en miroir de cet ensemble à partir du serveur distant ne conserve pas le GUID d'ensemble. Lorsque vous mettez en miroir des ensembles du serveur distant, seul l'ensemble actuellement déployé est mis en miroir sur le serveur local. Une nouvelle version de l'ensemble est créée sur le serveur local indépendamment de la version déployée de l'ensemble sur le serveur distant.

Options

-h , --help

Affiche un message d'aide.

--log=[fichier journal]

Consigne les messages dans un fichier. Si aucun fichier journal n'est spécifié, le fichier par défaut (/var/opt/novell/log/zenworks/zlmmirror.log) est utilisé.

-v , --verbeux

Affiche une sortie verbeuse.

--version

Imprime les informations de version zlmmirror et quitte.

--remote-timeout=[secondes]

Timeout de connexion du serveur distant (en secondes).

Fichiers

/etc/opt/novell/zenworks/zlmmirror.xml

Fichier de configuration par défaut.

Vous devez créer une configuration XML différente pour chaque serveur distant que vous mettez en miroir. Un fichier XML modèle peut être créé à l'aide de la commande conf-generate. Reportez-vous au Guide d'administration de ZENworks Linux Management pour en savoir plus sur la mise en miroir.

Vous trouverez ci-dessous une description des sections contenues dans le fichier de configuration XML zlmmirror. Vous devez fournir des détails sur le serveur distant (contenant le logiciel à mettre en miroir) et sur le serveur local (votre serveur ZLM recevant le logiciel mis en miroir), ainsi que des informations sur les catalogues, les ensembles et les paquetages à mettre en miroir.

Serveur distant

Le serveur distant est spécifié comme suit :

  • <RemoteServer>
  • <Base>https://zlm.novell.com/</Base>
  • <Type>zlm</Type>
  • <User>Administrator</User>
  • <Password>letmein</Password>
  • </RemoteServer>

Base - Chemin d'accès au serveur à mettre en miroir, au format suivant en fonction du type de ce serveur :

  • ZLM : https://serveur

  • DELL : http://ftp.dell.com

  • RCE : https://serveur/chemin

  • YaST : http(s)://serveur/chemin ou ftp://serveur/chemin

  • RHN : http(s)://serveur/chemin

  • NU : https://nu.novell.com/repo

  • YUM : espaces de stockage YUM pour SUSE tels que http://poincare.suse.de/testrepo/

Type - Type du serveur à mettre en miroir :

  • ZLM : ZENworks 7 Linux Management

  • DELL : serveur FTP du paquetage de mise à jour Dell

  • RCE : Red Carpet Enterprise ou ZENworks 6.x Linux Management

  • YaST : YaST Online Updates

  • RHN : Red Hat Network

  • NU : Novell Updates

  • YUM : Yellow Dog Updater, Modified

User - nom à utiliser lors de la connexion au serveur distant. Si vous ne spécifiez aucun utilisateur, zlmmirror lit les informations d'identité indiquées à l'emplacement suivant, en fonction du type du serveur :

  • ZLM : /etc/opt/novell/zenworks/zmd/deviceid sous SLES 9 et OES, et /etc/zmd/deviceid sous SLES 10 et SLED 10

  • RCE : /etc/ximian/mcookie

  • YaST : /etc/sysconfig/onlineupdate

  • NU : /etc/opt/novell/zenworks/zmd/deviceid sous SLES 9 et OES, et /etc/zmd/deviceid sous SLES 10 et SLED 10

  • YUM : ne requiert aucune authentification.

Lorsque vous vous connectez à un serveur RHN ou à un serveur Dell, laissez cet élément vide.

Password - mot de passe à utiliser lors de la connexion au serveur distant. Si vous ne spécifiez aucun mot de passe, zlmmirror lit le mot de passe indiqué à l'emplacement suivant, en fonction du type du serveur :

  • ZLM : /etc/opt/novell/zenworks/zmd/secret sous SLES 9 et OES, /etc/zmd/secret sous SLES 10 et SLED 10

  • RCE : /etc/ximian/partnernet

  • YaST : /etc/sysconfig/onlineupdate

  • NU : /etc/opt/novell/zenworks/zmd/secret sous SLES 9 et OES, /etc/zmd/secret sous SLES 10 et SLED 10

  • YUM : ne requiert aucune authentification.

Lorsque vous vous connectez à un serveur RHN ou à un serveur Dell, laissez cet élément vide.

Proxy - l'élément de configuration de proxy est facultatif et s'utilise avec un proxy Internet. Vous pouvez ajouter l'élément proxy n'importe où dans la section RemoteServer. Si le proxy Internet nécessite l'authentification, le format ressemble à l'exemple qui suit :

<Proxy>http://nom_utilisateur:mot_de_passe@serveur:port</Proxy>

Si le proxy Internet ne nécessite pas l'authentification, le format ressemble à l'exemple qui suit :

<Proxy>https://serveur:port</Proxy>

SystemID - pour effectuer une mise en miroir à partir du serveur RHN, vous devez ajouter l'élément de configuration SystemID au fichier de configuration zlmmirror. Vous pouvez utiliser le fichier systemid qui dispose d'une authentification valide auprès du serveur RHN. Vous devez fournir le chemin complet du fichier systemid situé sur le serveur ZENworks. Son format est similaire à l'exemple suivant :

<SystemID> /etc/opt/novell/zenworks/zlmmirror-example-rhn-conf.xml</SystemID>

Serveur local

Le serveur local est spécifié comme suit :

  • <LocalServer>
  • <Base></Base>
  • <Type>zlm</Type>
  • <User>Administrator></User>
  • <Password>letmein</Password>
  • </LocalServer>

Base - si l'attribut type est ZLM, laissez ce champ vide. Si l'attribut est de type STATIC, saisissez le chemin d'accès au répertoire local dans lequel vous souhaitez copier les paquetages, au format suivant : /path/on/filesystem.

Type - Type de mise en miroir que vous voulez réaliser :

  • ZLM : met en miroir les catalogues et les ensembles directement sur votre serveur ZENworks Linux Management. Une fois la mise en miroir terminée, les catalogues et les ensembles mis en miroir sont affichés dans le Centre de contrôle ZENworks.

    Vous ne pouvez pas effectuer de mise en miroir ZLM sur les serveurs secondaires.

  • STATIC : mise en miroir des paquetages sur le système de fichiers de votre serveur ZENworks Linux Management, sans qu'ils soient ajoutés à ZENworks.

    Vous ne pouvez effectuer de mise en miroir statique que sur les serveurs secondaires.

User - nom à utiliser lors de la connexion à votre serveur (Local) ZENworks Linux Management. Pour utiliser le compte d'administrateur par défaut, vous devez indiquer l'utilisateur Administrateur.

Password - mot de passe du compte indiqué dans le champ utilisateur. Si vous utilisez le compte Administrateur, il s'agit du mot de passe que vous avez spécifié au cours de l'installation du serveur.

Catalogues, ensembles et paquetages

Chaque ensemble et paquetage à mettre en miroir doit être contenu dans un catalogue sur le serveur distant : ainsi, l'élément Catalog est le seul nécessaire pour mettre en miroir un catalogue, un ensemble ou un paquetage. Un fichier de configuration peut comporter plusieurs éléments Catalog ; chaque catalogue à mettre en miroir doit posséder sa propre entrée.

  • <Catalog>
  • <Name>Red Carpet 2</Name>
  • <LocalName>Red Carpet 2</LocalName>
  • <Target>sles-9-i586</Target>
  • <Package>lib.*</Package>
  • </Catalog>

Nom local - Nom du catalogue dans lequel doit être placé le logiciel mis en miroir. Si vous ne spécifiez aucun nom local, c'est le nom du catalogue du serveur source qui est utilisé. Le nom local du catalogue ne doit pas être identique à celui réservé pour le dossier <nom du catalogue>-patches.

Dossier - Spécifie le dossier eDir (par exemple, /dossier1/dossier2) dans lequel sont créés et mis à jour les ensembles et les catalogues. Si vous ne spécifiez aucun dossier, les catalogues et les ensembles sont créés et mis à jour dans le dossier /zlmmirror.

Target - Limite la mise en miroir sur ce catalogue aux paquetages et aux correctifs qui prennent en charge les plates-formes cibles précisées. Si vous ne spécifiez pas target (cible), les paquetages de toutes les plates-formes sont mis en miroir. Cet élément peut être spécifié plusieurs fois. Il peut contenir soit un nom cible, soit une chaîne d'expression régulière pour la recherche de noms cibles concordants. Par exemple, pour inclure des cibles commençant par sles telles que sles-9-i586, utilisez l'expression régulière <Target>sles.*</Target>.

ExcludeTarget - Identique à Target, sauf que les paquetages et les correctifs qui prennent en charge les plates-formes cibles spécifiées sont exclus. L'option ExcludeTarget est exécutée après Target : les plates\-formes apparaissant dans une opération Target et ExcludeTarget sont finalement exclues. Par exemple, pour exclure des cibles se terminant par i586 telles que sles-9-i586, utilisez l'expression régulière <ExcludeTarget>.*i586</ExcludeTarget>.

Bundle - Limite la mise en miroir sur ce catalogue aux ensembles précisés. Si vous ne spécifiez pas l'ensemble, tous les ensembles sont mis en miroir. Cette option n'est valide que pour les serveurs source ZLM et YaST. Elle peut être spécifiée plusieurs fois et peut contenir soit un nom d'ensemble, soit une chaîne d'expression régulière pour la recherche de noms d'ensembles concordants. Pour plus d'informations, reportez-vous à la remarque ci-dessous sur les expressions régulières.

LocalBundleName - Renomme le nom de l'ensemble localement. Ceci ne s'applique qu'aux services RCE, NU et RHN pour lesquels un seul ensemble du catalogue se trouve sur le serveur distant. Si vous spécifiez <LocalBundleName>, vous ne devez pas spécifier la balise <Bundle>. Cette balise n'est pas applicable lorsque vous mettez en miroir OES à partir du service RCE avec un catalogue contenant plusieurs ensembles.

ExcludeBundle - Identique à Bundle, sauf que les paquetages et les correctifs contenus dans les ensembles spécifiés sont exclus. Cette option n'est valide que pour les serveurs source ZLM et YaST. Elle peut être spécifiée plusieurs fois et peut contenir soit le nom d'un ensemble, soit une chaîne d'expression régulière pour la recherche de noms d'ensembles concordants. L'option ExcludeBundle est exécutée après Bundle : les ensembles apparaissant dans une opération Bundle et ExcludeBundle sont finalement exclus. Pour plus d'informations, reportez-vous à la remarque ci-dessous sur les expressions régulières.

Logiciel - Limite la mise en miroir sur ce catalogue aux paquetages précisés. Si vous ne spécifiez pas le paquetage, tous les paquetages sont mis en miroir. Cette option peut être spécifiée plusieurs fois. Elle peut contenir soit un nom de paquetage, soit une chaîne d'expression régulière pour la recherche de noms de paquetages concordants. Cette option n'est pas prise en charge pour les ensembles de correctifs. Le filtrage des paquetages dans un ensemble de correctifs n'est pas pris en charge pour les serveurs distants de type RCE, YaST et NU. Pour plus d'informations, reportez-vous à la remarque ci-dessous sur les expressions régulières.

ExcludePackage - Identique à package, sauf que les paquetages spécifiés sont exclus. Cette option peut être spécifiée plusieurs fois. Elle peut contenir soit un nom de paquetage, soit une chaîne d'expression régulière pour la recherche de noms de paquetages concordants. Cette option ne s'applique pas aux correctifs YOU. L'option ExcludePackage est exécutée après Package : les paquetages apparaissant dans une opération Package et ExcludePackage sont finalement exclus. Pour plus d'informations, reportez-vous à la remarque ci-dessous sur les expressions régulières.

Catégorie : Limite la mise en miroir sur ce catalogue aux catégories d'ensembles de correctifs précisées. Si vous n'indiquez pas de catégorie, tous les ensembles sont mis en miroir. Les valeurs valides sont recommended (recommandé), optional (facultatif) et security (sécurité). Cette balise s'applique uniquement aux serveurs de type RCE et NU sous SLES 10, SLED 10 et OES 2.

ServicePackGroups - Accepte uniquement des valeurs booléennes (true ou false). Par défaut, <ServicePackGroups> est défini sur True et crée automatiquement des groupes d'ensembles. Cette option s'applique uniquement aux correctifs YOU.

AutoDeploy - La mise en miroir des paquetages vers un ensemble existant crée une version plus récente de l'ensemble et la déploie sur le serveur. Si AutoDeploy est défini sur False, la mise en miroir limite le déploiement de l'ensemble plus récent. Accepte uniquement des valeurs booléennes (true ou false). La valeur par défaut de cette option est True.

CreateMonolithicBundle - Crée automatiquement des ensembles de paquetages monolithiques comprenant uniquement les RPM des paquetages les plus récents. Cette option crée un ensemble monolithique distinct pour chaque version du Service Pack et un autre reprenant les mises à jour proposées après la dernière version du Service Pack. Elle accepte uniquement des valeurs booléennes (true ou false). Par défaut, elle est définie sur « true ». Cette option est prise en charge uniquement pour les correctifs YOU.

FilterPatchRPM - Limite l'opération de mise en miroir des ensembles de correctifs YOU au filtrage de tous les paquetages du type .patch.rpm. Cette option crée un ensemble de paquetages RPM équivalent sur le serveur local. Accepte uniquement des valeurs booléennes (true ou false). La valeur par défaut de cette option est False. Cette option s'applique uniquement aux correctifs YOU.

REMARQUE :le mode d'utilisation des expressions régulières (regex) a changé dans ZENworks 7.3 Linux Management. ZENworks Linux Management ne prend pas en charge l'utilisation de caractère joker pour les recherches de correspondance. Dans ZENworks Linux Management 6.6.x, vous pouvez utiliser une chaîne d'expression avec des caractères joker au lieu d'une chaîne d'expression régulière. Dans ZENworks 7.3 Linux Management, vous devez utiliser <Bundle>patch-.*</Bundle> pour mettre en miroir tous les ensembles dont le nom commence par patch-. ZENworks Linux Management prend en charge toutes les expressions régulières Java. Pour plus d'informations sur les expressions régulières Java, reportez-vous à la documentation de Java.

Auteurs

Copyright 2005-2009, Novell, Inc.. Tous droits réservés.

Reportez-vous à aussi

rug (1), zlman (1), zmd (8), zlm-debug (1), zrmservice (1)

Pour signaler tout problème rencontré lors de l'utilisation de ce logiciel ou de sa documentation, visitez le site Novell Bugzilla.