rug (1)

Name

rug - A interface de linha de comando para o Agente de Gerenciamento do Novell ZENworks Linux.

Sintaxe:

Descrição

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

Guia de Utilização

Esta seção contém um guia para as convenções e a formatação gerais de comandos.

Pastas

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.

Reticências (...)

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] [...]

Flags de opção

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] [...]

Comandos

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.

Comandos de gerenciamento de bundles

bundle-history (bhi) [opções] [string-de-pesquisa] [...]

Pesquisa as entradas de registro de bundle para as strings especificadas por [string-de-pesquisa]. Aceita os seguintes flags de opção:

  • -n, --search-name - Pesquisa por nome de bundle (padrão)
  • -a, --search-action - Pesquisa por ação
  • --search-user - Pesquisa por usuário
  • --match-all - Os pacotes devem corresponder a todas as strings de pesquisa (padrão)
  • --match-any - Permite que os pacotes correspondam a qualquer string de pesquisa
  • --match-substrings - Faz a correspondência das strings de pesquisa com qualquer parte do texto
  • --match-words - Os pacotes devem corresponder a todas as strings de pesquisa
  • -d, --days-back - Número máximo de dias para pesquisa no passado (padrão 30)
bundle-install (bin) [opções] [nomedobundle] [...]

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:

  • -y,--no-confirmation - Não solicitar confirmação.
  • -p,--prepare-only - Apenas preparar os bundles; não os instalar.
  • -f,--freshen - Renova os filhos.
  • -N,--dryrun - Testa e exibe, mas não realiza as ações solicitadas.
bundle-list (bl) [opções] [ [catálogo] [catálogo] [. . .] ]

Lista bundles disponíveis em catálogos em que você se inscreveu. Aceita os seguintes flags de opção:

  • -i, --installed-only - Mostra apenas os bundles instalados
  • -u, --uninstalled-only - Mostra apenas os bundles desinstalados
  • -c, --incomplete-only - Mostra apenas os bundles incompletos
bundle-lock-add (bla) [opções] [nome do bundle] [versã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.

bundle-lock-delete (bld) [opções] [número-de-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).

bundle-lock-list (bll) [opções]

Lista os bloqueios em vigor. Os bloqueios são classificados por número de ID.

bundle-remove (brm) [opções] [nomedobundle] [...]

Remove os bundles especificados. Aceita os seguintes flags de opção:

  • -y,--no-confirmation - Não solicitar confirmação. -
  • p,--prepare-only - Apenas preparar os bundles; não os instalar.
  • -f,--freshen - Renova os filhos.
  • -r,--allow-removals - Remove todos os pacotes conflitantes.
  • -N,--dryrun - Testa e exibe, mas não realiza as ações solicitadas.
bundle-search (bse) [opções] [stringdeconsulta]

Pesquisa bundles correspondentes à string de consulta. Aceita os seguintes flags de opção:

  • -i,--installed-only - Pesquisa apenas a lista de bundles instalados.
bundle-upgrade (bup) [opções] [nomedobundle] [...]

Atualiza os bundles especificados. Aceita os seguintes flags de opção:

  • -y,--no-confirmation - Não solicitar confirmação. -
  • p,--prepare-only - Apenas preparar os bundles; não os instalar.
  • -f,--freshen - Renova os filhos.
  • -N,--dryrun - Testa e exibe, mas não realiza as ações solicitadas.
catalogs (ca) [opções]

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.

subscribe (sub) [opções] [nomedocatálogo] [...]

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:

  • -s,--strict - Ocorrerá falha se tentar se inscrever em um catálogo já assinado.
  • -a,--all - Inscreve-se em todos os catálogos.
  • -e, --service - Especifica o serviço.
unsubscribe (unsub) [opções] [nomedocatálogo] [...]

Cancela a assinatura dos catálogos especificados. Aceita os seguintes flags de opção:

  • -s,--strict - Ocorrerá falha se tentar cancelar a assinatura de um catálogo não assinado.
  • -a,--all - Cancela a assinatura de todos os catálogos.
  • -e, --service - Especifica o serviço.

Comandos de gerenciamento de pacotes

bundle-packages (bp) [bundle]

Mostra os pacotes em um bundle determinado.

checkpoint-add (cpa) [nome] [data]

Adiciona um ponto de verificação. Se a data não for especificada, adicionará um ponto de verificação com a data atual.

checkpoint-remove (cpr) [nome] [nome] [...]

Remove os pontos de verificação especificados.

checkpoints (cp)

Obtém uma lista de pontos de verificação gravados.

dump [nomedoarquivo de saída]

Obtém um dump de informações do sistema como um banco de dados SQLite.

file-list (fl) [nome do pacote]

Lista arquivos contidos em um pacote.

history (hi) [opções] [termo de pesquisa]

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:

  • -n, --search-name - Pesquisa por nome do pacote (padrão).
  • -a, --search-action - Pesquisa por ação.
  • -d, --days-back - Número máximo de dias para pesquisa no passado (padrão 30)
info (if) [options] [nome do pacote] [...]

Exibe informações completas para o pacote especificado. Aceita os seguintes flags de opção:

  • -i, --uninstalled - Pesquisa por pacotes desinstalados.
  • -u, --unsubscribed - Pesquisa nos catálogos não assinados.
info-conflicts (ic) [nome do pacote]

Lista todos os conflitos do pacote especificado.

info-obsoletes (io) [nome do pacote]

Lista todas as informações obsoletas do pacote especificado.

info-provides (ip) [nome do pacote]

Lista as informações fornecidas pelo pacote especificado.

info-requirements (ir) [nome do pacote]

Lista os requisitos do pacote. Aceita os seguintes flags de opção:

  • -a, --all-providers - Lista todos os pacotes que possam atender a um requisito.
  • -v, --show-versions - Exibe informações completas sobre a versão dos pacotes.
install (in) [options] [-t resolvableType] [-c catalog] resolvable1 [resolvable2]

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:

  • -u, --allow-unsubscribed - Permite catálogos não assinados.
  • -d, --download-only - Faz download apenas de pacotes.
  • --entire-catalog - Instala todos os pacotes dos catálogos especificados. -
  • N,--dryrun - Testa e exibe, mas não realiza as ações solicitadas.
  • -i, --confirm - Sempre requer confirmação.
  • -y, --no-confirmation - Não solicita confirmação.
list-updates (lu) [catálogo] [ . . . ]

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.

lock-add (la) [opções] [nome ou padrão] [versã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.

lock-delete (ld) [opções] [número-de-bloqueio] [...]

Apaga o bloqueio de pacote especificado pelo número. Para encontrar o número de cada bloqueio, use o comando lock-list (ll).

lock-list (ll) [opções] [número-de-bloqueio] [...]

Lista os bloqueios de pacote em vigor. Os bloqueios são classificados por número de ID.

package-file (pf) [nomedearquivo]

Obtém o pacote que contém o arquivo especificado.

packages (pa) [opções] [catálogo] [...]

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:

  • -i, --installed-only - Mostra apenas os pacotes instalados.
  • -u, --uninstalled-only - Mostra apenas os pacotes desinstalados.
  • --sort-by-name - Classifica os pacotes por nome (padrão).
  • --sort-by-catalog - Classifica os pacotes por catálogo.
patch-search (pse) [opções] [stringdeconsulta]

Procura patches que correspondam a um padrão. Aceita os seguintes flags de opção:

  • --match-all - Os patches devem corresponder a todas as strings de pesquisa (padrão).
  • --match-any - Permite que os patches correspondam a qualquer string de pesquisa.
  • --match-substrings - Faz a correspondência entre as strings de pesquisa e qualquer parte do texto.
  • --match-words - As strings de pesquisa devem corresponder a palavras inteiras.
  • -d, --search-descriptions - Pesquisa em descrições de patches, mas não em nomes de patches.
  • -i, --installed-only - Mostra apenas os patches já instalados.
  • -u, --uninstalled-only - Mostra apenas os patches que ainda não foram instalados.
  • -c, --catalog - Mostra apenas os patches do catálogo especificado.
  • --sort-by-name - Classifica os patches pelo nome (padrão).
  • --sort-by-catalog - Classifica os patches por catálogo, e não pelo nome.
remove (rm) [opções] [pacote] [...]

Remove os pacotes especificados. Aceita os seguintes flags de opção:

  • -N, --dry-run - Testa e exibe, mas não realiza as ações solicitadas.
  • -i, --confirm - Sempre exige confirmação.
  • -y, --no-confirmation - Não solicita confirmação.
rollback (ro) [opções] [data]

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:

  • -d, --download-only - Faz download apenas de pacotes.
  • -N, --dry-run - Testa e exibe, mas não realiza as ações solicitadas.
  • -i, --confirm - Sempre exige confirmação.
  • -y, --no-confirmation - Não solicita confirmação.
search (se) [opções] [stringdeconsulta]

Procura pacotes que correspondam a um padrão. Aceita os seguintes flags de opção:

  • --match-all - Requer que os pacotes correspondam a todas as strings de pesquisa (padrão).
  • --match-any - Permite que os pacotes correspondam a qualquer string de pesquisa.
  • --match-substrings - Faz a correspondência entre as strings de pesquisa e qualquer parte do texto.
  • --match-words - Requer que as strings de pesquisa correspondam a palavras inteiras.
  • -d, --search-descriptions - Pesquisa em descrições de pacote, mas não em nomes de pacote.
  • -i, --installed-only - Mostra apenas os pacotes já instalados.
  • -u, --uninstalled-only - Mostra apenas os pacotes que ainda não foram instalados.
  • -c, --catalog - Mostra apenas pacotes do catálogo especificado.
  • --sort-by-name - Classifica os pacotes por nome (padrão).
  • --sort-by-catalog - Classifica os pacotes por catálogo, e não por nome.
summary (sum)

Mostra um resumo de atualizações disponíveis para cada catálogo.

update (up) [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:

  • -d, --download-only - Faz download apenas de pacotes.
  • -t, --type - Especifica o tipo de atualização.
  • --skip-interactive - Ignora as atualizações interativas.
  • -g, --category - Especifica a categoria de patches para atualização.
  • -N, --dry-run - Testa e exibe, mas não realiza as ações solicitadas.
  • -i, --confirm - Sempre exige confirmação.
  • -y, --no-confirmation - Não exige confirmação.
verify (ve) [opções]

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:

  • -N, --dry-run - Testa e exibe, mas não realiza as ações solicitadas.
  • -i, --confirm - Sempre exige confirmação.
  • -y, --no-confirmation - Não exige confirmação.
what-conflicts (wc) [dep.-de-pacote]

Lista pacotes que entram em conflito com o item especificado.

what-provides (wp) [stringdeconsulta]

Exibe pacotes que fornecem a biblioteca, o programa ou o pacote especificado como [string de consulta].

what-requires (wr) [stringdeconsulta]

Lista pacotes que solicitam a biblioteca, o programa ou o pacote especificado como [string de consulta].

Comandos para gerenciamento de patches

patches (pch) [opções] [catálogo] [catálogo] [...]

Mostra os patches em um determinado catálogo. Aceita os seguintes flags de opção:

  • -i, --installed-only - Mostra apenas os patches instalados.
  • -u, --uninstalled-only - Mostra apenas os patches desinstalados.
patch-info [patch]

Mostra informações detalhadas sobre um patch.

Comandos de gerenciamento de padrões

pattern-info [padrão]

Mostra informações detalhadas sobre um padrão.

patterns (pt) [opções] [catálogo] [catálogo] [...]

Mostra os padrões em um determinado catálogo. Aceita os seguintes flags de opção:

  • -i, --installed-only - Mostra apenas os padrões instalados.
  • -u, --uninstalled-only - Mostra apenas os padrões desinstalados.

Comandos de gerenciamento de preferências

get-prefs (get) [token]

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:

  • -d, --no-descriptions - Não mostra descrições das preferências.
set-prefs (set) [token] [valor]

Define uma variável de preferência.

Use rug get para exibir as preferências e os valores atuais.

Comandos de gerenciamento de produtos

product-info [produto]

Mostra informações detalhadas sobre um produto.

products (pd) [opções] [catálogo] [catálogo] [...]

Mostra os produtos em um determinado catálogo. Aceita os seguintes flags de opção:

  • -i, --installed-only - Mostra apenas os produtos instalados.
  • -u, --uninstalled-only - Mostra apenas os produtos desinstalados.

Comandos de gerenciamento de segurança

key-add (ka) [keyname] [iddechave]

Adiciona à lista de chaves whitelisted para um serviço.

key-delete (kd) [id de chave]

Remove da lista de chaves whitelisted para um serviço.

key-list (kl) [...]

Exibe chaves seguras para um serviço.

Comandos de gerenciamento de serviços

montar [opções] [caminho]

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:

  • -r, --recurse - Repetir no diretório.
  • -a, --alias - Álias para o novo canal.
  • -n, --name - Nome para o novo canal.
refresh (ref) [...]

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.

register [uri | number | name] [chave]

Registra o cliente referente ao servidor especificado.

service-add (sa) [opções] [uri]

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:

  • -t, --type - Tipo de serviço. O padrão é 'zenworks'. Use rug service-types para ver os serviços disponíveis. Os servidores ZENworks Linux Management 6.6.x exigem o tipo 'rce'.
  • -d, --device-type - O tipo de dispositivo que você está registrando.
  • -k, --key - Chave de registro.
  • -f, --ignore-failure - Repete o serviço em caso de falha. Por padrão, o intervalo de repetição é 5 minutos e o número de tentativas é 3. Se você não usar a opção -f, o serviço não será adicionado caso o ZMD não consiga solucionar o serviço e registrá-lo.
service-delete (sd) [uri | number | name] [...]

Apaga os serviços especificados.

service-list (sl)

Lista os serviços disponíveis.

service-types (st)

Lista os tipos de serviços disponíveis.

Comandos do sistema

clean-cache (cc) [...]

Limpa o cache HTTP.

load-modules (lm) [...]

Carrega os módulos do zmd.

ping

Excuta ping no daemon do ZMD executado no cliente.

restart

Reinicia o daemon ZLM. Aceita os seguintes flags de opção:

  • -f, --force - Força o encerramento.
  • -n, --no-wait - Não espera confirmação de reinicialização do daemon.
  • --clean - Faz limpeza na reinicialização
schedule (sch)

Mostra itens programados.

shutdown [opções] [...]

Interrompe o daemon ZLM. Aceita os seguintes flags de opção:

  • -f, --force - Forçar o encerramento.
  • -n, --no-wait - Não esperar confirmação de encerramento do daemon.
sleep [opções] [...]

Colocar daemon no modo adormecido. Aceita os seguintes flags de opção:

  • -f, --force - Forçar o encerramento.

Comandos de gerenciamento de usuários

user-add (ua) [nomedeusuário] [privilégio] [...]

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:

  • -r, --replace - Substitui o usuário se ele já existir.
user-delete (ud) [nomedeusuário] [...]

Apaga os usuários especificados.

user-edit (ue) [nomedeusuário]

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.

user-list (ul)

Lista os usuários.

Opções globais

As opções abaixo podem ser aplicadas a qualquer transação rug:

--normal-output

Saída normal (modo padrão). Algo entre a saída de depuração e a saída concisa.

--terse

Saída concisa.

--no-abbrev

Sem abreviação.

--quiet

Saída silenciosa; imprimir somente mensagens de erro.

--debug

Saída de depuração, imprimir rastreamentos completos de exceção.

Autores

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

Consulte Também

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.