Documentazione di Oracle Cloud Infrastructure

Diagnostica installazione agente in esecuzione

Il comando diagnostico consente di risolvere i problemi durante il processo di installazione. Vengono visualizzati i messaggi di errore, i messaggi di avvertenza e le informazioni di debug. Il comando è incluso nel programma di installazione del software OMA e nello script di installazione, che fornisce preziose informazioni e identifica eventuali problemi di installazione. Consente di determinare se le condizioni dei prerequisiti vengono soddisfatte sul computer host per consentire la corretta installazione dell'agente e la distribuzione del plugin.

Abilitazione della diagnostica

Per abilitare la diagnostica nel programma di installazione e nello script di installazione, eseguire il seguente comando diagnostico prima di avviare il processo di installazione:

Per Linux e macOS:

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

per eseguire il programma di installazione o lo script di installazione è necessaria la versione 5.1 o una versione inferiore a 7 di PowerShell. 
.\JMS_YourFleetName_windows.ps1 --diagnostic
La diagnostica raccoglie tutte le informazioni possibili e utili e aggiunge l'output al file di log. Il riepilogo diagnostico viene visualizzato con tutti i risultati. In caso di problemi, lo script di diagnostica genera un elenco di avvertenze e suggerimenti su come risolvere i problemi.
Nota

I file di log possono trovarsi nel seguente percorso:
  • per Linux: /var/log/oracle/JMSInstallScript/
  • per macOS: /Library/Oracle/JMSInstallScript/
  • per Windows: C:\ProgramData\Oracle\JMSInstallScript

In base all'ambiente di installazione (architettura del sistema operativo e del sistema operativo) e al tipo di agente (OCA o OMA), viene fornito un riepilogo diagnostico con i criteri selezionati e i relativi risultati visualizzati come risposte Sì/No.

A seconda del sistema operativo e del tipo di agente, i risultati saranno simili a:

Diagnostica non riuscita: 

======================================================================================================
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.
Diagnostica completata e riuscita: 
======================================================================================================
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.

I criteri controllati durante l'esecuzione della diagnostica possono differire a seconda dell'ambiente di installazione. La tabella riportata di seguito fornisce un elenco riepilogativo di tutti i criteri controllati in tutte le piattaforme supportate.

Tabella A-2 - Riepilogo diagnostico

Criteri Soluzione/raccomandazione
L'utente dispone dei privilegi sudo/root? Assicurarsi di disporre dell'accesso sudo, root o administrator.
Shell supportata? Assicurarsi di utilizzare la versione più recente della shell.
  • Windows: è necessario utilizzare PowerShell versione 5.1 o successiva.
  • Linux: se si utilizza una shell non supportata, aggiornare la shell ed eseguire di nuovo lo script di installazione.
Sistema operativo certificato? Assicurarsi che la versione del sistema operativo sia supportata. Per le piattaforme supportate, vedere i requisiti di sistema JMS.

Per saltare questo controllo, eseguire di nuovo lo script Installer JMS con il parametro --ignore-unsupported.

Sei in grado di raggiungere l'endpoint OCI? Controllare la connessione a Internet e le impostazioni proxy.
Soddisfa i requisiti minimi del disco? Tutte le piattaforme richiedono 300 MB di spazio libero su disco. Pulire il disco ed eseguire di nuovo lo script.
Soddisfa i requisiti minimi di memoria? Il Management Agent con plugin JMS richiede 500 MB di memoria libera. Pulire la memoria ed eseguire di nuovo lo script.
Java trovato nella directory Utenti? Assicurarsi di mantenere Java in una posizione comune accessibile a tutti gli utenti.
Java disponibile per l'installazione dell'agente? Assicurarsi di utilizzare la release più recente di Oracle JDK 8 per impostare il Management Agent. Fare riferimento alla sezione Requisiti agente.
Programma di installazione di Management Agent disponibile? Assicurarsi di scaricare il file corretto del programma di installazione del software dell'agente specifico del sistema operativo. Salvare il file del programma di installazione nella stessa directory dello script di installazione e verificare che sia accessibile.

Se il programma di installazione non si trova nella stessa directory dello script, specificare il percorso utilizzando il parametro --use-agent-installer-path.

È stato rilevato un Management Agent esistente? Se si dispone già di un'installazione Management Agent esistente e si desidera procedere con una reinstallazione, è possibile utilizzare il parametro --reinstall.
Il Management Agent esistente può essere aggiornato a una versione più recente? Se è stata abilitata la funzione di aggiornamento automatico, gli agenti vengono aggiornati automaticamente quando è disponibile la nuova versione. Tuttavia, in caso di problemi:
  • Aggiornare il Management Agent specificando il percorso del programma di installazione utilizzando il parametro --use-agent-installer-path.

    oppure

  • Reinstallare il Management Agent utilizzando il parametro --reinstall.
Controllo della flotta riuscito? Se durante il controllo viene rilevato l'OCID della flotta, è possibile eseguire l'upgrade dell'agente. Se l'ID flotta non viene trovato, reinstallare l'agente utilizzando il parametro --reinstall.
I prerequisiti per l'agente Oracle Cloud sono stati installati? Prima di installare l'agente Oracle Cloud, assicurarsi che vengano soddisfatti i prerequisiti riportati di seguito.
  • L'istanza si trova in un realm $OCI_REALM_KEY supportato
  • Sono disponibili i metadati OCI e la configurazione dell'istanza. In caso contrario, installare oci-metadata manualmente o forzare l'installazione del Management Agent utilizzando l'argomento --install-mgmt-agent.
  • Il pacchetto jq è installato, altrimenti installarlo manualmente. È possibile forzare anche l'installazione del Management Agent utilizzando l'argomento --install-mgmt-agent.
  • L'interfaccia CLI OCI è installata, altrimenti installarla manualmente ed eseguire di nuovo lo script. È possibile forzare anche l'installazione del Management Agent utilizzando l'argomento --install-mgmt-agent.
Soddisfa il requisito Java? Assicurarsi di aver installato le seguenti versioni Java da eseguire:
  • Management Agent - Oracle JDK 1.8 o versione successiva
  • Plugin JMS OCA: Oracle JDK 11 o versione successiva
Programma di installazione valido di Management Agent? Assicurarsi che il pacchetto del programma di installazione del Management Agent specifico del sistema operativo sia accessibile. In caso di problemi, eseguire di nuovo lo script con il parametro --use-agent-installer-path.
Il Management Agent può essere decompresso? Si è verificato un errore se lo script non è in grado di utilizzare le utility jar e unzip per decomprimere il Management Agent. Scaricare di nuovo il Management Agent ed eseguire lo script di installazione.
Il Management Agent esistente dispone di plugin JMS? Se nel Management Agent esistente mancano plugin, è possibile effettuare una delle operazioni riportate di seguito.
  • Distribuire i plugin utilizzando la pagina Management Agent in OCI
  • Reinstallare Management Agent con Java Management Service eseguendo lo script con il parametro --reinstall
Soddisfa i requisiti per le funzioni avanzate JMS? Per abilitare le funzioni avanzate JMS nell'istanza, assicurarsi che l'eseguibile sudo sia accessibile.
Sistema operativo certificato per l'agente Oracle Cloud? Java Management Service supporta solo l'agente Oracle Cloud su Oracle Linux. Per forzare l'installazione di Management Agent in un'istanza, utilizzare l'argomento --install-management-agent.
La verifica del certificato è stata superata?
Nota

Al momento, questa opzione è disponibile solo per le piattaforme Linux e macOS.
Assicurarsi che il servizio sia accessibile esaminando le impostazioni del firewall e del proxy.
L'orologio è sincronizzato con la piattaforma OCI?
Nota

Al momento, questa opzione è disponibile solo per le piattaforme Linux e macOS.
Assicurarsi che l'orologio dell'host sia sincronizzato con la piattaforma OCI. Se non è sincronizzato, sincronizzare il clock dell'host entro 5 minuti dalla piattaforma OCI ed eseguire di nuovo lo script.

Per ulteriori informazioni, vedere Scambio massimo di clock client consentito.