2.3 Solução de problemas

Se houver falha no Upgrade do Servidor ZENworks, será necessário corrigir o problema e executar o Instalador do Upgrade do ZENworks novamente.

  • Você deve executar o Instalador do Upgrade novamente no mesmo servidor em que o upgrade foi iniciado.

  • Se houver falha no upgrade durante a ação de banco de dados de upgrade pós-pacote, durante a nova execução e após a autenticação da zona, a página Resumo de Pré-upgrade será exibida, e o upgrade prosseguirá com as ações de banco de dados.

  • Se for usado o banco de dados PostgreSQL Incorporado, verifique se os arquivos .dbR e .logR foram apagados da pasta do banco de dados antes de executar o Instalador do Upgrade novamente.

As seções a seguir apresentam soluções aos problemas que podem ser encontrados durante o upgrade do Servidor Principal do ZENworks:

Há falha no upgrade do ZENworks porque houve falha no upgrade do mecanismo PostgreSQL

Explicação: Haverá falha no upgrade do ZENworks se houver falha no upgrade do mecanismo PostgreSQL. Isso pode ocorrer porque o estado do serviço PostgreSQL era inconsistente antes de iniciar o upgrade.
Ação: Se a exceção Falha na Criação do Serviço de Banco de Dados (dbsvc) com o código de retorno: 2 for gravada no registro de Upgrade, abra o arquivo zen20u2_upgrade_status, que fica em /etc/opt/novell/zenworks no Linux e em %ZENWORKS_HOME%\conf no Windows, e remova a linha POSTGRES_ENGINE_UPGRADE = stop service do arquivo. Inicie o serviço do banco de dados incorporado e acione novamente o upgrade.

A solução alternativa deve ser realizada apenas em caso de falha com interrupção do serviço. No entanto, essa solução alternativa não é recomendada em caso de falhas em outras fases.

O upgrade é concluído com erro em um servidor principal Linux

Explicação: Uma explicação da mensagem.
Causa possível: Quando você faz upgrade de um Servidor Principal Linux, o upgrade pode ser concluído com erro. No entanto, isso pode ser um alarme falso, e o upgrade pode ser bem-sucedido.
Solução do problema: Abra o registro de Upgrade e verifique se a seguinte declaração foi gravada:

“![CDATA[Docker service check failed: Format specifier '%s']]. Severity is CDATA[8]]”

Procure o número de instâncias de “![CDATA[8]]” no registro de upgrade. Se houver apenas uma instância, junto com a declaração acima, o upgrade foi bem-sucedido. Faça login no ZCC e verifique a mesma coisa.

A atualização de sistema de recriação não tem linha de base quando a atualização é aplicada a um dispositivo com agentes do ZENworks e MDM

Origem: ZENworks
Explicação: Quando você inicia o processo de recriação em um dispositivo com os agentes do ZENworks e MDM, o certificado é aplicado com êxito ao agente do ZENworks e o status aparece como Concluído, mas o status do agente MDM exibe o estado Ativação de Certificado Pendente, e esse estado é mantido mesmo que o registro do MDM seja anulado usando a tarefa rápida Anular Registro do Dispositivo MDM. Portanto, a atualização de recriação não terá uma linha de base mesmo depois que o horário de ativação for atingido.
Ação: Para definir a linha de base da atualização, ignore a atualização de sistema de recriação no dispositivo.

Falha no upgrade para o ZENworks 2020 no servidor principal Windows

Explicação: Há falha no upgrade do Servidor Principal Windows para o ZENworks 2020.
Ação: Execute estas etapas:
  1. Se já houve falha no upgrade do servidor, execute o seguinte comando como superusuário:

    icacls "%zenworks_home%\cache" /remove:d Users

  2. Após executar o comando, repita o upgrade usando o Upgrade de Mídia (ISO) do ZENworks 2020.

O dispositivo MDM exibe um status inconsistente após o upgrade para o ZENworks 2020 Update 2

Origem: ZENworks
Explicação: Quando você aplica o ZENworks 2020 Update 2 a um dispositivo MDM que foi registrado no ZENworks 2020 ou 2020 Update 1 (apenas MDM), o status do dispositivo de Atualização de Sistema aparece como Atualização Não Aplicável.
Ação: Nenhuma

Após atualizar todos os dispositivos na zona, você poderá ignorar os dispositivos MDM para definir a linha de base da atualização.

Falha na atualização de sistema devido a erro de reinicialização pendente

Origem: ZENworks
Explicação: Durante a implantação da atualização de sistema, o sistema será reiniciado várias vezes. Mesmo após o encerramento do sistema, houve falha na atualização de sistema com o erro de reinicialização pendente.
Ação: É recomendado reiniciar ou reinicializar o dispositivo após atualizá-lo. Nos dispositivos Windows mais recentes, devido ao modo Início Rápido, encerrar e ligar um dispositivo não são considerados uma reinicialização. Portanto, você precisa reiniciar ou reinicializar o dispositivo, ou desabilitar o modo “Início Rápido”.

Falha na atualização de sistema do IOA nos dispositivos SLED 15 SP1

Origem: ZENworks
Explicação: Quando você implanta uma atualização de sistema do IOA em dispositivos SLED 15 usando o comando “zac su”, pode haver falha na atualização de sistema. Isso pode ocorrer porque o pacote “at” talvez não esteja instalado nos dispositivos SLED 15 por padrão.

Para verificar isso, os usuários ou administradores do IOA podem consultar o arquivo zmd-messages.log e procurar o erro “Cannot run program "at": error=2, No such file or directory”.

Ação: Se o pacote “at” não estiver instalado no dispositivo IOA, instale o comando “at” usando o comando zypper ou outras ferramentas. Após instalar o comando “at”, execute novamente o comando zac su.

Caso o comando zypper não consiga identificar o pacote “at”, podemos instalar os seguintes RPMs:

Faça download dos RPMs em https://rpmfind.net/linux/rpm2html/search.php

  1. Procure “libHX28” e faça download do rpm aplicável à sua plataforma do OS.

    Exemplo: libHX28-3.22-lp150.1.7.x86_64.rpm

  2. Procure “libfl2” e faça download do rpm aplicável à sua plataforma do OS.

    Exemplo: libfl2-2.6.4-lp150.2.48.x86_64.rpm

  3. Procure “at” e faça download do rpm aplicável à sua plataforma do OS.

    Exemplo: at-3.1.20-lp150.2.27.x86_64.rpm

Durante o upgrade de qualquer servidor principal do Windows, o Windows Explorer é reiniciado automaticamente algumas vezes

Explicação: Durante o upgrade de qualquer Servidor Principal do Windows, o Windows Explorer é reiniciado automaticamente algumas vezes, e a janela do prompt de comando aparece automaticamente com a seguinte mensagem:
For each prompt presented, press 'enter' to accept the <default> value, type 'back' to return to the previous action, or type 'quit' to exit.
Ação: Ignore as mensagens.

Quando o upgrade do ZENworks é iniciado, se o banco de dados estiver executando qualquer transação, ela poderá entrar em conflito com o processo de upgrade

Origem: ZENworks; Upgrade
Explicação: Quando o Upgrade do ZENworks é iniciado, se o banco de dados estiver executando qualquer transação, ela poderá entrar em conflito com o processo de upgrade.
Ação: Elimine a sessão do banco de dados que está em conflito com o processo de upgrade. Execute as seguintes etapas para eliminar uma sessão de banco de dados:
  1. Efetue login no banco de dados como usuário do sistema e inicie o cliente SQL.

  2. Execute um dos seguintes scripts, de acordo com o tipo de banco de dados:

    • Oracle:

      select 'ALTER SYSTEM KILL SESSION '''||SID||','||SERIAL#||''';' AS "Drop Query",b.sql_text,a.* from gv$session a, gv$sql b where (case when a.sql_id is null then a.prev_sql_id else a.sql_id end)=b.sql_id and a.program='JDBC Thin Client' and a.logon_time< (sysdate-3/60/24) and a.username='<<ZENWORKSUSER>>';

      Onde:

      ZENWORKSUSER é o nome do usuário do banco de dados do ZENworks.

    • MS SQL:

      select 'KILL '+cast(spid as varchar(100)) as "Drop Query", r.text,s.* from sys.sysprocesses s cross apply sys.dm_exec_sql_text (sql_handle) r where s.program_name='jTDS' and s.spid!=@@spid and s.login_time < dateadd(minute,-3,getdate()) and s.loginame='<<ZENWORKSUSER>>';

      Onde:

      ZENWORKSUSER é o nome do usuário do banco de dados do ZENworks.

    • SQL Anywhere:

      SELECT 'Drop connection '+cast(sa_conn_info.Number as varchar(100))+';' as "Drop Query", sa_conn_info.Number AS connection_number, DB_NAME( DBNumber ) AS database_name, sa_conn_info.name AS connection_name, sa_conn_info.userid, CONNECTION_PROPERTY( 'LoginTime', Number ) as "Login Time", CONNECTION_PROPERTY( 'LastStatement', Number ) As "Query" FROM sa_conn_info() where sa_conn_info.Number != @@spid and CONNECTION_PROPERTY( 'LoginTime', Number ) < dateadd(minute,-3,getdate()) and userid='<<ZENWORKSUSER>>';

      Onde

      ZENWORKSUSER é o nome do usuário do banco de dados do ZENworks.

Ao usar o banco de dados Oracle, durante o upgrade ou a criação do banco de dados, a mensagem de erro TNS é exibida

Origem: ZENworks; Upgrade
Explicação: Ao usar o banco de dados Oracle, durante o upgrade ou a criação do banco de dados, você recebe a mensagem de erro: TNS:listener could not find available handler with matching protocol stack.
Ação: Aumente a carga máxima de conexões dedicadas, que é determinada pelo parâmetro PROCESSES. Se o problema persistir, contate o Suporte Técnico da Micro Focus.

Ao usar o banco de dados MS-SQL, durante o upgrade ou a criação do banco de dados, há problemas de conexão

Origem: ZENworks; Upgrade
Explicação: Ao usar o banco de dados MS-SQL, durante o upgrade ou a criação do banco de dados, há problemas de conexão com a seguinte mensagem de erro:
org.hibernate.exception.JDBCConnectionException: Cannot open connection
Caused by: java.sql.SQLException: I/O Error: Connection reset
Caused by: java.net.SocketException: Connection reset
Ação: Execute select * from sys.configurations where name='user connections'

Por padrão, a conexão máxima é de 32.767. É possível ajustá-la para Número de Servidores Principais * 200. Para obter mais informações sobre como configurar conexões de usuário, consulte http://technet.microsoft.com/en-us/library/ms187030.aspx.

Verifique se o servidor MS-SQL tem alta utilização da CPU e carga elevada do servidor de banco de dados. Contate o Suporte Técnico da Micro Focus para obter mais ajuda.

Valores incorretos exibidos para os registros do inventário a serem removidos

Origem: ZENworks; Upgrade
Explicação: Quando você decide pela remoção no Assistente de Upgrade, o número de registros especificado para exclusão aparece na página de resumo pré-remoção.

Por exemplo, se você marcar 8.000.000 de um total de 10.000.000 de registros para remoção, aparecerá 8.000.000 de 10.000.000 no campo Número de registros marcados para purgação.

Após a remoção bem-sucedida, quando você reiniciar o Assistente de Upgrade para remoção, a página Purgação do Banco de Dados mostrará um valor incorreto no campo Total number of records found to be deleted (Número total de registros encontrados para apagar).

Por exemplo, se foram apagados 8.000.000 de um total de 10.000.000 de registros do inventário, o valor ideal que deverá aparecer no campo Total number of records found to be deleted será de 200.000.

No momento, aparece um valor incorreto. Como resultado, ocorre uma incompatibilidade entre os valores exibidos para os registros já apagados do Inventário e os registros do Inventário que ainda serão apagados.

Ação: Não há solução alternativa.

Erro ao apagar uma pasta com nome longo

Origem: ZENworks; Upgrade
Explicação: Na zona do ZENworks que usa o banco de dados SQL Server, quando você tenta apagar um objeto do ZENworks (por exemplo, dispositivo ou pasta) que tenha um nome com mais do que 900 bytes, aparece o seguinte erro:

com.novell.zenworks.datamodel.exceptions.InternalDataModelException: org.hibernate.exception.GenericJDBCException: Operation failed. The index entry of length 912 bytes for the index 'idx_zZENObject_Name' exceeds the maximum length of 900 bytes.

Ação: Verifique se o tamanho dos nomes de Objetos do ZENworks na zona não excedem 900 bytes. Para obter mais informações, consulte https://technet.microsoft.com/en-us/library/ms191241%28v=sql.105%29.aspx.

Falha no upgrade do esquema do ZENworks devido à incompatibilidade de classificação no banco de dados MS SQL

Origem: ZENworks; Upgrade
Explicação: Haverá falha no upgrade do esquema do ZENworks se o servidor MS SQL e as classificações de banco de dados de auditoria forem incompatíveis.
Ação: Execute as seguintes consultas SQL nos dois bancos de dados (ZENworks e auditoria) para verificar a compatibilidade de classificação de banco de dados:
  • Consulta SQL para obter Classificações de Banco de Dados:

    SELECT collation_name FROM sys.databases WHERE name = db_name();

  • Consulta SQL para obter Classificações de colunas de Banco de Dados:

    select distinct collation_name from information_schema.columns where collation_name is not null;

Compartilhe os registros de upgrade e a saída das consultas com o Suporte da Micro Focus para análise mais detalhada.

O arquivo de registro XML de upgrade não é exibido apropriadamente no Google Chrome e no Firefox

Origem: ZENworks; Upgrade
Explicação: Quando você tenta ver o arquivo de registro XML de upgrade no Google Chrome e no Firefox, ele não é exibido apropriadamente.
Ação: Para ver o arquivo de registro em um browser, execute a seguinte ação de configuração:

microfocus-zenworks-configure -c

ConvertLogToHTMLConfigureAction -DlogFile=<CaminhoArquivoRegistro>

A ação de configuração converte o arquivo de registro XML em HTML e o abre em um browser da Web.

Se preferir, veja o arquivo de registro em qualquer editor de texto.

Em um Servidor Principal Linux, os serviços legados da Novell são listados na ação de configuração “start”

Origem: ZENworks; Upgrade
Explicação: Após o upgrade para o ZENworks 2020 Update 2 em um Servidor Principal Linux, quando você executa o seguinte comando:

novell-zenworks-configure -c Start

Os serviços legados da Novell são listados, e não os novos serviços da Micro Focus. Se você tentar iniciar, parar ou reiniciar os serviços, um erro de exceção será exibido.

Ação: Efetue logout do servidor Linux e efetue login novamente. Abra uma nova janela de terminal e digite o seguinte comando:

novell-zenworks-configure -c Start

Agora os novos serviços da Micro Focus são listados. Você pode iniciar, parar ou reiniciar os serviços.

Falha no upgrade do servidor principal do ZENworks com o erro “Zulu Platform x64 Architecture has stopped working”

Origem: ZENworks; Upgrade
Explicação: Há falha no upgrade do Servidor Principal Windows do ZENworks 2020 ou Update 1 para o 2020 Update 2 com o seguinte erro:

Zulu Platform x64 Architecture has stopped working

Causa possível: O erro ocorre devido à configuração Prevenção de Execução de Dados (DEP, Data Execution Prevention) que está em conflito com o programa.
Ação: Verifique a DEP no servidor navegando até o Painel de Controle > Sistema > Configurações avançadas do sistema. Na janela Propriedades do Sistema, clique em Avançado, em Desempenho, e clique em Configurações. Na janela Opções de Desempenho, clique em Prevenção de Execução de Dados.

Observe a configuração atual. Selecione Ativar DEP somente para programas e serviços essenciais do Windows se ainda não foi selecionada. Reinicie o servidor Windows e repita o upgrade do Servidor Principal do ZENworks. Se o erro persistir, contate o Suporte da Micro Focus.

Importante: Se a configuração foi mudada antes do upgrade, reverta o valor e reinicie o servidor Windows.