Esecuzione di task dei prerequisiti generici

Per impostare Oracle Management Cloud per il monitoraggio dell'ambiente Oracle E-Business Suite, è necessario eseguire un set di task generici.

Abilita la licenza di Enterprise Edition

Le offerte di Oracle Management Cloud sono classificate e sono disponibili in diverse edizioni di licenza, compreso Enterprise Edition.

In Oracle Management Cloud – Enterprise Edition sono disponibili le informazioni riportate di seguito.

Oracle Application Performance Monitoring: fornisce una piattaforma per il controllo e la gestione delle applicazioni.
Oracle Infrastructure Monitoring: controlla lo stato dell'intera infrastruttura della tecnologia di informazioni da una singola piattaforma e alert agli amministratori relativi ai problemi.
Orchestrazione Oracle: rende automatiche l'infrastruttura cloud e on premise ed esegue i task richiamando le API REST o utilizzando framework di automazione di terze parti.
Oracle IT Analytics: fornisce un'analisi dettagliata di 360-degree delle prestazioni, della disponibilità e della capacità delle applicazioni e degli investimenti nell'infrastruttura.

Abilitare Oracle Management Cloud - Enterprise Edition sia per il sistema host Oracle Cloud Infrastructure che per Oracle E-Business Suite.

Accedere alla console di Oracle Management Cloud come amministratore di Oracle Management Cloud.
Se il riquadro di navigazione di Management Cloud non è visualizzato, fare clic sull'icona di navigazione OMC nell'angolo superiore sinistro.
Nel riquadro di navigazione della console di Oracle Management Cloud fare clic su Amministrazione , quindi su Configurazione entità.
Fare clic su Licenze , quindi su Seleziona entità .
Individuare e selezionare le entità richieste, quindi fare clic sul pulsante Seleziona .
Selezionare Enterprise Edition per ogni entità elencata oppure fare clic su Edizione licenza e selezionare Imposta tutto su Enterprise .
Fare clic su Salva .

Installare gli agenti Oracle Management Cloud

Installare gli agenti Oracle Management Cloud che recuperano le metriche di monitoraggio.

Agente gateway: installare l'agente gateway su un host con accesso a Internet a Oracle Management Cloud e che può essere raggiunto da tutti gli host in cui vengono distribuiti gli agenti del cloud. Tutti gli agenti Oracle Management Cloud devono utilizzare un gateway comune.
Agenti cloud: installare gli agenti cloud su ogni host della topologia di Oracle E-Business Suite per monitorare e raccogliere i dati (ad esempio, metriche, informazioni di configurazione e log) dalle entità che risiedono su tali host.

Prima di installare gli agenti

Prima di installare gli agenti in Oracle E-Business Suite, tenere presenti le considerazioni riportate di seguito.

Per la directory base agente in cui si installa un agente:

Assicurarsi che solo l'utente root e l'utente agent installation dispongano dell'autorizzazione di scrittura sulla directory di base dell'agente e sulla relativa directory padre anche dopo l'installazione dell'agente. Assicurarsi che tutte le operazioni del ciclo di vita dell'agente, ad esempio l'aggiornamento o l'eliminazione siano state completate correttamente.
Se la directory base dell'agente viene creata prima dell'installazione, assicurarsi che la directory sia vuota. L'utente dell'installazione agente deve disporre dell'accesso in scrittura alla directory.
Se la directory base agente non viene creata prima dell'installazione, viene creata per impostazione predefinita nella directory in cui viene estratto il file ZIP del software agente. Assicurarsi che l'utente dell'installazione agente disponga dell'accesso in scrittura alla directory padre in cui viene creata la directory base agente.

Creare o scaricare una chiave di registrazione

Una chiave di registrazione viene emessa nel dominio di Identity e viene utilizzata quando si distribuiscono gli agenti del cloud. Dopo aver installato un agente con la chiave di registrazione, è possibile rimuovere la chiave da Oracle Management Cloud.

Quando si crea una chiave di registrazione, si specifica un conteggio per l'uso della chiave. Una chiave scade quando il conteggio degli usi è maggiore o uguale all'uso massimo specificato alla creazione della chiave.

Accedere alla console di Oracle Management Cloud come amministratore di Oracle Management Cloud.
Se il riquadro di navigazione di Management Cloud non è visualizzato, fare clic sull'icona di navigazione OMC nell'angolo superiore sinistro.
Nel riquadro di navigazione della console di Oracle Management Cloud, fare clic su Amministrazione , quindi su Agenti .
Fare clic sul menu a destra, quindi selezionare Gestisci chiavi di registrazione.
Creare una nuova chiave di registrazione immettendo i dettagli necessari nella pagina Chiavi di registrazione, quindi facendo clic su Crea nuova chiave .
Per scaricare una chiave di registrazione esistente, effettuare le operazioni riportate di seguito.
1. Nell'elenco delle chiavi di registrazione individuare la chiave che si desidera scaricare.
2. Fare clic sul menu Azioni sul lato destro della pagina, quindi selezionare Scarica .
  Un file di testo registrationKey.txt contenente il valore della chiave di registrazione viene scaricato nell'unità locale. Per visualizzare il valore della chiave, aprire il file registrationKey.txt.

Il valore della chiave verrà aggiunto nel parametro AGENT_REGISTRATION_KEY del file di risposta.

Scarica l'agente gateway

Utilizzare la console di Oracle Management Cloud per scaricare nell'host i file ZIP del bundle di installazione dell'agente gateway.

Quando si estrae il file ZIP del gateway, viene fornito come modello un file di risposta di esempio, gateway.rsp.

Accedere alla console di Oracle Management Cloud come amministratore di Oracle Management Cloud.
Se il riquadro di navigazione di Management Cloud non è visualizzato, fare clic sull'icona di navigazione OMC nell'angolo superiore sinistro.
Nel riquadro di navigazione della console di Oracle Management Cloud, fare clic su Amministrazione , quindi su Agenti .
Fare clic sul menu a destra e selezionare Scarica agenti .
Fare clic su Tipo di agente , quindi selezionare Gateway .
Fare clic su Sistema operativo, quindi selezionare il sistema operativo in cui si desidera installare l'agente.
Prendere nota dei valori dei parametri TENANT_NAME e OMC_URL visualizzati sotto il collegamento dell'agente. Quando si installa l'agente gateway, sarà necessario aggiornare il file di risposta con questi valori.
Fare clic sul collegamento del software agente relativo al sistema operativo in uso per scaricare il file ZIP del software del gateway.
Verificare che il file ZIP scaricato sia completo confrontando il valore di checksum SHA1 del file scaricato con quello elencato per l'agente nella pagina di download dell'agente:
```
sha1sum <agent_binary_filename>.zip
```
Il valore della colonna Checksum SHA1 nell'interfaccia utente deve corrispondere all'output.
Passare alla directory in cui è stato scaricato il bundle di software ed estrarre il software.
```
unzip <agent_binary_filename>.zip
```

Scarica l'agente cloud

Utilizzare la console di Oracle Management Cloud per scaricare nell'host i file ZIP del bundle di installazione del software dell'agente cloud.

Quando si estrae il file ZIP dell'agente, viene fornito come modello un file di risposta di esempio agent.rsp.

Accedere alla console di Oracle Management Cloud come amministratore di Oracle Management Cloud.
Se il riquadro di navigazione di Management Cloud non è visualizzato, fare clic sull'icona di navigazione OMC nell'angolo superiore sinistro.
Nel riquadro di navigazione della console di Oracle Management Cloud, fare clic su Amministrazione , quindi su Agenti .
Fare clic sul menu a destra e selezionare Scarica agenti .
Fare clic su Tipo di agente , quindi selezionare Agente cloud.
Fare clic su Sistema operativo, quindi selezionare il sistema operativo in cui si desidera installare l'agente.
Prendere nota dei valori dei parametri TENANT_NAME e OMC_URL visualizzati sotto il collegamento dell'agente. Quando si installa l'agente gateway, sarà necessario aggiornare il file di risposta con questi valori.
Fare clic sul collegamento del software agente relativo al sistema operativo in uso per scaricare il file ZIP del software del gateway.
Verificare che il file ZIP scaricato sia completo confrontando il valore di checksum SHA1 del file scaricato con quello elencato per l'agente nella pagina di download dell'agente:
```
sha1sum <agent_binary_filename>.zip
```
Il valore della colonna Checksum SHA1 nell'interfaccia utente deve corrispondere all'output.
Passare alla directory in cui è stato scaricato il bundle di software ed estrarre il software.
```
unzip <agent_binary_filename>.zip
```

Installa l'agente di gateway

Un agente gateway funge da canale protetto tra Oracle Management Cloud e tutti gli altri agenti Oracle Management Cloud.

Per installare un agente gateway, effettuare le operazioni riportate di seguito.

Modificare il file di risposta del gateway, gateway.rsp (ottenuto durante il download e l'estrazione del file ZIP del gateway), in un editor di testo e fornire i valori per i parametri necessari per installare un gateway.

Nella tabella riportata di seguito sono elencati i parametri necessari per l'installazione del gateway.

Parametro	Descrizione
`TENANT_NAME` oppure `TENANT_ID` (supportato nelle versioni precedenti e rimane compatibile con le versioni precedenti)	Nome del tenant in cui è in esecuzione Oracle Management Cloud. È possibile ottenere il valore `TENANT_NAME` per un agente passando ad Amministrazione > Agenti > Download e selezionando un tipo di agente dall'elenco a discesa Tipo di agente . Il valore `TENANT_NAME` viene visualizzato nella parte inferiore della pagina.
`OMC_URL` oppure `UPLOAD_ROOT` (supportato nelle versioni precedenti e rimane compatibile con le versioni precedenti)	L'URL assoluto che include il protocollo necessario per la connessione a Oracle Management Cloud per il caricamento dei dati per un `TENANT_NAME` specifico. Per ottenere questo valore, accedere ad Amministrazione > Agenti > Scarica e selezionare un tipo di agente dall'elenco a discesa Tipo di agente . Il valore `OMC_URL` viene visualizzato nella parte inferiore della pagina.
`AGENT_REGISTRATION_KEY`	Chiave per la convalida dell'identità del tenant e dell'autenticità dell'installazione. È possibile ottenere la chiave di registrazione dal dashboard di Oracle Management Cloud passando ad Amministrazione > Agenti > Chiavi di registrazione.
`AGENT_BASE_DIRECTORY`	Directory vuota in cui l'agente deve essere installato sul computer host. Se la directory specificata non è presente, ne viene creata una durante l'installazione. Nota: in Windows, la lunghezza del percorso di directory che include la lettera dell'unità deve essere inferiore a 23 caratteri.

Salvare il file di risposta.
Eseguire un controllo dei prerequisiti per convalidare i parametri. Utilizzare l'interfaccia della riga di comando per eseguire lo script AgentInstall.sh che passa il parametro EXECUTE_PREREQ=true.
```
$ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed for [Gateway]. 
```
Lo script esegue il controllo dei prerequisiti. Se il controllo dei prerequisiti non riesce, lo script si arresta con un messaggio di errore rilevante.

Per ulteriori dettagli, vedere il file di log disponibile in <AGENT_ZIP_FILE_EXTRACTED_DIRECTORY>/AgentInstall_<timestamp>.log. Correggere gli errori prima di installare il gateway.
Installare l'agente eseguendo lo script AgentInstall.sh con il nome del file di risposta come parametro.
./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the gateway.rsp file>

Installa l'agente cloud

Un agente cloud raccoglie i dati dell'entità dall'host in cui viene distribuito l'agente cloud.

L'installazione dell'agente cloud richiede nomi di dominio completamente qualificati (FQDN) per gli host. Per gli ambienti UNIX, aggiungere il file FQDN nel file /etc/hosts e assicurarsi che sia mappato al nome host e all'indirizzo IP corretti dell'host.

Nota: installare l'agente cloud su ogni host del livello applicazione e host del database.

Per installare un agente cloud:

Modificare il file di risposta dell'agente cloud, agent.rsp (ottenuto durante il download e l'estrazione del file ZIP dell'agente cloud), in un editor di testo e fornire i valori per i parametri necessari per installare un agente cloud.

La tabella riportata di seguito elenca i parametri richiesti in precedenza e in alto per l'installazione di un agente cloud che utilizza un gateway per comunicare con Oracle Management Cloud su un server proxy.

Parametro	Descrizione
`GATEWAY_HOST`	Se l'agente cloud comunica con Oracle Management Cloud mediante un gateway, fornire il nome dominio completamente qualificato (FQDN) del gateway. Quando si installa l'agente cloud, assicurarsi di fornire lo stesso nome host gateway utilizzato per installare il gateway. Ad esempio, durante la distribuzione del gateway, se si specifica `ORACLE_HOSTANME=abc.xyz.com` e durante l'installazione dell'agente cloud, si specifica `GATEWAY_HOST=abc`, si verificheranno errori di registrazione degli agenti cloud. Un agente gateway deve essere installato sull'host ed essere attivo e in esecuzione.
`GATEWAY_PORT`	Quando un agente cloud utilizza un gateway per comunicare con Oracle Management Cloud, è necessario specificare la porta del gateway. È possibile ottenere il numero di porta eseguendo il comando seguente: `$Gateway_Agent_Home/agent_inst/bin/omcli status agent`
`OMC_PROXYHOST`	Indirizzo del server proxy da utilizzare per la connessione. Assicurarsi di non passare il valore `https://` ai dettagli dell'host proxy.
`OMC_PROXYPORT`	Porta del server proxy.
`OMC_PROXYUSER`	Nome utente richiesto per accedere al server proxy.
`OMC_PROXYPWD`	La password richiesta per accedere al server proxy.
`OMC_PROXYREALM`	Realm di autenticazione, se presente, da utilizzare per accedere al server proxy.
`AGENT_PORT`	Il numero di porta a cui verrà associato il processo agente. Lo script `AgentInstall` arresta il processo di installazione se questa porta è occupata al momento dell'installazione.

Salvare il file di risposta.
Eseguire un controllo dei prerequisiti per convalidare i parametri. Utilizzare l'interfaccia della riga di comando per eseguire lo script AgentInstall.sh che passa il parametro EXECUTE_PREREQ=true.
```
$ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed. 
```
Lo script esegue il controllo dei prerequisiti. Se il controllo dei prerequisiti non riesce, lo script si arresta con un messaggio di errore rilevante.
Installare l'agente eseguendo lo script AgentInstall.sh con il nome del file di risposta come parametro.
./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the agent.rsp file>

Verifica installazione agente

Dopo aver installato il gateway e l'agente cloud, verificare che gli agenti siano stati distribuiti correttamente.

Accedere alla console di Oracle Management Cloud come amministratore di Oracle Management Cloud.
Se il riquadro di navigazione di Management Cloud non è visualizzato, fare clic sull'icona di navigazione OMC nell'angolo superiore sinistro.
Nel riquadro di navigazione della console di Oracle Management Cloud, fare clic su Amministrazione , quindi su Agenti .
Fare clic sulla scheda relativa al tipo di agente, ad esempio Gateway o Agenti cloud.
Verificare che il nome host del gateway o dell'agente cloud distribuito esista nella lista degli agenti disponibili.