rug - A interface de linha de comando para o Agente do Novell ZENworks Linux Management.
O utilitário rug é a interface de linha de comando do agente do ZENworks Linux Management. Ele funciona com o daemon do ZENworks Linux Management para instalar, atualizar e remover softwares de acordo com os comandos fornecidos. O software que ele instala pode ser dos servidores ZENworks 7.x Linux Management, ZENworks 6.6.x Linux Management, repositórios YUM, serviço ZYPP, assim como de arquivos locais.
Os servidores ZENworks Linux Management classificam softwares por categoria em catálogos, que são grupos de softwares semelhantes. Por exemplo, um catálogo pode conter software do fornecedor do sistema operacional, e outro catálogo pode conter o SUSE Linux Enterprise Desktop. Você pode inscrever-se em catálogos individuais para controlar a exibição de pacotes disponíveis e evitar a instalação acidental de um software indesejado. Por padrão, todas as operações são realizadas em software de dentro de catálogos em que você se inscreveu, embora você possa alterar isso com o flag --allow-unsubscribed. O utilitário rug também fornece outros recursos, como rollback, bloqueios, histórico e preferências para facilitar o gerenciamento de pacotes e bundles.
Dependendo do tipo de dispositivo gerenciado, a localização do utilitário rug poderá variar.
Para dispositivos SUSE Linux Enterprise Server 10 (SLES 10) e SUSE LINUX Enterprise Desktop 10 (SLED 10), o utilitário rug está localizado no seguinte diretório:
/usr/bin
Em todos os outros dispositivos gerenciados, o utilitário rug é instalado na seguinte localização:
/opt/novell/zenworks/bin
Esta seção contém um guia para as convenções e a formatação gerais de comandos.
Se nenhuma pasta for especificada para os comandos que utilizam um argumento de pasta, o comando terá como destino a pasta raiz. Para especificar um caminho de pasta, liste cada pasta da raiz separada por uma barra (/). Por exemplo, se você tiver uma pasta chamada folder1 na raiz, contendo uma subpasta chamada subfolder1, você fará referência a essa pasta como folder1/subfolder1. Cada pasta especificada já deverá existir.
As reticências indicam que um comando aceita várias entradas do último tipo de argumento. Por exemplo, as reticências no comando a seguir indicam que catalog-add-bundle pode aceitar vários bundles:
rug bundle-history [opções] [string-de-pesquisa] [...]
Os comandos que não têm opções específicas de comando (aceitam apenas os flags de opção padrão) não têm as opções listadas como um argumento na referência do comando. Por exemplo, a entrada de referência para o comando a seguir não lista opções, pois ele aceita somente os flags padrão:
rug list-updates (lu) [catálogo]
Contudo, o comando a seguir lista opções, pois o comando tem uma opção específica de comando (-a):
rug bundle-history [opções] [string-de-pesquisa] [...]
rug fornece um número de comandos (mostrado como [comando] na seção Sintaxe:). Cada comando aceita os flags de opção listados na seção Opções globais. Além disso, vários deles têm flags de opção específicos, listados com os comandos.
O comando mais usado é rug update que faz download e instala atualizações nos catálogos nos quais você se inscreveu.
Pesquisa as entradas de registro de bundle para as strings especificadas por [string-de-pesquisa]. Aceita os seguintes flags de opção:
Instala os bundles especificados. A rug tenta localizar os bundles especificados nos catálogos em que você se inscreveu. Use bundle-upgrade para atualizar um bundle já instalado. Aceita os seguintes flags de opção:
NOTA:As opções -N e -r não se aplicam a Bundles de arquivos.
Lista bundles disponíveis em catálogos em que você se inscreveu.
A saída para este comando é apresentada nas seguintes colunas: Status, Catálogo, Nome, Versão e Tipo. As colunas fornecem os detalhes de cada bundle designado ou disponível para o dispositivo gerenciado. Catálogo, Nome, Versão e Tipo representam o nome do catálogo, nome do bundle, versão do bundle e tipo do bundle, respectivamente.
O campo Status ficará vazio se o bundle não for instalado, exibirá “i” se o bundle estiver instalado, “v” se o bundle estiver instalado, mas for de uma versão diferente em comparação com aquela exibida na lista, e “*” se o bundle estiver parcialmente instalado.
Por padrão, o comando mostra o nome do bundle de exibição.
Aceita os seguintes flags de opção:
Adiciona uma regra de bloqueio de bundle. Isso impede mudanças no estado de instalação do bundle não especificado no bloqueio. O nome do bundle pode ser especificado individualmente, com padrões de caractere curinga ou até mesmo com relações de número de versão. Por exemplo, o comando rug bla gnome* recusa-se a remover quaisquer bundles que comecem com “gnome”. Aceita as seguintes opções:
-c, --catalog - Catálogo para correspondência no bloqueio.
Apaga o bloqueio de bundle especificado pelo número. É possível encontrar os números de cada bloqueio de bundle com o comando lock-list (bll).
Lista os bloqueios em vigor. Os bloqueios são classificados por número de ID. Os bundles bloqueados pelo administrador no servidor não são listados.
Remove os bundles especificados. Aceita os seguintes flags de opção:
NOTA:As opções -N e -r não se aplicam a Bundles de arquivos.
Pesquisa os bundles que correspondem à string de consulta. Aceita os seguintes flags de opção:
Lista os tipos de bundle disponíveis.
Faz upgrade dos bundles. Aceita os seguintes flags de opção:
NOTA:As opções -N e -r não se aplicam a Bundles de arquivos.
Lista os catálogos disponíveis para os serviços adicionados. Aceita os seguintes flags de opção:
-u, --uri - Mostrar o URI do serviço.
Inscreve-se nos catálogos especificados. Cada catálogo especificado deve estar disponível em um dos serviços adicionados. Aceita os seguintes flags de opção:
Cancela a assinatura dos catálogos especificados. Aceita os seguintes flags de opção:
Mostra os arquivos em um determinado bundle de arquivo. Aceita o seguinte flag de opção:
A coluna Status ficará vazia se o arquivo não for instalado. Exibirá “i” se o arquivo estiver instalado, “c” se o arquivo estiver compactado ou “p” se o arquivo for de uma versão anterior à instalada no dispositivo.
Mostra os pacotes em um bundle determinado. Aceita os seguintes flags de opção:
Se a opção --show-nevra não for especificada, a saída para este comando será apresentada nas colunas Status, Catálogo, Nome, Versão e Arq. Elas fornecem os detalhes de cada pacote que faz parte do bundle determinado. Catálogo, Nome, Versão e Arq representam, respectivamente, nome do catálogo, nome do pacote, versão do pacote e arquitetura do pacote.
A coluna Status ficará vazia se o pacote não for instalado. Exibirá “i” se o pacote estiver instalado, “v” se houver uma versão diferente do pacote instalada no dispositivo ou “s” se o pacote do bundle for de uma versão anterior à instalada no dispositivo.
A descrição dessas colunas é a mesma com outros comandos de pacote.
Se a opção --show-nevra for especificada, a saída para este comando será representada nas colunas Status, Catálogo, Nome, Época, Versão, Release, e Arq.
-g,--use-guid - Consulte os bundles pelos respectivos GUIDs.
Adiciona um ponto de verificação. Se a data não for especificada, adicionará um ponto de verificação com a data atual.
Remove os pontos de verificação especificados.
Obtém uma lista de pontos de verificação gravados.
Obtém um dump de informações do sistema como um banco de dados SQLite.
Lista arquivos contidos em um pacote.
Pesquisa no histórico do pacote o termo de pesquisa especificado. Por padrão, pesquisa nomes de pacotes para o termo de pesquisa, exibindo o histórico da versão do pacote. Use os flags de opção a seguir para executar uma pesquisa diferente:
Exibe informações completas para o pacote especificado. Aceita os seguintes flags de opção:
Lista todos os conflitos do pacote especificado.
Lista todas as informações obsoletas do pacote especificado.
Lista as informações fornecidas pelo pacote especificado.
Lista os requisitos do pacote. Aceita os seguintes flags de opção:
Instala os resolvíveis especificados. Se um usuário solicitar um pacote com uma versão, o zmd instalará a versão exata do pacote. Se a versão do pacote não for especificada, o zmd instalará a melhor versão do pacote. Nas plataformas SLES 10 e SLED 10, o resolvableType pode ser um pacote, padrão, produto ou patch; por padrão ele é pacote. Aceita os seguintes flags de opção:
Lista os tipos resolvíveis disponíveis.
Exibe atualizações disponíveis nos catálogos especificados. A adição de catálogos como argumentos limita a lista dos catálogos que você especificou. Se você não estiver inscrito em um catálogo, nenhuma atualização estará disponível, mesmo que você nomeie o catálogo como um argumento. É preciso inscrever-se para listar atualizações.
Se a saída desse comando não corresponder às atualizações pendentes listadas no servidor, será porque essas atualizações pendentes exibem atualizações de todos os catálogos disponíveis e não apenas dos catálogos em que o cliente está inscrito. Para que as listas se correspondam, o cliente deverá estar inscrito em todos os catálogos disponíveis.
Aceita os seguintes flags de opção:
-t, --type - Especificar o tipo de atualização.
Adiciona uma regra de bloqueio de pacote. Isso impede mudanças no estado de instalação do pacote especificado no bloqueio. O nome do pacote pode ser especificado individualmente, com padrões de caractere curinga ou até mesmo com relações de número de versão.
O package_name pode incluir caracteres curingas. A tabela a seguir explica os operadores relacionais válidos que podem ser usados com o pacote no comando:
Se quiser instalar uma versão específica do pacote ZENworks, verifique primeiro se a versão do pacote foi bloqueada e, em seguida, instale a versão do pacote somente se ela não estiver bloqueada. Por exemplo, suponhamos que todas as versões posteriores do pacote, “X 1.7” foram bloqueadas usando o comando rug la X >1.7. Se você tentar instalar o pacote X 1.9 usando o comando rug in X (1.9), a ação falhará.
Apaga o bloqueio de pacote especificado pelo número. Para encontrar o número de cada bloqueio, use o comando lock-list (ll).
Lista os bloqueios de pacote em vigor. Os bloqueios são classificados por número de ID.
Obtém o pacote que contém o arquivo especificado.
Exibe os pacotes de um determinado catálogo. Se nenhum catálogo for especificado, todos os pacotes em todos os catálogos serão listados. Aceita os seguintes flags de opção:
Se a opção --show-nevra não for especificada, a saída para este comando será apresentada nas colunas Status, Bundle, Nome, Versão e Arq. Elas fornecem os detalhes de cada pacote que faz parte do bundle determinado. Bundle, Nome, Versão e Arq representam, respectivamente, nome do bundle, nome do pacote, versão do pacote e arquitetura do pacote. O campo Status ficará vazio se o pacote não estiver instalado, exibirá “i” se o pacote estiver instalado ou “v” se o pacote estiver instalado, mas for de uma versão diferente em comparação com aquela exibida na lista.
A descrição dessas colunas é a mesma com outros comandos de pacote.
Se a opção --show-nevra for especificada, a saída para este comando será representada pelas colunas Bundle, Nome, Época, Versão, Release e Arq.
Procura patches que correspondam a um padrão. Aceita os seguintes flags de opção:
Remove os pacotes especificados. Aceita os seguintes flags de opção:
Faz rollback das transações de pacote para o horário e a data especificada. Define a preferência de rollback, que fica desabilitada por padrão. Aceita os seguintes flags de opção:
Procura pacotes que correspondam a um padrão. Aceita os seguintes flags de opção:
Se a opção --show-nevra não for especificada, a saída para este comando será apresentada nas colunas Status, Catálogo, Bundle, Nome, Versão e Arq. Elas fornecem os detalhes de cada pacote que faz parte do bundle determinado. Catálogo, Bundle, Nome, Versão e Arq representam, respectivamente, nome do catálogo, nome do bundle, nome do pacote, versão do pacote e arquitetura do pacote. O campo Status ficará vazio se o pacote não estiver instalado, exibirá “i” se o pacote estiver instalado ou “v” se o pacote estiver instalado, mas for de uma versão diferente em comparação com aquela exibida na lista.
A descrição dessas colunas é a mesma com outros comandos de pacote.
Se a opção --show-nevra for especificada, a saída para este comando será apresentada nas colunas Status, Catálogo, Bundle, Nome, Época, Versão, Release e Arq.
Mostra um resumo de atualizações disponíveis para cada catálogo.
Instala e faz download de atualizações. Se não houver argumentos, serão instaladas atualizações para todos os catálogos assinados. Fornece o nome de catálogo para manter as atualizações específicas dos catálogos mencionados. Para bundles ou pacotes únicos, use rug install. Se não estiver inscrito em um catálogo, nenhuma atualização estará disponível, mesmo que você liste o catálogo como um argumento. É preciso que você se inscreva para instalar atualizações. Aceita os seguintes flags de opção:
Verifica as dependências do sistema. Quando as dependências do sistema não são atendidas, o rug sugere a remoção ou a instalação de pacotes necessários para resolver conflitos. Aceita os seguintes flags de opção:
Lista pacotes que entram em conflito com o item especificado.
Exibe pacotes que fornecem a biblioteca, o programa ou o pacote especificado como [string de consulta].
Lista pacotes que solicitam a biblioteca, o programa ou o pacote especificado como [string de consulta].
Mostra os patches em um determinado catálogo. Aceita os seguintes flags de opção:
Mostra informações detalhadas sobre um patch.
Mostra informações detalhadas sobre um padrão.
Mostra os padrões em um determinado catálogo. Aceita os seguintes flags de opção:
Lista as políticas efetivas designadas aos dispositivos, junto com seus detalhes de programação.
Exibe o valor do token de preferência especificado. Se nenhum token for fornecido, todas as preferências serão exibidas. Aceita o seguinte flag de opção:
Define uma variável de preferência.
Use rug get para exibir as preferências e os valores atuais.
Mostra informações detalhadas sobre um produto.
Mostra os produtos em um determinado catálogo. Aceita os seguintes flags de opção:
Adiciona à lista de chaves whitelisted para um serviço.
Remove da lista de chaves whitelisted para um serviço.
Exibe chaves seguras para um serviço.
Monta um diretório como um catálogo, adicionando todos os pacotes do diretório para o catálogo. A plataforma para o catálogo é considerada a mesma do servidor. Aceita os seguintes flags de opção:
Atualiza os serviços especificados. Se nenhum serviço for especificado, todos os serviços serão atualizados. Você deve adicionar um serviço usando o comando rug service-add antes de atualizar. Use rug service-list para ver a lista atual de serviços. O argumento de serviço pode ser o número de serviço de saída da lista de serviços.
Registra o cliente referente ao servidor especificado.
Adiciona o servidor especificado como um serviço. Na maioria dos casos, o URI é o URL do servidor ZENworks Linux Management, por exemplo, https://zlmserver. Aceita os seguintes flags de opção:
Apaga os serviços especificados. Aceita o seguinte flag de opção:
Lista os serviços disponíveis.
Lista os tipos de serviços disponíveis.
Limpa o cache HTTP.
Carrega os módulos do zmd.
Excuta ping no daemon do ZMD executado no cliente.
Reinicia o daemon ZLM. Aceita os seguintes flags de opção:
Mostra itens programados.
Interrompe o daemon ZLM. Aceita os seguintes flags de opção:
Colocar daemon no modo adormecido. Aceita os seguintes flags de opção:
Limpa o diretório de cache YOU, /var/lib/YaST2/mnt no SLES 9, Novell Linux Desktop e OES.
Adiciona um novo usuário com o nome de usuário e privilégios especificados. Os seguintes privilégios podem ser concedidos: instalar, bloquear, remover, inscrever-se, confiável, fazer upgrade, ver, superusuário. Se você não fornecer argumentos, eles serão solicitados. Depois que o usuário for adicionado, rug user-update será iniciado automaticamente. Use essa ferramenta para conceder privilégios adicionais. Aceita os seguintes flags de opção:
Apaga os usuários especificados.
Edita um usuário existente. Esse comando é interativo: primeiro ele lista privilégios, em seguida oferece um prompt. Digite o sinal de mais (+) ou menos (-) e o nome do privilégio e, em seguida, pressione Enter. Por exemplo, para permitir que o usuário instale um software, digite +install. Para gravar e sair, pressione Enter em uma linha em branco. Os seguintes privilégios podem ser concedidos ou revogados: instalar, bloquear, remover, inscrever-se, confiável, fazer upgrade, ver, superusuário.
Lista os usuários. Para mostrar a lista de usuários, você precisa ter o privilégio somente leitura ou superusuário. O privilégio somente leitura pode ser habilitado usando o comando user-add ou user-edit.
As opções abaixo podem ser aplicadas a qualquer transação rug:
Saída normal (modo padrão). Algo entre a saída de depuração e a saída concisa.
Saída concisa.
Sem abreviação.
Saída silenciosa; imprimir somente mensagens de erro.
Saída de depuração, imprimir rastreamentos completos de exceção.
Imprime a versão rug e sai.
Copyright 2005-2009, Novell, Inc.. Todos os direitos reservados.
zlman (1), zmd (8), zrmservice (1), zlm-debug (1), zlmmirror (1)
Para relatar problemas deste software ou de sua documentação, visite o Novell Bugzilla.