zlmmirror (1)

Name

zlmmirror - Duplica, total o parcialmente, paquetes y catálogos de software, desde servidores remotos ZENworks® Linux Management, YaST Online Updates, Novell Updates, YUM y Red Hat Network a su servidor local ZENworks Linux Management o a un directorio local. Para obtener información detallada sobre la duplicación de paquetes de actualización de Dell en el servidor ZENworks, consulte la sección sobre la duplicación de software en la Guía de administración de ZENworks 7.3 Linux Management.

Sintaxis

zlmmirror [comando] [opciones] [argumentos]

Este comando lee la información necesaria para conectar con el servidor local y con el servidor remoto en un archivo de configuración XML. En la Guía de administración de ZENworks 7.3 Linux Management se incluye información detallada sobre la creación de archivos de configuración de zlmmirror.

Descripción

zlmmirror le permite conectarse a un servidor remoto y copiar catálogos, lotes o paquetes de software a su servidor mediante unos pocos comandos sencillos. El software se puede duplicar desde los siguientes servidores:

  • ZENworks Linux Management

  • Paquetes de actualización de Dell (DUP, Dell Update Package)

  • YaST Online Updates

  • Red Hat* Network

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

  • Actualizaciones Novell

  • YUM

Novell®, Dell, SUSE y Red Hat mantienen servidores de sus tipos respectivos, lo que le permite duplicar los catálogos y lotes que le interesan sin necesidad de mantener ni actualizar estos repositorios. La duplicación es el método más adecuado para conseguir la mayor parte del software que tendrá que distribuir a los dispositivos gestionados.

Cuando se usa, zlmmirror se conecta al servidor remoto, al servidor local y al programa zlman, autenticándose en cada ocasión. Se debe ejecutar en el mismo sistema que zlman y el resto del servidor ZENworks Linux Management (Gestión de ZENworks Linux). Requiere privilegios de usuario Root.

Comandos

Todos los comandos siguientes aceptan los indicadores de opción mostrados en la sección Opciones globales. Además, aceptan las opciones individuales indicadas en cada comando.

Comandos de configuración

Estos comandos se usan para crear, convertir y validar archivos de configuración de zlmmirror.

conf-convert (cc) [opciones] [archivo para convertir] [nombre de archivo convertido]

Convierte el archivo de configuración rcmirror.conf especificado al nuevo formato XML.

conf-generate (cg) [opciones] [nombre de archivo de destino]

Crea un archivo de configuración nuevo vacío con todos los campos posibles.

conf-validate (cv) [opciones] [nombre de archivo]

Comprueba si hay errores en el archivo de configuración y muestra la información de configuración de análisis.

Comandos de catálogos y lotes

Estos comandos le permiten ver los catálogos, los lotes y los paquetes disponibles en el servidor remoto.

bundle-list-packages (blp) [opciones] [lote] [catálogo]

Muestra una lista de los paquetes disponibles en el lote especificado. Acepta los siguientes indicadores de opción:

  • -c,--conf=[nombre de archivo]: especifica el nombre de archivo que se usará; de lo contrario, se utiliza el archivo por defecto (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target: restringe el listado al destino especificado.
catalog-list-bundles (clb) [opciones] [catálogo]

Muestra una lista de los lotes disponibles en el catálogo especificado. Acepta los siguientes indicadores de opción:

  • -c,--conf=[nombre de archivo]: especifica el archivo de configuración que se usará; de lo contrario, se utiliza el archivo por defecto (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target: restringe el listado al destino especificado.
catalog-list-packages (clp) [opciones] [catálogo]

Muestra una lista de los paquetes disponibles en el catálogo especificado. Acepta los siguientes indicadores de opción:

  • -c,--conf=[nombre de archivo]: especifica el archivo de configuración que se usará; de lo contrario, se utiliza el archivo por defecto (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target: restringe el listado al destino especificado.
server-list-bundles (slb) [opciones]

Muestra una lista de los lotes disponibles en el servidor remoto. Acepta los siguientes indicadores de opción:

  • -p,--packages: en servidores RCE, incluye solamente parches de lote. (Esto excluye lotes de paquetes.)
  • -c,--conf=[nombre de archivo]: especifica el archivo de configuración que se usará, de lo contrario se utiliza el archivo por defecto (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target: restringe el listado al destino especificado.
server-list-catalogs (slc) [opciones]

Muestra una lista de los catálogos disponibles en el servidor remoto. Acepta los siguientes indicadores de opción:

  • -c,--conf=[nombre de archivo]: especifica el archivo de configuración que se usará, de lo contrario se utiliza el archivo por defecto (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target: restringe el listado al destino especificado.
server-list-packages (slp) [opciones]

Muestra una lista de los paquetes disponibles en el servidor remoto. Acepta los siguientes indicadores de opción:

  • -c,--conf=[nombre de archivo]: especifica el archivo de configuración que se usará, de lo contrario se utiliza el archivo por defecto (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target: restringe el listado al destino especificado.

Comando de duplicación

El comando de duplicación se utiliza para realizar la operación de duplicado incluida en zlmmirror.xml.

mirror (m) [opciones]

Realiza una operación de duplicación. Acepta los siguientes indicadores de opción:

  • -n, --dryrun: imprime los paquetes que se duplicarán o añadirán. No duplica nada.
  • -r, --re-download: vuelve a descargar el contenido aunque ya se haya duplicado.
  • -p, --packagesets: en servidores RCE y NU, incluye solamente parches de paquetes. (Esto excluye lotes de paquetes.)
  • -s, --sync-local: en un servidor ZENworks Linux Management remoto, sincroniza el archivo del servidor local con el archivo del servidor remoto.
  • --force-nevra: permite que un nuevo paquete con NEVRA conflictivo (nombre, época, versión, revisión y arquitectura) sobrescriba en un paquete existente.
  • -c, --conf=[nombre de archivo]: especifica el archivo de configuración que se usará. Si no se especifica, se utiliza el archivo por defecto (/etc/opt/novell/zenworks/zlmmirror.xml).
  • --category=[valor]: especifica valores como Seguridad, Recomendada y Opcional. Este valor tendrá prioridad con respecto a los valores especificados en el archivo de configuración de duplicación. Este comando es aplicable a los servidores RCE y NU.
  • -o, --remove-obsolete-patches: elimina los lotes de parches YOU duplicados del servidor local de ZENworks si dichos lotes se consideran obsoletos en el repositorio YOU. Si los lotes de parches YOU se duplican en una carpeta que contenga parches obsoletos, estos últimos se eliminarán de la carpeta. Esta opción sólo es aplicable al servidor de YOU.
  • -g, --retain-guid: conserva el GUID del lote al duplicar lotes entre los servidores de ZENworks Linux Management ubicados en distintas zonas de gestión. Los lotes se crean por defecto en el directorio Bundles/zlmmirror. Si existe algún lote con el mismo nombre en el servidor local, la duplicación del lote desde el servidor remoto no conserva el GUID del lote. Al duplicar lotes del servidor remoto, sólo se duplica en el servidor local el lote distribuido actualmente. En el servidor local se crea una nueva versión del lote independiente de la versión distribuida del lote del servidor remoto.

Opciones

-h , --ayuda

Muestra un mensaje de ayuda.

--log=[archivo de registro]

Registra los mensajes en un archivo. Si no se especifica un archivo de registro, se utiliza el archivo por defecto (/var/opt/novell/log/zenworks/zlmmirror.log).

-d , --detallado

Muestra una salida detallada.

--version

Imprime la información de la versión de zlmmirror y sale.

--remote-timeout=[segundos]

Interrupción de conexión de servidor remoto (segundos).

Archivos

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

El archivo de configuración por defecto.

Se debe crear un archivo XML de configuración distinto para cada servidor que se duplique. Se puede crear un archivo XML de plantilla mediante el comando conf-generate. Consulte la Guía de administración de ZENworks Linux Management para obtener información detallada sobre el duplicado.

A continuación, se incluye una descripción de las secciones incluidas en el archivo de configuración XML de zlmmirror. Debe proporcionar detalles acerca del servidor remoto que contenga el software que desea duplicar y del servidor local, que es el servidor ZLM que recibe el software duplicado, así como la información sobre los paquetes, lotes y catálogos que desea duplicar.

Servidor remoto

El servidor remoto se debe especificar conforme a la siguiente sintaxis:

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

Base: vía al servidor que desea duplicar con el siguiente formato, en función del tipo:

  • ZLM: https://servidor

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

  • RCE: https://servidor/vía

  • YaST: http(s)://servidor/vía o ftp://servidor/vía

  • RHN: http(s)://servidor/vía

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

  • YUM: archivo YUM para SUSE, como http://poincare.suse.de/testrepo/

Type: tipo de servidor que desea duplicar:

  • ZLM: ZENworks 7 Linux Management

  • DELL: servidor FTP de paquetes de actualización de Dell

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

  • YaST: YaST Online Updates

  • RHN: Red Hat Network

  • NU: actualizaciones Novell

  • YUM: Yellow Dog Updater, modificado

User: nombre que se debe usar para conectarse al servidor remoto. Si no se especifica ningún usuario, zlmmirror obtiene la identidad de la siguiente ubicación, en función del tipo.

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

  • RCE: /etc/ximian/mcookie

  • YaST: /etc/sysconfig/onlineupdate

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

  • YUM: no requiere autenticación.

Cuando se conecte a un servidor RHN o Dell, deje vacío este campo.

Password: contraseña que se debe usar para conectarse al servidor remoto. Si no se especifica ninguna contraseña, zlmmirror obtiene la contraseña de la siguiente ubicación, en función del tipo.

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

  • RCE: /etc/ximian/partnernet

  • YaST: /etc/sysconfig/onlineupdate

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

  • YUM: no requiere autenticación

Cuando se conecte a un servidor RHN o Dell, deje vacío este campo.

Proxy: este elemento de configuración es opcional y se usa con un servidor proxy de Internet. Puede añadir este elemento en cualquier lugar dentro de la sección RemoteServer. Si el servidor proxy de Internet requiere autenticación, el formato será similar al del siguiente ejemplo:

<Proxy>http://nombredeusuario:contraseña@servidor:puerto</Proxy>

Si el servidor proxy de Internet no requiere autenticación, el formato será similar al del siguiente ejemplo:

<Proxy>https://servidor:puerto</Proxy>

SystemID: para duplicar desde el servidor RHN, se debe añadir el elemento de configuración SystemID al archivo de configuración de zlmmirror. Puede utilizar el archivo systemid, que cuenta con una autenticación válida para el servidor RHN. Es preciso indicar la vía completa del archivo systemid ubicado en el servidor de ZENworks. El formato será semejante al del siguiente ejemplo:

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

Servidor local

El servidor local se debe especificar conforme a la siguiente sintaxis:

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

Base: si el atributo Type es ZLM, deje este campo vacío. Si el atributo Type es STATIC, indique la vía al directorio local en el que desee copiar los paquetes usando el siguiente formato: /vía/en/sistema_de_archivos.

Type: tipo de duplicado que desea realizar:

  • ZLM: duplica catálogos y paquetes directamente en el servidor ZENworks Linux Management. Después de la duplicación, los catálogos y los lotes duplicados se muestran en el Centro de control de ZENworks.

    No es posible realizar duplicados de ZLM en los servidores secundarios.

  • STATIC: duplica paquetes en el sistema de archivos del servidor ZENworks Linux Management, pero no los añade a ZENworks.

    Sólo se permite la duplicación estática en los servidores secundarios.

User: nombre que se debe utilizar para conectarse al servidor de ZENworks Linux Management (local). Es necesario especificar el usuario administrador si se desea usar la cuenta de administrador por defecto.

Password: contraseña de la cuenta del usuario indicada anteriormente. Si se usa la cuenta de administrador, ésta será la contraseña que se especificó durante la instalación del servidor.

Catálogos, lotes y paquetes

Cada lote y paquete que desee duplicar debe estar contenido en un catálogo en el servidor remoto, por lo que Catálogo es el único elemento necesario para duplicar un catálogo, lote o paquete. Un archivo de configuración puede disponer de varios elementos Catalog y cada catálogo que desee duplicar debe tener su propia entrada.

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

LocalName: nombre del catálogo donde desea ubicar el software duplicado. Si no se especifica ningún nombre local, se usa el nombre de catálogo del servidor de origen. El nombre local del catálogo no deber ser igual al reservado para la carpeta <nombre_catálogo>-patches.

Carpeta: especifica la carpeta eDir (como /folder1/folder2) donde se crean y actualizan lotes y catálogos. Si no se especifica ningún valor, los catálogos y los lotes se crean y actualizan en la carpeta /zlmmirror.

Target: limita la operación de duplicación del catálogo a los paquetes y parches compatibles con las plataformas de destino especificadas. Si no se especifica el destino, se duplican los paquetes para todas las plataformas. Este elemento puede especificarse en múltiples ocasiones y puede contener un nombre de destino o una cadena de expresión regular para los nombres de destino coincidentes. Por ejemplo, para incluir destinos que comiencen con sles como sles-9-i586, utilice sles de expresión regular <Target>.*</Target>.

ExcludeTarget: lo mismo que para Target, se excluyen excepto paquetes y parches que admitan plataformas de destino especificado. La función de excluir destinos (ExcludeTarget) se realiza después de mostrar los destinos en cuestión (Target), por lo que las plataformas que aparezcan en ambos sitios se excluirán en última instancia. Por ejemplo, para excluir destinos que terminan por i586, como sles-9-i586, use la expresión regular <ExcludeTarget>.*i586</ExcludeTarget>.

Bundle: limita la operación de duplicación del catálogo sólo a los lotes especificados. Si no se especifica un lote, se duplican todos los lotes. Esta opción sólo es válida para los servidores origen ZLM y YaST. Puede especificarse en múltiples ocasiones y puede contener un nombre de lote o una cadena de expresión regular para nombres de lotes coincidentes. Consulte la siguiente nota acerca de expresiones regulares para obtener más información.

LocalBundleName: vuelve a nombrar el lote localmente. Esto sólo se aplica a servicios RCE, NU y RHN, donde un catálogo tiene solo un lote en el servidor remoto. Si especifica <LocalBundleName>, no debe especificar la etiqueta <Bundle>. Esta etiqueta no es aplicable al duplicar OES desde el servicio RCE con más de un lote por catálogo.

ExcludeBundle: lo mismo que para Bundle, excepto paquetes y parches del lote especificado. Esta opción es válida solamente para servidores origen ZLM y YaST, puede especificarse en múltiples ocasiones y puede contener un nombre de lote o una cadena de expresión regular para nombres de lotes coincidentes. La función de excluir lotes (ExcludeBundle) se realiza después de mostrar los lotes en cuestión (Target), por lo que los lotes que aparezcan en ambos sitios se excluirán en última instancia. Consulte la siguiente nota acerca de expresiones regulares para obtener más información.

Package: limita la operación de duplicación del catálogo sólo a los paquetes especificados. Si no se especifica el paquete, se duplican todos los paquetes. Esta opción puede especificarse en múltiples ocasiones y puede contener un nombre de destino o una cadena de expresión regular para los nombres de destino coincidentes. Esta opción no se puede utilizar con lotes de parches. Los servidores remotos del tipo RCE, YaST y NU no permiten que se filtren paquetes en un lote de parches. Consulte la siguiente nota acerca de expresiones regulares para obtener más información.

ExcludePackage: igual que la función de paquete (Package), con la excepción de que se excluyen los paquetes especificados. Esta opción puede especificarse en múltiples ocasiones y puede contener un nombre de destino o una cadena de expresión regular para los nombres de destino coincidentes. Los parches YOU no admiten esta opción. La función de excluir paquetes (ExcludePackage) se realiza después de mostrar los paquetes en cuestión (Package), por lo que los paquetes que aparezcan en ambos sitios se excluirán en última instancia. Consulte la siguiente nota acerca de expresiones regulares para obtener más información.

Categoría: limita la operación de duplicación del catálogo a las categorías de lotes de parches especificados. Si no se especifica la categoría, se duplicarán todos los lotes de parches. Los valores válidos son recomendado, opcional y seguridad. Esta etiqueta sólo es aplicable a los servidores de tipo RCE y NU de SLES 10, SLED 10 y OES 2.

ServicePackGroups: acepta sólo valores booleanos (verdadero o falso). <ServicePackGroups> se establece en verdadero por defecto y crea automáticamente grupos de lotes. Los parches YOU sólo admiten esta opción.

AutoDeploy: el duplicado de paquetes del lote existente crea una nueva versión del lote y lo activa en el servidor. Si AutoDeploy se establece en falso, la operación de duplicado restringe la activación del nuevo lote. Acepta sólo valores booleanos (verdadero o falso). La opción se establece en verdadero por defecto.

CreateMonolithicBundle: crea automáticamente lotes de paquetes monolíticos que incluyen únicamente los últimos RPM de paquete. Permite crear un lote monolítico independiente para cada versión de Service Pack y otro lote monolítico independiente con las actualizaciones posteriores a la última versión de Service Pack. Acepta sólo valores booleanos (verdadero o falso). La opción se establece en verdadero por defecto. Esta opción la admiten únicamente los parches YOU.

FilterPatchRPM: restringe la operación de duplicado para los lotes de parches YOU para filtrar todos los paquetes del tipo .patch.rpm. Esta opción crea un lote de paquete RPM equivalente en el servidor local. Acepta sólo valores booleanos (verdadero o falso). La opción se establece en falso por defecto. Los parches YOU no admiten esta opción.

NOTA:el uso de expresiones regulares (regexes) se ha modificado en ZENworks 7.3 Linux Management. ZENworks Linux Management no utiliza correspondencia de caracteres comodín. En ZENworks Linux Management 6.6.x, puede utilizar una cadena de expresión comodín en lugar de una regular. En ZENworks 7.3 Linux Management, se debe usar <Bundle>patch-.*</Bundle> para duplicar todos los lotes con un nombre que comienza por “patch-”. ZENworks Linux Management admite todas las expresiones regulares de Java. Para obtener más información acerca de expresiones regulares de Java, consulte la documentación de Java.

Autores

Copyright 2005-2009, Novell, Inc.. Reservados todos los derechos.

Véase

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

Para informar sobre problemas relacionados con este software o su documentación, visite Novell Bugzilla.