zlmmirror (1)

Name

zlmmirror - Espelha bundles e catálogos de software, total ou parcialmente, de servidores remotos ZENworks® Linux Management, YaST Online Updates, Novell Updates, YUM e Red Hat Network para seu servidor local ZENworks Linux Management ou para um diretório local. Para obter informações detalhadas sobre como espelhar Pacotes de Atualização Dell em seu servidor ZENworks, consulte Espelhando software no Guia de Administração do Novell Zenworks 7.3 Linux Management.

Sintaxe:

zlmmirror [comando] [opções] [argumentos]

Este comando lê as informações necessárias à conexão com o servidor local e remoto em um arquivo de configuração XML. O Guia de Administração do Novell Zenworks 7.3 Linux Management contém informações detalhadas sobre a criação de arquivos de configuração do zlmmirror.

Descrição

O zlmmirror permite que você se conecte a um servidor remoto e copie catálogos, bundles ou pacotes de software do servidor remoto para o seu servidor usando alguns comandos simples. O software pode ser espelhado dos seguintes servidores:

  • ZENworks Linux Management

  • DUPs (Dell Update Packages - Pacotes de Atualização Dell)

  • YAST Online Updates

  • Red Hat* Network

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

  • Novell Updates

  • YUM

A Novell®, a Dell, a SUSE e a Red Hat mantêm servidores de seus respectivos tipos, para que você possa espelhar de forma simples os catálogos e os bundles de seu interesse, sem precisar manter ou atualizar esses repositórios. O espelhamento é o método preferido para obter a maioria dos softwares que você distribui para dispositivos gerenciados.

Durante o uso, o zlmmirror conecta-se ao servidor remoto, ao servidor local e ao programa zlman, autenticando-se a cada conexão. Ele deve ser executado no mesmo sistema que o zlman e o restante do servidor ZENworks Linux Management e exige privilégios root.

Comandos

Todos os comandos abaixo aceitam os flags de opções listados na seção Opções Globais. Eles também aceitam as opções individuais listadas com cada um deles.

Comandos de Configuração

Esses comandos são usados para criar, converter e validar os arquivos de configuração do zlmmirror.

conf-convert (cc) [opções] [arquivo a converter] [nome do arquivo convertido]

Converte o arquivo de configuração rcmirror.conf especificado no novo formato XML.

conf-generate (cg) [opções] [nomedoarquivo de destino]

Cria um novo arquivo de configuração vazio mostrando todos os campos possíveis.

conf-validate (cv) [opções] [nomedoarquivo]

Verifica se há erros no arquivo de configuração e exibe as informações de configuração analisadas.

Comandos de catálogo e de bundle

Esses comandos permitem que você veja os catálogos, bundles e pacotes no servidor remoto.

bundle-list-packages (blp) [opções] [bundle] [catálogo]

Lista os pacotes disponíveis no bundle especificado. Aceita os seguintes flags de opção:

  • -c,--conf=[nomedoarquivo] - Especifica o arquivo de configuração a ser usado; caso contrário, será usado o padrão (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target - Restringe a lista ao destino especificado.
catalog-list-bundles(clb) [opções] [catálogo]

Lista os bundles disponíveis no catálogo especificado. Aceita os seguintes flags de opção:

  • -c,--conf=[nomedoarquivo] - Especifica o arquivo de configuração a ser usado; caso contrário, será usado o padrão (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target - Restringe a lista ao destino especificado.
catalog-list-packages (clp) [opções] [catálogo]

Lista os pacotes disponíveis no catálogo especificado. Aceita os seguintes flags de opção:

  • -c,--conf=[nomedoarquivo] - Especifica o arquivo de configuração a ser usado; caso contrário, será usado o padrão (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target - Restringe a lista ao destino especificado.
server-list-bundles (slb) [opções]

Lista os bundles disponíveis no servidor remoto. Aceita os seguintes flags de opção:

  • -p,--packages - Para servidores RCE, inclui apenas bundles de patch. (Isto exclui os bundles de conjunto de pacote)
  • -c,--conf=[nomedoarquivo] - Especifica o arquivo de configuração a ser usado; caso contrário, será usado o padrão (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target - Restringe a lista ao destino especificado.
server-list-catalogs (slc) [opções]

Lista os catálogos disponíveis no servidor remoto. Aceita os seguintes flags de opção:

  • -c,--conf=[nomedoarquivo] - Especifica o arquivo de configuração a ser usado; caso contrário, será usado o padrão (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target - Restringe a lista ao destino especificado.
server-list-packages (slp) [opções]

Lista os pacotes disponíveis no servidor remoto. Aceita os seguintes flags de opção:

  • -c,--conf=[nomedoarquivo] - Especifica o arquivo de configuração a ser usado; caso contrário, será usado o padrão (/etc/opt/novell/zenworks/zlmmirror.xml).
  • -t,--target - Restringe a lista ao destino especificado.

Comando Espelhado

O comando mirror é usado para executar a operação de espelhamento real contida no zlmmirror.xml.

mirror (m) [opções]

Realiza uma operação de espelhamento. Aceita os seguintes flags de opção:

  • -n, --dryrun - Imprime os pacotes a serem espelhados ou adicionados. Ele não espelha nada.
  • -r, --re-download - Refaz o download dos conteúdos, mesmo que eles já tenham sido espelhados.
  • -p, --packagesets - Para servidores RCE e NU, inclui apenas bundles de patch. (Isto exclui os bundles de conjunto de pacote).
  • -s, --sync-local - Para um servidor remoto ZENworks Linux Management, sincroniza o repositório do servidor local com o repositório do servidor remoto.
  • --force-nevra - Permite que um novo pacote com NEVRA (nome, época, versão, release e arquitetura) em conflito sobregrave um pacote existente.
  • -c, --conf=[nomedoarquivo] - Especifica o arquivo de configuração a ser usado. Se não for especificado, o arquivo padrão (/etc/opt/novell/zenworks/zlmmirror.xml) será usado.
  • --category=[valor] - Especifica valores como segurança, recomendado ou opcional. Este valor terá precedência sobre os valores que você especificar no arquivo de configuração de espelhamento. Este comando se aplica aos servidores RCE e NU.
  • -o, --remove-obsolete-patches - Remove os bundles de patch YOU espelhados do servidor ZENworks local se os bundles estiverem obsoletos no repositório YOU. Se os bundles de patch YOU forem espelhados em uma pasta que contém os patches obsoletos, estes serão removidos dessa pasta. Esta opção se aplica apenas ao servidor YOU.
  • -g, --retain-guid - Retém o GUID do bundle ao espelhar bundles entre Servidores ZENworks Linux Management localizados em diferentes zonas de gerenciamento. Por padrão, os bundles são criados no diretório Bundles/zlmmirror. Se já houver um bundle com o mesmo nome no servidor local, o espelhamento dele a partir do servidor remoto não manterá o GUID do bundle. Quando você espelha bundles a partir do servidor remoto, apenas o bundle que está atualmente implantado é espelhado para o servidor local. Uma nova versão do bundle é criada no servidor local, independentemente da versão distribuída do bundle no servidor remoto.

Opções

-h , --ajuda

Exibe uma mensagem de ajuda.

--log=[arquivoderegistro]

Registra mensagens em um arquivo. Se nenhum arquivo de registro for especificado, o padrão (/var/opt/novell/log/zenworks/zlmmirror.log) será usado.

-v , --verbose

Exibe a saída verbosa.

--versão

Imprime as informações de versão do zlmmirror e encerra.

--remote-timeout=[segundos]

Tempo de espera de conexão do servidor remoto (segundos).

Arquivos

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

O arquivo de configuração padrão.

Você deve criar uma configuração XML diferente para cada servidor remoto que espelhar. É possível criar um arquivo XML de gabarito usando o comando conf-generate. Consulte o Guia de Administração do ZENworks Linux Management para obter instruções detalhadas sobre espelhamento.

Veja abaixo uma descrição das seções contidas no arquivo de configuração XML do zlmmirror. Forneça detalhes sobre o servidor remoto que contém o software que deseja espelhar e o servidor local, que é o servidor ZLM que recebe o software espelhado, bem como informações sobre os catálogos, os bundles e os pacotes a serem espelhados.

Servidor remoto

O servidor remoto é especificado de acordo com o seguinte:

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

Base - Caminho para o servidor que deseja espelhar, no formato a seguir, dependendo de Type:

  • ZLM: https://servidor

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

  • RCE: https://servidor/caminho

  • YaST: http(s)://servidor/caminho ou ftp://servidor/caminho

  • RHN: http(s)://servidor/caminho

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

  • YUM: repositórios YUM para SUSE, como http://poincare.suse.de/testrepo/

Type - Tipo de servidor que você deseja espelhar:

  • ZLM: ZENworks 7 Linux Management

  • DELL: Servidor FTP do Pacote de Atualização 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, Modificado

Usuário - Nome a ser usado para conexão ao servidor remoto. Se nenhum usuário for especificado, o zlmmirror lerá a identidade do seguinte local, dependendo de Type:

  • ZLM: /etc/opt/novell/zenworks/zmd/deviceid no SLES 9 e OES, e em /etc/zmd/deviceid no SLES 10 e SLED 10

  • RCE: /etc/ximian/mcookie

  • YaST: /etc/sysconfig/onlineupdate

  • NU: /etc/opt/novell/zenworks/zmd/deviceid no SLES 9 e OES, e em /etc/zmd/deviceid no SLES 10 e SLED 10

  • YUM: Não requer nenhum tipo de autenticação.

Quando você se conectar em um servidor RHN ou Dell, deixe esse elemento vazio.

Senha - Senha a ser usada para a conexão com o servidor remoto. Se nenhuma senha for especificada, o zlmmirror lerá a senha do seguinte local, dependendo de Type:

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

  • RCE: /etc/ximian/partnernet

  • YaST: /etc/sysconfig/onlineupdate

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

  • YUM: Não requer nenhum tipo de autenticação.

Quando você se conectar em um servidor RHN ou Dell, deixe esse elemento vazio.

Proxy - O elemento de configuração de proxy é opcional e é usado com um Proxy da Internet. Você pode adicionar o elemento Proxy em qualquer ponto na seção RemoteServer. Se o proxy da Internet exigir autenticação, o formato será igual ao exemplo a seguir:

<Proxy>http://nomedeusuário:senha@servidor:porta</Proxy>

Se o proxy da Internet não exigir autenticação, o formato será como o deste exemplo:

<Proxy>https://servidor:porta</Proxy>

SystemID - Para espelhar do servidor RHN, é necessário adicionar o elemento de configuração do SystemID no arquivo de configuração do zlmmirror. Você pode usar o arquivo systemid que tenha uma autenticação válida para o servidor RHN. É necessário fornecer o caminho completo do arquivo systemid localizado no Servidor ZENworks. O formato é parecido com o do exemplo a seguir:

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

Servidor local

O servidor local é especificado de acordo com o seguinte:

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

Base - Se o atributo Tipo for ZLM, deixe esse campo em branco. Se o atributo Type for STATIC, digite o caminho do diretório local em que deseja copiar os pacotes, no seguinte formato: /caminho/no/sistema_de_arquivos.

Tipo - Tipo de espelhamento que deseja realizar:

  • ZLM: Espelha catálogos e bundles diretamente para o seu servidor ZENworks Linux Management. Após o espelhamento, os catálogos e bundles espelhados são exibidos no ZENworks Control Center.

    Não é possível executar espelhamento do ZLM em servidores secundários.

  • STATIC: Espelha pacotes no sistema de arquivos do servidor ZENworks Linux Management, mas não os adiciona ao ZENworks.

    Você pode executar apenas espelhamento estático em servidores secundários.

Usuário - Nome a ser usado durante a conexão com o servidor ZENworks Linux Management (local). O usuário Administrador deverá ser especificado se você desejar usar a conta de administrador padrão.

Senha - Senha para a conta fornecida em Usuário. Se você estiver usando a conta de Administrador, esta será a senha especificada durante a instalação do servidor.

Catálogos, Bundles e Pacotes

Cada bundle e pacote que você quiser espelhar deverá estar contido em um catálogo no servidor remoto, portanto, Catálogo é o único item necessário para espelhar um catálogo, bundle ou pacote. Um arquivo de configuração pode ter Vários elementos Catalog e cada catálogo que você quiser espelhar deverá ter sua própria entrada.

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

Local Name - Nome do catálogo em que deve ser incluído o software espelhado. Se nenhum Nome de Local for especificado, será usado o nome do catálogo do servidor de origem. O nome local para o catálogo não deve ser o mesmo daquele reservado para a pasta <catalogname>-patches.

Pasta - Especifica a pasta eDir (por exemplo, /folder1/folder2) em que os bundles e os catálogos serão criados e atualizados. Se não for especificada, os catálogos e bundles serão criados e atualizados na pasta /zlmmirror.

Target - Restringe a operação de espelhamento no catálogo aos pacotes e patches que oferecem suporte às plataformas de destino especificadas. Se não for especificado um destino, os pacotes de todas as plataformas serão espelhados. Esse elemento pode ser especificado várias vezes e pode conter um nome de destino ou uma string de expressão regular para correspondência de nomes de destino. Por exemplo, para incluir destinos que comecem com sles, como sles-9-i586, use a expressão <Target>sles regular.*</Target>.

ExcludeTarget - O mesmo que Target, com a exceção de que os pacotes e os patches que suportam as plataformas de destino especificadas são excluídos. ExcludeTarget é executado depois de Target; portanto, as plataformas que constam de Target e ExcludeTarget são excluídas. Por exemplo, para excluir destinos que terminem com i586, como sles-9-i586, use a expressão regular <ExcludeTarget>.*i586</ExcludeTarget>.

Bundle - Restringe a operação de espelhamento no catálogo aos bundles especificados. Se o bundle não for especificado, todos os bundles serão espelhados. Esta opção é válida apenas para servidores de origem ZLM e YaST. Ela pode ser especificada várias vezes e conter um nome de bundle ou uma string de expressão regular para correspondência de nomes de bundle. Consulte abaixo a nota sobre expressões regulares para obter mais informações.

LocalBundleName - Renomeia o nome de bundle localmente. Isto é aplicável apenas para os serviços RCE, NU e RHN nos quais um catálogo tem apenas um bundle no servidor remoto. Se você especificar <LocalBundleName>, não deverá especificar o tag <Bundle>. Esta tag não se aplica quando você espelha o OES do serviço RCE com mais de um bundle por catálogo.

ExcludeBundle - Semelhante a Bundle, com a exceção de que os pacotes e patches contidos no bundle ou bundles especificados são excluídos. Esta opção é válida apenas para servidores de origem ZLM e YaST, pode ser especificada várias vezes e pode conter um nome de bundle ou uma string de expressão regular para a correspondência dos nomes de bundles. ExcludeBundle é executado depois de Bundle; portanto, os bundles que constam de Bundle e ExcludeBundle são excluídos. Consulte abaixo a nota sobre expressões regulares para obter mais informações.

Pacote - Restringe a operação de espelhamento no catálogo aos pacotes especificados. Se o pacote não for especificado, todos os pacotes serão espelhados. Esse elemento pode ser especificado várias vezes e pode conter um nome de pacote ou uma string de expressão regular para correspondência de nomes de pacote. Esta opção não é suportada por bundles de patch. A filtragem de pacotes em um bundle de patch não é suportada para servidores remotos dos tipos RCE, YaST e NU. Para obter mais informações, consulte abaixo a nota sobre expressões regulares.

ExcludePackage - O mesmo que Package, exceto que os pacotes especificados são excluídos. Esse elemento pode ser especificado várias vezes e pode conter um nome de pacote ou uma string de expressão regular para correspondência de nomes de pacote. Esta opção não é suportada por patches YOU. ExcludePackage é executado depois de Package; portanto, os pacotes que constam de Package e ExcludePackage são excluídos. Consulte abaixo a nota sobre expressões regulares para obter mais informações.

Categoria - Restringe a operação de espelhamento no catálogo às categorias especificadas de bundles de patch. Se a categoria não for especificada, todos os bundles de patch serão espelhados. Os valores válidos são recomendado, opcional e segurança. Esta tag aplica-se apenas aos servidores do tipo RCE e NU do SLES 10, SLED 10 e OES 2.

ServicePackGroups - Aceita apenas valores Booleanos (verdadeiro ou falso). Por padrão, <ServicePackGroups> é definido como verdadeiro e cria grupos de bundle automaticamente. Esta opção é suportada apenas por patches YOU.

AutoDeploy - O espelhamento de pacotes em um bundle existente cria uma versão mais nova do bundle e a distribui no servidor. Se AutoDeploy for definido como falso, a operação de espelhamento restringirá a distribuição do bundle mais novo. Aceita somente valores booleanos (verdadeiro ou falso). Por padrão, a opção é definida como verdadeiro.

CreateMonolithicBundle - Cria automaticamente bundles de pacote monolíticos que consistem apenas nos rpms de pacote mais recentes. Cria um bundle monolítico separado para cada versão do Service Pack, e um bundle monolítico separado com as atualizações após a versão mais recente do Service Pack. Aceita apenas valores Booleanos (verdadeiro ou falso). Por padrão, a opção é definida como verdadeiro. Esta opção é suportada apenas por patches YOU.

FilterPatchRPM - Restringe a operação de espelhamento dos bundles de patch YOU para filtrar todos os pacotes do tipo .patch.rpm. Esta opção cria um bundle de pacote RPM equivalente no servidor local. Aceita somente valores Booleanos (verdadeiro ou falso). Por padrão, a opção é definida como falso. Esta opção é suportada somente para patches YOU.

NOTA:O uso de expressões regulares (regexes) foi modificado no ZENworks 7.3 Linux Management. O ZENworks Linux Management não usa correspondência de caracteres curinga. No ZENworks Linux Management 6.6.x, é possível usar uma string de expressão de caractere curinga em vez de uma string de expressão regular. No ZENworks 7.3 Linux Management, você deve usar <Bundle>patch-.*</Bundle> para espelhar todos os bundles com um nome que comece com “patch-”. O ZENworks Linux Management suporta todas as expressões Java regulares. Para obter mais informações sobre expressões regulares Java, consulte a documentação do Java.

Autores

Copyright 2005-2009, Novell, Inc.. Todos os direitos reservados.

Consulte Também

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

Para relatar problemas deste software ou de sua documentação, visite o Novell Bugzilla.