Documentação do Oracle Cloud Infrastructure

Execução do Diagnóstico de Instalação do Agente

O comando de diagnóstico ajuda na solução de problemas durante o processo de instalação. Ela exibe mensagens de erro, mensagens de aviso e informações de depuração. O comando está incluído no instalador do software OMA e no script de instalação, que fornece feedback valioso e identifica possíveis problemas de instalação. Ele ajuda a determinar se as condições de pré-requisito são atendidas na máquina host para permitir a instalação bem-sucedida do agente e a implantação do plug-in.

Ativando Diagnóstico

Para ativar o diagnóstico no instalador e no script de instalação, execute o seguinte comando de diagnóstico antes de iniciar o processo de instalação:

Para Linux e macOS:

$ sudo bash ./JMS_YourFleetName_<linux|macos>.sh --diagnostic
Para o Windows (usando PowerShell):
Observação

É necessário o PowerShell versão 5.1 ou qualquer versão abaixo de 7 para executar o instalador ou o script de instalação. 
.\JMS_YourFleetName_windows.ps1 --diagnostic
O diagnóstico coleta todas as informações possíveis e úteis e adiciona a saída ao arquivo de log. O resumo do diagnóstico é exibido com todas as descobertas. Se houver algum problema, o script de diagnóstico gerará uma lista de avisos e recomendações sobre como corrigir os problemas.
Observação

Os arquivos de log podem ser localizados no seguinte caminho:
  • para Linux: /var/log/oracle/JMSInstallScript/
  • para macOS: /Library/Oracle/JMSInstallScript/
  • para Windows: C:\ProgramData\Oracle\JMSInstallScript

Com base no ambiente de instalação (arquitetura do Sistema Operacional e do Sistema Operacional) e no tipo de agente (OCA ou OMA), é fornecido um resumo de diagnóstico com critérios verificados e seus resultados exibidos como respostas Sim/Não.

Dependendo do sistema operacional e do tipo de agente, os resultados serão semelhantes a:

Falha no diagnóstico: 

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : No    
   Found 2 files with 'oracle.mgmt_agent*.rpm' pattern in /home/opc folder.    
   Please, run script test_linux.sh again with --use-agent-installer-path parameter.
Management Agent has been detected? : No
======================================================================================================
Diagnostics have failed. Please resolve all issues and run the jms setup installer again.
O diagnóstico foi concluído com sucesso: 
======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : Yes
Existing Management Agent has been detected? : Yes
Existing Management Agent has JMS plugins? : Yes
Existing Management Agent can be upgraded? : Yes
======================================================================================================
Diagnostics have finished running and no error occurred.

Os critérios verificados durante a execução do diagnóstico podem diferir de acordo com o ambiente de instalação. A tabela a seguir fornece uma lista resumida de todos os critérios verificados em todas as plataformas suportadas.

Tabela A-2 - Resumo de Diagnósticos

Critérios Solução/Recomendação
O usuário tem privilégios sudo/root? Verifique se você tem acesso a sudo, root ou administrator.
O shell é suportado? Certifique-se de que você esteja usando a versão mais recente do Shell.
  • Windows: Você deve usar o PowerShell versão 5.1 ou posterior.
  • Linux: Se você estiver usando shell não suportado, atualize o shell e execute o script de instalação novamente.
Sistema operacional certificado? Certifique-se de que a versão do sistema operacional seja suportada. Consulte os Requisitos do Sistema JMS para obter as plataformas suportadas.

Para ignorar essa verificação, execute o script do instalador JMS novamente com o parâmetro --ignore-unsupported.

Capaz de acessar o ponto final do OCI? Verifique sua conexão de internet e configuração de proxy.
Atende aos requisitos mínimos de disco? Todas as plataformas requerem 300 MB de espaço livre em disco. Limpe o disco e execute novamente o script.
Atende aos requisitos mínimos de memória? O Management Agent com plug-ins JMS requer 500Mb de memória livre. Limpe a memória e execute novamente o script.
Java encontrado no diretório Usuários? Certifique-se de manter o Java em um local comum que seja acessível a todos os usuários.
Java disponível para instalação do agente? Certifique-se de estar usando a versão mais recente do Oracle JDK 8 para configurar o agente de gerenciamento. Consulte Pré-requisitos do Agente.
Instalador do Agente de Gerenciamento disponível? Certifique-se de fazer download do arquivo correto do instalador de software do agente específico do seu sistema operacional. Salve o arquivo do instalador no mesmo diretório do script de instalação e verifique se ele está acessível.

Se o instalador não estiver no mesmo diretório do script, especifique o caminho usando o parâmetro --use-agent-installer-path.

O Management Agent existente foi detectado? Se você já tiver uma instalação do agente de gerenciamento existente e quiser continuar com uma reinstalação, poderá usar o parâmetro --reinstall.
É possível fazer upgrade do Management Agent existente para uma versão mais recente? Se você tiver ativado o recurso de upgrade automático, os agentes serão atualizados automaticamente quando a nova versão estiver disponível. No entanto, se houver um problema:
  • Atualize o agente de gerenciamento especificando o caminho do instalador usando o parâmetro --use-agent-installer-path.

    ou

  • Reinstale o agente de gerenciamento usando o parâmetro --reinstall.
Verificação de frota aprovada? Se o OCID da frota for encontrado durante a verificação, você poderá fazer upgrade do agente. Se o ID da frota não for encontrado, reinstale o agente usando o parâmetro --reinstall.
Os pré-requisitos do Oracle Cloud Agent foram instalados? Certifique-se de que os seguintes pré-requisitos sejam atendidos antes de instalar o Oracle Cloud Agent:
  • A instância está localizada em um realm $OCI_REALM_KEY suportado
  • Metadados do OCI e Configuração da Instância estão disponíveis. Caso contrário, instale oci-metadata manualmente ou force a instalação do agente de gerenciamento usando o argumento --install-mgmt-agent.
  • O pacote jq está instalado; caso contrário, instale-o manualmente. Você também pode forçar a instalação do agente de gerenciamento usando o argumento --install-mgmt-agent.
  • A CLI do OCI está instalada; caso contrário, instale-a manualmente e execute o script novamente. Você também pode forçar a instalação do agente de gerenciamento usando o argumento --install-mgmt-agent.
Atende ao requisito de Java? Certifique-se de ter instalado as seguintes versões do Java a serem executadas:
  • Agente de gerenciamento - Oracle JDK 1.8 ou mais recente
  • Plug-in JMS do OCA: Oracle JDK 11 ou mais recente
Instalador do Management Agent válido? Certifique-se de que o pacote do instalador do agente de gerenciamento específico do seu SO esteja acessível. Se houver algum problema, execute o script novamente com o parâmetro --use-agent-installer-path.
O Management Agent pode ser descompactado? Ocorre um erro se o script não puder usar os utilitários jar e unzip para descompactar o agente de gerenciamento. Faça download do agente de gerenciamento novamente e execute o script de instalação.
O Management Agent existente tem plug-ins JMS? Se houver plug-ins ausentes no agente de gerenciamento existente, você poderá:
  • Implantar os plug-ins usando a página Management Agents no OCI
  • Reinstale o Management Agent com o Java Management Service executando o script com o parâmetro --reinstall
Atende aos requisitos para recursos avançados do JMS? Para ativar recursos avançados JMS na instância, certifique-se de que o executável sudo esteja acessível.
SO certificado para o Oracle Cloud Agent? O Java Management Service só suporta o Oracle Cloud Agent no Oracle Linux. Para forçar a instalação do Management Agent em uma instância, use o argumento --install-management-agent.
A verificação de certificado foi aprovada?
Observação

No momento, essa opção só está disponível para plataformas Linux e macOS.
Certifique-se de que o serviço esteja acessível revisando suas definições de firewall e proxy.
Sincronização de relógio com a plataforma OCI?
Observação

No momento, essa opção só está disponível para plataformas Linux e macOS.
Certifique-se de que o relógio do host esteja em sincronia com a plataforma OCI. Se ele não estiver em sincronia, sincronize o relógio do host em até 5 minutos da plataforma OCI e execute o script novamente.

Consulte Número Máximo Permitido para o Clock do Cliente para obter mais informações.