rug - A interface de linha de comando para o Agente de Gerenciamento do Novell ZENworks Linux.
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 instalado por ele pode estar nos servidores ZENworks 7. x Linux Management, ZENworks 6.6. x Linux Management, nos repositórios YUM, no serviço ZYPP e nos 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:
Lista bundles disponíveis em catálogos em que você se inscreveu. 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* se recusará a remover qualquer bundle cujo nome comece 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. Para encontrar o número de cada bloqueio de bundle, use o comando lock-list (bll).
Lista os bloqueios em vigor. Os bloqueios são classificados por número de ID.
Remove os bundles especificados. Aceita os seguintes flags de opção:
Pesquisa bundles correspondentes à string de consulta. Aceita os seguintes flags de opção:
Atualiza os bundles especificados. Aceita os seguintes flags de opção:
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 pacotes em um bundle determinado.
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 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 SLE 10, o resolvableType pode ser um pacote, padrão, produto ou patch; por padrão é um pacote. Aceita os seguintes flags de opção:
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.
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:
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:
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:
Exibe o valor do token de preferência especificado. Se nenhum token for fornecido, todas as preferências serão exibidas. Aceita os seguintes flags 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.
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:
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.
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.
Copyright 2005-2007, 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.