Installare i Management Agent

Dopo aver completato i prerequisiti come descritto nella sezione Esegui prerequisiti per la distribuzione dei Management Agent, attenersi alla procedura riportata di seguito per installare i Management Agent.

Passo 1: scaricare il software del Management Agent
Passo 2: creare una chiave di installazione
Passo 3: Configurare un file di risposta
Passo 4: Installa Management Agent
Passo 5: verificare l'installazione di Management Agent
Risolvere i problemi di installazione di Management Agent

Per vedere come installare Management Agent per questi esempi specifici, guardare i video riportati di seguito.

Per ulteriori dettagli, incluse le modalità di installazione di Management Agent su tutti i sistemi operativi e le modalità di download di Management Agent, è possibile seguire le istruzioni riportate di seguito.

Scarica software del Management Agent

È possibile scaricare il software Management Agent utilizzando una delle opzioni riportate di seguito.

Opzione 1: scaricare il software Management Agent utilizzando la console di Oracle Cloud

Nella console di Oracle Cloud è possibile eseguire i passi riportati di seguito per scaricare il software Management Agent.

Nella console di Oracle Cloud, fare clic sul menu di navigazione, andare a Osservabilità e gestione, quindi in Management Agent selezionare Download e chiavi.
Le opzioni Software Download consentono di selezionare il sistema operativo.
Nel riquadro Download software selezionare il sistema operativo su cui verrà installato Management Agent dalla colonna Scarica.
Fare clic sul collegamento specifico del sistema operativo per scaricare il file software dell'agente.
Ambienti Exadata: per installare Management Agent in Exadata ed Exadata Cloud, inclusi Cloud@Customer e in Oracle Cloud Infrastructure, è necessario seguire solo le istruzioni per installare Management Agent in un volume esterno utilizzando il file ZIP Linux.
Nota

Il tipo di package RPM per Linux non è supportato in Exadata.

Ad esempio, fare clic su Agente per WINDOWS (X86_64) per Windows.

Il file software viene salvato sull'host.

Dopo aver scaricato il file, è possibile verificarne l'integrità controllando il valore della colonna SHA-256 Checksum. Ad esempio, se si utilizza Linux, deve corrispondere all'output del seguente comando: sha256sum <download_file>

Opzione 2: scaricare il software Management Agent mediante CLI

È possibile utilizzare l'interfaccia della riga di comando (CLI) di Oracle Cloud Infrastructure per scaricare il software Management Agent completando i passi riportati di seguito. L'interfaccia della riga di comando (CLI) di Oracle Cloud Infrastructure (OCI) è uno strumento di interfaccia della riga di comando. Per ulteriori informazioni, vedere Command Line Interface (CLI, interfaccia a riga di comando).

Ottenere il valore object-url utilizzando il comando CLI agent-image list.
```
oci management-agent agent-image list --compartment-id <tenancyId>
```
Il valore object-url restituito è simile al seguente:

https://objectstorage.<region_identifier>.oraclecloud.com/n/<namespace>/b/<bucketName>/o/Linux-x86_64/latest/oracle.mgmt_agent.rpm

Da quanto sopra, prendere nota dei valori <namespace> e <bucketName>.

Scaricare il software Management Agent con il principal autenticato OCI utilizzando i valori <namespace> e <bucketName> dal passo 1:

Per Linux:

oci os object get --namespace <namespace> --bucket-name <bucketName> --name Linux-x86_64/latest/oracle.mgmt_agent.rpm --file oracle.mgmt_agent.rpm

Per Windows Server:

oci os object get --namespace <namespace> --bucket-name <bucketName> --name Windows-x86_64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip

Per Solaris:

oci os object get --namespace <namespace> --bucket-name <bucketName> --name Solaris-Sparc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip

Per AIX:

oci os object get --namespace <namespace> --bucket-name  <bucketName> --name AIX-ppc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip

Per Linux ARM:

oci os object get --namespace <namespace> --bucket-name  <bucketName> --name Linux-Aarch64/latest/oracle.mgmt_agent.rpm  --file oracle.mgmt_agent.rpm

Per desktop macOS e Windows: Management Agent è supportato quando si utilizza il servizio Java Management. Per i dettagli, vedere Servizio Java Management, in particolare la sezione Installazione di un Management Agent.

3 Dopo aver scaricato il file, è possibile verificarne l'integrità controllando il valore della colonna SHA-256 Checksum. Ad esempio, se si utilizza Linux, deve corrispondere all'output del seguente comando: sha256sum <download_file>

Opzione 3: scaricare il software Management Agent utilizzando l'API REST

Per scaricare il software del Management Agent, è possibile effettuare le operazioni riportate di seguito.

Per i dettagli, utilizzare l'API REST ListManagamentAgentImages con autenticazione OCI valida. Per ulteriori informazioni, consultare la documentazione dell'API REST ListManagementAgentImages.
Ottenere il valore object-url dall'output e utilizzare questo URL per scaricare il software del Management Agent. Per i dettagli, consulta l'operazione GetObject dalla documentazione API del servizio di storage degli oggetti.

Crea chiave di installazione

È necessario creare una chiave di installazione prima di installare Management Agent.

Una chiave di installazione viene emessa a fronte del dominio di Identity e ne convalida l'autenticità. Assicurarsi di creare la chiave di installazione prima di avviare l'installazione di Management Agent.

Per creare una chiave di installazione:

Nella home page Management Agent, fare clic su Scarica e chiavi dal menu a sinistra per visualizzare il riquadro Installa chiavi.
Nella parte inferiore della pagina viene visualizzato il riquadro Installa chiavi.
Nel riquadro Installa chiavi fare clic su Crea chiave per creare una chiave.
Immettere i dettagli richiesti nella finestra Crea chiave.
1. Nel campo Nome chiave specificare un nome per identificare la chiave.
2. Nel campo Compartimento selezionare il compartimento dall'elenco a discesa. Questo è il compartimento in cui verrà creata la risorsa agente.
3. Nel campo Numero massimo di installazioni specificare un numero che indichi il numero massimo di installazioni che è possibile associare alla chiave. Il valore predefinito è 1000.
4. Nel campo Valido per, specificare un numero che indichi il periodo di validità della chiave. Il valore predefinito è 1 settimana.
5. La casella di controllo Illimitato è facoltativa.
  
  Se è selezionata, la chiave può essere utilizzata per un numero illimitato di installazioni di agenti e gateway e la chiave non scade mai.
  
  Rischi derivanti dall'uso di chiavi illimitate: Oracle consiglia di mantenere la durata di una chiave di installazione a un tempo minimo richiesto e a un numero limitato di agenti. Assicurarsi di mantenere la chiave scaricata in una posizione sicura per proteggere la riservatezza. Se la chiave di installazione illimitata viene compromessa, un intruso può installare agenti non autorizzati nella tenancy. Un audit regolare degli agenti della tenancy può aiutare a mitigare eventuali rischi potenziali associati a chiavi di installazione illimitate. Quando non è più necessaria una chiave di installazione illimitata, assicurarsi di eliminarla utilizzando la console dei Management Agent o l'interfaccia CLI.
Viene creata una nuova chiave.

Il riquadro Installa chiavi offre diverse opzioni disponibili per la gestione delle chiavi. Durante un passo successivo, l'opzione Scarica chiave su file è utile per scaricare un file che può essere utilizzato come modello di file di risposta, come descritto in Configura file di risposta.

Per maggiori informazioni sulla gestione delle chiavi di installazione, vedere Gestione delle chiavi di installazione.

Nota

Se si installa Management Gateway, è possibile utilizzare la stessa chiave di installazione per installare Management Gateway e Management Agent. Per informazioni su Management Gateway, vedere Management Gateway.

Configurare un file di risposta

Lo script di installazione di Management Agent utilizza un file di risposta per leggere i parametri dell'agente specifici dell'ambiente in uso.

Rivedi parametri agente

Quando si esegue lo script di configurazione dell'agente, è necessario un file di risposta contenente i parametri dell'agente.

Nella sezione seguente vengono descritti i parametri supportati nel file di risposta.

Tabella 3-1 Parametri del file di risposta

Nome parametro	Tipo di parametro	descrizione;
`ManagementAgentInstallKey`	obbligatorio	Chiave di installazione necessaria per verificare l'identità del dominio e l'autenticità dell'installazione.
`CredentialWalletPassword`	Facoltativo	Password del wallet dell'agente quando l'utente fornisce una password personalizzata per il wallet per memorizzare le informazioni riservate. La lunghezza minima della password è 8 caratteri con le seguenti specifiche: Almeno un carattere minuscolo (a-z) Almeno un carattere maiuscolo (A-Z) Almeno una cifra (0-9) Almeno un carattere speciale del seguente elenco: '!', '@', '#', '%', '^', '&', '*' Tutti i caratteri della password devono provenire dai caratteri definiti in precedenza. Ad esempio, se la password contiene il carattere `$` come parte della password, il controllo di validità non verrà eseguito poiché `$` non è tra i caratteri speciali elencati sopra.
`GatewayServerHost`	Facoltativo	Nome host o indirizzo del server Management Gateway o del server proxy. Se specificato, è necessario fornire anche `GatewayServerPort`. Se Management Gateway è configurato in modalità High Availability, è necessario specificare il nome host del load balancer come valore `GatewayServerHost`. Per informazioni, vedere Configure High Availability for Management Gateway.
`GatewayServerPort`	Facoltativo	Numero di porta del server o del server proxy di Management Gateway. Se specificato, è necessario fornire anche `GatewayServerHost`. Se Management Gateway è configurato in modalità High Availability, è necessario specificare il numero di porta del load balancer come valore `GatewayServerPort`. Per informazioni, vedere Configure High Availability for Management Gateway.
`GatewayServerUser`	Facoltativo	Nome utente, se il server Management Gateway o il server proxy richiede l'autenticazione. Se specificato, è necessario fornire anche `GatewayServerPassword`.
`GatewayServerPassword`	Facoltativo	Password, se il server di Management Gateway o il server proxy richiede l'autenticazione. Se specificato, è necessario fornire anche `GatewayServerUser`.
`GatewayServerRealm`	Facoltativo	Il realm di autenticazione per il server proxy. Se si utilizza Management Gateway, questo valore non è necessario.
`AgentDisplayName`	Facoltativo	Il nome visualizzato dell'agente. Se viene lasciato vuoto, il valore predefinito verrà impostato su "`Agent (host-name)`".
`Service.plugin.<plugin_name>.download=true`	Facoltativo	Nome del plugin che si desidera distribuire durante l'installazione dell'agente. `<plugin_name>` è un plugin supportato dal servizio Management Agent. Ad esempio, se si desidera distribuire il plugin DataSafe durante l'installazione dell'agente, sarà: `Service.plugin.datasafe.download=true`
`FreeFormTags = [{"<key1>":"<value1>"}, {"<key2>":"<value2>"}]`	Facoltativo	Associazione dei metadati delle tag se si utilizzano le tag in OCI. Si compone di una chiave e di un valore. La chiave è qualsiasi nome utilizzato per fare riferimento alla tag. Valore è il valore aggiunto dall'utente che applica il tag alla chiave tag. Per Agente associato, se questo Management Agent è configurato per la connessione tramite un Management Gateway, aggiungere una tag denominata `"GatewayGroup"`. Ad esempio: `"GatewayGroup":"<User_Defined_ClusterName>`
`DefinedTags = [{"namespace1":{"<key1>":"<value1>"}}, {"namespace2":{"<key2>":"<value2>"}}]`	Facoltativo	Associazione dei metadati delle tag se si utilizzano le tag in OCI. L'amministratore delle tag crea e gestisce tutte le tag che gli utenti applicano alle risorse. Gli utenti devono avere criteri di tag definiti. Lo spazio di nomi tag è un contenitore per le chiavi di tag. La chiave tag è una chiave all'interno dello spazio di nomi. È necessario creare chiavi tag per tag definite in uno spazio di nomi. Per i tag definiti, il valore del tag ha un tipo che può essere una stringa o una lista di stringhe. Durante la definizione del tipo di valore tag, se il tipo definito è una stringa, è possibile immettere qualsiasi valore. Se invece si tratta di un elenco di stringhe, questo valore deve essere una delle stringhe di tale elenco. Nell'esempio seguente sono disponibili 2 spazi di nomi `admin_namespace` e `finance_namespace`. Ogni spazio di nomi utilizza 2 chiavi e 2 valori `environment_type=non-prod, sensitivity=restricted`. Per definire le tag, è possibile utilizzare: `DefinedTags = [{"admin_namespace": {"environment_type": "non-prod", "sensitivity": "restricted"}, "finance_namespace": {"environment_type": "non-prod","sensitivity": "restricted"}}]`
`GatewayServerRootCACertOcid`	Facoltativo	Questo parametro è disponibile a partire dalla versione agente 221019.0021. Quando l'agente si connette a un gateway di gestione con versione 221019.0021.1667404647 o successiva, la connessione verrà cifrata. Questo parametro specifica il valore `OCID` del certificato dell'autorità di certificazione root da utilizzare. Agente e gateway devono trovarsi nello stesso compartimento.
`importTrustedCertsDirectory`	Facoltativo	Posizione dei certificati CA root aggiuntivi in formato PEM. Utilizzare questo parametro se si desidera aggiungere ulteriori certificati CA root in formato PEM. Il Management Agent ha eseguito la ricerca in tale posizione e ha aggiunto i certificati durante l'installazione. Ad esempio: `importTrustedCertsDirectory=/tmp/crt`
`maxHeapInMb`	Facoltativo	Quantità di heap massima in megabyte. Il valore heap predefinito è 512 Mb. Utilizzare questo parametro per sottoporre a tuning l'agente in modo che utilizzi più heap se si è a conoscenza del tempo di installazione precedente in cui l'agente verrà configurato con un carico elevato, ad esempio log e database. Ad esempio: `maxHeapInMb=1024`
`BufferingEnabled`	Facoltativo	Abilita il buffering per vari endpoint tramite Management Gateway, ad esempio i servizi OCI di Log Analytics e Object Storage.

Creare un file di risposta

Prima di procedere, assicurarsi di aver esaminato e compreso le informazioni fornite in Rivedi parametri agente.

Per installare e configurare gli agenti, è necessario creare un file di risposta ed eseguire uno script utilizzando il file di risposta appena creato che punterà l'agente all'area OCI corretta e consentirà la creazione di una risorsa per l'agente.

Nota

Quando si crea un file di risposta, controllare la posizione e le autorizzazioni del file. Assicurarsi che il file di risposta disponga delle autorizzazioni di lettura per l'utente del sistema operativo mgmt_agent.

Per creare un file di risposta, utilizzare una delle seguenti opzioni:

Opzione 1: scaricare un modello di file di risposta per creare un file di risposta

È possibile scaricare un file modello contenente i parametri agente che possono essere salvati e utilizzati come file di risposta durante l'installazione dell'agente.

Per scaricare un modello di file di risposta, utilizzare l'opzione di menu Scarica chiave su file nell'elenco Chiavi di installazione agente.

Fare clic su Scarica e chiavi nel menu a sinistra per aprire il riquadro Chiavi di installazione agente. Dall'elenco delle chiavi di installazione dell'agente, selezionare la chiave che si desidera scaricare.
Sul lato destro del tasto selezionato, fare clic sul menu delle azioni e selezionare Scarica chiave su file.

Viene scaricato un file. Per ulteriori informazioni, vedere Scarica chiave di installazione.

Quando si scarica la chiave di installazione dell'agente in un file, il file scaricato contiene i parametri dell'agente, incluso il valore della chiave di installazione dell'agente specifica.

Dopo aver scaricato il file, è necessario personalizzarlo in base all'ambiente in uso:

Aprire il file utilizzando un editor di testo, esaminarlo e modificare i parametri obbligatori dell'agente. Vedere Rivedi parametri agente.
Commentare (aggiungere il simbolo # all'inizio della riga) o rimuovere i parametri dell'agente non necessari per la configurazione dell'agente specifica.
Annullare il commento (rimuovere il simbolo # dall'inizio della riga) dei parametri agente necessari per la configurazione agente specifica e aggiornare il valore del parametro agente, se necessario.
Salvare il file di risposta aggiornato. Ad esempio, può essere salvato come file di risposta input.rsp.

Opzione 2: creare un file di risposta utilizzando un editor di testo

È possibile creare manualmente un file di risposta utilizzando un editor di testo. Ad esempio, è possibile creare un file utilizzando l'editor di testo preferito, aggiungere i parametri dell'agente necessari per la configurazione dell'agente al file di risposta e salvarlo. Ad esempio, il file di risposta può essere salvato come input.rsp.

Esempio di file response input.rsp:

managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5
CredentialWalletPassword = Abcdefgh1#

Dopo aver creato il file di risposta utilizzando una delle opzioni precedenti, controllare le autorizzazioni del file e assicurarsi che disponga delle autorizzazioni di lettura per l'utente mgmt_agent (utente del sistema operativo creato durante il processo di installazione di Management Agent).

Installa Management Agent

Dopo aver scaricato il software dell'agente, creato una chiave di installazione e un file di risposta, è possibile procedere con l'installazione del Management Agent per raccogliere i dati dalle origini che si desidera gestire e monitorare da Oracle Cloud Infrastructure.

Nota

Exadata: per installare il Management Agent in Exadata e Exadata Cloud, scaricare e installare il Management Agent utilizzando il metodo di installazione del file ZIP per evitare problemi con le operazioni di gestione del ciclo di vita Exadata. Non utilizzare l'installazione RPM in alcuna distribuzione Exadata, inclusi on premise, Cloud@Customer e Oracle Cloud Infrastructure. Per le distribuzioni di Exadata Cloud in Cloud@Customer e Oracle Cloud Infrastructure, assicurarsi che il Management Agent sia installato nel file system /u02.

Per istruzioni sull'installazione, vedere Installa Management Agent su un volume esterno utilizzando il file ZIP Linux.

Per ulteriori dettagli e considerazioni importanti durante l'installazione di Management Agent in Exadata Cloud, vedere OCI: Observability & Management Support For Exadata Cloud ID documento 3015115.1 su My Oracle Support.
Distribuzione di massa: la distribuzione di massa del Management Agent è supportata. Per informazioni, vedere l'esercitazione Distribuzione di massa di Oracle Management Agent mediante Ansible Playbooks.
È possibile installare Management Agent su più virtual machine. Per i dettagli, vedere il video OCI Management Agent: Come installare Management Agent su più virtual machine.

Installa Management Agent su Linux (file RPM)

Nota

Exadata: non utilizzare l'installazione RPM in alcuna distribuzione Exadata, incluse le distribuzioni on premise, Cloud@Customer e Oracle Cloud Infrastructure. Per istruzioni sull'installazione, vedere Installa Management Agent su un volume esterno utilizzando il file ZIP Linux.

Per installare il software del Management Agent su Linux utilizzando un file RPM, effettuare le operazioni riportate di seguito.

Eseguire il login come utente con privilegi sudo. Per modificare l'utente predefinito, vedere Use a Non-default OS User to Install Management Gateway.
Installare il software dell'agente.
Passare alla directory in cui è stato scaricato il file RPM del software del Management Agent ed eseguire il comando seguente per installare il file RPM:
```
sudo rpm -ivh <rpm_file_name.rpm>
```
Ad esempio: sudo rpm -ivh oracle.mgmt_agent-<VERSION>.rpm
L'output sarà simile a quanto riportato di seguito.
```
Preparing... ################################# [100%]
Checking pre-requisites

      Checking if any previous agent service exists
      Checking if OS has systemd or initd
      Checking available disk space for agent install
      Checking if /opt/oracle/mgmt_agent directory exists
      Checking if 'mgmt_agent' user exists
      'mgmt_agent' user already exists, the agent will proceed installation without creating a new one.
      Checking Java version
      JAVA_HOME is not set. Trying default path
      Java version: 1.8.0_281 found at /usr/bin/java

Updating / installing...
      1:oracle.mgmt_agent-<VERSION>################################# [100%]
Executing install
      Unpacking software zip
      Copying files to destination dir (/opt/oracle/mgmt_agent)
      Initializing software from template
      Creating 'mgmt_agent' daemon
      Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer-log-0
      Setup agent using input response file (run as any user with 'sudo' privileges)
      Usage:sudo
      /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=[RESPONSE_FILE]
Agent install successful
```
Il processo di installazione dell'agente effettua le operazioni riportate di seguito.
- Viene creato un nuovo utente denominato mgmt_agent. Questo sarà l'utente del Management Agent. Se l'utente mgmt_agent esiste già, il processo di installazione dell'agente lo utilizzerà per installare il software dell'agente.
- Quando si crea il daemon mgmt_agent, l'ulimit hard e soft nofile è impostato su 5000.
- Tutti i file agente vengono copiati e installati dall'utente mgmt_agent. La directory base di installazione dell'agente è la directory in cui è installato l'agente. La directory viene creata come parte del processo di installazione dell'agente nella directory /opt/oracle/mgmt_agent.
- Per impostazione predefinita, il servizio mgmt_agent viene abilitato e avviato automaticamente dopo l'installazione dell'agente.
I file di log dell'installazione dell'agente si trovano nella directory /opt/oracle/mgmt_agent/installer-logs. Per visualizzare i file di log o qualsiasi altro file di installazione dell'agente, eseguire il login come utente mgmt_agent che esegue quanto segue:
```
sudo -u mgmt_agent sh
```

Configurare il Management Agent eseguendo lo script setup.sh utilizzando un file di risposta.

sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<full_path_of_response_file>

L'output sarà simile a quanto riportato di seguito.

sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<response_file_directory>/input.rsp
Executing configure
      Generating communication wallet
      Parsing input response file
      Validating install key
      Generating security artifacts
      Registering management agent
      Configuration Logs: /opt/oracle/mgmt_agent/configure-logs

Agent configuration successful

Starting agent...
Agent started successfully
In future agent can be started by directly running: sudo systemctl start mgmt_agent
Please make sure that you delete input.rsp or store it in a secure location.

Per ulteriori informazioni sulla creazione dei file di risposta, vedere Creare un file di risposta.

Installa Management Agent su Linux (file `ZIP`)

Nota

Exadata: per installare il Management Agent in Exadata e Exadata Cloud, scaricare e installare il Management Agent utilizzando il metodo di installazione del file ZIP per evitare problemi con le operazioni di gestione del ciclo di vita Exadata. Non utilizzare l'installazione RPM in alcuna distribuzione Exadata, inclusi on premise, Cloud@Customer e Oracle Cloud Infrastructure. Per le distribuzioni di Exadata Cloud in Cloud@Customer e Oracle Cloud Infrastructure, assicurarsi che il Management Agent sia installato nel file system /u02.

Per istruzioni sull'installazione, vedere Installa Management Agent su un volume esterno utilizzando il file ZIP Linux.

Per ulteriori dettagli e considerazioni importanti durante l'installazione di Management Agent in Exadata Cloud, vedere OCI: Observability & Management Support For Exadata Cloud ID documento 3015115.1 su My Oracle Support.

Per installare il software del Management Agent su Linux utilizzando un file ZIP, attenersi alla procedura riportata di seguito.

Nota

La posizione di installazione predefinita si trova sotto il volume /opt. Se si preferisce utilizzare un volume esterno per installare il Management Agent, vedere Installa Management Agent su un volume esterno utilizzando il file ZIP Linux.

Estrarre il software del Management Agent.

Accedere alla directory in cui è stato scaricato il file ZIP del software del Management Agent e decomprimerlo in qualsiasi posizione preferita.
Eseguire il login come utente con privilegi sudo.
Installare e configurare il Management Agent eseguendo lo script installer.sh che fornisce un file di risposta. Per informazioni su come creare un file di risposta, vedere Creare un file di risposta.
Passare alla directory in cui è stato decompresso il file ZIP del software del Management Agent ed eseguire le operazioni riportate di seguito.
```
sudo ./installer.sh <full_path_of_response_file>
```
Ad esempio: sudo ./installer.sh /tmp/input.rsp
L'output sarà simile a quanto riportato di seguito.
```
sudo ./installer.sh <user_home_directory>/input.rsp 
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        JAVA_HOME is not set or not readable to root
        Trying default path /usr/bin/java
        Java version: 1.8.0_282 found at /usr/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Creating 'mgmt_agent'daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
```
Il processo di installazione dell'agente effettua le operazioni riportate di seguito.
- Viene creato un nuovo utente denominato mgmt_agent. Questo sarà l'utente del Management Agent. Se l'utente mgmt_agent esiste già, il processo di installazione dell'agente lo utilizzerà per installare il software dell'agente.
- Quando si crea il daemon mgmt_agent, l'ulimit hard e soft nofile è impostato su 5000.
- Tutti i file di installazione dell'agente sono di proprietà dell'utente mgmt_agent. La directory base di installazione dell'agente è la directory in cui è installato l'agente. La directory viene creata come parte del processo di installazione dell'agente nella directory /opt/oracle/mgmt_agent.
- Per impostazione predefinita, il servizio mgmt_agent viene abilitato e avviato automaticamente dopo l'installazione dell'agente.
I file di log dell'installazione dell'agente si trovano nella directory /opt/oracle/mgmt_agent/installer-logs.

I file di log dell'agente in esecuzione si trovano in /opt/oracle/mgmt_agent/agent_inst/log.
Per visualizzare i file di log o qualsiasi altro file di installazione dell'agente, eseguire il login come utente mgmt_agent che esegue quanto segue:
```
sudo -u mgmt_agent sh
```

Installa Management Agent in un volume esterno utilizzando il file `ZIP` di Linux

Nota

In alcuni ambienti Linux, il volume /opt ha uno spazio su disco limitato e non può essere utilizzato per installare il software. In questi casi, è possibile installare il Management Agent su un volume esterno utilizzando il file ZIP di Linux e creando un collegamento simbolico.

Per installare Management Agent su un volume esterno in Linux, effettuare le operazioni riportate di seguito.

Creare la directory di installazione di Management Agent in un volume esterno.
Ad esempio:
```
sudo mkdir -p /devext/oracle/mgmt_agent
```
Nell'esempio precedente, /devext è un volume esterno.
Creare un collegamento simbolico nella directory /opt/oracle per puntare al volume esterno.
Prima di eseguire il comando riportato di seguito, verificare che la directory /opt/oracle esista già.
Ad esempio:
```
sudo ln -s /devext/oracle/mgmt_agent /opt/oracle/mgmt_agent
```
Verificare che il file ZIP di Linux del software Management Agent sia stato scaricato. Per informazioni dettagliate, vedere Scaricare il software del Management Agent.

Passare a una shell root, impostare la variabile di ambiente OPT_ORACLE_SYMLINK = true e installare il software Management Agent come utente root.

sudo /bin/bash
export OPT_ORACLE_SYMLINK=true
./installer.sh <full_path_of_response_file>

Ad esempio:

sudo /bin/bash
export OPT_ORACLE_SYMLINK=true
./installer.sh ./input.rsp

Al termine del processo di installazione, verificare che l'utente Linux mgmt_agent sia il proprietario della posizione di installazione del Management Agent.
```
stat -c '%U' /opt/oracle/mgmt_agent
mgmt_agent

sudo stat -c '%U' /opt/oracle/mgmt_agent/agent_inst
mgmt_agent
```

Installa Management Agent su Mac

L'installazione di Management Agent su un Mac è supportata quando si utilizza il servizio Java Management. Per i dettagli, vedere Servizio Java Management, in particolare la sezione Installazione di un Management Agent.

Installa Management Agent in Windows Server

Per installare il software Management Agent in Windows Server, effettuare le operazioni riportate di seguito.

Estrarre il software del Management Agent.

Accedere alla directory in cui è stato scaricato il file ZIP del software del Management Agent e decomprimerlo in qualsiasi posizione preferita.
Eseguire il login come utente amministratore e aprire una finestra del prompt dei comandi.

Installare e configurare il Management Agent eseguendo lo script install.bat utilizzando un file di risposta.

installer.bat <full_path_of_response_file>

L'output sarà simile a quanto riportato di seguito.

installer.bat C:\<user_home_directory>\input.rsp
Checking pre-requisites

        Checking if previous agent service exists
        Checking if C:\Oracle\mgmt_agent\agent_inst directory exists
        Checking if C:\Oracle\mgmt_agent\200820.0751 directory exists
        Checking available disk space for agent install
        Checking Java version
                Java version: 1.8.0_281 found at C:\Program Files\Java\jdk1.8.0_281
 
Executing install
        Unpacking software zip
        Copying files to destination dir (C:\Oracle\mgmt_agent)
        Initializing software from template
        Creating mgmt_agent service 

Agent install successful 

Executing configure

        Parsing input response file
        Generating communication wallet
        Validating install key
        Generating security artifacts
        Registering Management Agent

The mgmt_agent service is starting....
The mgmt_agent service was started successfully.


Agent setup completed and the agent is running
In the future agent can be started by directly running: NET START mgmt_agent
Please make sure that you delete C:\<user_home_directory>\input.rsp or store it in secure location.

Per ulteriori informazioni sulla creazione dei file di risposta, vedere Creare un file di risposta.

Il processo di installazione dell'agente effettua le operazioni riportate di seguito.

Viene creata una nuova directory nell'ambito del processo di installazione dell'agente: C:\Oracle\mgmt_agent.
La directory base di installazione dell'agente è la directory in cui verrà installato l'agente. Per impostazione predefinita, l'agente viene installato nella directory C:\Oracle. Questa directory predefinita può essere modificata impostando la variabile di ambiente AGENT_INSTALL_BASEDIR prima di eseguire lo script install.bat.
I file di log dell'installazione dell'agente si trovano nella directory C:\Oracle\mgmt_agent\installer-logs.

Installa Management Agent sul desktop Windows

L'installazione di Management Agent in un desktop Windows è supportata quando si utilizza il servizio Java Management. Per i dettagli, vedere Servizio Java Management, in particolare la sezione Installazione di un Management Agent.

Installazione di Management Agent in Solaris

Per installare il software del Management Agent su Solaris, procedere come segue:

Estrarre il software del Management Agent.

Accedere alla directory in cui è stato scaricato il file ZIP del software del Management Agent e decomprimerlo in qualsiasi posizione preferita.
Se il percorso di sudo non è impostato nel file PATH, impostare la variabile di ambiente SUDO_PATH con il percorso di sudo. È possibile utilizzare l'opzione sudo -E per conservare le variabili di ambiente durante l'esecuzione del comando come sudo.

Verificare che useradd e groupadd si trovino nella variabile di ambiente PATH. Ad esempio, se si trova nella posizione /sbin/useradd, confermare che si trova nel percorso.

Verificare che sudo si trovi nella variabile di ambiente PATH. Ad esempio, se sudo si trova nella posizione /usr/bin/sudo, confermare che la variabile di ambiente PATH includa la posizione "/usr/bin".
Eseguire il login come utente con privilegi sudo.
Installare e configurare il Management Agent eseguendo lo script installer.sh utilizzando un file di risposta.

Per informazioni sulla creazione dei file di risposta, vedere Creare un file di risposta.
Passare alla directory in cui è stato decompresso il file ZIP del software del Management Agent ed eseguire le operazioni riportate di seguito.
```
sudo ./installer.sh <full_path_of_response_file>
```
L'output sarà simile a quanto riportato di seguito.
```
sudo ./installer.sh <user_home_directory>/input.rsp 
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        JAVA_HOME is not set or not readable to root
        Trying default path /usr/bin/java
        Java version: 1.8.0_282 found at /usr/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Creating 'mgmt_agent'daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
```
Il processo di installazione dell'agente effettua le operazioni riportate di seguito.
- Viene creato un nuovo utente denominato mgmt_agent. Questo sarà l'utente del Management Agent. Se l'utente mgmt_agent esiste già, il processo di installazione dell'agente lo utilizzerà per installare il software dell'agente.
- Quando si crea il daemon mgmt_agent, l'ulimit hard e soft nofile è impostato su 5000.
- Tutti i file di installazione dell'agente sono di proprietà dell'utente mgmt_agent. La directory base di installazione dell'agente è la directory in cui è installato l'agente. La directory viene creata come parte del processo di installazione dell'agente nella directory /opt/oracle/mgmt_agent.
- Per impostazione predefinita, il servizio mgmt_agent viene abilitato e avviato automaticamente dopo l'installazione dell'agente.
I file di log dell'installazione dell'agente si trovano nella directory /opt/oracle/mgmt_agent/installer-logs.

I file di log dell'agente in esecuzione si trovano in /opt/oracle/mgmt_agent/agent_inst/log.
Per visualizzare i file di log o qualsiasi altro file di installazione dell'agente, eseguire il login come utente mgmt_agent che esegue quanto segue:
```
sudo -u mgmt_agent sh
```

Installa Management Agent su AIX

Per installare il software del Management Agent su AIX, attenersi alla procedura riportata di seguito.

Nota

sudo, unzip e OpenJDK 8 per AIX sono obbligatori prima di procedere con l'installazione di Management Agent.

Estrarre il file ZIP del software del Management Agent.

Accedere alla directory in cui è stato scaricato il file ZIP del software del Management Agent e decomprimerlo in qualsiasi posizione preferita.

Per l'installazione è richiesta la utility unzip. Per informazioni su unzip per AIX, vedere AIX Toolbox for Open Source Software.
Eseguire il login come utente con privilegi sudo.
Installare e configurare il Management Agent eseguendo lo script installer.sh che fornisce un file di risposta.

Per informazioni su come creare un file di risposta, vedere Creare un file di risposta.

Passare alla directory in cui è stato decompresso il file ZIP del software del Management Agent ed eseguire le operazioni riportate di seguito.
```
sudo sh installer.sh <full_path_of_response_file>
```
Ad esempio: sudo sh installer.sh /usr/input.rsp
L'output sarà simile a quanto riportato di seguito.
```
Checking pre-requisites
    Checking if any previous agent service exists
    Checking if OS has systemd or initd
    Checking available disk space for agent install
    Checking if /opt/oracle/mgmt_agent directory exists
    Checking if 'mgmt_agent' user exists
    Checking Java version
        Trying /tmp/java/jdk8u372-b07
        Java version: 1.8.0_372 found at /tmp/java/jdk8u372-b07/bin/java
    Checking agent version

Executing install
    Unpacking software zip
    Copying files to destination dir (/opt/oracle/mgmt_agent)
    Initializing software from template
    Checking if JavaScript engine is available to use       
    Creating mgmt_agent daemon
    Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0

Agent install successful

Executing configure

    Parsing input response file
    Validating install key
    Generating communication wallet
    Generating security artifacts
    Registering Management Agent

Starting agent...
0513-059 The mgmt_agent Subsystem has been started. Subsystem PID is 16122232.
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo startsrc -s mgmt_agent 

Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
```
Il processo di installazione dell'agente effettua le operazioni riportate di seguito.
- Viene creato un nuovo utente denominato mgmt_agent. Questo sarà l'utente del Management Agent. Se l'utente mgmt_agent esiste già, il processo di installazione dell'agente lo utilizzerà per installare il software dell'agente.
- Quando si crea il daemon mgmt_agent, l'ulimit hard e soft nofile è impostato su 5000.
- Tutti i file di installazione dell'agente sono di proprietà dell'utente mgmt_agent. La directory base di installazione dell'agente è la directory in cui è installato l'agente. La directory viene creata come parte del processo di installazione dell'agente nella directory /opt/oracle/mgmt_agent.
- Per impostazione predefinita, il servizio mgmt_agent viene abilitato e avviato automaticamente dopo l'installazione dell'agente.
I file di log dell'installazione dell'agente si trovano nella directory /opt/oracle/mgmt_agent/installer-logs.

I file di log dell'agente in esecuzione si trovano in /opt/oracle/mgmt_agent/agent_inst/log.
Per visualizzare i file di log o qualsiasi altro file di installazione dell'agente, eseguire il login come utente mgmt_agent che esegue quanto segue:
```
sudo -u mgmt_agent sh
```

Installare più Management Agent

Management Agent supporta l'installazione di più istanze di Management Agent sullo stesso computer per replicare i dati raccolti dall'agente in più aree. Ogni Management Agent viene installato puntando a un'area OCI diversa durante la raccolta dalle stesse origini.

Nota

La funzione Installa più Management Agent è attualmente disponibile solo su Linux.

Identificativi servizio agente

Gli identificativi del servizio agente vengono utilizzati per identificare un servizio agente in presenza di altre istanze agente su un determinato computer in modo da evitare confusione. Ogni servizio Management Agent può essere installato con un identificativo specifico utilizzato per individuare e gestire tale particolare istanza di agente.

Se l'installazione di un Management Agent viene avviata senza fornire un identificativo del servizio, viene presunta l'installazione predefinita.

Tutti gli identificativi di servizio devono iniziare con mgmt_agent- seguito da una stringa composta solo da valori alfanumerici, trattini o caratteri di sottolineatura come unici caratteri consentiti. Ad esempio:

mgmt_agent-oc1_phx-abc123

Per installare il Management Agent con un identificativo del servizio, effettuare le operazioni indicate di seguito.

Estrarre il software del Management Agent.

Accedere alla directory in cui è stato scaricato il file ZIP del software del Management Agent e decomprimerlo in qualsiasi posizione preferita.
Eseguire il login come utente con privilegi sudo.

Installare e configurare il Management Agent eseguendo lo script installer.sh utilizzando un file di risposta.

Per informazioni sulla creazione dei file di risposta, vedere Creare un file di risposta.

Passare alla directory in cui è stato decompresso il file ZIP del software del Management Agent ed eseguire le operazioni riportate di seguito.

sudo ./installer.sh <full_path_of_response_file> <service identifier>

Ad esempio:

sudo ./installer.sh /tmp/input.rsp mgmt_agent-oc1_phx-abc123

L'output sarà simile a quanto riportato di seguito.

sudo ./installer.sh <user_home_directory>/input.rsp mgmt_agent-oc1_phx-abc123
Checking pre-requisites
	Checking if any previous agent service exists
	Checking if OS has systemd or initd
	Checking available disk space for agent install
	Checking if /opt/oracle/mgmt_agent-oc1_phx-abc123 directory exists
	Checking if 'mgmt_agent' user exists
	Checking Java version
		JAVA_HOME is not set or not readable to root
		Trying default path /usr/bin/java
		Java version: 1.8.0_282 found at /usr/bin/java
	Checking agent version

Executing install
	Unpacking software zip
	Copying files to destination dir (/opt/oracle/mgmt_agent-oc1_phx-abc123)
	Initializing software from template
	Checking if JavaScript engine is available to use
	Creating mgmt_agent-oc1_phx-abc123 daemon
	Agent Install Logs: /opt/oracle/mgmt_agent-oc1_phx-abc123/installer-logs/installer.log.0

Agent install successful

Executing configure

	Parsing input response file
	Validating install key
	Generating communication wallet
	Generating security artifacts
	Registering Management Agent

Starting agent...
Agent started successfully


Agent setup completed and the agent is running.
In the future agent can be started by directly running: sudo systemctl start mgmt_agent-oc1_phx-abc123

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

Il processo di installazione dell'agente effettua le operazioni riportate di seguito.

Viene creato un nuovo utente denominato mgmt_agent. Questo sarà l'utente del Management Agent. Se l'utente mgmt_agent esiste già, il processo di installazione dell'agente lo utilizzerà per installare il software dell'agente.
Daemon che utilizza l'identificativo del servizio durante la creazione del nome.
Gli ulimit di nofile hard e soft sono impostati su 5000.
Tutti i file di installazione dell'agente sono di proprietà dell'utente mgmt_agent. La directory base di installazione dell'agente è la directory in cui è installato l'agente. La directory viene creata come parte del processo di installazione dell'agente nella directory /opt/oracle/<service-identifier> .
Per impostazione predefinita, il servizio daemon <service-identifier> viene abilitato e avviato automaticamente dopo l'installazione dell'agente.
Tutte le interazioni con il servizio daemon agente, ad esempio l'avvio o l'arresto di un agente, possono essere eseguite utilizzando <service-identifier>. Ad esempio:
```
sudo systemctl start <service-identifier>
sudo systemctl stop <service-identifier>
```

I file di log dell'installazione dell'agente si trovano nella directory /opt/oracle/<service-identifier>/installer-logs.

I file di log dell'agente in esecuzione si trovano in /opt/oracle/<service-identifier>/agent_inst/log.

Per visualizzare i file di log o qualsiasi altro file di installazione dell'agente, eseguire il login come utente mgmt_agent che esegue quanto segue:

sudo -u mgmt_agent sh

Verifica dell'installazione di Management Agent

Verifica dell'installazione dell'agente mediante l'interfaccia utente

Per verificare l'installazione dell'agente mediante l'interfaccia utente, effettuare le operazioni indicate di seguito.

Nella pagina principale Management Agent fare clic su Agenti nel menu a sinistra.

Viene visualizzata la pagina Agenti con una lista di tutti gli agenti e gateway installati.

Per visualizzare solo gli agenti, è possibile utilizzare la sezione Filters dal menu a sinistra:

Andare a Filters, utilizzare l'elenco a discesa Install Type e selezionare Agent.

Vengono visualizzati tutti gli agenti.
Dalla lista Agenti, cercare l'agente installato di recente utilizzando la colonna Creato che visualizza la data di installazione dell'agente o la colonna Host che visualizza il nome host in cui è stato installato l'agente.

Verifica dell'installazione dell'agente mediante l'interfaccia a riga di comando

Verifica dell'installazione dell'agente mediante l'interfaccia a riga di comando su Linux

Eseguire il login all'host utilizzando un utente con privilegi sudo.
Eseguire il comando riportato di seguito:
Per Oracle Linux 6:
```
sudo /sbin/initctl status mgmt_agent
```
Per Oracle Linux 7:
```
sudo systemctl status mgmt_agent
```
Per ulteriori dettagli controllare il file di log: /opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log.

Verifica dell'installazione dell'agente mediante l'interfaccia a riga di comando in Windows

Eseguire il login all'host utilizzando la shell dei comandi di un account Administrator.
Eseguire il comando riportato di seguito:
```
sc query mgmt_agent
```
Per ulteriori dettagli controllare il file di log: C:\Oracle\mgmt_agent\agent_inst\log\mgmt_agent.log.

Verifica dell'installazione dell'agente con l'interfaccia a riga di comando su Solaris

Eseguire il login come utente che dispone del privilegio sudo per eseguire i comandi come utente root.
Eseguire il comando riportato di seguito:
```
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.

Risolvere i problemi di installazione di Management Agent

Per i problemi relativi ai Management Agent, vedere Risoluzione dei problemi relativi al servizio Management Agent.
Per i problemi di Management Gateway, vedere Risolvere i problemi relativi ai gateway di gestione.
Per i Management Agent nei problemi delle istanze di computazione, vedere Risolvere i problemi dei Management Agent nelle istanze di computazione.

Documentazione di Oracle Cloud Infrastructure