zac para Linux (1)

Name

zac - A interface de gerenciamento de linha de comando do Agente do Micro Focus ZENworks que está instalada e em execução nos dispositivos gerenciados pelo Linux.

Sintaxe

zac command options

Descrição

O utilitário zac executa funções de gerenciamento de linha de comando no dispositivo gerenciado ZENworks, incluindo a instalação e remoção de bundles de software, aplicação de políticas e registro e cancelamento de registro do dispositivo.

Guia de utilização

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

A maioria dos comandos tem uma forma extensa e uma forma abreviada:

  • Forma extensa: add-reg-key
  • Forma abreviada: ark

Quando ambos os formatos estão disponíveis, o comando é listado da seguinte forma:

add-reg-key (ark) opções

Ao usar o comando, insira apenas a forma por extenso ou a forma abreviada:

zac add-reg-key opções

zac ark opções

Se uma opção incluir um espaço, coloque-a entre aspas:

zac ark "opção 1"

Argumentos obrigatórios e opcionais

Os argumentos delimitados por parênteses ( ) são obrigatórios, e os delimitados por colchetes [ ] são opcionais.

Reticências (…)

As reticências indicam que um comando aceita várias entradas do último tipo de argumento. Os argumentos devem ser separados por espaço ou vírgulas, dependendo do comando. Por exemplo:

zac <comando> [opções] (servidor) (bundle) [...]

As reticências indicam que <comando> pode aceitar vários bundles. Na ajuda no nível do comando, o argumento de várias entradas é indicado como [(bundle) (bundle) ... (bundle)] para ficar mais claro.

Comandos de ajuda

/? ou ‑‑help

Exibe a ajuda referente ao sistema.

COMMAND /?

Exibe a descrição de um comando especificado.

/g ou ‑‑group

Exibe comandos do grupo especificado.

Comandos do servidor satélite de autenticação

authentication server reconfigure (asr) [-t all|config|jetty|casa] [-u nome_do_usuário] [-p senha]

Reconfigura um Satélite de Autenticação habilitado.

Exemplos:

Para buscar os arquivos de configuração do servidor:

zac asr -t config

Para reconfigurar o certificado de assinatura do CASA:

zac asr -t casa

Para reconfigurar o servidor Web Jetty:

zac asr -t jetty -u Administrador -p senha

Para reconfigurar todo o Satélite:

zac asr -t all -u Administrador -p senha

Se forem obrigatórios um nome de usuário e uma senha, mas eles não forem fornecidos na linha de comando, será emitido um aviso.

import-authentication-cert(iac)[-pk <private-key.der>] [-c <signed-server-certificate.der>] [-ca <signing-authority-public-certificate.der>] [-ks <keystore.jks>] [-ksp <keystore-pass-phrase>] [-a <signed-cert-alias>] [-ks <signed-cert-passphrase>] [-u nome_do_usuário] [-p senha] [-rc]

Configura um dispositivo Satélite de Autenticação com certificados assinados externamente.

  • rc – Confirma a reconfiguração do Servidor Satélite de Autenticação para que não seja emitido um aviso ao administrador para a reconfiguração.

Cada Satélite deve ter seu próprio certificado de servidor e chave privada individual. Para obter mais informações sobre como gerar certificados externos, consulte a Instalação do Servidor ZENworks .

Comandos de bundles

bundle-install (bin) [opções] [nome do bundle | GUID | Padrão]

Instala os bundles determinados com base no nome de exibição que corresponde à expressão regular ou string especificada, ou ao GUID do bundle. Use o comando bundle-list para obter uma lista dos bundles disponíveis e seus nomes de exibição.

As seguintes expressões regulares são suportadas:

Expressão Regular

Funcionalidade

^abc

Corresponde à string que começa com 'abc'.

[abc]

Corresponde à string que inclui 'a', 'b' ou 'c'.

a*c

Corresponde zero ou mais vezes ao 'a' seguido de 'c', 'ac','aac','aaac' ou 'c'.

Aceita a seguinte opção:

  • -N, ‑‑dryrun – Faz o teste e exibe, mas não executa realmente a ação solicitada. É possível executar dry run na versão do bundle apenas uma vez. Essa opção aplica-se apenas às ações Instalar RPM do bundle.

Veja a seguir um exemplo de instalação do bundle com base no nome do bundle:

zac bin bundle1

bundle-launch (bln) [nome de exibição do bundle] [-noSelfHeal]

Inicia o bundle especificado. As ações no conjunto de Ações de Inicialização são executadas.

Se você tentar iniciar um bundle que não esteja instalado, o bundle primeiro será instalado e depois iniciado.

Use o comando bundle-list para obter uma lista dos bundles disponíveis e seus nomes de exibição.

Um exemplo para iniciar um bundle com base no nome de exibição:

zac bln bundle1

Exemplo de como iniciar um bundle com base no nome de exibição e de como desativar a autorreparação se houver falha na ação de inicialização (por padrão, a autorreparação está ativada):

zac bln bundle1 -noSelfHeal

bundle-list (bl) [opções]

Exibe a lista de bundles atribuídos ao dispositivo e ao usuário conectado.

O resultado desse comando aparece nas colunas e mostram os detalhes de cada bundle atribuído ou disponível ao dispositivo gerenciado. As colunas Nome de Exibição, Versão e Tipo de Bundle representam o nome de exibição, a versão ou área de segurança (se o bundle for uma versão de área de segurança) e o tipo do bundle, respectivamente. A coluna Status mostra os seguintes estados:

  • Disponível: exibe esse estado quando o bundle está instalado.
  • Não Instalado: exibe esse estado quando determinada versão do bundle não está instalada.
  • Descarregado: exibe esse estado quando o conteúdo foi descarregado, mas a ação no conjunto de Ações de Instalação não foi executada.

Esse comando aceita as seguintes opções:

  • -a, ‑‑all – Lista os bundles filtrados e não filtrados. Bundles filtrados são bundles de cadeia. Por padrão, os bundles não filtrados são exibidos.
  • -g, ‑‑show-guid – Exibe o GUID do bundle.

Veja um exemplo para listar todos os bundles:

zac bl -a

bundle-lock-add (bla) [opções] [nome do bundle] […]

Bloqueia os bundles determinados que correspondem à expressão regular ou string especificada contra upgrade ou remoção.

As seguintes expressões regulares são suportadas:

Expressão Regular

Funcionalidade

^abc

Corresponde à string que começa com 'abc'.

[abc]

Corresponde à string que inclui 'a', 'b' ou 'c'.

a*c

Corresponde zero ou mais vezes ao 'a' seguido de 'c', 'ac','aac','aaac' ou 'c'.

Aceita as seguintes opções:

  • -li, ‑‑lock-install – Bloqueia o bundle e impede a instalação do bundle especificado no bloqueio.

NOTA:Os bloqueios de bundle aplicam-se apenas ao conjunto de ações de Instalação.

  • -t, ‑‑type – Especifique o tipo de bundle a ser bloqueado. Os tipos disponíveis são linux e patch. Se nenhum tipo for especificado, o tipo bundle será selecionado.
bundle-lock-list (bll)

Lista os bloqueios de bundle. Os bloqueios de bundle são classificados pelo número de ID.

Exemplo:

zac bll

bundle-lock-remove (blr) [opções] [índice de bundle] […]

Remove o bloqueio do bundle especificado por seu número. Você pode encontrar o número de cada bloqueio usando o comando bundle-lock-list (bll).

Aceita as seguintes opções:

  • -n – Remove os bloqueios de bundle especificados por nome. Verifique se o nome não inclui nenhum padrão.
  • ‑‑remove-all – Remove todos os bloqueios de bundle.

Um exemplo para remover um bloqueio de bundle abc:

zac blr -n abc

Um exemplo para remover todos os bloqueios de bundle:

zac blr ‑‑remove-all

bundle-refresh (br) [nome de exibição do bundle | guid]

Atualiza as informações sobre o bundle especificado.

Exemplo:

zac br bundle1

bundle-search (bse) [opções] pattern

Procura bundles que correspondam à string ou expressão regular especificada.

As seguintes expressões regulares são suportadas:

Expressão Regular

Funcionalidade

a+bc

Corresponde uma ou mais vezes ao ‘a’ seguido de ‘bc’.

Por exemplo, corresponde uma ou mais vezes ao ‘a’ seguido de ‘abc’ ou ‘aabc’.

[a-z]\*

Corresponde à string vazia e a strings com nomes que incluem apenas caracteres alfabéticos.

Por exemplo, corresponde à string vazia "" ou a strings com nomes como acb e xyz, apenas com caracteres alfabéticos.

a*bc

Corresponde zero ou mais vezes ao 'a' seguido de 'bc'.

Por exemplo, corresponde zero ou mais vezes ao ‘a’ seguido de ‘abc’, ‘aabc’, ‘aaabc’ ou ‘bc’.

O resultado desse comando é semelhante ao resultado do comando zac bl.

Aceita a seguinte opção:

  • -i,‑‑installed-only – Pesquisa apenas a lista de bundles instalados.
bundle-uninstall (bu) [nome de exibição do bundle | guid]

Desinstala o bundle especificado. As ações que suportam a ação Desfazer são executadas durante a desinstalação do bundle. Após o término da desinstalação do bundle, o estado do bundle aparece como Não Instalado.

Use o comando bundle-list para obter uma lista dos bundles instalados e seus nomes de exibição.

Exemplo:

zac bu bundle1

bundle-verify (bv) [nome de exibição do bundle]

Reinstala o bundle e executa os conjuntos de Ações de Verificação para verificar se nenhum arquivo foi removido ou corrompido. Use o comando bundle-list para obter uma lista dos bundles instalados e seus nomes de exibição.

Exemplo:

zac bv bundle1

Comandos de certificado

cert-info (ci) [caminho do arquivo de certificado de ca] [-u <nome_do_usuário> -p <senha>]

Lista informações de certificados de chave pública para cada servidor ZENworks conhecido ou adiciona um certificado raiz confiável ao armazenamento confiável de dispositivos. O arquivo pode estar em formato DER ASN.1 ou codificado com base 64 delimitado por --‑‑BEGIN CERTIFICATE---- e --‑‑END CERTIFICATE--.

Exemplo:

Para listar o certificado para cada servidor ZENworks conhecido:

zac ci

Para adicionar um certificado raiz confiável ao armazenamento confiável de dispositivos:

zac ci c:\certs\mytrustcacert.der -u meu_usuário -p minha_senha

Comandos de roll-up de coleção

collection-clients (crc)

Exibe dispositivos que fizeram upload de arquivos para esta Coleção.

Exemplo:

zac crc

collection-point (cp)

Mostra o status e a configuração da função de coleção.

Exemplo:

collection-point [wake]

wake: Aciona os módulos que fazem coleta (Inventário, Status de MD, Remetente da mensagem)

collection-queued (crq)

Exibe arquivos coletados ainda sem roll-up.

Exemplo:

zac crq

collection-state (crs)

Exibe o estado atual da função Coleção do Satélite.

Exemplo:

zac crs

collection-upload-orphans (cuo)

Encontra arquivos órfãos no dispositivo Satélite e fará o roll-up deles para o servidor de coleção pai ou os apagará, se o roll-up já tiver sido executado.

Esse comando constrói uma lista dos arquivos nas pastas em /var/opt/novell/zenworks/work/collection (exceto a pasta collectionStatsDB) e tenta encontrar as informações de upload originais para cada entrada no banco de dados de estatísticas da coleção.

Se houver uma entrada para um arquivo no banco de dados, e parecer que o roll-up do arquivo não foi executado, o roll-up desse arquivo será feito. Se a entrada mostrar que o roll-up do arquivo já foi feito, o arquivo no dispositivo Satélite será apagado. Se não houver nenhuma entrada para um arquivo no banco de dados, o roll-up do arquivo será feito. Esse comando também lista os arquivos que não foram carregados, nem apagados.

Antes de executar esse comando, execute zac crw para enviar os arquivos pendentes para o servidor pai.

Exemplo:

zac cuo

collection-wake (crw)

Envia os arquivos coletados ao servidor pai.

Exemplo:

zac crw

Comandos de distribuição de conteúdo

cdp-checksum (cchk) [-l:<caminho para o registro>]

Valida o conteúdo do satélite calculando o checksum de cada arquivo.

O arquivo de registro opcional mostra os detalhes dos resultados da comparação de checksum.

Exemplo:

zac cchk -l:"/var/opt/novell/zenworks/logs/cchk.log"

cdp-verify-content (cvc) [-c] [-l:<caminho para o registro>]

Compara a lista de IDs de conteúdo e seus estados de sincronização neste CDP com os valores pressupostos pelos Servidores Principais.

Você pode usar as seguintes opções:

  • c – Calcula o checksum do conteúdo local.

Exemplo:

zac cvc -l:"/var/opt/novell/zenworks/logs/cvc.log"

cdp-import-content (cic) <caminho do conteúdo> [<caminho para o registro>]

Importa o conteúdo ausente do diretório especificado pelo caminho do conteúdo, registrando no arquivo especificado pelo caminho do registro.

Exemplo:

zac cic /usr/content_Dir /var/opt/novell/zenworks/logs/cic.log

distribution-info (cdi) [opção]

Exibe informações estatísticas sobre a função Conteúdo. Você pode usar as seguintes opções:

  • all – Executa todas as opções marcadas com *.
  • ss – Mostra o status da sincronização *.
  • rs – Obtém o tamanho do Repositório de Conteúdo *.
  • da – Lista dispositivos que recuperaram dados deste dispositivo *.
  • ne – Obtém o número de erros de distribuição de conteúdo *.
  • ds – Obtém o tamanho dos dados armazenados no servidor por este dispositivo *.
  • fs – Obtém o número de arquivos armazenados no servidor *.
  • ah [n] – Exibe n entradas (padrão: todas) do histórico de acessos.
  • ch – Limpa o histórico.
  • eh <arquivo> – Exporta o histórico de acessos para <arquivo>, no qual o caminho está incluído e o arquivo em si não deve existir.

Exemplos:

zac cdi

zac cdi rs

distribution-state (cds)

Exibe o estado atual da função Conteúdo do Satélite. Exibe se a função está habilitada/desabilitada, o status (Iniciando, Ativa, Parando, Parada), os URLs Pai e a programação de replicação.

Exemplo:

zac cds

distribution-wake (cdp) [replicate | cleanup]

Aciona o thread do worker do ponto de distribuição de conteúdo. Você pode usar uma das seguintes opções:

  • replicate – Faz o download de qualquer conteúdo novo ou alterado do Ponto de Distribuição de Conteúdo do servidor pai do ZENworks.
  • cleanup – Remove qualquer conteúdo que não deve ser mais armazenado no Ponto de Distribuição de Conteúdo.

Exemplos:

zac cdp

zac cdp replicate

Comandos básicos

get-settings (gs) <chave>

O download das configurações é feito pelo Módulo de Configurações para o cache local a cada atualização. Esse procedimento retornará as configurações efetivas associadas à chave especificada.

Exemplo:

zac gs key1

Exemplo para listar as configurações do Gerenciamento Remoto:

zac gs RemoteManagement

Todas as chaves de configurações do ZENworks são armazenadas no diretório /var/opt/novell/zenworks/zmd/cache/settings/.

get-pref (get) <nome de preferência>

Exibe as preferências definidas.

Exemplo para exibir todas as preferências definidas:

zac get-pref

Exemplo para exibir todas as preferências que tenham nomes começando com abc:

zac get-pref abc

set-pref (definir) <nome de preferência> <valor de preferência>

Define o valor de uma preferência.

Exemplo para definir o valor de preferência abc como 123:

zac set-pref abc 123

NOTA:Para configurar um servidor proxy para o dispositivo gerenciado, verifique se o dispositivo gerenciado tem estas duas preferências configuradas: proxy-host e proxy-port. Se o servidor proxy exigir autenticação, o dispositivo gerenciado deverá ter também as seguintes preferências configuradas: proxy-username e proxy-password.

set-proxy (sp) [opções] <endereço IP/Nome de host:porta>

Especifica um proxy para contato em vez de contatar um Servidor ZENworks diretamente.

As opções são:

  • ‑‑default – Define um proxy que pode ser anulado por configurações de proxy da Zona de Gerenciamento.
  • ‑‑clear – Limpa o proxy atual, mas usará as configurações de proxy da Zona de Gerenciamento.

Exemplos:

IPv4:

zac sp 123.456.78.90:2349 administrator novell

zac sp /default 123.456.78.90:2349

zac sp /clear

Se não for especificado um nome de usuário e uma senha, você será solicitado a digitá-los.

Comandos de atualização do sistema

zac zeus-refresh / zeus-ref

Recupera a atualização do sistema quando ela é atribuída a um dispositivo.

Comandos de serviços externos

Esses comandos são usados para gerenciar serviços externos.

external-service-add (esa) ‑‑type (tipo) (url) (Nome do Serviço) [Propriedades]

Adiciona repositórios de pacotes externos como YUM, ZYPP ou o diretório Local que contém os RPMs. Todas as propriedades específicas ao tipo devem começar com -D.

É possível listar os tipos de serviço que podem ser adicionados usando o comando zac est.

Ele suporta os seguintes tipos:

  • YUM: adiciona repositório do tipo YUM. Aceita as seguintes propriedades:

    • -Dusername=value -Dpassword=value – Essa propriedade é opcional e usada durante a adição de um repositório autenticado YUM.
    • -DsyncExternal=true – Essa propriedade é opcional e usada para sincronização com a ferramenta de Gerenciamento de Pacote Local.

    Por exemplo, execute o seguinte comando para adicionar um tipo de serviço YUM:

    zac esa ‑‑type YUM -Dusername=nome_de_usuário -Dpassword=senha https://nu.novell.com/sles11 sles11-yum-repo

  • ZYPP: adiciona repositório do tipo ZYPP. Aceita as seguintes propriedades:

    • -DsyncExternal=true – Essa propriedade é opcional e usada para sincronização com a ferramenta de Gerenciamento de Pacote Local.

    Por exemplo, execute o seguinte comando para adicionar um tipo de serviço ZYPP:

    zac esa ‑‑type ZYPP http://zypp.source.com/sles11/x86_64 sles11-zypp-repo

  • Mount: adiciona um repositório do tipo Mount. O tipo Mount adiciona um serviço do diretório Local que contém os RPMs. Aceita as seguintes propriedades:

    • -Drecursive=(Valor) – Essa propriedade é opcional. Os valores válidos são true (verdadeiro) ou false (falso). Se verdadeiro, os RPMs serão adicionados recursivamente de todos os diretórios no caminho absoluto especificado.
    • -DsyncExternal=true – Essa propriedade é opcional e usada para sincronização com a ferramenta de Gerenciamento de Pacote Local.

    Por exemplo, execute o seguinte comando para adicionar pacotes recursivamente de todos os diretórios, usando o tipo de serviço Mount:

    zac esa ‑‑type mount -Drecursive=true file:///mnt/sles11-cd/i586 sles11-rpms

NOTA:Os serviços ZYPP ou Mount não são sincronizados com a Ferramenta de Gerenciamento de Pacote YUM nos dispositivos Red Hat.

external-service-delete (esd) (index | name | url | ‑‑all)

Remove os serviços externos especificados.

A opção ‑‑all apaga todos os serviços externos.

external-service-list (esl)

Lista todos os serviços externos.

A coluna Origem exibe os Agentes do ZENworks que foram adicionados por meio do comando zac e o Servidor ZENworks que foi adicionado pela Política de Serviço Externo.

A coluna Status mostra se o serviço externo está ativo ou inativo. Impossível atualizar os serviços externos com status Inativo.

A coluna Estado mostra se o serviço externo está habilitado ou desabilitado.

external-service-refresh (esr) (index | name | url | ‑‑all)

Atualiza os serviços externos especificados.

A opção ‑‑all atualiza todos os serviços.

external-service-state (ess) (enable | disable) (index | name | url | ‑‑all)

Habilita ou desabilita os serviços externos especificados.

A opção ‑‑all muda o estado de todos os serviços.

external-service-types (est)

Lista os tipos de serviços disponíveis.

Comandos de criação de imagens

file-system-guid (fsg)[-d] [-r]

Remove e restaura o GUID de estação de trabalho no sistema de arquivos como preparação para obter uma imagem.

Exemplo para remover o GUID do sistema de arquivos:

zac file-system-guid -d

Exemplo para restaurar o GUID do sistema de arquivos:

zac file-system-guid -r

Exemplo para imprimir o valor do GUID:

zac fsg

Comandos de inventário

inventory (inv) [scannow | cdf]

Executa uma exploração de inventário ou abre o Formulário de Dados de Coleção.

Exemplo: para executar uma exploração de inventário:

zac inv scannow

Exemplo: para abrir o Formulário de Dados de Coleção:

zac inv cdf

Comandos apenas inventário

Esses comandos só são usados para agentes Apenas Inventário (IOA, Inventory-Only Agents).

zac ioa cfg <IP do servidor>

Configura o dispositivo Linux IOA como o IP do servidor mencionado.

Exemplo de execução de exploração Apenas Inventário:

zac ioa cfg 10.70.13.124

zac ioa version

Exibe a versão do agente Apenas Inventário (IOA).

inventory (inv) [scannow]

Executa a exploração de um inventário.

Exemplo de como executar a exploração de um inventário:

zac inv scannow

Comandos de gerenciamento de usuários locais

Estes comandos são usados para gerenciar usuários locais e seus privilégios.

user-add (ua) (nome_de_usuário)

Adiciona o usuário local ao armazenamento de privilégios do ZENworks.

Exemplo:

zac ua nome_de_usuário

user-delete (ud) (nome_de_usuário)

Apaga o usuário local do armazenamento de privilégios do ZENworks.

Exemplo:

zac ud nome_de_usuário

user-list (ul)

Lista o seguinte:

  • - Nomes de usuário e privilégios para os usuários locais adicionados ao armazenamento de privilégios do ZENworks.
  • - Privilégios para os usuários locais que não foram adicionados ao armazenamento de privilégios do ZENworks (usuário padrão). O usuário padrão é representado por * (asterisco).

Exemplo:

zac ul

user-edit (ue) (nome_de_usuário) [+/-Privilege]

Edita os privilégios dos usuários locais. Use o sinal + (adição) para adicionar um novo privilégio, e – (subtração) para remover um privilégio existente.

Por padrão, o usuário local recém-criado tem o privilégio Ver. Os usuários locais que não foram adicionados ao armazenamento de privilégios do ZENworks herdam o privilégio atribuído ao usuário padrão, que é representado por * (asterisco). É possível mudar os privilégios atribuídos a qualquer usuário local e atribuir ao usuário os seguintes privilégios:

Privilégio

Funcionalidade

Ver

Ver ou listar as informações sobre bundles, políticas, configuração etc.

Instale o

Instalar ou desinstalar bundles, políticas, pacotes etc.

Configurar

Executar os comandos de configuração.

Superusuário

Executar todos os comandos do zac, pois um Superusuário recebe todos os privilégios. Por padrão, o usuário root recebe o privilégio Superusuário, que não pode ser modificado.

Exemplos:

Se quiser permitir que os usuários locais no armazenamento de privilégios do ZENworks vejam, instalem e desinstalem bundles e políticas, é possível atribuir os privilégios Ver e Instalar a esses usuários executando o seguinte comando:

zac ue nome_de_usuário +Install

Se quiser permitir que os usuários locais que não foram adicionados ao armazenamento de privilégios do ZENworks vejam, instalem ou desinstalem bundles e políticas, é possível atribuir os privilégios Ver e Instalar ao usuário * executando o seguinte comando:

zac ue '*' +Install

user-privilege-export (upe) (nome do arquivo .xml)

Exporta uma lista de usuários locais e seus privilégios para um arquivo .xml especificado, a fim de reutilizar essa lista em outros dispositivos gerenciados.

Exemplo:

zac upe /tmp/privileges.xml

Após exportar a lista, é possível importá-la para outros dispositivos gerenciados executando o comando user-privilege-import (upi).

user-privilege-import (upi) (nome do arquivo .xml)

Importa uma lista de usuários locais e seus privilégios para outros dispositivos gerenciados de um arquivo .xml especificado. Essa lista pode ser exportada para o arquivo .xml executando o comando user-privilege-export (upe).

Exemplo:

zac upi /tmp/privileges.xml

Comandos de local

config-location (cl)

Exibe o local de configuração. O local de configuração determina a qual servidor (ou servidores) ZENworks o dispositivo vai se conectar para fins de autenticação, configuração, conteúdo e coleção.

Exemplos:

zac config-location

zac cl

Comandos de registro

logger [resetlog | level [MANAGED|ERROR|WARN|INFO|DEBUG] |managedlevel]

Muda a configuração do registrador.

Você pode usar as seguintes opções:

  • resetlog – Redefine o registro.
  • nível – Se usado sem um nível, exibe o nível de registro atual gerenciado. Se usado com um dos níveis, altera o nível de registro para o nível especificado.
  • managedlevel – Exibe o nível de Registro Global da zona.

Exemplo para redefinir o arquivo de registro:

zac logger resetlog

Exemplo para mostrar o nível de registro atual:

zac logger level

Exemplo para definir o nível de registro para DEBUG e acima:

zac logger level DEBUG

Comandos de gerenciamento de pacotes

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.

checkpoints-list

Lista os pontos de verificação gravados.

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

Remove os pontos de verificação especificados.

dist-upgrade (dup) [opções] [nome do bundle|nome do serviço] […]

Realiza um upgrade de distribuição. Esse comando realiza uma atualização de todos os pacotes com um algoritmo especial do Resolver, que cuida da alteração na arquitetura do pacote, das divisões do pacote, das atualizações de padrão e produto etc. Se nenhum argumento for especificado, os pacotes de todos os bundles do ZENworks e serviços externos serão considerados no upgrade da distribuição.

Aceita as seguintes opções:

  • -d, ‑‑download-only – Faz download apenas de pacotes.
  • -N, ‑‑dry-run – Testa e exibe as ações solicitadas, porém, não as executa.
  • -y, ‑‑no-confirm – Não solicita confirmação.

Por exemplo, é possível fazer upgrade da distribuição do SLES 10 SP2 para o SLES 10 SP3.

info (info) [opção] pattern

Exibe as informações do pacote especificado que corresponde ao padrão determinado.

As seguintes expressões regulares são suportadas:

Expressão Regular

Funcionalidade

^abc

Corresponde à string que começa com 'abc'.

[abc]

Corresponde à string que inclui 'a', 'b' ou 'c'.

a*c

Corresponde zero ou mais vezes ao 'a' seguido de 'c', 'ac','aac','aaac' ou 'c'.

O comando exibe o Nome, a Versão, a Arquitetura e a Descrição dos pacotes.

Aceita as seguintes opções:

  • ‑‑provides – Lista os pacotes e arquivos fornecidos pelo pacote que corresponde ao padrão especificado.
  • ‑‑requires – Lista os pacotes e arquivos que são exigidos pelo pacote correspondente ao padrão especificado.
install (in) [opções] (nome do pacote) […]

Instala os pacotes especificados. Se você especificar um pacote com uma versão, a versão exata do pacote será instalada. Se você especificar um pacote com um nome, a melhor versão do pacote será instalada.

NOTA:Para instalar uma versão menos eficiente do pacote, especifique a versão desejada para executar essa ação.

Aceita as seguintes opções:

  • -b, ‑‑bundle [nome do bundle] – Instala um pacote do bundle especificado. O bundle que você especificar também pode ser um Bundle de Dependência do Linux. No entanto, para instalar um Bundle de Dependência do Linux, a opção Publicar Pacotes deve estar definida como Verdadeiro. Para obter mais informações sobre Publicação de Pacotes, consulte Creating Linux Dependency Bundles (Criando bundles de dependência do Linux).
  • -d, ‑‑download-only – Faz download dos pacotes no diretório de cache zen. Por padrão, o diretório de cache zen fica em /var/opt/novell/zenworks/zmd/cache.
  • -N, ‑‑dry-run – Testa e exibe as ações solicitadas, porém, não as executa.
  • -y, ‑‑no-confirm – Não solicita confirmação.
  • -f, ‑‑freshen – Instala os pacotes somente quando existe uma versão anterior desses pacotes.
  • -s, ‑‑service [nome do serviço] – Instala um pacote a partir do serviço especificado.
  • -p, ‑‑pattern [nome do padrão] – Instala um pacote de determinado padrão. No entanto, apenas os pacotes obrigatórios que fazem parte do padrão são instalados.
  • ‑‑entire-bundle [nome do bundle] […] – Instala todos os pacotes a partir dos bundles especificados. Você pode especificar um único bundle ou vários.
  • ‑‑ignore-dependency – Não verifica dependências. Os pacotes dependentes são ignorados e apenas os pacotes são instalados.
  • -r, ‑‑regex-pattern <padrão de expressão regular> [<padrão de expressão regular>]- Instala todos os pacotes que correspondem à expressão regular especificada.

As seguintes expressões regulares são suportadas:

Expressão Regular

Funcionalidade

^abc

Corresponde à string que começa com 'abc'.

[abc]

Corresponde à string que inclui 'a', 'b' ou 'c'.

a*c

Corresponde zero ou mais vezes ao 'a' seguido de 'c', 'ac','aac','aaac' ou 'c'.

Além disso, o comando lista também os pacotes dependentes que concluíram sua instalação com êxito.

list-updates (lu) [opções] [nome do bundle|nome do serviço] […]

Exibe as atualizações disponíveis nos bundles e serviços especificados. Você pode especificar um único bundle ou serviço, ou vários bundles ou serviços, para os quais deseja exibir as atualizações. Se nenhum bundle ou serviço for especificado, o comando exibirá todas as atualizações disponíveis.

Aceita a seguinte opção:

  • -t, ‑‑type [tipo] – Lista as atualizações do tipo de serviço especificado.
lock-add (la) (nome ou padrão)[versão]

Adiciona uma regra de bloqueio de pacote. Esse comando bloqueia os pacotes especificados que, se corresponderem à expressão regular ou string determinada, não serão atualizados nem removidos. 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 número da versão deve ser especificado entre aspas simples ou duplas.

Operador Relacional

Funcionalidade

=

Bloqueia somente a versão do pacote especificada.

<

Bloqueia todas as versões do pacote mais antigas que a versão especificada, excluindo a versão especificada.

>

Bloqueia todas as versões do pacote posteriores à versão especificada, excluindo a versão especificada.

<=

Bloqueia todas as versões do pacote mais antigas que a versão especificada, assim como a versão especificada.

>=

Bloqueia todas as versões do pacote posteriores à versão especificada, assim como

Para instalar uma versão específica do pacote, esse comando primeiro verificará se a versão do pacote está bloqueada e, depois, instalará a versão do pacote apenas se não estiver bloqueada. Por exemplo, suponha que todas as versões posteriores do pacote “X 1.7” tenham sido bloqueadas por meio do comando zac la X '>' 1.7. Se você instalar o pacote X 1.9 usando o comando zac in X (1.9), haverá falha na instalação.

lock-delete (ld) (número do bloqueio) […]

Apaga o bloqueio do pacote que você especificar pelo seu número. Para encontrar o número de cada bloqueio, use o comando lock-list (ll).

lock-list (ll)

Lista os bloqueios de pacote.

packagehistory (ph) [opções] […]

Lista o histórico de transações do pacote realizadas pelo ZENworks. Esse comando exibe o nome, a data, a operação, a versão e o lançamento do pacote.

Aceita os seguintes flags de opção:

  • -n, ‑‑search-name [nome do pacote] – Pesquisa por nome do pacote.
  • -a, ‑‑search-action [nome da ação] – Pesquisa por nome da ação. Os nomes de ação válidos são Nenhum, Instalar, Remoção e Upgrade.
  • -d, ‑‑days-back [dias] – Número máximo de dias para pesquisa no passado (o padrão é 30).
  • -c, ‑‑clean-history – Limpa o histórico do pacote.
  • -o, ‑‑search-operation [operação] – Pesquisa com base na operação realizada. A operação realizada pode ser Instalação, Remoção ou Upgrade.
remove (rm) [opções] (nome do pacote) […]

Remove os pacotes especificados.

Aceita as seguintes opções:

  • ‑‑entire-bundle [nome do bundle] – Remove todos os pacotes do bundle especificado.
  • -N, ‑‑dry-run – Testa e exibe as ações solicitadas, porém, não as executa.
  • -y, ‑‑no-confirm – Não solicita confirmação.
  • -r, ‑‑regex-pattern <padrão de expressão regular> [<padrão de expressão regular>] – Remove todos os pacotes que correspondem à expressão regular especificada.

As seguintes expressões regulares são suportadas:

Expressão Regular

Funcionalidade

^abc

Corresponde à string que começa com 'abc'.

[abc]

Corresponde à string que inclui 'a', 'b' ou 'c'.

a*c

Corresponde zero ou mais vezes ao 'a' seguido de 'c', 'ac','aac','aaac' ou 'c'.

Além disso, esse comando lista também os pacotes dependentes para concluir com êxito a remoção do pacote especificado.

rollback (ro) [opções] [data ou ponto de verificação]

Volta as transações do pacote à data e hora que você especificar, se a preferência de rollback estiver definida. Por padrão, a preferência de rollback fica desabilitada. Você pode habilitar a preferência de rollback executando o comando zac set rollback true.

Se quiser voltar para determinada versão do pacote, essa versão do pacote e suas dependências deverão estar disponíveis como parte do serviço ou do bundle atribuído. Se a versão do pacote ou suas dependências não estiverem disponíveis, ocorrerá falha no rollback.

Além disso, esse comando lista também os pacotes dependentes obrigatórios para um rollback bem-sucedido.

Aceita as seguintes opções:

  • -d, ‑‑download-only – Faz download apenas de pacotes.
  • -N, ‑‑dry-run – Testa e exibe as ações solicitadas, porém, não as executa.
  • -y, ‑‑no-confirm – Não solicita confirmação.
  • -p, ‑‑package (nome do pacote) – Nome do pacote que precisa passar por rollback.
search (se) [opções] [padrão]

Procura os pacotes que correspondem ao padrão especificado. Se nenhum argumento for especificado, todos os pacotes serão exibidos. Esse comando mostra nome de origem, tipo de origem, nome do pacote, versão e arquitetura.

Aceita as seguintes opções:

  • -b, ‑‑bundle [nome do bundle] – Pesquisa pacotes no bundle especificado.
  • -d, ‑‑search-in-description – Pesquisa nas descrições de pacotes, mas não nos nomes de pacotes.
  • -i, ‑‑installed-only – Mostra apenas os pacotes instalados.
  • -u, ‑‑uninstalled-only – Mostra apenas os pacotes desinstalados.
  • -s, ‑‑service [nome do serviço] – Pesquisa os pacotes no serviço especificado.
  • -t, ‑‑type [tipo do serviço] – Pesquisa os pacotes com base no tipo de serviço especificado.
  • -p, ‑‑pattern [nome do padrão] – Mostra os padrões disponíveis.
  • ‑‑sort-by-bundle – Classifica os pacotes pelo bundle, e não pelo nome. A classificação padrão é pelo nome do pacote.
  • ‑‑show-nevra – Mostra os detalhes de NEVRA dos pacotes.
update (up) [opções] [nome do bundle|nome do serviço] […]

Atualiza os pacotes instalados. Você pode especificar um único nome de bundle ou de serviço, ou vários nomes de bundles ou de serviços, para os quais atualizar os pacotes. Se nenhum nome de bundle ou de serviço for especificado, todos os pacotes serão atualizados.

Se houver pacotes instalados com o mesmo nome e arquitetura, mas versões diferentes, apenas os pacotes com a versão maior serão atualizados.

Aceita as seguintes opções:

  • -d, ‑‑download-only – Faz download apenas de pacotes.
  • -N, ‑‑dry-run – Testa e exibe as ações solicitadas, porém, não as executa.
  • -y, -‑‑no-confirm – Não solicita confirmação.
  • -t, ‑‑type [tipo de serviço] – Atualiza os pacotes do tipo de serviço externo especificado.
what-provides (wp) pattern

Mostra os pacotes que incluem biblioteca, programa ou pacote correspondente ao padrão especificado. Apenas o padrão de caractere curinga * é suportado.

Exemplo de como exibir pacotes que terminam com a:

zac wp *a

what-requires (wr) pattern

Lista os pacotes que requerem biblioteca, programa ou pacote correspondente ao padrão especificado.

Um exemplo de como exibir pacotes que começam com a:

zac wr a*

Comandos para gerenciamento de patches

patch-scan (ps)

Explora o dispositivo para verificar se há patches não aplicados, usando o arquivo de assinatura do patch atual (DAU) do dispositivo. Em seguida, é feito upload dos resultados no servidor.

Exemplo de como executar uma verificação de patch:

zac ps

patch-scan ‑‑quick (ps ‑‑quick)

Faz upload dos resultados da última exploração para o servidor. Esse comando não executa uma nova exploração de detecção.

Exemplo de como executar uma verificação rápida de patch:

zac ps ‑‑quick

patch-apply-policy (pap)

Atualiza os dispositivos com a versão mais recente de todas as políticas de patch.

Exemplo de como executar uma política de aplicação de patch:

zac pap

patch-quarantine-release (pqr)

Libera da quarentena todos os patches em quarentena no dispositivo em que o comando é executado, de modo que uma única tentativa de instalação possa ser realizada, seja de uma programação de política de patch ou de uma programação de correção.

Exemplo de como executar uma liberação de quarentena de patch:

zac pqr

Comandos de políticas

policy-list (pl)

Lista as políticas cujo uso obrigatório está sendo assegurado no momento no dispositivo (políticas efetivas). Para listar todas as políticas (efetivas ou não efetivas) use a opção ‑‑all.

Exemplos:

zac pl

zac pl ‑‑all

policy-refresh (pr)

Aplica todas as políticas atribuídas ao dispositivo e ao usuário.

Exemplo:

zac pr

Comandos de registro

add-reg-key (ark) <chave de registro>

Registra o dispositivo usando a chave especificada. Registro com chaves é adicionável. Se o dispositivo foi registrado anteriormente com uma chave e você registrá-lo com uma nova chave, o dispositivo receberá todas as designações de grupo associadas as duas chaves.

Exemplo:

zac ark key12

register (reg) [-k <chave>] [-u <nome_do_usuário> -p <senha] <endereço do Servidor ZENworks:porta>

Registra o dispositivo em uma zona de gerenciamento. Para executar esse comando, você deve ter direitos para Criar/Apagar dispositivos na pasta em que você está tentando registrar.

Exemplos:

zac reg -k key1 https://123.456.78.90

zac reg -k key1 https://zenserver.novell.com:8080

O número da porta é requerido somente se o Servidor ZENworks não estiver usando a porta HTTP padrão (80). Se um nome de usuário e senha não forem fornecidos, eles serão solicitados a você.

NOTA:A opção -k não será aplicada se o objeto Dispositivo correspondente já estiver presente no servidor e a reconciliação for feita com esse objeto Dispositivo.

reregister (rereg)[-u <nome de usuário> -p <senha>] <novo guid>

Registra um dispositivo na zona atual e atribui a ele o GUID de um objeto Dispositivo existente. O objeto Dispositivo associado no momento é apagado. Para executar esse comando, você deve ter direitos para Criar/Apagar dispositivos na pasta que você está tentando registrar novamente.

Por exemplo, se você criar a imagem de um dispositivo após substituir o disco rígido, o dispositivo poderá receber um novo GUID. Entretanto, com o comando reregister, você poderá atribuir o mesmo GUID que já existia antes da substituição do disco rígido.

Exemplos:

Para registrar novamente, especifique um nome de usuário e uma senha:

zac reregister -u meu_usuário -p minha_senha eaa6a76814d650439c648d597280d5d4

Para registrar novamente e receber uma solicitação de nome de usuário e senha:

zac reregister eaa6a76814d650439c648d597280d5d4

unregister (unr) [-f] [-s] [-a] [-u <nome de usuário> -p <senha>]

Remove o registro do dispositivo da zona de gerenciamento. Para executar esse comando, você deve ter direitos para Criar/Apagar dispositivos na pasta cujo registro você está tentando cancelar.

Exemplo:

Para forçar que o registro de um dispositivo seja anulado localmente quando não for possível contatar um servidor:

zac unr -f -u myuser -p mypassword

Para anular o registro localmente e suprimir o prompt que solicita nome de usuário e senha:

zac unr -s

Use a opção -a para anular o registro de forma assíncrona. Com essa opção, o servidor apaga o dispositivo de forma assíncrona.

Os parâmetros -a, -f, -u e -p são opcionais. Se não usar os parâmetros -u e -p, você será solicitado a digitar um nome de usuário e uma senha. Se a opção -a for especificada, o servidor ZENworks retornará a chamada de anulação de registro rapidamente, mas apagará o objeto Dispositivo do banco de dados de forma assíncrona, em algum momento futuro. Se a exclusão do dispositivo não for concluída e houver uma nova tentativa de registrar o dispositivo, o servidor ZENworks exibirá um erro. Se houver uma grande quantidade de dados associados ao dispositivo no banco de dados, poderá levar bastante tempo para apagar o dispositivo. Use a opção -a quando a exclusão do dispositivo real no servidor levar muito tempo e esgotar o tempo de espera do comando de anulação de registro do agente.

NOTA:A execução do comando UNR pode provocar alta utilização do banco de dados. Isso pode ocorrer por qualquer um dos seguintes motivos:

  • O comando UNR está em execução no servidor.

  • A zona contém um grande número de dispositivos gerenciados.

  • Os dispositivos gerenciados têm um histórico enorme.

  • O Patch Management está habilitado.

reestablish-trust (retr) [-u <nome_de_usuário> -p <senha>]

Restabelece a confiança com a Zona de Gerenciamento atual. O nome de usuário e senha usados devem ser do Administrador da Zona.

Exemplo:

zac retr -u meu_usuário -p minha_senha

Os parâmetros -u e -p são opcionais. Se não usar os parâmetros -u e -p, você será solicitado a digitar um nome de usuário e uma senha.

Comandos de função do satélite

remint-satellite-cert (rsc)

Recria o certificado SSL do Satélite.

Exemplo: zac rsc

satellite-cachecfg (satcfg)

Lê funções do Satélite do cache.

Exemplo:

zac satcfg

satellite-clearcache (satcc)

Remove informações de configuração do Satélite do cache.

Exemplo:

zac satcc

satellite-refreshcfg (satrc)

Atualiza funções do Satélite.

Exemplo:

zac satrc

satellite-roles (satr)

Informa sobre as funções atuais do Satélite e seus estados.

Exemplo:

zac satr

imgsatserver status (status do iss)

Exibe as propriedades da função criação de imagens do dispositivo, incluindo seu status atual, o status do serviço PXE, arquivos de imagem e estatísticas de criação de imagens.

Status Atual: Mostra se o seu dispositivo está atualmente configurado para executar operações de criação de imagens. O status atual será Ativo quando o dispositivo for elevado a satélite com a função Criação de Imagens.

Status do Serviço PXE: Mostra se o serviço DHCP Proxy está habilitado no dispositivo.

Solicitações de PXE: O número de solicitações de criação de imagens de qualquer tipo recebido pelo Imaging Server desde que ele foi iniciado. Esse número inclui as solicitações que apresentaram falha, que foram negadas ou que foram encaminhadas a outros Imaging Servers. As informações sobre cada uma dessas solicitações, como origem, tipo, data/horário e resultados, são registradas no Imaging Server.

Imagens Enviadas: O número de imagens que o Imaging Server enviou aos clientes de criação de imagens desde que foi iniciado. Isso inclui apenas as imagens recuperadas nesse Imaging Server.

Imagens Recebidas: O número de novas imagens que foram recebidas e armazenadas no Imaging Server desde que ele foi iniciado. Esse número inclui as imagens que foram recebidas por redirecionamentos de clientes.

Exemplo:

zac iss status

Comandos de status

agent-properties (agp)

Fornece informações sobre o Agente do ZENworks. Os campos a seguir fornecem informações sobre o Agente do ZENworks:

Endereço do Dispositivo. O endereço IP do seu dispositivo.

Nome do Dispositivo. O nome do computador do seu dispositivo.

Estado do Dispositivo. O estado do dispositivo – Gerenciado, Não Gerenciado, Desativado ou Desconhecido. O estado Desconhecido é exibido apenas se há erro.

Último Contato com o Servidor. A última vez que o Agente do ZENworks contatou o Servidor ZENworks.

Próximo Contato com o Servidor. O horário programado para o Agente do ZENworks contatar o Servidor ZENworks.

Usuário Principal. O usuário conectado.

Exemplo:

zac agp

zac agent-properties

cache-clear (cc)

Limpa o cache do ZENworks no dispositivo. Isso remove todas as entradas no banco de dados do cache e apaga qualquer arquivo de cache associado a essas entradas.

Exemplo:

zac cc

refresh (ref)[general [bypasscache] | partial [bypasscache] | bypasscache]

Inicia uma atualização geral para todas as definições de registro e configuração; ou inicia uma atualização parcial para todas as definições de registro e configuração.

Use bypasscache para evitar o uso de dados do cache do servidor durante a atualização. Essa opção é útil para testes ou solução de problemas.

Exemplos:

zac ref general bypasscache

zac ref partial bypasscache

zac ref bypasscache

zenhttp-status(zhs)

Lista a porta e as tags das sub-rotinas registradas.

Exemplo:

zac zhs

zone-config (zc)

Exibe informações sobre o Servidor ZENworks que o dispositivo está acessando para obter informações de configuração (o servidor de configuração) ou lista as informações sobre o servidor de configuração.

Exemplos:

zac zc

get-settings (gs) <chave>

O download das configurações é feito pelo Módulo de Configurações para o cache local a cada atualização. Esse procedimento retornará as configurações efetivas associadas à chave especificada.

Exemplo:

zac gs key1

Todas as chaves de configurações válidas do ZENworks estão armazenadas no diretório /var/opt/novell/zenworks/cache/zmd/settings.

Exemplo para listar as configurações do Gerenciamento Remoto:

zac gs RemoteManagement

statussender (sts)

Esse comando faz roll-up das informações de status para o Servidor Principal. Você pode fazer roll-up das informações que foram atualizadas desde o último roll-up de status ou pode fazer roll-up de todas as informações de status.

Exemplos:

Para fazer roll-up das informações de status que foram atualizadas desde o último roll-up de status bem-sucedido:

zac sts rollup

Para fazer roll-up de todas as informações de status:

zac sts rollup full