• Risoluzione dei problemi: disinstallare l'agente e rimuovere il file del servizio prima di installare il nuovo agente.
• Risoluzione dei problemi: Java non è una JVM a 64 bit. Impostare il percorso di una JVM a 64 bit nella variabile di ambiente JAVA_HOME o Java non trovato. Impostare il percorso preferito in JAVA_HOME.
• Risoluzione dei problemi: installazione dell'agente non riuscita con messaggio: useradd: impossibile ottenere un GID univoco (nessun altro GID disponibile).
• Risoluzione dei problemi: useradd: impossibile creare la directory /usr/share/mgmt_agent
• Risoluzione dei problemi: Windows: impossibile trovare il percorso specificato. Installazione dell'agente non riuscita.
• Risoluzione dei problemi: lo stato di Management Agent è "Non disponibile" nella console dopo l'installazione iniziale
• Risoluzione dei problemi: dopo la configurazione, il Management Agent non è visibile nella console o tramite l'API
• Risoluzione dei problemi: le metriche Prometheus o Kubernetes monitorate mediante Management Agent non sono disponibili
• Risoluzione dei problemi: l'agente viene eseguito in OutOfMemoryException
• Risoluzione dei problemi: il Management Agent OCI non si avvia sull'host Windows
• Risoluzione dei problemi: l'aggiornamento automatico del Management Agent non funziona o alcuni agenti sono stati saltati
• Risoluzione dei problemi: indirizzo IP visualizzato nella colonna host quando Management Agent è installato nell'host di Windows
• Risoluzione dei problemi: l'installazione di Management Agent non riesce su SELinux quando si utilizza un volume esterno
• Risoluzione dei problemi: installazione del Management Agent non riuscita su Red Hat Enterprise Linux 9.x
• Risoluzione dei problemi: installazione dell'agente non riuscita - JavaHome non è impostato per l'interruzione dell'installazione dell'agente
• Risoluzione dei problemi: l'installazione di Management Agent non riesce nel valore RUN_AGENT_AS_USER previsto per Linux come root
• Risoluzione dei problemi: accesso allo script non riuscito utilizzando un percorso assoluto. Autorizzazioni insufficienti
• Risoluzione dei problemi: tentativo di registrazione cloud non riuscito con stato HTTP 407, credenziali Gateway Server errate
• Risoluzione dei problemi: impossibile visualizzare lo spazio di nomi e le metriche Prometheus nel servizio di monitoraggio
• Risoluzione dei problemi: flag fornito ma non definito
• Risoluzione dei problemi: impossibile aggiungere le credenziali SSH con errore: carattere non racchiuso tra virgolette non valido
• Risoluzione dei problemi: errore nel percorso del certificato
• Risoluzione dei problemi: impossibile installare Oracle Management Agent nell'istanza di Windows
• Risoluzione dei problemi: durante l'installazione del Management Agent e la visualizzazione dei messaggi con timeout della connessione di rete
• Risoluzione dei problemi: CloudRegistrationStep: tentativo di registrazione non riuscito con stato HTTP 401 (le informazioni necessarie per completare l'autenticazione non sono state fornite o non sono corrette)
• Troubleshoot: "code": "NotAuthenticated","message": "The required information to complete authentication was not provided or was incorrect.

Risoluzione dei problemi: disinstallare l'agente e rimuovere il file del servizio prima di installare il nuovo agente.

Causa: sull'host è già installato un agente. Un processo di disinstallazione precedente non ha rimosso correttamente il file del servizio agente.

Risoluzione dei problemi: Java non è una JVM a 64 bit. Impostare il percorso di una JVM a 64 bit nella variabile di ambiente JAVA_HOME oppure Java non trovato. Impostare il percorso preferito in JAVA_HOME.

Causa: la variabile di ambiente JAVA_HOME non è impostata oppure non punta a una posizione JDK a 64 bit.

Azione: impostare la variabile di ambiente JAVA_HOME sulla versione JDK corretta e riprovare a installare l'agente. Attualmente è supportato solo il JDK a 64 bit.

Risoluzione dei problemi: installazione dell'agente non riuscita con messaggio: useradd: impossibile ottenere un GID univoco (nessun altro GID disponibile)

Causa: lo script di installazione non può aggiungere un utente e un gruppo durante il processo di installazione del Management Agent poiché gli ID gruppo disponibili nel sistema Linux sono già in uso.

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent) 
useradd: Can't get unique GID (no more available GIDs) 
useradd: can't create group 
Agent installation failed, please check log file

Azione: rivolgersi all'amministratore di sistema prima di procedere con quanto riportato di seguito.

1. Modificare il file /etc/login.defs. Per modificare il file sono necessari i privilegi sudo.

   Cercare le voci riportate di seguito.

   SYS_GID_MIN               nnnn
   SYS_GID_MAX               mmmm
   SYS_UID_MIN               pppp
   SYS_UID_MAX               qqqq

   Dove nnnn e pppp sono il valore minimo e mmmm e qqqq sono il valore massimo.

   Se le voci precedenti non esistono nel file, aggiungerle.

2. Aggiornare il valore della voce SYS_GID_MAX in base a quanto consigliato dall'amministratore del sistema e salvare il file.

3. Rimuovere l'installazione dell'agente non riuscita eseguendo: sudo rpm -e oracle.mgmt_agent.

4. Logout della shell seguito dal login.

5. Riprovare l'installazione dell'agente.

Risoluzione dei problemi: useradd: impossibile creare la directory /usr/share/mgmt_agent

Durante l'installazione di Management Agent, l'utente mgmt_agent viene creato con la posizione della directory home predefinita in /usr/share/mgmt_agent.

Causa: non sono disponibili autorizzazioni file sufficienti in /usr/share oppure il file system è di sola lettura.

Azioni possibili:

• Impostare le autorizzazioni per concedere all'utente mgmt_agent l'accesso alla posizione della directory home utente predefinita: /usr/share.

• Impostare una directory home diversa utilizzando la variabile di ambiente USER_HOME_DIR_ROOT se si desidera utilizzare una posizione diversa.

  Impostare la variabile di ambiente USER_HOME_DIR_ROOT con il percorso che si preferisce utilizzare come directory home per l'utente mgmt_agent e assicurarsi che l'utente del Management Agent disponga delle autorizzazioni file corrette per tale directory preferita.

Risoluzione dei problemi: Windows: impossibile trovare il percorso specificato. Installazione dell'agente non riuscita.

LIVELLO DI ERRORE=9009

Possibile causa: le variabili di ambiente non sono state impostate correttamente a causa degli spazi nel nome della directory o della cartella.

Gli ambienti Windows consentono di utilizzare spazi all'interno di un nome directory/cartella che causa un problema con l'installazione di Management Agent poiché le virgolette vengono aggiunte automaticamente al nome da Windows. Ad esempio, esiste una directory/cartella denominata: Program Files. In questo caso Windows inserisce automaticamente le virgolette poiché c'è uno spazio all'interno del nome della cartella e ora dirà: "Program Files".

Le virgolette aggiuntive possono causare un problema poiché il programma di installazione di Management Agent non consente virgolette per le variabili di ambiente, ad esempio JAVA_HOME e AGENT_INSTALL_BASEDIR.

Azione:

Risoluzione dei problemi: lo stato del Management Agent è "Non disponibile" nella console dopo l'installazione iniziale

Possibile causa n. 1: indicatore orario di sistema errato

Azione: verificare l'ora di sistema dell'host dell'agente e, se necessario, correggere l'ora.

Possibile causa n. 2: se si utilizza il file di risposta input.rsp per il Management Agent, è necessario definire le tag per il compartimento Management Agent.

Se i tag non sono definiti, è possibile che venga visualizzato un errore simile al seguente:

Attempts:
<--> Endpoint:       management-agent.us-ashburn-1.oci.oraclecloud.com
     opc-request-id: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXJ8
     StartTime:      2024-09-18 03:45:12,662 GMT
     Status:         400 Bad Request
     Headers:        Strict-Transport-Security=max-age=31536000; includeSubDomains;
                     Connection=close
                     Content-Length=63
                     opc-request-id=XXXXXXXXXXXXXXXXXXXXXXXX..................B25ADA8E
                     Date=Wed, 18 Sep 2024 03:45:12 GMT
                     Content-Type=application/json
     ErrorBody:      
{
  "code" : "InvalidParameter",
  "message" : "Invalid tags"
}

Azione: per definire le tag specifiche per l'ambiente in uso, nel file di risposta input.rsp aggiungere i parametri riportati di seguito e specificare le coppie chiave-valore per l'ambiente in uso. Per ulteriori informazioni, vedere Creare un file di risposta.

DefinedTags = [{"namespace1":{"<key1>":"<value1>"}},
      {"namespace2":{"<key2>":"<value2>"}}]

Risoluzione dei problemi: dopo la configurazione, il Management Agent non è visibile nella console o tramite l'API

Possibile causa: se dopo aver configurato il Management Agent o l'agente gateway di gestione, l'agente non viene visualizzato nella console di Oracle Cloud o tramite l'API, i criteri corretti potrebbero non essere impostati per l'utente o il gruppo di utenti.

Azione: verificare che l'utente o il gruppo di utenti disponga dei criteri necessari configurati per il Management Agent o l'agente gateway. Per impostare i criteri, vedere Creare criteri per il gruppo di utenti.

Risoluzione dei problemi: le metriche Prometheus o Kubernetes monitorate mediante Management Agent non sono disponibili

Risoluzione dei problemi: l'agente viene eseguito in OutOfMemoryException

Possibile causa: l'agente potrebbe esaurire la memoria heap se non viene sottoposta a tuning in modo appropriato per supportare il carico a cui è stata assegnata.

Azione: aggiornare le impostazioni della memoria heap per il Management Agent.

Risoluzione dei problemi: il Management Agent OCI non si avvia su un host Windows

Risoluzione dei problemi: l'aggiornamento automatico del Management Agent non funziona o alcuni agenti sono stati saltati

Possibile causa: se l'upgrade automatico del Management Agent OCI non funziona per alcuni Management Agent, è possibile che l'upgrade automatico del Management Agent abbia smesso di funzionare perché alcuni file o directory erano di proprietà di proprietari non validi nel file system dell'agente.

Ad esempio, se alcuni file o directory della seguente posizione non disponevano delle autorizzazioni corrette, l'aggiornamento automatico dell'agente non funzionava: /opt/oracle/mgmt_agent/agent_inst.

In questo file di log è possibile che venga visualizzato il seguente errore: /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log

ERROR - Following files are owned by invalid owners: [/opt/oracle/mgmt_agent/db00_cred.json,
/opt/oracle/mgmt_agent/agent_inst/config/emd.properties.backup]
(ManagedAgent upgrade checker)-32] WARN - Files with invalid owners were found, skipping auto-upgrade

Azione: nell'host del Management Agent, confermare nel file system dell'agente, tutti i file e le directory sono di proprietà del proprietario mgmt_agent e del gruppo mgmt_agent:mgmt_agent in modo che l'upgrade automatico del Management Agent possa essere completato.

Risoluzione dei problemi: l'indirizzo IP visualizzato nella colonna host quando Management Agent è installato nell'host Windows

Problema: il Management Agent viene installato su un host Windows e la console del Management Agent visualizza l'indirizzo IP dell'host Windows nella console di Oracle Cloud anziché visualizzare il nome di dominio completo o il nome host di Windows.

L'installazione di Management Agent deve essere completata e nella colonna host verrà visualizzato il nome FQDN della pagina Agente dell'host Windows.

Risoluzione dei problemi: installazione di Management Agent non riuscita su SELinux quando si utilizza il volume esterno

systemctl start mgmt_agent
Job for mgmt_agent.service failed because the control process exited with error code.
See "systemctl status mgmt_agent.service"and "journalctl -xeu mgmt_agent.service" for details.

journalctl -xeu mgmt_agent.service
...
Dec 08 15:48:19 ol9-arm systemd[1261408]: mgmt_agent.service: Failed to execute /dir1/oracle/managementagent/agent_inst/bin/agentcore: Permission denied
Dec 08 15:48:19ol9-arm systemd[1261408]: mgmt_agent.service: Failed at step EXEC spawning /dir1/oracle/managementagent/agent_inst/bin/agentcore: Permission denied

$ ausearch -ts recent -m avc -i
...
type=AVC msg=audit(12/08/202315:49:26.991:51338) : avc:  denied  { read open } for  pid=1261576comm=(gentcore) path=/dir1/oracle/managementagent/agent_inst/bin/agentcore dev="dm-0"ino=915154scontext=system_u:system_r:init_t:s0           tcontext=unconfined_u:object_r:default_t:s0 tclass=file permissive=0

Tutti i messaggi di errore sopra riportati indicano che SELinux non consente di eseguire comandi nella cartella scelta.

Azione: contattare l'amministratore del sistema e creare i criteri necessari che consentono di installare ed eseguire il Management Agent.

Risoluzione dei problemi: installazione del Management Agent non riuscita su Red Hat Enterprise Linux 9.x

L'installazione di Management Agent non riesce e potrebbe essere visualizzato il seguente messaggio di errore: mgmt_agent service creation failed. Reason: Detected Linux .

Inoltre, i messaggi del log degli errori di installazione possono confermare l'errore e indicare che i tentativi di configurazione utilizzano un service manager non corretto per installare l'agente.

Causa: Red Hat ha rimosso il package chkconfig nella distribuzione Red Hat Enterprise Linux (RHEL) 9. Per ulteriori dettagli, vedere la Red Hat Knowledge base.

Azione:

Soluzione 1: installare il pacchetto chkconfig

1. Installare il pacchetto mancante eseguendo il seguente comando:

   $ dnf install chkconfig

2. Verificare che il pacchetto esista nell'ambiente eseguendo il seguente comando:

   $ rpm -qa | grep chkconfig

3. Installare di nuovo il Management Agent.

Soluzione 2 - Senza installare il pacchetto chkconfig

Se l'installazione del pacchetto chkconfig non è un'opzione come descritto nella sezione precedente della soluzione 1, completare i seguenti passaggi come soluzione alternativa per installare il software Management Agent.

$ sudo /bin/bash

$ export DIST_LINUX_FAMILY_OVERRIDE="Red Hat"

# RPM install
$ rpm -ivh <rpm_file_name.rpm>

# ZIP install
$ ./installer.sh <full_path_of_response_file>

Risoluzione dei problemi: l'installazione di Management Agent non riesce nel valore RUN_AGENT_AS_USER previsto per Linux come root

Se si installa l'agente e viene visualizzato il seguente errore, è necessario modificare le autorizzazioni per l'utente che installa l'agente.

rpm -ivh oracle.mgmt_agent.240229.1733.Linux-x86_64.rpm
Preparing...################################# [100%]
Checking pre-requisites
Checking available disk space for agent upgrade
Current agent run-as-user is root
Current user group is rootroot is not the default user, checking if required environment variables are set
RUN_AGENT_AS_USER=mgmt_agent contains an unexpected value
Expected RUN_AGENT_AS_USER value to be root, exiting
error: %pre(oracle.mgmt_agent-240229.1733-1.x86_64) scriptlet failed, exit status 1
error: oracle.mgmt_agent-240229.1733-1.x86_64: install failed

Soluzione:

Risoluzione dei problemi: accesso allo script non riuscito utilizzando un percorso assoluto. Autorizzazioni insufficienti

Se si verifica il seguente errore, è possibile modificare le autorizzazioni per risolvere i problemi.

Copying files to destination dir (/opt/oracle/mgmt_agent)Initializing software from templateChecking if JavaScript engine is available to useCreating mgmt_agent daemonmgmt_agent service creation failed. Reason: Failed to access the script using an
        absolute path. Insufficient permissions may prevent the user "mgmt_agent" from traversing
        one of the folders. Please check the following permissions

Soluzione: è possibile configurare la directory /opt/oralce con 755 autorizzazioni per consentire l'accesso al programma di installazione dell'agente.

Risoluzione dei problemi: tentativo di registrazione cloud non riuscito con stato HTTP 407, credenziali Gateway Server errate

Se si installa Management Agent e l'esecuzione di CloudRegistrationStep non riesce con il seguente errore HTTP Status 407 , le credenziali GatewayServerUser o GatewayServerPassword potrebbero essere errate.

CloudRegistrationStep: The registration attempt failed with HTTP Status 407
Additional details are available in the configure logs at /opt/oracle/mgmt_agent/configure-logs 

Risoluzione dei problemi: l'installazione dell'agente non riesce JAVA_HOME non è impostata per l'interruzione dell'installazione dell'agente

rpm -ivh oracle.mgmt_agent.240229.1733.Linux-x86_64.rpmPreparing...################################# [100%]
Checking pre-requisites
Checking available disk space for agent upgrade
Current agent run-as-user is rootCurrent user group is rootroot is not the default user, checking if required environment variables are set
Checking agent version
Updating / installing...
1:oracle.mgmt_agent-240229.xxxx-1################################# [100%]
Failed to get unit file state for mgmt_agent.service: No such file or directory
Executing install
JavaHome is not set aborting agent install
warning:%post(oracle.mgmt_agent-240229.1733-1.x86_64) scriptlet failed, exit status 1

Risoluzione dei problemi: impossibile visualizzare lo spazio di nomi e le metriche Prometheus nel servizio di monitoraggio OCI

In OCI Console, se i criteri necessari vengono impostati correttamente e lo spazio di nomi e le metriche Prometheus non sono visibili da OCI Monitoring in Metric Explorer, potrebbe essere necessario confermare che l'utente del sistema operativo mgmt_agent disponga delle autorizzazioni di lettura per il file .properties.

agent_inst/discovery/PrometheusEmitter/compute_exporter.properties 

Risoluzione dei problemi: flag fornito ma non definito

Errore: se viene visualizzato il seguente errore: flag fornito ma non definito: -trusted-certs-dir

$ sudo -u oracle-cloud-agent /usr/libexec/oracle-cloud-agent/plugins/oci-managementagent/oci-managementagent -cli -trusted-certs-dir=/tmp/trustedcerts
flag provided but not defined: -trusted-certs-dir
Usage of /usr/libexec/oracle-cloud-agent/plugins/oci-managementagent/oci-managementagent:
  -agent-config string
        agent config yml file
  -cli
        run the monitoring in cli mode
  -debug
        enable debug logging
  -dev
        enable dev runs
  -force-redeploy
        force redeploy image
  -metadata-config string
        metadata config json file
  -oci-config string
        oci config file
  -staging
        enable staging endpoint
  -upgrade-native-agent
        invoke native agent upgrade

Risoluzione dei problemi: impossibile aggiungere le credenziali SSH con errore: carattere non racchiuso tra virgolette non valido

Possibile causa: se durante l'installazione dell'agente viene visualizzato il seguente errore, è possibile che sia presente un componente di rete che inserisce i propri certificati. In alternativa, se si verifica un errore durante l'installazione dell'agente e la connessione avviene tramite un proxy, è possibile che il proxy in uso inietti un certificato personalizzato. Sarà necessario consultare l'amministratore per ottenere il certificato personalizzato e seguire i passi riportati di seguito.

Risoluzione dei problemi: impossibile installare Oracle Management Agent nell'istanza di Windows

Risoluzione dei problemi: quando si installa Management Agent e si vedono messaggi di timeout della connessione di rete

Risoluzione dei problemi: CloudRegistrationStep: tentativo di registrazione non riuscito con stato HTTP 401 (le informazioni necessarie per completare l'autenticazione non sono state fornite o non sono corrette)

Causa: questo problema può verificarsi a causa di una chiave di risposta non valida o errata.

Azione: assicurarsi di disporre di una chiave valida. Per ulteriori informazioni, vedere Gestisci chiavi di installazione.

Troubleshoot: "code": "NotAuthenticated","message": "The required information to complete authentication was not provided or was incorrect.

Causa: questo problema può verificarsi a causa di una chiave di risposta scaduta.

Azione: assicurarsi di disporre di una chiave valida. Per ulteriori informazioni, vedere Gestisci chiavi di installazione.

• Errore:... specifica più pacchetti
• Errore: scriptlet non riuscito con codice di uscita

Errore:... specifica più pacchetti

Causa: il registro rpm dispone di più package con il nome specificato.

rpm -e oracle.mgmt_agent --allmatches

Errore: scriptlet non riuscito con codice di uscita

Causa: rpm non è stato in grado di arrestare l'agente in esecuzione o di rimuovere il file del servizio agente dal sistema.

• Risoluzione dei problemi: l'aggiornamento automatico è abilitato, ma l'agente non viene aggiornato automaticamente a causa del proprietario del file non valido

Risoluzione dei problemi: l'aggiornamento automatico è abilitato, ma l'agente non viene aggiornato automaticamente a causa del proprietario del file non valido

Se la versione dell'agente non viene aggiornata dopo 24 ore di attesa, alcuni problemi sul disco potrebbero impedire l'aggiornamento automatico dell'agente.

La causa più comune di questo errore è che i file sono di proprietà di un utente del sistema operativo diverso dall'utente che ha installato Management Agent. Il processo di aggiornamento viene eseguito come lo stesso utente del sistema operativo del processo in esecuzione corrente e non ha la possibilità di passare alla radice. Qualsiasi file nella directory mgmt_agent creato manualmente dall'utente può interferire con la capacità dell'agente di eseguire l'aggiornamento automaticamente.

• Risoluzione dei problemi: lo stato dell'agente è 'Non disponibile'
• Risoluzione dei problemi: impostazione del Management Agent non riuscita con fork/exec oracle.polaris.oca.main: autorizzazione negata
• Risoluzione dei problemi: errore di autenticazione del Management Agent a causa del disallineamento del clock, un'ora diversa nell'istanza di computazione rispetto all'ora sul server
• Risoluzione dei problemi: servizio Management Agent OCI: agente non visibile nella console OCI in osservabilità e gestione

Risoluzione dei problemi: l'agente si trova nello stato Non disponibile e il file di log dell'agente riporta "Tag non valide"

La pagina Management Agent mostra l'agente in stato 'Non disponibile' e il file mgmt_agent.log (situato nella directory <Agent_Inst>/logs) riporta il seguente messaggio:

ErrorBody:{"code" : "InvalidParameter","message" : "Invalid tags: Resource creation failed because the resource requires tag value(s). Aggiungere un valore a ciascuna delle seguenti definizioni di tag: \nGLOBAL.ComponentType, GLOBAL.ApplicationName,

Causa:

Questo problema può verificarsi quando il compartimento richiede tag obbligatorie per ogni risorsa e la richiesta di creazione della risorsa non include le tag, quindi la richiesta di attivazione non riuscirà con il messaggio:"Tag non valide: creazione della risorsa non riuscita perché la risorsa richiede valori di tag" e lo stato dell'agente viene visualizzato come 'Non disponibile'.

Azione:

• Management Agent

  Se si dispone di un Management Agent standalone, è necessario disinstallarlo.

  Se il Management Agent è stato installato utilizzando un RPM o un file ZIP, è necessario disinstallarlo e reinstallarlo fornendo un file di risposta utilizzando il parametro DefinedTags come descritto nella sezione Rivedi parametri agente.

• Management Agent nelle istanze di calcolo
  Se il Management Agent viene abilitato mediante OCI Console mediante il plugin OCA, non esiste alcun file di risposta poiché non viene utilizzato per le istanze di computazione. In questo caso:

  1. Eseguire il login all'istanza in cui viene distribuito Management Agent e sudo come utente oracle-cloud-agent utilizzando il comando seguente:

     sudo -u oracle-cloud-agent sh

  2. Creare un file agent.definedtags nella seguente posizione:/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/security/resource/
  3. Aggiungere le tag definite necessarie per la creazione della risorsa nel file agent.definedtags.

     Ad esempio, se sono presenti 2 spazi di nomi admin_namespace e finance_namespace

     e ogni spazio di nomi utilizza 2 chiavi e 2 valori environment_type=non-prod, sensitivity=restricted, è possibile utilizzare quanto segue:

     DefinedTags = [{"admin_namespace": {"environment_type": "non-prod",
         "sensitivity": "restricted"}, "finance_namespace": {"environment_type":
         "non-prod","sensitivity": "restricted"}}]

  4. Riavviare oracle-cloud-agent utilizzando il comando:

     sudo systemctl restart oracle-cloud-agent

Risoluzione dei problemi: impostazione del Management Agent non riuscita con fork/exec oracle.polaris.oca.main: autorizzazione negata

Gli utenti possono riscontrare questo errore che causa l'impossibilità di installare o avviare il Management Agent.

Il messaggio di errore visualizzato nella vista Plugin dell'istanza di computazione per il plugin Management Agent è simile al seguente:

workflow.go:23: [ERROR] step [*core.SetupImageStep] execution failed with [setup image failed with [fork/exec 230821.1905/bin/oracle.polaris.oca.main: permission denied]]
mgmtagent_image.go:139: [ERROR] bootstrap workflow failed with error setup image failed with [fork/exec 230821.1905/bin/oracle.polaris.oca.main: permission denied]
agent.go:74: [ERROR] failed to start agent during bootstrap with [setup image failed with [fork/exec 230821.1905/bin/oracle.polaris.oca.main: permission denied]]

Causa possibile:

Questo problema può verificarsi quando un'istanza di computazione non consente le operazioni di fork/esecuzione dalla directory /tmp attivando tmpfs con il flag noexec.

$ mount | grep tmpfs
tmpfs on /tmp type tmpfs (rw,nosuid,nodev,noexec,inode64)

L'output deve indicare il flag noexec.

Azione:

1. Arrestare l'agente Oracle Cloud.

    sudo systemctl stop oracle-cloud-agent

2. Aggiungere la seguente impostazione al file: /etc/oracle-cloud-agent/plugins/oci-managementagent/config.yml

   overrideTmpDir: true

3. Avviare l'agente Oracle Cloud.

   $ sudo systemctl start oracle-cloud-agent

Risoluzione dei problemi: errore di autenticazione del Management Agent a causa del disallineamento del clock, un'ora diversa nell'istanza di computazione rispetto all'ora sul server

Causa: se tra l'istanza di computazione in cui è in esecuzione l'agente e il servizio Oracle Cloud Infrastructure Identity è presente un disallineamento di clock di più di 5 minuti, le richieste verranno rifiutate con un protocollo HTTP 401.

Nell'istanza di OCI Compute, andare alla scheda Agente Oracle Cloud e il Management Agent visualizza un errore nella colonna Messaggio:

rpc error: code = Unavailable desc = connection error: desc = "transport: error while
      dialing: dial unix /var/lib/oracle-cloud-agent/tmp/plugin1825606937: connect: connection
      refused"

Oppure nei log potresti trovare il seguente errore:

2022-12-09 07:41:22,144 [SysExecutor.0 (Resource Principal Token Refresher)-47] WARN  - #-#  invocation access log [request-id-prefix: K9YBE4AY] #-#
Service: OCI
Method:  GET
Path:    /20200202/managementAgents/ocid1.managementagent.....rvf6i3ba/resourcePrincipalToken
Headers:opc-rpt-request-token=********************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************         
        date=Fri, 09 Dec 2022 07:41:19 GMT         
        host=management-agent.ap-tokyo-1.oci.oraclecloud.com         
        Authorization=******************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************         
        opc-request-id=K9YBE4AYQFIMP2J6HGQ2JUKU1IJPFYVO         
        User-Agent=Jersey/2.34 (Apache HttpClient 4.5.13)Attempts:
<--> Endpoint:       management-agent.ap-tokyo-1.oci.oraclecloud.com     
     opc-request-id: K9YBE4AYQFIMP2J6HGQ2JUKU1IJPFYVO     
     StartTime:      2022-12-09 07:41:19,976 GMT     
     Status:         401 Unauthorized     
     Headers:        X-Content-Type-Options=nosniff                     
                     Content-Length=187                         
                     opc-request-id=K9YBE4AYQFIMP2J6HGQ2JUKU1IJPFYVO/E4356B68C6C541BAD867E46760316D35/4118B130EE46A8E25F90DC91AB7F12D7                     
                     Date=Fri, 09 Dec 2022 07:41:21 GMT                     
                     Content-Type=application/json     
      ErrorBody:
{  
    "code" : "NotAuthenticated",  
    "message" : "Unable to authenticate the request for ocid1.managementagent.oc1.ap-tokyo-1.amaaaa...6frjnrbvqrvf6i3ba"}

Azione

Correggere il disallineamento dell'orologio e riavviare. Se l'agente è rimasto inattivo per giorni a causa di questo errore, è necessario eseguire il cleanup del file donotrestart prima di riavviare l'agente.

Inoltre, Oracle consiglia di impostare la data/ora del sistema operativo per la sincronizzazione automatica con i server NTP in modo da evitare tempi di inattività in futuro. Se sul computer sono in esecuzione servizi aggiuntivi, è consigliabile riavviare il computer dopo la modifica dell'ora in modo che i servizi possano essere reimpostati con il nuovo orario.

Per correggere la data/ora del sistema operativo in cui l'agente è in esecuzione e quindi riavviare l'agente, effettuare le operazioni riportate di seguito.

1. Per arrestare l'agente eseguire il comando seguente:

   sudo systemctl stop oracle-cloud-agent

2. Correggere la data e l'ora.
3. Eseguire il comando seguente per eliminare il file configure.donotrestart.

   sudo rm /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/configure.donotrestart

4. Avviare l'agente.

   sudo systemctl start oracle-cloud-agent

Risoluzione dei problemi: servizio Management Agent OCI: agente non visibile nella console OCI in osservabilità e gestione

Installazione di OCI Management Agent riuscita in un'istanza di computazione. L'agente è in esecuzione sull'host. Tuttavia, l'agente non viene visualizzato nella console di Oracle Cloud se si passa al menu Navigazione, si seleziona Osservabilità e gestione, si passa ai Management Agent e si seleziona Agenti.

Possibile causa: i compartimenti dell'istanza di computazione e della chiave di installazione dell'agente sono diversi.  

• Risoluzione dei problemi: Rimuovi Management Gateway
• Risoluzione dei problemi: Configura Management Gateway
• Risoluzione dei problemi: l'installazione di Management Gateway non riesce su Red Hat Enterprise Linux 9.x
• Risoluzione dei problemi: l'installazione di Management Gateway non riesce con l'errore: impossibile creare i certificati e il report dei log delle identità: autenticazione non riuscita: DATE_OUTSIDE_CLOCK_SKEW
• Risoluzione dei problemi: durante l'installazione o la configurazione di Management Gateway, si è verificato un errore di timeout

Risoluzione dei problemi: rimozione del gateway di gestione

Causa: in alcuni casi potrebbe essere necessario rimuovere un'installazione di Management Gateway esistente per reinstallarla.

Risoluzione dei problemi: Configura Management Gateway

Causa: in alcuni casi, il nome host potrebbe non essere risolto nell'ambiente di installazione che potrebbe causare l'errore dell'installazione con il seguente messaggio di errore:

Risoluzione dei problemi: "Impossibile risolvere il valore del nome host <hostname> nell'ambiente di installazione. Risolvere il nome host o fornire GatewayCertCommonName nel file di risposta ed eseguire di nuovo lo script di impostazione del gateway."

Azione:

• Controllare e risolvere il nome host dell'ambiente per ottenere il valore FQDN (Full Qualified Doamin Name) dopo l'esecuzione del comando: hostname -f
• Facoltativamente, un utente può fornire un nome di dominio completamente qualificato personalizzato per la configurazione del gateway mediante il popolamento della proprietà GatewayCertCommonName nel file di risposta di input. Vedere Parametri file di risposta
• Rieseguire lo script del gateway di configurazione.

  sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<user_home_directory>/gateway.rsp

Causa: in alcuni casi l'installazione di Management Gateway potrebbe non riuscire con il seguente messaggio di errore a causa dell'assenza di criteri in OCI o a causa di problemi di limite delle risorse nella tenancy. Se viene visualizzato il seguente errore, attenersi alla procedura riportata di seguito.

Risoluzione dei problemi: "Impossibile avviare Management Gateway perché non è stato possibile creare, inizializzare o recuperare i certificati in OCI. Per ulteriori dettagli, controllare i log."

Azione:

• Aprire il file di log nella directory di installazione di Management Gateway, ad esempio: /opt/oracle/mgmt_agent/plugins/GatewayProxy/statedir/log/mgmt_gateway.log
• Se il file di log contiene uno dei seguenti 404 codici di errore, scegliere una delle seguenti opzioni per risolvere il problema:

  2023-07-25 15:38:06.694/CEST [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility - Response String {  "code" : "NotAuthorizedOrNotFound",  "message" : "Authorization failed or requested resource not found."}
  2023-07-25 15:38:06.696/CEST [pool-3-thread-1] ERROR com.oracle.mgmtagent.proxy.ProxyServer - Error while initializing and loading certificate bundlescom.oracle.mgmtagent.proxy.exception.CertificateFailureException: The response status is 404 after multiple retries at com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility.executeRequest(CertificateUtility.java:293) ~

  • Opzione consigliata: utilizzare l'applicazione Management Gateway Quick Start Marketplace per creare automaticamente i gruppi dinamici, i criteri e gestire i certificati necessari per installare Management Gateway.
  • I gruppi dinamici e i criteri corretti necessari per l'installazione di Management Gateway vengono aggiunti manualmente e confermati al compartimento specifico all'interno della tenancy in cui si desidera installare Management Gateway. Per ulteriori informazioni, vedere Eseguire i prerequisiti per la distribuzione di Management Gateway.

• Se il file di log contiene uno dei 400 codici di errore riportati di seguito, esaminare le opzioni riportate di seguito per risolvere il problema.

  2023-09-20 18:51:32.772/GMT [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateCreationUtil - Create Vault Service Url invoked https://kms.us-ashburn-1.oraclecloud.com/20180608/vaults
  2023-09-20 18:51:33.400/GMT [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility - Received response code 400
  2023-09-20 18:51:33.400/GMT [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility - Header name opc-request-id , value /5704D03441842D3818B824B2D6B2712E/1D1FED893474FDA900188E24F3DEE59B
  2023-09-20 18:51:33.401/GMT [pool-3-thread-1] INFO  com.oracle.mgmtagent.proxy.oci.certificate.util.CertificateUtility - Response String {  "code" : "LimitExceeded",  "message" : "The limit for this tenancy has been exceeded."}

  • Controllare il limite per la risorsa Conteggio vault predefinito per il servizio di gestione delle chiavi in OCI Console. È possibile inviare una richiesta per aumentare i limiti delle risorse. Per ulteriori informazioni, vedere Gestione delle chiavi e Gestione dei vault.
  • È possibile impostare i certificati manualmente. Per i dettagli, vedere Eseguire i prerequisiti per la distribuzione di Management Gateway e andare alla sezione Gestione manuale dei certificati.
    Nota
    
    Quando si creano i certificati Emessi dalla CA interna , il profilo del certificato deve essere Server TLS o Client TLS e sono supportati solo gli algoritmi di firma RSA.

• In caso di altri errori correlati al vault o alle API del servizio di chiavi nei log, è possibile inviare una richiesta e contattare il team oci_kms fornendo il corpo della risposta e opc-request-id.
• In caso di altri errori relativi alle autorità di certificazione o alle API del servizio di certificazione nei log, inviare una richiesta e contattare il team oci_certificates fornendo il corpo della risposta e opc-request-id.

Risoluzione dei problemi: installazione di Management Gateway non riuscita su Red Hat Enterprise Linux 9.x

Inoltre, i messaggi del log degli errori di installazione possono confermare l'errore e indicare che i tentativi di configurazione utilizzano un service manager errato per installare il gateway.

Causa: Red Hat ha rimosso il package chkconfig nella distribuzione Red Hat Enterprise Linux (RHEL) 9. Per ulteriori dettagli, vedere la Red Hat Knowledge base.

Azione:

1. Installare il pacchetto mancante eseguendo il seguente comando:

   $ dnf install chkconfig

2. Verificare che il pacchetto esista nell'ambiente eseguendo il seguente comando:

   $ rpm -qa | grep chkconfig

3. Installare nuovamente Management Gateway.

Se l'installazione del pacchetto chkconfig non è un'opzione come descritto nella sezione Soluzione 1 sopra, completare i seguenti passaggi come soluzione alternativa per installare il software Management Gateway.

$ sudo /bin/bash

$ export DIST_LINUX_FAMILY_OVERRIDE="Red Hat"

# RPM install
$ rpm -ivh <rpm_file_name.rpm>

# ZIP install
$ ./installer.sh <full_path_of_response_file>

Risoluzione dei problemi: installazione del gateway di gestione non riuscita con errore: impossibile creare i certificati e il report dei log delle identità: autenticazione non riuscita: DATE_OUTSIDE_CLOCK_SKEW

Causa:

Autenticazione del report dei log delle identità non riuscita: DATE_OUTSIDE_CLOCK_SKEW

# /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<PATH>/gateway_agent.rsp/opt/oracle/mgmt_agent/agent_inst/bin/setupAgent.sh
    opts=<PATH>/gateway_agent.rsp

Executing configure

Parsing input response file
Validating install key
Generating communication wallet
Generating security artifactsRegistering Management Gateway
Found service plugin(s):[GatewayProxy]

Starting gateway...
Gateway started successfully
Starting plugin deployment for: [GatewayProxy]
Deploying service plugin(s)...Done.
GatewayProxy : Successfully deployed external plugin

Gateway setup completed and the gateway is running.
In the future gateway can be started by directly running: sudo systemctl start mgmt_gateway

Please make sure that you delete <PATH>/gateway_agent.rsp or store it in secure location.

Creating gateway system properties file
Creating properties fileCreating or validating certificates
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Waiting for Management Gateway to create or validate certificates...
Failed to start Management Gateway as certificates could not be created, initialized or retrieved in OCI. Please check the logs for more details.
Management Gateway stopped

Azione:

Nell'host in cui è installato Management Gateway, assicurarsi che l'ora dell'host sia corretta, quindi installare Management Gateway.

Risoluzione dei problemi: durante l'installazione o la configurazione di Management Gateway, si è verificato un errore di timeout

Se si verifica che OCI Console visualizzi Management Gateway come attivo, ma le metriche non vengono popolate.

/opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<user_home_directory>/gateway.rsp
Starting gateway...
Gateway started successfully

Starting plugin deployment for: [GatewayProxy]
Deploying service plugin(s)...............Timed out.

Agent is unable to check if it deployed requested service plugin(s) successfully or not. 
Please check back later on the console.

Causa: il tempo di completamento del task di impostazione di Management Gateway più lungo del previsto potrebbe causare un problema di comunicazione di rete e il timeout di Management Gateway.