zac (1)

Name

zac - A interface de gerenciamento de linha de comando para o Novell ZENworks Adaptive Agent.

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

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

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

add-reg-key (ark) argumentos

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

zac add-reg-key argumentos

zac ark argumentos

Argumentos podem ser obrigatórios ou opcionais. Argumentos obrigatórios são incluídos entre os sinais de maior e menor <argumento>. Argumentos opcionais são incluídos entre colchetes [argumento]. Se um argumento incluir espaço, coloque-o entre aspas:

zac ark "arg 1"

Comandos de ajuda

/h ou --help

Exibe informações sobre os comandos.

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 Servidor 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 servidor satélite:

zac asr -t all -u Administrador -p senha

Se forem obrigatórios um nome de usuário e uma senha, mas 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]

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

Comandos de bundles

bundle-install (bin) <nome de exibição do bundle>

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

Exemplo:

zac bin bundle1

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

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

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

zac bln bundle1

Exemplo para iniciar um bundle com base no nome de exibição e desativar auto-recuperação se a ação de inicialização falhar (por padrão, auto-recuperação fica ativado):

zac bln bundle1 -noSelfHeal

bundle-list (bl)

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

Exemplo:

zac bl

bundle-props (bp) <nome de exibição do bundle>

Exibe o status, a versão, o GUID e as informações de requisitos para o bundle especificado. Use o comando bundle-list para obter uma lista dos bundles disponíveis e seus nomes de exibição.

Exemplo:

zac bln bundle1

bundle-refresh (br) <nome de exibição ou guid do bundle>

Atualiza as informações sobre o bundle especificado.

Exemplo:

zac br bundle1

bundle-remove (brm) <nome de exibição do bundle>

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

Exemplo:

zac brm bundle1

bundle-uninstall (bu) <nome de exibição do bundle>

Desinstala o bundle especificado. 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>

Verifica um bundle instalado (especificado pelo nome de exibição do bundle) para garantir que nenhum arquivo tenha sido 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 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 detalhes dos resultados da comparação de checksum.

Exemplo:

zac cchk -l:"C:\Arquivos de Programas\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:"C:\Arquivos de Programas\Novell\ZENworks\logs\cvc.log"

cdp-import-content (cic) <caminho do conteúdo> [-l:<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 c:\diretório_de_origem_da_importação -l:"C:\Arquivos de Programas\Novell\ZENworks\logs\cic.log"

wake-cdp (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 download do Servidor ZENworks pai do Ponto de Distribuição de Conteúdo de qualquer conteúdo novo ou mudado.
• 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

Esse comando aplica-se apenas quando o agente é promovido como um satélite.

Comandos de banco de dados

statussender CleanUp

Executa a limpeza imediatamente e apaga entradas no banco de dados MDStatus não atualizadas por 14 dias desde o último roll-up com êxito. Por padrão, a limpeza é executada uma vez ao dia, assim que o Serviço de Agente é iniciado. O método de limpeza registra mensagens apropriadas no arquivo zmd-messages.log quando o nível do registro é definido como DEPURAR.

O banco de dados MDStatus é usado para transferir o status dos bundles e políticas do dispositivo gerenciado para o Servidor ZENworks.

statussender RollUp

Faz roll-up para o banco de dados MDStatus de status que foi atualizado desde o último roll-up com êxito. Por padrão, o remetente do status faz roll-up de status automaticamente a cada 5 minutos.

O banco de dados MDStatus é usado para transferir o status dos bundles e políticas do dispositivo gerenciado para o Servidor ZENworks.

Comandos de criação de imagens

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

Exibe, remove ou restaura o GUID da estação de trabalho no sistema de arquivos em preparação para criar a imagem.

Exemplo de exibição do valor do GUID:

zac fsg

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

Comandos de inventário

inventory (inv) inventory [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 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

security-location (sl) [view | list | set <local>]

Exibe ou muda o local de segurança do dispositivo. O local de segurança determina quais políticas de segurança (configurações) são aplicadas ao dispositivo.

Aceita os seguintes argumentos opcionais. Se nenhum argumento for especificado, o argumento view será usado.

• view - Exibe o local atual.
• list - Exibe todos os locais definidos.
• set <local> - Muda para o local especificado. <local> deve ser um dos locais definidos.

Exemplos:

• zac security-location view
• zac sl
• zac sl list
• zac sl set office

Comandos de registro

logger (registro) resetlog|level [GERENCIADO|ERRO|AVISO|INFORMAÇÕES|DEPURAR] |managedlevel , logger

Muda ou exibe a configuração do registrador para o ZENworks Adaptive Agent.

Você pode usar as seguintes opções:

• resetlog - Redefine o registro.
• level - Se essa opção for usada sem nível, exibirá o nível de registro gerenciado atual. Se for usada com um dos níveis, mudará o nível de registro para o nível especificado.
• managedlevel - Exibe o nível de registro gerenciado atual.

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 DEPURAR e acima:

zac logger level DEBUG

Comandos de políticas

policy-export (pe) <tipo de política>

Exporta as configurações de uma política de marcadores do browser para um arquivo XML ou de uma política de grupo do Windows para um arquivo ZIP.

O tipo de política deve ser browserbookmarkspolicy ou grouppolicy.

Uso da política de marcadores do browser

zac pe browserbookmarkspolicy <nome do arquivo XML de exportação> <pasta Favoritos a ser exportada>

Exemplo de política de marcadores do browser:

zac pe browserbookmarkspolicy c:\financial.xml Financial

Exemplo de política de grupo do Windows:

zac pe grouppolicy <opções> <nome do arquivo ZIP a ser exportado>

onde as opções são:

• all - Exporta as configurações do computador e do usuário.
• computer (cmp) - Exporta apenas as configurações do computador.
• user (usr) - Exporta apenas as configurações do usuário.
• active-directory (ad) [caminho da política de grupo do Active Directory] - Exporta a política de grupo do Active Directory; requer que você especifique o caminho da política de grupo do Ative Directory.

Exemplo de política de grupo do Windows:

zac pe grouppolicy all c:\policy.zip

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

get-settings (gs) <chave de registro>

Lista as configurações associadas à chave de registro especificada.

Exemplo:

zac gs key1

Você também pode usar o comando get-settings (gs) para listar as configurações usando várias chaves. Para obter mais informações, consulte get-settings (gs) <chave> na seção Comandos de status.

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

Registra o dispositivo em uma zona de gerenciamento.

Você pode usar as seguintes opções:

• g - Permite criar um novo objeto Dispositivo com um novo GUID e senha para o dispositivo, caso você tenha vários dispositivos com o mesmo GUID. Quando você registra um dispositivo usando esse switch, todas as associações (políticas e bundles) atribuídas ao objeto Dispositivo original são removidas. Você não pode usar essa opção para criar um novo GUID para um Servidor Principal ou um dispositivo Satélite. O usuário local deverá ter direitos de Administrador Local para utilizar essa opção.
• k - Permite registrar o dispositivo usando a chave de registro especificada.
• p - Permite especificar a senha do administrador da Zona de Gerenciamento.
• u - Permite especificar o nome do usuário do administrador da Zona de Gerenciamento.

Exemplos:

zac reg -k key1 https://123.456.78.90

zac reg -k key1 -u administrator -p novell 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ê.

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.

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 GUID anterior do dispositivo 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] [-u <nome_do_usuário> -p <senha>]

Remove o registro do dispositivo da zona de gerenciamento.

Exemplo:

zac unr -u administrator -p novell

Os parâmetros -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. O parâmetro -f ignora o banco de dados do ZENworks e força a anulação de registro do dispositivo localmente; essa opção somente será necessária se o objeto Dispositivo já tiver sido apagado do banco de dados do ZENworks ou se o dispositivo não puder se conectar ao banco de dados.

Comandos de status

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

dump-prop-pages (dpp) <diretório de destino>

Envia as páginas HTML exibidas nas páginas de propriedade do ícone do ZENworks para arquivos no diretório de destino especificado.

Exemplo:

zac dpp c:\temp

get-settings (gs) <chave>

Lista as configurações associadas à chave especificada.

Exemplo:

zac gs key1

Todas as chaves de configurações válidas do ZENworks são armazenadas no diretório \Arquivos de Programas\Novell\ZENworks\cache\zmd\settings.

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

zac gs RemoteManagement

refresh (ref)[general | partial bundle <Nome de Exibição do Bundle> [bypasscache]

Inicia uma atualização geral para todas as definições de bundles, políticas, registro e configuração; inicia uma atualização parcial para todas as definições de políticas, 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

set-proxy (sp) [opções] <endereço IP:porta> [nome_do_usuário] [senha]

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 pelas 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:

zac sp 123.456.78.90 administrator novell

zac sp /default 123.456.78.90

Se um nome de usuário e senha não forem fornecidos, eles serão solicitados a você.

winproxy-refresh (wpr)

Consulta a zona de gerenciamento sobre o trabalho de proxy atribuído a esse dispositivo.

Exemplo:

zac wpr

zenhttp-status(zhs)

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

Exemplo:

zac zhs

Esse comando aplica-se apenas quando o agente é promovido como um satélite.

info-collect (zeninfo) [<arquivo_de_destino>]

Coleta informações de suporte do ZENworks, incluindo dados de cache, dados de configuração, registros de depuração, informações sobre a instalação do produto, atualizações, eventos de status e informações básicas sobre o sistema. As informações são compactadas em um arquivo ZIP e incluídas no local especificado. Se você não especificar um local, será usado ${TEMP}\zeninfo-${DateTime}.zip para Windows e ${TMPDIR}\zeninfo-${DateTime}.zip para Linux. Se você estiver enfrentando problemas com um dispositivo gerenciado, o Suporte da Novell poderá pedir a execução desse comando e o envio do arquivo ZIP resultante à Novell para ajudar a solucionar seu problema.

zone-config (zc) [-l]

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

zac zc -l

Autores

Copyright 2008-2010, Novell, Inc. Todos os direitos reservados. http://www.novell.com