• Collegarsi a OCI e aprire il menu di navigazione da OCI Console.

• In Osservabilità e gestione fare clic su Management Agent.

• Andare al menu a sinistra e selezionare un compartimento dall'elenco a discesa Compartimento.

  Viene visualizzata la console Management Agent.

1. Creare una directory in cui memorizzare i certificati CA (Root Certificate Authority) sicuri aggiuntivi nel formato PEM. Nell'esempio seguente, la directory tmp è un esempio. È possibile utilizzare qualsiasi directory e confermare che l'utente dell'agente abbia accesso in lettura a ogni directory nel percorso dei certificati.

   mkdir /tmp/crt

2. Quindi, immettere il comando seguente per copiare tutti i certificati trusted personalizzati in formato PEM nella nuova directory creata nel passaggio precedente.

   cp *.pem /tmp/crt

3. Impostare le autorizzazioni per la directory e il relativo contenuto per consentire all'agente standalone di accedere ai certificati.

   chmod 644 /tmp/crt

4. Per aggiungere certificati sicuri personalizzati al Management Agent durante l'installazione o la configurazione, è necessario specificare la directory dei certificati nel file di risposta input.rsp.

   importTrustedCertsDirectory=/tmp/crt

5. A questo punto, è possibile eseguire l'installazione per importare i certificati nel Management Agent.
6. Dopo l'installazione, è possibile utilizzare il comando seguente e sostituire i seguenti con i valori dell'ambiente in uso per verificare che i certificati protetti siano stati importati correttamente nel keystore dell'agente. Sostituire <CUSTOM_CERTIFICATE_FILE_NAME> con il nome del file del certificato personalizzato nell'ambiente in uso, ad esempio: my-cert.pem

   keytool -list -keystore /opt/oracle/mgmt_agent/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE_FILE_NAME>

   Il file commwallet.pem è un certificato personalizzato aggiunto all'area di memorizzazione dei certificati sicuri dell'agente.

1. Utilizzare i comandi seguenti per creare una directory trustedcerts in cui importare i certificati trusted in questa posizione: /var/lib/oracle-cloud-agent/plugins/oci-managementagent/. Verificare che l'utente oracle-cloud-agent sia proprietario della directory.

   cd /var/lib/oracle-cloud-agent/plugins/oci-managementagent/
   mkdir trustedcerts
   chown oracle-cloud-agent:oracle-cloud-agent trustedcerts/

2. Copiare tutti i certificati protetti personalizzati in formato PEM nella nuova directory creata nel passo precedente.

   cp *.pem /var/lib/oracle-cloud-agent/plugins/oci-managementagent/trustedcerts

3. Ora è possibile eseguire l'installazione dell'agente OCA per importare i certificati nel Management Agent.
4. Dopo l'installazione, è possibile utilizzare il comando seguente per verificare che i certificati protetti siano stati importati correttamente nel keystore dell'agente. Sostituire <CUSTOM_CERTIFICATE> con il nome del file del certificato personalizzato nell'ambiente in uso, ad esempio: my-cert.pem

   keytool -list -keystore /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/security/comm/commwallet.jks -alias <CUSTOM_CERTIFICATE>

   Il file commwallet.pem è un certificato personalizzato aggiunto all'area di memorizzazione dei certificati sicuri dell'agente.

• Distribuire un plugin utilizzando la pagina Agenti
• Distribuzione di un plugin durante l'installazione di Management Agent

1. Dal menu a sinistra, fare clic su Agenti per aprire la pagina Agenti.

2. Dalla lista Agenti, fare clic sull'agente desiderato in cui si desidera distribuire il plugin.

   Viene visualizzata la pagina dei dettagli dell'agente.

   
   
   

3. Fare clic su Distribuisci plugin.

   Viene visualizzata la finestra Distribuisci plugin.

4. Selezionare il plugin e selezionare Aggiorna.

   Il plugin selezionato verrà distribuito sull'agente desiderato.

1. Seguire le istruzioni per scaricare il software dell'agente e creare una chiave di installazione dell'agente, come descritto in Scarica il software del Management Agent e Crea chiave di installazione.

2. Scaricare il file della chiave di installazione dell'agente.

   Andare alla pagina Chiavi di installazione agente e selezionare l'opzione Scarica chiave su file dal menu Azioni.

   L'opzione Scarica chiave su file consente di scaricare un modello di file di risposta. Per informazioni dettagliate, scaricare la chiave di installazione.

3. Modificare il modello di file di risposta utilizzando un editor di testo e creare un file di risposta personalizzato.

   Seguire le istruzioni per creare un file di risposta utilizzando l'opzione Scarica modello di file di risposta, come descritto in Opzione 1: Scaricare un modello di file di risposta per creare un file di risposta.

   Il modello del file di risposta contiene i parametri dell'agente, incluso il parametro del plugin del servizio, necessario per la distribuzione di un plugin.

   Per distribuire un plugin di servizio nell'ambito del processo di installazione di Management Agent, personalizzare il parametro Service.plugin.<plugin_name>.download.

   Ad esempio, se si desidera distribuire il plugin DataSafe durante l'installazione dell'agente, il valore del parametro sarà: Service.plugin.datasafe.download=true

   Per ulteriori informazioni sui parametri agente supportati nel file di risposta, vedere Rivedi parametri agente.

4. Per completare l'installazione, installare il Management Agent come descritto in Installa Management Agent.

• Controlla stato plugin servizio
• Controlla stato richiesta di lavoro

• Nella pagina Elenco agenti, fare clic sull'agente desiderato.

  Viene visualizzata la pagina dei dettagli dell'agente.

• Fare clic su Abilita log agente.

  Viene visualizzata la finestra Abilita log: Agente per l'agente selezionato.

• Selezionare un compartimento gruppo di log dall'elenco a discesa.
• Selezionare un gruppo di log dall'elenco a discesa.

  Se si desidera creare un nuovo gruppo di log, fare clic su Crea gruppo di log.

  Nella finestra Crea gruppo di log immettere Nome gruppo di log e una Descrizione. Dopo, fare clic su Crea.

• Fare clic su Abilita.

• Passare a Osservabilità e gestione e andare a Log Analytics.
• Nella pagina Log Analytics, andare a Amministrazione.

  Nel menu di sinistra selezionare Sources.

  Nel riquadro centrale, selezionare Log Oracle Management Agent e verificare che l'agente sia elencato nella lista Entità associate.

• Fare clic su Disabilita log agente.

  Viene visualizzata la finestra Disabilita log agente per l'agente selezionato.

• Fare clic su Disabilita.

• Il Management Agent è stato distribuito utilizzando Management Agent versione 231231.0001 o successiva.
• Per Prometheus Exporter, il Management Agent deve trovarsi sulla stessa macchina virtuale (VM) o su una VM con accesso all'endpoint dell'esportatore. Questo Management Agent è configurato per eseguire lo scrap delle metriche dall'esportatore Prometheus in esecuzione.

• Nella pagina Elenco agenti, fare clic sull'agente desiderato.

  Viene visualizzata la pagina dei dettagli dell'agente.

• Fare clic su Gestisci origini dati.

  Nella finestra Origini dati viene visualizzata una tabella con le colonne riportate di seguito.

  • Nome: Nome dell'origine dati.
  • Tipo: tipo dell'origine dati. Ad esempio: Prometheus.
  • Stato: stato dell'origine dati.
  • Ora creazione: indicatore orario di creazione dell'origine dati.
  • : mostra più azioni disponibili per un'origine dati specifica.
• Se si fa clic su un nome di origine dati specifico, viene visualizzata la finestra Visualizza origine dati.

  Utilizzare la Visualizza origine dati per visualizzare tutte le informazioni relative a un'origine dati.

  Ad esempio, è possibile visualizzare i dati delle metriche da Prometheus Exporter.

• Per aggiungere un'origine dati, utilizzare Aggiungi origine dati.

  • Selezionare il tipo di origine dati dall'elenco a discesa. Ad esempio: Prometheus.
  • Utilizzare Nome per immettere il nuovo nome dell'origine dati.
  • Selezionare Compartimento metrica dall'elenco a discesa.
  • Immettere Spazio di nomi metrica.
  • Immettere l'URL utilizzato da Prometheus Exporter per pubblicare le relative metriche.
  • Utilizzare le dimensioni delle metriche personalizzate per aggiungere una dimensione metrica.
  • Se necessario, utilizzare le proprietà facoltative.
• Elimina origine dati: utilizzare il menu azioni per eliminare un'origine dati.
• Modifica origine dati: utilizzare il menu azioni per modificare le proprietà di un'origine dati.

  Ad esempio, è possibile modificare l'URL dell'esportatore Prometheus che pubblica i dati della metrica nel servizio OCI Monitoring.

1. Eseguire il login come utente con autorizzazioni sudo.

2. Eseguire il comando riportato di seguito:

   Per Oracle Linux 6: sudo /sbin/initctl start mgmt_agent

   Per Oracle Linux 7: sudo systemctl start mgmt_agent

1. Eseguire il login come utente Administrator e aprire una finestra del prompt dei comandi.

2. Eseguire il comando seguente: net start mgmt_agent

1. Eseguire il login come utente con le autorizzazioni sudo per eseguire i comandi come utente root.

2. Eseguire il comando riportato di seguito:

   sudo /etc/init.d/mgmt_agent start

1. Eseguire il login come utente con autorizzazioni sudo.

2. Eseguire il comando riportato di seguito:

   Per Oracle Linux 6: sudo /sbin/initctl stop mgmt_agent

   Per Oracle Linux 7: sudo systemctl stop mgmt_agent

1. Eseguire il login come utente amministratore e aprire una finestra del prompt dei comandi.

2. Eseguire il comando seguente: net stop mgmt_agent

1. Eseguire il login come utente che dispone del privilegio sudo per eseguire i comandi come utente root.

2. Eseguire il comando riportato di seguito:

   sudo /etc/init.d/mgmt_agent stop

1. Eseguire il login come utente amministratore e aprire una finestra del prompt dei comandi.

2. Eseguire il comando seguente: sc query mgmt_agent

   Per ulteriori dettagli controllare il file di log: C:\Oracle\mgmt_agent\agent_inst\log\mgmt_agent.log.

1. Eseguire il login come utente che dispone del privilegio sudo per eseguire i comandi come utente root.

2. Eseguire il comando seguente: sudo /etc/init.d/mgmt_agent status

   Per ulteriori dettagli controllare il file di log: /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log.

• Aggiornamento automatico
• Upgrade manuale

• Un agente distribuito sull'host di destinazione non è più necessario.
• Non è più necessario raccogliere dati, metriche delle prestazioni o log da un host di destinazione specifico.
• È stata modificata la topologia di distribuzione.

• Rimuovi agenti dall'interfaccia utente

• Rimozione degli agenti dall'interfaccia a riga di comando

1. Selezionare l'agente dall'elenco Agenti e fare clic sul menu Azione.

   Figura 4-1 Elimina agente

   

2. Fare clic su Elimina agente.

3. Premere Delete per confermare la selezione.

• Linux con il comando RPM
• Linux utilizza lo script di disinstallazione
• Windows
• Solaris
• AIX

sudo rpm -e <rpm_name>

$ sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_agent...
Removing mgmt_agent daemon from systemd...
Removed symlink/etc/systemd/system/multi-user.target.wants/mgmt_agent.service.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

C:\Oracle>mgmt_agent\uninstaller.bat
Removing agent from Management Agent Cloud Service
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Removing agent service from the host
Agent service was removed from the host successfully
Removing agent directories

sudo bash /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected Oracle Linux Server (Red Hat family):
Stopping mgmt_agent...
Removing mgmt_agent daemon from systemd...
Removed symlink /etc/systemd/system/multi-user.target.wants/mgmt_agent.service.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

sudo sh /opt/oracle/mgmt_agent/agent_inst/bin/uninstaller.sh
Executing pre-remove step from uninstall
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Attempting to remove the Agent from Management Agent Cloud service, please do not interrupt...
Agent was removed from Management Agent Cloud service successfully.
Detected AIX:
Stopping mgmt_agent...
Waiting for mgmt_agent to exit...
Stopped mgmt_agent.
Removing mgmt_agent daemon...
0513-083 Subsystem has been Deleted.
Agent was removed from the host successfully.
Executing post-remove step from uninstall
Agent state directory was removed from the host successfully.

• Opzione 1. Nel servizio Management Agent, Oracle consiglia di utilizzare la console di Oracle Cloud o l'API per aggiungere credenziali denominate.
• Opzione 2. È possibile configurare le credenziali di origine nei file di configurazione dell'agente per consentire all'agente di raccogliere dati da origini diverse.

• Console di Oracle Cloud
• API credenziali denominate Management Agent

• Confermare che la versione di Management Agent: 250704.1404 o successiva è installata.
• Configurare quanto riportato di seguito per l'utente.
  • Aggiungere le autorizzazioni necessarie per le credenziali denominate, vedere Scenari utente e Informazioni di riferimento sui criteri del servizio Management Agent.
  • Aggiungere il criterio seguente per le credenziali denominate, vedere la Tabella 2-1 per Management Agent.

    ALLOW GROUP <group-name> TO MANAGE management-agent-named-credentials IN <compartment_name>

  • Creare un segreto in un vault. A tale scopo, è necessaria un'autorizzazione aggiuntiva per la creazione di un segreto, vedere Creazione di un segreto in un vault e Dettagli per Vault, Key Management e Secrets. Il vault e il segreto possono trovarsi in compartimenti diversi. E sia il vault che il segreto possono trovarsi in un compartimento diverso dall'agente.
  • Configurare le autorizzazioni riportate di seguito in modo da poter leggere il bundle di segreti. Vedere Dettagli per Vault, Key Management e Secrets.
    • Per elencare i vault delle autorizzazioni VAULT_INSPECT e VAULT_READ.
    • Per elencare i segreti, le autorizzazioni SECRET_INSPECT e SECRET_READ.
• Configurare le autorizzazioni e i criteri per la risorsa agente, per effettuare le operazioni riportate di seguito.

  • Creare un gruppo dinamico per la risorsa agente utilizzando l'esempio riportato di seguito. Sostituire ocid1.compartment.oc1.agentcompartmentid con l'OCID del compartimento per l'agente. Vedere Come creare un gruppo dinamico nella console e Gestione dei gruppi dinamici.

    ALL {resource.type='managementagent', resource.compartment.id='ocid1.compartment.oc1.agentcompartmentid'}

  • Aggiungere il criterio seguente per consentire al gruppo dinamico di leggere il segreto in un compartimento specifico, sostituire ocid1.compartment.oc1.secretcompartmentid con l'OCID del compartimento per il segreto, vedere Aggiornamento della istruzione di un criterio.

    allow dynamic-group X to read secret-bundles in compartment ocid1.compartment.oc1.secretcompartmentid

  • L'agente deve inoltre disporre di autorizzazioni e criteri per qualsiasi risorsa OCI utilizzata per creare credenziali denominate. Ad esempio, se l'agente utilizza credenziali denominate per interagire con un database autonomo, è necessario creare un criterio per consentire al gruppo dinamico dell'agente di leggere il wallet del database autonomo. Ad esempio:

    allow dynamic-group X to read autonomous-databases in compartment DB_COMPARTMENT

• Un utente operatore con l'autorizzazione MGMT_AGENT_NAMED_CREDENTIAL_APPLY, quindi gli agenti a cui l'utente ha accesso possono utilizzare le credenziali denominate per eseguire azioni senza avere accesso alle password. Un utente con questa autorizzazione non sarà in grado di visualizzare il vault o gli OCID segreti contenuti nella credenziale denominata.
• Un utente amministratore, con le seguenti autorizzazioni, può eseguire le operazioni CRUD standard su credenziali denominate e non avrà accesso per leggere il bundle di segreti dal vault.

  • MGMT_AGENT_NAMED_CREDENTIAL_CREATE

  • MGMT_AGENT_NAMED_CREDENTIAL_UPDATE

  • MGMT_AGENT_NAMED_CREDENTIAL_DELETE

• Se un utente dispone dell'autorizzazione MGMT_AGENT_DELETE, può eliminare la risorsa agente e verranno eliminate anche tutte le credenziali denominate associate.
  Nota
  
  L'eliminazione di un agente o di una credenziale denominata non ha effetto sul segreto memorizzato nel vault OCI.

1. Aprire il menu di navigazione e selezionare Osservabilità e gestione. In Agente gestione, selezionare Agenti.
2. Selezionare il compartimento contenente gli agenti che si desidera elencare. Selezionare l'opzione per includere i compartimenti secondari per ottenere una panoramica dei dettagli dell'agente nel compartimento selezionato, inclusi i compartimenti figlio.
3. Nel menu Azioni selezionare Gestisci credenziali denominate.
   • In alternativa, è possibile andare alla pagina Dettagli agente, selezionare l'opzione Altre azioni, quindi selezionare Gestisci credenziali denominate.
4. Immettere Nome credenziale. Facoltativamente, è possibile immettere una descrizione.
5. Selezionare il tipo di credenziale che si desidera aggiungere dall'elenco a discesa Tipo di credenziale.
6. Per ogni campo o attributo del tipo di credenziale selezionato, immettere un valore o selezionare un identificativo risorsa oppure selezionare un vault e un identificativo segreto.

   Se la risorsa esiste in un compartimento diverso, è possibile selezionare Modifica compartimento per modificare il compartimento e trovare il valore della risorsa.

7. Per aggiungere tag, selezionare Mostra opzioni avanzate.
   • Per aggiungere tag, selezionare uno spazio di nomi tag, immettere una chiave tag e un valore tag, quindi selezionare Aggiungi tag. È possibile limitare l'accesso alle credenziali aggiungendo tag. Se si dispone delle autorizzazioni necessarie per creare una credenziale denominata, si dispone anche delle autorizzazioni per aggiungere tag in formato libero. Per aggiungere una tag definita, è necessario disporre anche delle autorizzazioni per lo spazio di nomi della tag. Per ulteriori informazioni, vedere Panoramica sull'applicazione di tag e per informazioni su come aggiungere una tag quando si crea una risorsa, vedere Utilizzo delle tag risorsa.
   • Per eliminare una tag, selezionare la X.
8. Selezionare Salva per aggiungere la credenziale denominata all'agente. Se non è possibile salvare le credenziali denominate, confermare di aver inserito tutti i campi obbligatori.

   Quando vengono salvate le credenziali denominate, viene inviata una richiesta di lavoro all'agente. Una volta completata la richiesta di lavoro, l'agente può utilizzare queste credenziali denominate per eseguire vari task tra più plugin o servizi distribuiti sull'agente.

   Nota
   
   Se la richiesta di lavoro non riesce, verificare che l'agente disponga dell'autorizzazione SECRET_READ per accedere ai segreti del vault ed eseguire l'operazione GetSecret, vedere Dettagli per Vault, Key Management e Secrets.

   Per modificare o eliminare le credenziali denominate per un agente, procedere come segue.

   1. Trovare l'agente che si desidera aggiornare per effettuare le operazioni riportate di seguito.
      • Andare alla pagina elenco Agenti. Accanto all'agente che si desidera aggiornare, selezionare il menu Azioni, quindi selezionare Gestisci credenziali denominate.
      • In alternativa, è possibile andare alla pagina Dettagli agente, selezionare l'opzione Altre azioni, quindi selezionare Gestisci credenziali denominate.
   2. Selezionare Modifica o Elimina. È possibile modificare i dettagli del vault relativi al nome utente e alla password. Impossibile modificare il nome o il tipo di credenziale.
      Nota
      
      Se si elimina una credenziale denominata in uso, il monitoraggio dell'origine sull'agente potrebbe essere interrotto.

• Tipi di credenziali di origine
• Aggiungi o aggiorna credenziali
• Elimina credenziali
• Aggiungi o aggiorna alias credenziali
• Elimina alias credenziale

• Aprire il menu di navigazione. In Amministrazione e governance, andare a Governance e fare clic su Audit.

  Viene visualizzato il servizio di audit.

• Aggiorna JRE su Linux
  • Aggiorna JRE mediante package RPM
  • Aggiorna JRE mediante archivio compresso
• Aggiorna JRE su Windows
• Aggiorna custom JAVA_HOME