Documentación de Oracle Cloud Infrastructure

Ejecución del diagnóstico de instalación del agente

El comando de diagnóstico ayuda en la resolución de problemas durante el proceso de instalación. Muestra mensajes de error, mensajes de advertencia e información de depuración. El comando se incluye en el instalador de software de OMA y en la secuencia de comandos de instalación, que proporciona información valiosa e identifica posibles problemas de instalación. Ayuda a determinar si se cumplen las condiciones previas necesarias en la máquina host para permitir la instalación correcta del agente y el despliegue del plugin.

Activación de diagnóstico

Para activar el diagnóstico en el installer y la secuencia de comandos de instalación, ejecute el siguiente comando de diagnóstico antes de iniciar el proceso de instalación:

Para Linux y macOS:

$ sudo bash ./JMS_YourFleetName_<linux|macos>.sh --diagnostic
Para Windows (mediante PowerShell):
Nota

Se necesita PowerShell versión 5.1 o cualquier versión inferior a 7 para ejecutar el instalador o el script de instalación. 
.\JMS_YourFleetName_windows.ps1 --diagnostic
El diagnóstico recopila toda la información posible y útil, y agrega la salida al archivo log. El resumen de diagnóstico se muestra con todos los resultados. Si hay algún problema, la secuencia de comandos de diagnóstico genera una lista de advertencias y recomendaciones sobre cómo corregir los problemas.
Nota

Los archivos log se pueden ubicar en la siguiente ruta:
  • para Linux: /var/log/oracle/JMSInstallScript/
  • para macOS: /Library/Oracle/JMSInstallScript/
  • para Windows: C:\ProgramData\Oracle\JMSInstallScript

Según el entorno de instalación (arquitectura del sistema operativo y del sistema operativo) y el tipo de agente (OCA u OMA), se proporciona un resumen de diagnóstico con los criterios comprobados y sus resultados se muestran como respuestas Sí/No.

Según el sistema operativo y el tipo de agente, los resultados serán similares a:

Fallo de 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.
El diagnóstico se ha realizado correctamente: 
======================================================================================================
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.

Los criterios comprobados durante la ejecución del diagnóstico pueden variar según el entorno de instalación. En la siguiente tabla se proporciona una lista resumida de todos los criterios comprobados en todas las plataformas soportadas.

Tabla A-2 Resumen de diagnósticos

Criterios Solución/Recomendación
¿El usuario tiene privilegios sudo/root? Asegúrese de que tiene acceso sudo, root o administrator.
¿Está soportado el shell? Asegúrese de usar la versión de shell más reciente.
  • Windows: debe utilizar PowerShell versión 5.1 o posterior.
  • Linux: si utiliza un shell no admitido, actualice el shell y vuelva a ejecutar el script de instalación.
¿Sistema operativo certificado? Asegúrese de que la versión del sistema operativo esté soportada. Consulte Requisitos del sistema de JMS para conocer las plataformas soportadas.

Para omitir esta comprobación, vuelva a ejecutar el script del instalador de JMS con el parámetro --ignore-unsupported.

¿Puede acceder al punto final de OCI? Compruebe la configuración de conexión a Internet y proxy.
¿Cumple los requisitos mínimos de disco? Todas las plataformas requieren 300 MB de espacio libre en disco. Limpie el disco y vuelva a ejecutar la secuencia de comandos.
¿Cumple los requisitos mínimos de memoria? El agente de gestión con plugins de JMS necesita 500 MB de memoria libre. Limpie la memoria y vuelva a ejecutar el script.
¿Se ha encontrado Java en el directorio Users? Asegúrese de mantener Java en una ubicación común a la que puedan acceder todos los usuarios.
¿Java disponible para la instalación del agente? Asegúrese de utilizar la última versión de Oracle JDK 8 para configurar el agente de gestión. Consulte Requisitos previos del agente.
¿Está disponible el instalador de Management Agent? Asegúrese de descargar el archivo del instalador de software del agente correcto específico de su sistema operativo. Guarde el archivo del instalador en el mismo directorio que la secuencia de comandos de instalación y compruebe si se puede acceder a él.

Si el instalador no está en el mismo directorio que la secuencia de comandos, especifique la ruta mediante el parámetro --use-agent-installer-path.

¿Se ha detectado un agente de gestión existente? Si ya tiene una instalación de agente de gestión existente y desea continuar con una reinstalación, puede utilizar el parámetro --reinstall.
¿El agente de gestión existente se puede actualizar a una versión más reciente? Si ha activado la función de actualización automática, los agentes se actualizan automáticamente cuando la nueva versión está disponible. Sin embargo, si hay un problema:
  • Actualice el agente de gestión especificando la ruta del instalador mediante el parámetro --use-agent-installer-path.

    O

  • Vuelva a instalar el agente de gestión con el parámetro --reinstall.
Comprobación de flota correcta. Si se encuentra el OCID del conjunto durante la comprobación, puede actualizar el agente. Si no se encuentra el ID de conjunto, vuelva a instalar el agente con el parámetro --reinstall.
¿Se han instalado los requisitos para Oracle Cloud Agent? Asegúrese de que se cumplen los siguientes requisitos previos antes de instalar Oracle Cloud Agent:
  • La instancia se encuentra en un dominio $OCI_REALM_KEY soportado
  • Están disponibles los metadatos de OCI y la configuración de instancia. De lo contrario, instale oci-metadata manualmente o fuerce la instalación del agente de gestión mediante el argumento --install-mgmt-agent.
  • El paquete jq está instalado; de lo contrario, instálelo manualmente. También puede forzar la instalación del agente de gestión mediante el argumento --install-mgmt-agent.
  • La CLI de OCI está instalada; de lo contrario, instálela manualmente y vuelva a ejecutar el script. También puede forzar la instalación del agente de gestión mediante el argumento --install-mgmt-agent.
¿Cumple los requisitos de Java? Asegúrese de que ha instalado las siguientes versiones de Java para su ejecución:
  • Agente de gestión: Oracle JDK 1.8 o posterior
  • Plugin JMS de OCA: Oracle JDK 11 o posterior
¿Instalador de Management Agent válido? Asegúrese de que se pueda acceder al paquete del instalador del agente de gestión específico del sistema operativo. Si hay algún problema, vuelva a ejecutar el script con el parámetro --use-agent-installer-path.
¿Se puede descomprimir el agente de gestión? Se produce un error si el script no puede utilizar las utilidades jar y unzip para descomprimir el agente de gestión. Vuelva a descargar el agente de gestión y ejecute el script de instalación.
¿El agente de gestión existente tiene plugins de JMS? Si faltan plugins en el agente de gestión existente, puede:
  • Despliegue los plugins mediante la página Agentes de gestión en OCI
  • Vuelva a instalar Management Agent con Java Management Service ejecutando el script con el parámetro --reinstall
¿Cumple los requisitos de las funciones avanzadas de JMS? Para activar las funciones avanzadas de JMS en la instancia, asegúrese de que se puede acceder al ejecutable sudo.
¿Sistema operativo certificado para Oracle Cloud Agent? Java Management Service solo admite Oracle Cloud Agent en Oracle Linux. Para forzar la instalación del agente de gestión en una instancia, utilice el argumento --install-management-agent.
¿Se ha pasado la verificación del certificado?
Nota

Actualmente, esta opción solo está disponible para plataformas Linux y macOS.
Asegúrese de que se puede acceder al servicio revisando la configuración del firewall y el proxy.
¿Está sincronizado el reloj con la plataforma OCI?
Nota

Actualmente, esta opción solo está disponible para plataformas Linux y macOS.
Asegúrese de que el reloj del host esté sincronizado con la plataforma OCI. Si no está sincronizado, sincronice el reloj del host a los 5 minutos de la plataforma OCI y vuelva a ejecutar el script.

Consulte Maximum Allowed Client Clock Skew para obtener más información.