3.0 Solução de problemas de utilitários de linha de comando do ZENworks

As seções a seguir apresentam soluções para os problemas que você pode encontrar ao trabalhar com os utilitários de linha de comando do Micro Focus ZENworks:

Quando você executa o comando zman db, pode ocorrer o erro de espaço de heap do Java

Origem: ZENworks 2017 Update 2
Explicação: Quando você executa o comando zman db, pode ocorrer o erro de espaço de heap do Java OutOfMemoryError:.
Causa possível: Memória de heap do Java limitada configurada para o processo do zman.
Ação: Usando a nova ação de configuração UpdateZManConfigPropertiesConfigureAction, é possível configurar o tamanho de heap. Por padrão, o tamanho máximo de heap está definido como 512.

Para aumentar o tamanho de heap:

No prompt de comando, execute o comando a seguir:

novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction -Dzman.jvm.max.heapSize=<entrada do usuário>

Em que <entrada do usuário> pode ser entre max.heapsize: 512 (padrão) e 1024 (limite superior)

Além do max.heapsize, é possível configurar outros parâmetros, como min.heapSize, scrollSize e debugLevel.

novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction -Dzman.jvm.max.heapSize=<entrada do usuário> -Dzman.jvm.min.heapSize=<entrada do usuário> -Dzman.renderer.scrollSize=<entrada do usuário> -Dzman.debugLevel=<entrada do usuário>

Em que <entrada do usuário> para min.heapSize pode ser entre 64 (padrão) e 512 (limite superior)

scrollSize aceita qualquer valor de número inteiro (-1 é o padrão)

debugLevel aceita os valores 1, 2, 3 (padrão) e 4

NOTA:Se o arquivo zman-config.property estiver corrompido ou for apagado, execute o comando novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction sem parâmetros para obter os valores padrão no arquivo.

zman trava quando a saída de um comando é redirecionada para um arquivo usando os operadores de redirecionamento de linha de comando como > ou >>

Origem: ZENworks; zman.
Causa possível: O zman requer o nome de usuário e a senha do administrador do ZENworks para executar cada comando. Se as credenciais não forem fornecidas com o comando, você será solicitado a digitá-las. Entretanto, se a saída do comando for redirecionada para o arquivo, você não será solicitado a digitar as credenciais, pois os prompts de nome de usuário e senha também serão redirecionados para o arquivo. Consequentemente, o zman travará, aguardando a inserção das credenciais.
Ação: Especifique as credenciais como parte do comando usando as opções -U|--User e -P|--Password.
Ação: Armazene as credenciais usando o comando admin-store-credential e depois execute o comando.
Ação: Redirecione a saída para um arquivo usando a opção -R|--Redirect, em vez do operador de redirecionamento > ou >>.

Uma mensagem de êxito incorreta é exibida quando o argumento opcional "nome de grupo provisório" não é passado ao comando system-update-staging-group-create

Origem: ZENworks; zman.
Explicação: O zman exibirá a mensagem incorreta a seguir se o argumento opcional de nome de grupo provisório não for passado para o comando system-update-staging-group-create: 
Successfully created the object "null"
Ação: Para ver a lista de grupos provisórios que incluiriam o grupo provisório recém-criado, execute o comando system-update-staging-group-list (susgl) no prompt do console.

A função de Criação de Imagens adicionada a um Satélite com o comando zman ssaimg não é imediatamente aplicada ao servidor

Origem: ZENworks; zman.
Explicação: Se você configurar a função de criação de imagens usando o comando zman ssaimg, a função será imediatamente adicionada ao dispositivo. Se a função não for imediatamente adicionada, ela será incluída somente durante a próxima programação de atualização do dispositivo.
Ação: Se quiser aplicar a função imediatamente ao dispositivo, você deverá atualizá-lo manualmente de uma das seguintes maneiras:

  • No prompt de comando, execute o comando zman workstation-refresh|wrf. Se o dispositivo gerenciado for um servidor, execute o comando zman server-refresh|srf.

  • No dispositivo gerenciado, clique o botão direito do mouse no ícone do ZENworks e clique em Atualizar.

Os comandos zman não funcionam para usuários não root em um servidor ZENworks Linux

Origem: ZENworks; zman.
Explicação: Caso um usuário não root execute os comandos zman em um servidor ZENworks Linux, a seguinte mensagem de erro será exibida:

Você não tem privilégios suficientes para executar os comandos zman. Como usuário não root no Linux, você deve fazer parte do grupo zmanusers para executar os comandos zman.

Ação: Adicione o usuário não root ao grupo zmanusers antes de executar os comandos zman.

  1. Efetue login no servidor ZENworks como root.

  2. No prompt do console do servidor:

    • Se o usuário já existir no dispositivo Linux, execute o seguinte comando:

      groupmod -A non-rootusername zmanusers

    • Se o usuário não existir no dispositivo Linux, execute o seguinte comando:

      useradd -G zmanusers non-rootusername

  3. Faça login no servidor ZENworks como usuário não root.

Um usuário não root não pode configurar uma função do Satélite usando o comando zman ssc

Origem: ZENworks; zman.
Explicação: Se um usuário não root tentar configurar uma função do Satélite usando o comando zman ssc em um Servidor Principal Linux, a seguinte mensagem de erro será exibida: 
The role you specified (Satellite_role_name) is not a valid satellite server role. Valid roles are:
ZoneConfig.ROLE_COLLECTION
ZoneConfig.ROLE_CONTENT
ZoneConfig.ROLE_AUTHENTICATION
Ação: Faça o seguinte:

  1. Verifique se o usuário não root foi adicionado ao grupo zmanusers.

    1. Efetue login no servidor ZENworks como root.

    2. No prompt do console do servidor:

      • Se o usuário já existir no dispositivo Linux, execute o seguinte comando:

        groupmod -A non-rootusername zmanusers

      • Se o usuário não existir no dispositivo Linux, execute o seguinte comando:

        useradd -G zmanusers non-rootusername

  2. Adicione o usuário não root ao grupo de usuários do ZENworks usando o comando usermod -A nome_do_usuário_não_root. Depois disso, o usuário não root poderá configurar funções do Satélite.

O comando zac cuo não faz upload dos arquivos de auditoria do agente do Servidor Satélite para o Servidor Principal quando o banco de dados collectionStatsDB está corrompido.

Origem: ZENworks; zac.
Explicação: Quando é feito upload dos arquivos de auditoria do agente para o Servidor Satélite, o servidor mantém as referências aos arquivos de auditoria no banco de dados collectionStatsDB. Se o banco de dados estiver corrompido, todas as referências serão perdidas e os arquivos ficarão órfãos. Portanto, ao executar o comando zac cuo para fazer upload dos arquivos de auditoria do agente para o Servidor Principal, você receberá um erro.
Ação: Para fazer upload dos arquivos de auditoria do agente para o Servidor Principal, você deve executar as seguintes etapas no Servidor Satélite:

  1. Pare o serviço do agente.

  2. Apague a pasta /var/opt/novell/zenworks/work/collection/collectionStatsDB que possui referências aos arquivos de auditoria órfãos.

  3. Inicie o serviço do agente.

  4. Execute o comando zac cuo.

Há falha em alguns comandos zman com OutOfMemoryError

Origem: ZENworks; zman.
Explicação: Alguns comandos zman podem falhar com o erro OutOfMemory.
Ação: Aumente o tamanho máx. de heap do zman:

Windows: No arquivo %ZENWORKS_HOME%\conf\zman\properties\zman-config.properties, aumente o valor do tamanho máx. de heap em JVM_STARTUP_OPTIONS de 128m para 512m.

Linux: No arquivo /opt/novell/zenworks/bin/zman, aumente o tamanho máx. de heap em MEM_OPTS de 256m para 512m.

Falha no comando zman ssd usado para remover uma função de satélite

Origem: ZENworks; zman
Explicação: Falha no comando zman ssd com o seguinte erro:

Erro interno. Verifique o registro de zman para obter mais informações

Quando você usa o ssd, o comando zman de remoção de função do satélite, esse comando remove a função, mas não envia a tarefa rápida de atualização do satélite.

Causa possível: Isso acontece porque a tarefa rápida de atualização do satélite já está em andamento ou prestes a ser processada no satélite.
Ação: Nenhuma

Comandos zac travam nos servidores satélite RHEL quando a programação de replicação de conteúdo é configurada para curta duração

Origem: ZENworks; zac
Explicação: Quando você executa comandos zac em um Servidor Satélite RHEL, o processo trava por tempo indefinido.
Causa possível: A programação de replicação de conteúdo está configurada para uma curta duração. Por exemplo, 5 minutos.

NOTA:É recomendado configurar a programação de replicação de conteúdo para 12 horas.

Ação: Efetue login no ZENworks Control Center e adicione uma variável de sistema da zona, enable.cdp.cleanup.thread.wait.time, e defina o valor como True (Verdadeiro).

Há falha na ação de configuração com a exceção ZEN configure action container is not responding

Origem: ZENworks
Explicação: A ação de configuração é concluída com o seguinte aviso:

com.novell.zenworks.configure.NonFatalConfigureException: ZEN configure action container is not responding

Causa possível: Esse problema ocorreu porque o container ZENConfigure não pôde inicializar dentro do tempo de espera.
Ação: Aumente o tempo de espera do container ZENConfigure usando a propriedade de configuração max-retries-for-configure-server=<número de novas tentativas> no diretório /etc/opt/microfocus/zenworks/host-configure-action.properties. O valor padrão de max-retries-for-configure-server é 60.

NOTA:Crie o arquivo com a entrada se ele não existir.