

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Oracle Enterprise Manager
<a name="Oracle.Options.OEM"></a>

Amazon RDS supporta Oracle Enterprise Manager (OEM). OEM è la linea di prodotti Oracle per la gestione integrata della tecnologia informatica aziendale. 

Amazon RDS supporta OEM su CBD o non CBD Oracle Database 19c. Nella seguente tabella sono descritte le opzioni di OEM supportate.


****  

| Opzione | ID opzione | Versioni OEM supportate | 
| --- | --- | --- | 
|  [OEM Database Express](Appendix.Oracle.Options.OEM_DBControl.md)  |  `OEM`  |  OEM Database Express 19c  | 
|  [OEM Management Agent](Oracle.Options.OEMAgent.md)  |  `OEM_AGENT`  |  OEM Cloud Control per 13c  | 

**Nota**  
Puoi utilizzare OEM Database oppure OEM Management Agent, ma non entrambi.

# Oracle Enterprise Manager Database Express
<a name="Appendix.Oracle.Options.OEM_DBControl"></a>

Amazon RDS supporta Oracle Enterprise Manager Database Express (EM Express) tramite l’utilizzo dell’opzione OEM. Amazon RDS supporta EM Express per Oracle Database 19c utilizzando l’architettura CDB o non CDB.

EM Express è uno strumento di gestione dei database basato sul web incluso nel database ed è disponibile solo quando è aperto. Supporta la gestione delle prestazioni chiave e le funzioni di amministrazione di base del database. Per ulteriori informazioni, consulta l’articolo [Introduction to Oracle Enterprise Manager Database Express](https://docs.oracle.com/en/database/oracle/oracle-database/19/admqs/getting-started-with-database-administration.html#GUID-BA75AD46-D22E-4914-A31E-C395CD6A2BBA) nella documentazione di Oracle Database.

**Nota**  
EM Express non è supportato nelle classi di istanze database db.t3.small. Per maggiori informazioni sulle classi di istanza database, consulta [Classi di istanza database RDS per Oracle](Oracle.Concepts.InstanceClasses.md).

## Impostazioni dell’opzione OEM
<a name="Appendix.Oracle.Options.OEM_DBControl.Options"></a>

Amazon RDS supporta le seguenti impostazioni per l'opzione OEM. 


****  

| Impostazione opzioni | Valori validi | Descrizione | 
| --- | --- | --- | 
| **Porta** | Un valore intero. |  La porta sull’istanza database RDS per Oracle in ascolto di EM Express. Il valore predefinito è 5500.  | 
| **Gruppi di sicurezza** | — |  Un gruppo di sicurezza che ha accesso a **Port (Porta)**.   | 

## Passaggio 1: aggiunta dell’opzione OEM
<a name="Appendix.Oracle.Options.OEM_DBControl.Add"></a>

Di seguito è riportato il processo generale per aggiungere l'opzione OEM a un'istanza database: 

1. Creare un nuovo gruppo di opzioni oppure copiare o modificare un gruppo di opzioni esistente.

1. Aggiungere l'opzione al gruppo di opzioni.

1. Associa il gruppo di opzioni a questa istanza database.

Quando aggiungi l’opzione OEM, si verifica una breve interruzione mentre l’istanza database viene riavviata automaticamente. 

**Per aggiungere l'opzione OEM a un'istanza database**

1. Determinare il gruppo di opzioni che si desidera usare. È possibile creare un nuovo gruppo di opzioni oppure usare un gruppo di opzioni esistente. Se si desidera usare un gruppo di opzioni esistente, puoi passare alla fase successiva. In caso contrario, creare un gruppo di opzioni database personalizzato con le seguenti impostazioni: 

   1. Per **Engine (Motore)** scegliere l'edizione Oracle per l'istanza database. 

   1. In **Major engine version (Versione principale del motore)**, scegliere la versione dell'istanza database. 

   Per ulteriori informazioni, consulta [Creazione di un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. Aggiungere l'opzione OEM al gruppo di opzioni e configurare le impostazioni dell'opzione. Per ulteriori informazioni sull'aggiunta di opzioni, consulta [Aggiunta di un'opzione a un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Per ulteriori informazioni su ciascuna impostazione, consulta [Impostazioni dell’opzione OEM](#Appendix.Oracle.Options.OEM_DBControl.Options). 
**Nota**  
Se aggiungi l’opzione OEM a un gruppo di opzioni esistente già associato a una o più istanze database, si verifica una breve interruzione mentre tutte le istanze database vengono riavviate automaticamente. 

1. Applicare il gruppo di opzioni a un'istanza database nuova o esistente:
   + Per una nuova istanza database, applicare il gruppo di opzioni quando viene avviata l'istanza. Per ulteriori informazioni, consulta [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md). 
   + Per un'istanza database esistente, applicare il gruppo di opzioni modificando l'istanza e collegando il nuovo gruppo di opzioni. Quando aggiungi l’opzione OEM, si verifica una breve interruzione mentre l’istanza database viene riavviata automaticamente. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md). 

**Nota**  
Puoi anche usare AWS CLI per aggiungere l'opzione OEM. Per alcuni esempi, consulta [Aggiunta di un'opzione a un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).

## Passaggio 2: (solo CDB) sblocco dell’account utente DBSNMP
<a name="Appendix.Oracle.Options.OEM_DBControl.DBSNMP"></a>

Se l’istanza database utilizza l’architettura CDB, è necessario accedere a EM Express come `DBSNMP`. In un CDB `DBSNMP` è un utente comune. Per impostazione predefinita, questo account è bloccato. Se l’istanza database non utilizza l’architettura CDB, salta questo passaggio.

**Per sbloccare l’account utente DBSNMP in un’istanza CDB**

1. In SQL\$1Plus o in un’altra applicazione Oracle SQL, accedi come utente master all’istanza database.

1. Esegui la seguente procedura memorizzata per sbloccare l’account `DBSNMP`:

   ```
   1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password');
   ```

   Se viene visualizzato un errore per segnalare che la procedura non esiste, riavvia l’istanza CDB per installarla automaticamente. Per ulteriori informazioni, consulta [Riavvio di un'istanza DB DB](USER_RebootInstance.md).

## Passaggio 3: accesso a EM Express tramite il browser
<a name="Appendix.Oracle.Options.OEM_DBControl.Using"></a>

Quando accedi EM Express dal browser web, viene visualizzata una finestra di accesso in cui ti viene chiesto di immettere il nome utente e la password.

**Per accedere a EM Express tramite il browser**

1. Identifica l’endpoint e la porta EM Express per l’istanza database Amazon RDS. Per informazioni su come trovare l’endpoint per l’istanza database Amazon RDS, consulta [Esito dell'endpoint dell'istanza database RDS per Oracle](USER_Endpoint.md).

1. Inserisci un URL nella barra di localizzazione del browser utilizzando il seguente formato. 

   ```
   https://endpoint.rds.amazonaws.com:port/em
   ```

   Ad esempio, se l’endpoint dell’istanza database Amazon RDS è `mydb.a1bcde234fgh.us-east-1.rds.amazonaws.com` e la porta EM Express è `1158`, utilizza il seguente URL per accedere a EM Express.

   ```
   1. https://mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com:1158/em
   ```

1. Quando ti vengono richiesti i dati di accesso, esegui la procedura riportata di seguito, a seconda dell’architettura del tuo database:  
**Il database è un database non CDB.**  
Immetti il nome utente master e la password master dell'istanza database.  
**Il database è un CDB.**  
Immetti `DBSNMP` per l’utente e la password `DBSNMP`. Lascia vuoto il campo `Container`.

## Modifica delle impostazioni di OEM Database
<a name="Appendix.Oracle.Options.OEM_DBControl.ModifySettings"></a>

Dopo avere abilitato OEM Database, puoi modificare l'impostazione dei gruppi di sicurezza dell'opzione. 

Non è possibile modificare il numero di porta OEM dopo avere associato il gruppo di opzioni a un'istanza database. Per modificare il numero di porta OEM utilizzato per un'istanza database, procedi come indicato di seguito: 

1. Crea un nuovo gruppo di opzioni.

1. Aggiungi l'opzione OEM con il numero di porta al nuovo gruppo di opzioni. 

1. Rimuovi il gruppo di opzioni esistente dall'istanza database.

1. Aggiungi il nuovo gruppo di opzioni all'istanza database.

Per ulteriori informazioni su come modificare le impostazioni dell'opzione, consulta [Modifica di un'impostazione di un'opzione](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.ModifyOption). Per ulteriori informazioni su ciascuna impostazione, consulta [Impostazioni dell’opzione OEM](#Appendix.Oracle.Options.OEM_DBControl.Options). 

## Esecuzione di attività OEM Database Express
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks"></a>

Puoi utilizzare le procedure Amazon RDS per eseguire determinate attività OEM Database Express. Con queste procedure, puoi eseguire le attività elencate di seguito.

**Nota**  
Le attività OEM Database Express vengono eseguite in modo asincrono.

**Topics**
+ [Cambiare il front-end del sito Web per OEM Database Express in Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash)
+ [Cambiare il front-end del sito Web per OEM Database Express in Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET)

### Cambiare il front-end del sito Web per OEM Database Express in Adobe Flash
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash"></a>

**Nota**  
Questo task è disponibile solo per Oracle Database 19c non-. CDBs

A partire da Oracle Database 19c, Oracle ha dichiarato obsoleta la precedente interfaccia utente OEM Database Express, basata su Adobe Flash. OEM Database Express utilizza ora un'interfaccia creata con Oracle JET. In caso di problemi con la nuova interfaccia, puoi tornare all'interfaccia basata su Flash che è stata dichiarata obsoleta. I problemi che si possono verificare con la nuova interfaccia includono il restare bloccati in una schermata `Loading` dopo aver effettuato l'accesso a OEM Database Express. Potrebbero anche mancare alcune funzionalità importanti che erano presenti nella versione basata su Flash di OEM Database Express.

Per cambiare il front-end del sito Web di OEM Database Express in Adobe Flash, eseguire la procedura Amazon RDS `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash`. Questa procedura equivale al comando SQL `execemx emx`.

Le best practice di sicurezza scoraggiano l'uso di Adobe Flash. Sebbene sia possibile ripristinare l'OEM Database Express basato su Flash, è consigliabile utilizzare i siti Web OEM Database Express basati su Jet, se possibile. Se ripristini l'utilizzo di Adobe Flash e desideri tornare a utilizzare Oracle JET, utilizza la procedura `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Dopo un aggiornamento del database Oracle, una versione più recente di Oracle JET potrebbe risolvere i problemi relativi a JET in OEM Database Express. Per ulteriori informazioni sul passaggio a Oracle JET, consulta [Cambiare il front-end del sito Web per OEM Database Express in Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET).

**Nota**  
L'esecuzione di questa attività dall'istanza database di origine per una replica di lettura ha anche come conseguenza che i front-end del sito Web di OEM Database Express cambiano in Adobe Flash.

La seguente invocazione di procedura crea un'attività per cambiare il sito Web di OEM Database Express in Adobe Flash e restituire l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash() as TASK_ID from DUAL;
```

È possibile visualizzare il risultato visualizzando il file di output dell'attività.

```
SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log'));
```

Sostituire *`task-id`* con l'ID attività restituito dalla procedura. Per ulteriori informazioni sulla procedura Amazon RDS `rdsadmin.rds_file_util.read_text_file`, consulta [Lettura dei file in una directory di istanze database](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 

È inoltre possibile visualizzare il contenuto del file di output del task in cercando tra le voci Console di gestione AWS di registro nella sezione **Registri ed eventi** il. `task-id`

### Cambiare il front-end del sito Web per OEM Database Express in Oracle JET
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET"></a>

**Nota**  
Questo task è disponibile solo per Oracle Database 19c non-. CDBs

Per cambiare il front-end del sito Web di OEM Database Express in Adobe Flash, eseguire la procedura Amazon RDS `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Questa procedura equivale al comando SQL `execemx omx`.

Per impostazione predefinita, i siti Web di OEM Database Express per le istanze database di Oracle che eseguono 19c o versioni successive utilizzano Oracle JET. Se è stata utilizzata la procedura `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash` per cambiare il front-end del sito Web di OEM di Database Express in Adobe Flash, è possibile tornare a Oracle JET. Per fare ciò, utilizza la procedura `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Per ulteriori informazioni sul passaggio ad Adobe Flash, consulta [Cambiare il front-end del sito Web per OEM Database Express in Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash).

**Nota**  
L'esecuzione di questa attività dall'istanza database di origine per una replica di lettura ha anche come conseguenza che i front-end del sito Web di OEM Database Express cambiano in Oracle JET.

La seguente invocazione di procedura crea un'attività per cambiare il sito Web di OEM Database Express in Oracle JET e restituire l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet() as TASK_ID from DUAL;
```

È possibile visualizzare il risultato visualizzando il file di output dell'attività.

```
SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log'));
```

Sostituire *`task-id`* con l'ID attività restituito dalla procedura. Per ulteriori informazioni sulla procedura Amazon RDS `rdsadmin.rds_file_util.read_text_file`, consulta [Lettura dei file in una directory di istanze database](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 

È inoltre possibile visualizzare il contenuto del file di output del task in cercando tra le voci Console di gestione AWS di registro nella sezione **Registri ed eventi** il. `task-id`

## Rimozione dell'opzione OEM Database
<a name="Appendix.Oracle.Options.OEM_DBControl.Remove"></a>

Puoi rimuovere l'opzione OEM da un'istanza database. Quando rimuovi l’opzione OEM, si verifica una breve interruzione mentre l’istanza viene riavviata automaticamente. Quindi, una volta rimossa l'opzione OEM, non è necessario riavviare l'istanza database.

Per rimuovere l'opzione OEM dall'istanza database, procedi in uno dei seguenti modi:
+ Rimuovi l'opzione OEM dal gruppo di opzioni a cui appartiene. Questa modifica coinvolge tutte le istanze database che usano il gruppo di opzioni. Per ulteriori informazioni, consulta [Rimozione di un'opzione da un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). 
+ Modifica l'istanza database e specifica un diverso gruppo di opzioni che non comprenda l'opzione OEM. Questa modifica coinvolge una singola istanza database. È possibile specificare il gruppo di opzioni predefinito (vuoto) o un gruppo di opzioni personalizzato diverso. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md). 

# Oracle Management Agent per Enterprise Manager Cloud Control
<a name="Oracle.Options.OEMAgent"></a>

Oracle Management Agent (OEM) è un componente software che monitora destinazioni in esecuzione su host e comunica tali informazioni a Oracle Management Service (OMS) di livello intermedio. Amazon RDS supporta Management Agent tramite l'utilizzo dell'opzione `OEM_AGENT`. 

Per ulteriori informazioni, consulta [Overview of Oracle Enterprise Manager Cloud Control 12c](http://docs.oracle.com/cd/E24628_01/doc.121/e25353/overview.htm) e [Overview of Oracle Enterprise Manager Cloud Control 13c](http://docs.oracle.com/cd/E63000_01/EMCON/overview.htm#EMCON109) nella documentazione Oracle.

**Topics**
+ [Requisiti per Management Agent](#Oracle.Options.OEMAgent.PreReqs)
+ [Prerequisiti di comunicazione host OMS](#Oracle.Options.OEMAgent.PreReqs.host)
+ [Limitazioni per Management Agent](#Oracle.Options.OEMAgent.limitations)
+ [Impostazioni dell'opzione per Management Agent](#Oracle.Options.OEMAgent.Options)
+ [Abilitazione dell’opzione Management Agent per l’istanza database](#Oracle.Options.OEMAgent.Enable)
+ [Rimozione dell'opzione Management Agent](#Oracle.Options.OEMAgent.Remove)
+ [Esecuzione delle attività di database con Management Agent](#Oracle.Options.OEMAgent.DBTasks)

## Requisiti per Management Agent
<a name="Oracle.Options.OEMAgent.PreReqs"></a>

Di seguito sono riportati i requisiti generali per l’utilizzo di Management Agent: 
+ L’istanza database deve eseguire Oracle Database 19c (19.0.0.0). È possibile utilizzare l’architettura CDB o non CDB.
+ È necessario utilizzare un Oracle Management Service (OMS) configurato per effettuare la connessione all’istanza database. Tieni presenti i seguenti requisiti di OMS:
  + Le versioni 13.5.0.0.v2 e 13.5.0.0.v3 di Management Agent richiedono OMS versione 13.5.0.23 o 24.1.
  + La versione 13.5.0.0.v1 di Management Agent richiede OMS versione 13.5.0.0 o 24.1.
  + Le versioni 13.4.0.9.v1 e 13.4.0.9.v2 di Management Agent richiedono OMS versione 13.4.0.9 o successiva e la patch 32198287.
+ Nella maggior parte dei casi, è necessario configurare il VPC per permettere le connessioni dal tuo OMS all'istanza database. Se non hai familiarità con Amazon Virtual Private Cloud (Amazon VPC), completa le fasi in [Tutorial: crea un VPC da utilizzare con un ) IPv4](CHAP_Tutorials.WebServerDB.CreateVPC.md) prima di continuare. 
+ È possibile utilizzare Management Agent con Oracle Enterprise Manager Cloud Control per 12c e 13c. Assicurati di disporre di spazio di storage sufficiente per la release OEM:
  + Almeno 8,5 GiB per OEM 13c Release 5
  + Almeno 8,5 GiB per OEM 13c Release 4
  + Almeno 8,5 GiB per OEM 13c Release 3
  + Almeno 5,5 GiB per OEM 13c Release 2
  + Almeno 4,5 GiB per OEM 13c Release 1
  + Almeno 2,5 GiB per OEM 12c
+ Se stai utilizzando le versioni `OEM_AGENT 13.2.0.0.v3` e `13.3.0.0.v2` di Management Agent e desideri utilizzare la connettività TCPS, segui le istruzioni riportate in [Configuring third party CA certificates for communication with target databases](https://docs.oracle.com/cd/E73210_01/EMSEC/GUID-8337AD48-1A32-4CD5-84F3-256FAE93D043.htm#EMSEC15996) nella documentazione Oracle. Inoltre, aggiorna JDK su OMS seguendo le istruzioni indicate nel documento Oracle contrassegnato dal numero identificativo 2241358.1. Quest’operazione consente a OMS di supportare tutte le suite di cifratura supportate dal database.
**Nota**  
La connettività TCPS tra il Management Agent e l'istanza database è supportata solo per Management Agent `OEM_AGENT 13.2.0.0.v3`, `13.3.0.0.v2`, `13.4.0.9.v1` e versioni successive.

## Prerequisiti di comunicazione host OMS
<a name="Oracle.Options.OEMAgent.PreReqs.host"></a>

Assicurati che il tuo host OMS e l’istanza database Amazon RDS possano comunicare. Esegui questa operazione: 
+ Per effettuare la connessione da Management Agent al tuo host OMS, quando l’host OMS è protetto da un firewall, aggiungi gli indirizzi IP delle istanze database al firewall. Assicurati che il firewall per l’OMS consenta il seguente traffico di rete:  
Dall’host OMS all’istanza database  
Configura una regola del firewall unidirezionale che consenta il traffico dall’host OMS alla porta del listener del database (per impostazione predefinita, la 1521) e la porta di OEM Agent (per impostazione predefinita, la 3872).  
Dall’istanza database all’host OMS  
Configura una regola del firewall unidirezionale che consenta il traffico dall’istanza database alla porta HTTP di OMS (per impostazione predefinita, la 4903).
+ Per effettuare la connessione dall'OMS al Management Agent, se l'OMS ha un nome host risolvibile pubblicamente, aggiungi l'indirizzo dell'OMS a un gruppo di sicurezza. Il gruppo di sicurezza deve avere regole in entrata che permettono l'accesso alla porta del listener di database e a quella del Management Agent. Per un esempio su come creare un gruppo di sicurezza e aggiungere regole in entrata, consulta [Tutorial: crea un VPC da utilizzare con un ) IPv4](CHAP_Tutorials.WebServerDB.CreateVPC.md). 
+ Per effettuare la connessione dall'OMS al Management Agent, se l'OMS non ha un nome host risolvibile pubblicamente, utilizza uno dei seguenti: 
  + Se OMS si trova in un'istanza Amazon Elastic Compute Cloud (Amazon EC2) in un VPC privato, è possibile configurare il peering VPC per effettuare la connessione da OMS a Management Agent. Per ulteriori informazioni, consulta [Un'istanza database in un VPC a cui accede un'istanza EC2 in un VPC diverso](USER_VPC.Scenarios.md#USER_VPC.Scenario3). 
  + Se l'OMS è ospitato in locale, è possibile configurare una connessione VPN per permettere l'accesso dall'OMS al Management Agent. Per ulteriori informazioni, consulta l'articolo relativo a [Un'istanza database in un VPC a cui accede un'applicazione client tramite Internet](USER_VPC.Scenarios.md#USER_VPC.Scenario4) o alle [connessioni VPN](https://docs.aws.amazon.com/vpc/latest/userguide/vpn-connections.html). 
+ Per connettere OEM Management Agent versione 13.5.0.0 (v1-v3) a un host OMS 24.1, imposta `MINIMUM_TLS_VERSION` per l’utilizzo del protocollo `TLSv1.2` nelle opzioni di configurazione.

## Limitazioni per Management Agent
<a name="Oracle.Options.OEMAgent.limitations"></a>

Di seguito sono riportate alcune delle limitazioni all’utilizzo di Management Agent: 
+ Non è possibile fornire immagini personalizzate di Oracle Management Agent.
+ Le attività amministrative come l'esecuzione dei processi e l'applicazione di patch ai database, che richiedono credenziali host, non sono supportate. 
+ Non è garantito che i parametri host e l'elenco di processi riflettano lo stato reale del sistema. Pertanto, non è consigliabile utilizzare OEM per monitorare il file system radice o il file system del punto di montaggio. Per ulteriori informazioni sul monitoraggio del sistema operativo, vedere [Monitoraggio dei parametri del sistema operativo con il monitoraggio avanzato](USER_Monitoring.OS.md).
+ L'individuazione automatica non è supportata. È necessario aggiungere manualmente le destinazioni dei database. 
+ La disponibilità dei moduli OMS dipende dall'edizione del database. Ad esempio, la diagnosi delle prestazioni del database e il modulo di ottimizzazione sono disponibili solo per Oracle Database Enterprise Edition. 
+ Management Agent consuma memoria e risorse di calcolo ulteriori. Se hai problemi di prestazioni dopo aver abilitato l'opzione `OEM_AGENT`, ti consigliamo di aumentare a una classe di istanza database più ampia. Per ulteriori informazioni, consulta [Classi di istanze DB ](Concepts.DBInstanceClass.md) e [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md). 
+ L'utente che esegue il comando `OEM_AGENT` sull’host Amazon RDS non dispone dell'accesso al sistema operativo al log di avvisi. Pertanto, non è possibile raccogliere parametri per `DB Alert Log` e `DB Alert Log Error Status` in OEM.

## Impostazioni dell'opzione per Management Agent
<a name="Oracle.Options.OEMAgent.Options"></a>

Amazon RDS supporta le seguenti impostazioni per l'opzione Management Agent.


| Impostazione opzioni | Campo obbligatorio | Valori validi | Descrizione | 
| --- | --- | --- | --- | 
|  **Version** (`AGENT_VERSION`)  |  Sì  |  `13.5.0.0.v3` `13.5.0.0.v2` `13.5.0.0.v1` `13.4.0.9.v2` `13.4.0.9.v1` `13.3.0.0.v2` `13.3.0.0.v1` `13.2.0.0.v3` `13.2.0.0.v2` `13.2.0.0.v1` `13.1.0.0.v1`  |  La versione del software Management Agent. La versione minima supportata è la `13.1.0.0.v1`. Il nome dell' AWS CLI opzione è`OptionVersion`.  Nelle AWS GovCloud (US) regioni, le versioni 13.1 non sono disponibili.   | 
|  **Porta** (`AGENT_PORT`)  |  Sì  |  Un valore intero.  |  La porta dell'istanza database in ascolto dell'host OMS. Il valore predefinito è 3872. L'host OMS deve appartenere a un gruppo di sicurezza che ha accesso a questa porta.  Il nome dell' AWS CLI opzione è`Port`.  | 
|  **Gruppi di sicurezza**  |  Sì  |  Gruppi di sicurezza esistenti  |  Un gruppo di sicurezza che ha accesso a **Port (Porta)**. L'host OMS deve appartenere a questo gruppo di sicurezza.  Il nome dell' AWS CLI opzione è `VpcSecurityGroupMemberships` o`DBSecurityGroupMemberships`.  | 
|  **OMS\$1HOST**  |  Sì  |  Un valore di stringa, ad esempio *my.example.oms*   |  Il nome host accessibile pubblicamente o l'indirizzo IP dell'OMS.  Il nome dell' AWS CLI opzione è`OMS_HOST`.  | 
|  **OMS\$1PORT**  |  Sì  |  Un valore intero.  |  La porta di caricamento HTTPS sull'host OMS che è in ascolto del Management Agent.  Per determinare la porta di caricamento HTTPS, effettuare la connessione all'host OMS ed eseguire il seguente comando (che richiede la password di `SYSMAN`): emctl status oms -details  Il nome dell' AWS CLI opzione è`OMS_PORT`.  | 
|  **AGENT\$1REGISTRATION\$1PASSWORD**  |  Sì  |  Un valore di stringa.  |  La password utilizzata dal Management Agent per effettuare l'autenticazione con l'OMS. Consigliamo di creare una password persistente sull'OMS prima di abilitare l'opzione `OEM_AGENT`. Con una password persistente, è possibile condividere un singolo gruppo di opzioni di Management Agent con più database Amazon RDS.  Il nome dell' AWS CLI opzione è`AGENT_REGISTRATION_PASSWORD`.  | 
|  **ALLOW\$1TLS\$1ONLY**  |  No  |  `true`, `false` (default)  |  Un valore che configura l'agente OEM per supportare solo il protocollo `TLSv1` mentre l'agente è in ascolto come un server. Questa impostazione non è più supportata. Le versioni 13.1.0.0.v1 e successive di Management Agent supportano la tecnologia Transport Layer Security (TLS) per impostazione predefinita.   | 
|  **MINIMUM\$1TLS\$1VERSION**  |  No  |  `TLSv1` (default), `TLSv1.2`  |  Una valore che specifica la versione TLS minima supportata dall'agente OEM mentre l'agente è in ascolto come un server. Per le versioni dell’agente non supportate, è consentita solo l’impostazione `TLSv1`. Per connettere 13.5.0.0 (v1-v3) a un host OMS 24.1, imposta questa opzione su `TLSv1.2`.  | 
|  **TLS\$1CIPHER\$1SUITE**  |  No  |  Per informazioni, consulta [Impostazioni dell'opzione per Management Agent](#Oracle.Options.OEMAgent.Options).  |  Un valore che specifica la suite di cifratura TLS utilizzata dall'agente OEM mentre l'agente è in ascolto come un server.   | 

La tabella seguente elenca le suite di crittografia TLS supportate dall'opzione Management Agent.


| Suite di cifratura | Versione Agent supportata | Conformità agli standard FedRAMP | 
| --- | --- | --- | 
| TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | Tutti | No | 
| TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 | 13.1.0.0.v1 e versioni successive | No | 
| TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 e versioni successive | No | 
| TLS\$1RSA\$1CON\$1AES\$1256\$1CBC\$1 SHA256 | 13.2.0.0.v3 e versioni successive | No | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | 13.2.0.0.v3 e versioni successive | Sì | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 e versioni successive | Sì | 
| TLS\$1ECDHE\$1RSA\$1CON\$1AES\$1128\$1CBC\$1 SHA256 | 13.2.0.0.v3 e versioni successive | Sì | 
| TLS\$1ECDHE\$1RSA\$1CON\$1AES\$1256\$1CBC\$1 SHA384 | 13.2.0.0.v3 e versioni successive | Sì | 
| TLS\$1ECDHE\$1ECDSA\$1CON\$1AES\$1256\$1GCM\$1 SHA384 | 13.4.0.9.v1 e versioni successive | Sì | 
| TLS\$1ECDHE\$1ECDSA\$1CON\$1AES\$1256\$1CBC\$1 SHA384 | 13.4.0.9.v1 e versioni successive | Sì | 

### Compatibilità dei certificati con le suite di crittografia
<a name="Oracle.Options.OEMAgent.CertificateCompatibility"></a>

RDS per Oracle supporta i certificati RSA ed Elliptic Curve Digital Signature Algorithm (ECDSA). Quando configuri l’opzione OEM Agent per l’istanza database, devi assicurarti che le suite di crittografia specificate nell’impostazione dell’opzione `TLS_CIPHER_SUITE` siano compatibili con il tipo di certificato utilizzato dall’istanza database.

Nella tabella seguente è illustrata la compatibilità tra i tipi di certificato e le suite di crittografia:


| Tipo di certificato | Suite di crittografia compatibili | Suite di crittografia incompatibili | 
| --- | --- | --- | 
| Certificati RSA (rds-ca-2019, 2048-g1, 4096-g1) rds-ca-rsa rds-ca-rsa |  TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1CON\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1CON\$1AES\$1256\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1CON\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1CON\$1AES\$1256\$1CBC\$1 SHA384  |  TLS\$1ECDHE\$1ECDSA\$1CON\$1AES\$1256\$1GCM\$1 SHA384 TLS\$1ECDHE\$1ECDSA\$1CON\$1AES\$1256\$1CBC\$1 SHA384  | 
| Certificati ECDSA (384-g1) rds-ca-ecc |  TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1 SHA384 TLS\$1ECDHE\$1ECDSA\$1CON\$1AES\$1256\$1CBC\$1 SHA384  |  TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1CON\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1CON\$1AES\$1256\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1CON\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1CON\$1AES\$1256\$1CBC\$1 SHA384  | 

Quando specifichi una suite di crittografia nell’impostazione dell’opzione `TLS_CIPHER_SUITE`, assicurati che sia compatibile con il tipo di certificato utilizzato dall’istanza database. Se tenti di associare un gruppo di opzioni a un’opzione OEM Agent che contiene una suite di crittografia incompatibile con il tipo di certificato di un’istanza database, l’operazione avrà esito negativo e verrà visualizzato un messaggio di errore per segnalare l’incompatibilità.

## Abilitazione dell’opzione Management Agent per l’istanza database
<a name="Oracle.Options.OEMAgent.Enable"></a>

Per abilitare l’opzione Management Agent, utilizza la procedura seguente:

**Topics**
+ [Fase 1: aggiungere l’opzione Management Agent a un’istanza database](#Oracle.Options.OEMAgent.Add)
+ [Fase 2: sbloccare l’account utente DBSNMP](#Oracle.Options.OEMAgent.DBSNMP)
+ [Fase 3: aggiungere le destinazioni alla console di Management Agent](#Oracle.Options.OEMAgent.Using)

### Fase 1: aggiungere l’opzione Management Agent a un’istanza database
<a name="Oracle.Options.OEMAgent.Add"></a>

Per aggiungere l’opzione Management Agent all’istanza database, procedi nel seguente modo:

1. Creare un nuovo gruppo di opzioni oppure copiare o modificare un gruppo di opzioni esistente.

1. Aggiungere l'opzione al gruppo di opzioni.

1. Associare il gruppo di opzioni a questa istanza database.

Se riscontri errori, puoi consultare i documenti di [My Oracle Support](https://support.oracle.com/) per informazioni sulla risoluzione di problemi specifici.

Dopo aver aggiunto l'opzione Management Agent, non è necessario riavviare l'istanza database. Non appena il gruppo di opzioni è attivo, è attivo anche l'agente OEM. 

Se l'host OMS utilizza un certificato di terze parti non attendibile, Amazon RDS restituisce il seguente errore.

```
You successfully installed the OEM_AGENT option. Your OMS host is using an untrusted third party certificate. 
Configure your OMS host with the trusted certificates from your third party.
```

Se viene restituito questo errore, l'opzione Management Agent non è abilitata finché il problema non viene corretto. Per informazioni sulla correzione del problema, consulta il documento di supporto My Oracle [2202569.1](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2202569.1).

#### Console
<a name="Oracle.Options.OEMAgent.Add.Console"></a>

**Per aggiungere l’opzione Management Agent all’istanza database**

1. Determinare il gruppo di opzioni che si desidera usare. È possibile creare un nuovo gruppo di opzioni oppure usare un gruppo di opzioni esistente. Se si desidera usare un gruppo di opzioni esistente, puoi passare alla fase successiva. In caso contrario, creare un gruppo di opzioni database personalizzato con le seguenti impostazioni: 

   1. Per **Engine (Motore)** scegliere l'edizione Oracle per l'istanza database. 

   1. In **Major engine version (Versione principale del motore)**, scegliere la versione dell'istanza database. 

   Per ulteriori informazioni, consulta [Creazione di un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. Aggiungere l'opzione **OEM\$1AGENT (OEM\$1AGENT)** al gruppo di opzioni e configurare le impostazioni di opzione. Per ulteriori informazioni sull'aggiunta di opzioni, consulta [Aggiunta di un'opzione a un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Per ulteriori informazioni su ciascuna impostazione, consulta [Impostazioni dell'opzione per Management Agent](#Oracle.Options.OEMAgent.Options). 

1. Applicare il gruppo di opzioni a un'istanza database nuova o esistente: 
   + Per una nuova istanza database, si applica il gruppo di opzioni quando viene avviata l'istanza. Per ulteriori informazioni, consulta [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md). 
   + Per un'istanza database esistente, viene applicato il gruppo di opzioni modificando l'istanza e collegando il nuovo gruppo di opzioni. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md). 

#### AWS CLI
<a name="Oracle.Options.OEMAgent.Add.CLI"></a>

[L'esempio seguente utilizza il comando -group per aggiungere l'opzione a un gruppo di opzioni chiamato. AWS CLI add-option-to-option](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) `OEM_AGENT` `myoptiongroup` 

Per Linux, macOS o Unix:

```
aws rds add-option-to-option-group \
    --option-group-name "myoptiongroup" \
    --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] \
    --apply-immediately
```

Per Windows:

```
aws rds add-option-to-option-group ^
    --option-group-name "myoptiongroup" ^
    --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] ^
    --apply-immediately
```

### Fase 2: sbloccare l’account utente DBSNMP
<a name="Oracle.Options.OEMAgent.DBSNMP"></a>

Management Agent utilizza l’account utente `DBSNMP` per connettersi al database e segnalare i problemi a Oracle Enterprise Manager. In un CDB, `DBSNMP` è un utente comune. Questo account utente è necessario sia per Management Agent sia per OEM Database Express. Per impostazione predefinita, questo account è bloccato. La procedura per sbloccare questo account varia a seconda che il database utilizzi l’architettura non CDB o CDB.

**Per sbloccare l’account utente DBSNMP**

1. In SQL\$1Plus o in un’altra applicazione Oracle SQL, accedi come utente master all’istanza database.

1. A seconda dell’architettura del database, effettua una delle seguenti azioni:  
**Il database è un database non CDB.**  
Esegui la seguente istruzione SQL:  

   ```
   1. ALTER USER dbsnmp IDENTIFIED BY new_password ACCOUNT UNLOCK;
   ```  
**Il database è un CDB.**  
Esegui la seguente stored procedure per sbloccare l’account `DBSNMP`:  

   ```
   1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password');
   ```
Se viene visualizzato un errore per segnalare che la procedura non esiste, riavvia l’istanza CDB per installarla automaticamente. Per ulteriori informazioni, consulta [Riavvio di un'istanza DB DB](USER_RebootInstance.md).

### Fase 3: aggiungere le destinazioni alla console di Management Agent
<a name="Oracle.Options.OEMAgent.Using"></a>

Per aggiungere un’istanza database come destinazione, assicurati di conoscere l’endpoint e la porta. Per informazioni su come trovare l’endpoint per l’istanza database Amazon RDS, consulta [Esito dell'endpoint dell'istanza database RDS per Oracle](USER_Endpoint.md). Se il database utilizza l’architettura CDB, aggiungi il container `CDB$ROOT` separatamente come destinazione.

**Per aggiungere le destinazioni alla console di Management Agent**

1. Nella console OMS, selezionare **Setup (Configurazione)**, **Add Target (Aggiungi destinazione)**, **Add Targets Manually (Aggiungi manualmente destinazioni)**. 

1. Scegliere **Add Targets Declaratively by Specifying Target Monitoring Properties (Aggiungi destinazioni in modo dichiarativo specificando le proprietà di monitoraggio della destinazione)**.

1. Per **Target Type (Tipo di destinazione)**, scegliere **Database Instance (Istanza database)**.

1. Per **Monitoring Agent (Agente di monitoraggio)** scegliere l'agente con l'ID uguale all'identificatore istanze DB di RDS. 

1. Scegliere **Add Manually (Aggiungi manualmente)**.

1. Inserire l’endpoint per l’istanza database Amazon RDS o selezionarlo dall’elenco di nomi host. Verificare che il nome dell'host specificato corrisponda all'endpoint dell'istanza database Amazon RDS.

1. Specificare le seguenti proprietà del database:
   + Immettere un nome in **Target Name (Nome destinazione)**. 
   + Immettere un nome in **Database system name (Nome del sistema di database)**.
   + Immettere **dbsnmp** in **Monitor username (Nome utente monitoraggio)**. 
   + In **Password monitoraggio**, immettere la password da [Fase 2: sbloccare l’account utente DBSNMP](#Oracle.Options.OEMAgent.DBSNMP). 
   + In **Role (Ruolo)** immettere **normal (normale)**. 
   + In **Oracle home path (Percorso home di Oracle)** immettere **/oracle**. 
   + Per **Listener Machine name (Nome macchina listener)**, viene già visualizzato l'identificatore dell'agente. 
   + In **Port (Porta)** immettere la porta del database. La porta RDS predefinita è 1521. 
   + In **Database name (Nome del database)** immettere il nome del database. Se il database è un CDB, il nome è `RDSCDB`. 

1. Scegliere **Test Connection (Connessione di prova)**. 

1. Scegli **Next (Successivo)**. Il database di destinazione viene visualizzato nell'elenco di risorse monitorate. 

## Rimozione dell'opzione Management Agent
<a name="Oracle.Options.OEMAgent.Remove"></a>

È possibile rimuovere l'OEM Agent dall'istanza database. Dopo aver rimosso l'opzione OEM Agent, non è necessario riavviare la tua istanza database. 

Per rimuovere l'OEM Agent dall'istanza database, procedere in uno dei seguenti modi: 
+ Rimuovere l'opzione OEM Agent dal gruppo di opzioni a cui appartiene. Questa modifica coinvolge tutte le istanze database che usano il gruppo di opzioni. Per ulteriori informazioni, consulta [Rimozione di un'opzione da un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). 
+ Modificare l'istanza database e specificare un diverso gruppo di opzioni che non comprenda l'opzione OEM Agent. Questa modifica coinvolge una singola istanza database. È possibile specificare il gruppo di opzioni predefinito (vuoto) o un gruppo di opzioni personalizzato diverso. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md). 

## Esecuzione delle attività di database con Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks"></a>

Puoi utilizzare le procedure Amazon RDS per eseguire alcuni comandi EMCTL in Management Agent. Con queste procedure, puoi eseguire le attività elencate di seguito.

**Nota**  
Le attività vengono eseguite in modo asincrono.

**Topics**
+ [Protezione di Management Agent](#Oracle.Options.OEMAgent.DBTasks.SecureAgent)
+ [Ottenere lo stato del Management Agent](#Oracle.Options.OEMAgent.DBTasks.GetAgentStatus)
+ [Riavvio di Management Agent](#Oracle.Options.OEMAgent.DBTasks.RestartAgent)
+ [Elenco delle destinazioni monitorate da Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListTargets)
+ [Elenco dei thread di raccolta monitorati da Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads)
+ [Cancellazione dello stato di Management Agent](#Oracle.Options.OEMAgent.DBTasks.ClearState)
+ [Configurazione di Management Agent per il caricamento automatico del proprio OMS](#Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS)
+ [Ping dell'OMS](#Oracle.Options.OEMAgent.DBTasks.PingOMS)
+ [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus)

### Protezione di Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.SecureAgent"></a>

Per proteggere Management Agent, esegui la procedura di Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent`. Questa procedura equivale al comando `emctl secure agent`.

La procedura seguente crea un’attività per proteggere Management Agent e restituisce l’ID dell’attività:

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent as TASK_ID from DUAL;
```

Per visualizzare il file di output dell’attività ed esaminare il risultato, consulta [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Ottenere lo stato del Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.GetAgentStatus"></a>

Per ottenere lo stato del Management Agent, eseguire la Amazon RDS procedura `rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent`. Questa procedura equivale al comando `emctl status agent`.

La procedura seguente crea un'attività per ottenere lo stato del Management Agent e restituisce l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent() as TASK_ID from DUAL;
```

Per visualizzare il file di output dell’attività ed esaminare il risultato, consulta [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Riavvio di Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.RestartAgent"></a>

Per riavviare Management Agent, esegui la procedura di Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent`. Questa procedura equivale ai comandi `emctl stop agent` e `emctl start agent`.

La procedura seguente crea un'attività per riavviare Management Agent e restituisce l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL;    
```

Per visualizzare il file di output dell’attività ed esaminare il risultato, consulta [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Elenco delle destinazioni monitorate da Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ListTargets"></a>

Per elencare le destinazioni monitorate da Management Agent, esegui la procedura di Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent`. Questa procedura equivale al comando `emctl config agent listtargets`.

La procedura seguente crea un'attività per elencare le destinazioni monitorate dal Management Agent e restituisce l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL;
```

Per visualizzare il file di output dell’attività ed esaminare il risultato, consulta [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Elenco dei thread di raccolta monitorati da Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads"></a>

Per elencare tutti i thread di raccolta in esecuzione, pronti e pianificati monitorati dal Management Agent, esegui la procedura Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent`. Questa procedura equivale al comando `emctl status agent scheduler`.

La procedura seguente crea un'attività per elencare i thread di raccolta e restituisce l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent() as TASK_ID from DUAL;          
```

Per visualizzare il file di output dell’attività ed esaminare il risultato, consulta [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Cancellazione dello stato di Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ClearState"></a>

Per cancellare lo stato di Management Agent, esegui la procedura di Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent`. Questa procedura equivale al comando `emctl clearstate agent`.

La procedura seguente crea un'attività che cancella lo stato del Management Agent e restituisce l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent() as TASK_ID from DUAL;
```

Per visualizzare il file di output dell’attività ed esaminare il risultato, consulta [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Configurazione di Management Agent per il caricamento automatico del proprio OMS
<a name="Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS"></a>

Per configurare Management Agent in modo che carichi Oracle Management Server (OMS) a cui è associato, esegui la procedura di Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent`. Questa procedura equivale al comando `emclt upload agent`.

Nella procedura seguente viene creata un'attività in cui Management Agent carica l'OMS associato e restituisce l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent() as TASK_ID from DUAL;
```

Per visualizzare il file di output dell’attività ed esaminare il risultato, consulta [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Ping dell'OMS
<a name="Oracle.Options.OEMAgent.DBTasks.PingOMS"></a>

Per eseguire il ping dell'OMS di Management Agent, esegui la procedura di Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent`. Questa procedura equivale al comando `emctl pingOMS`.

Nella procedura seguente viene creata un'attività che esegue il ping dell'OMS del Management Agent e restituisce l'ID dell'attività.

```
SELECT rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent() as TASK_ID from DUAL;
```

Per visualizzare il file di output dell’attività ed esaminare il risultato, consulta [Visualizzazione dello stato di un'attività in corso](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Visualizzazione dello stato di un'attività in corso
<a name="Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus"></a>

È possibile visualizzare lo stato di un'attività in corso in un file bdump. I file bdump si trovano nella directory `/rdsdbdata/log/trace`. Il nome del file bdump ha il formato che segue.

```
dbtask-task-id.log 
```

Per monitorare un'attività, sostituisci `task-id` con l'ID di tale attività.

Per visualizzare i contenuti dei file bdump, esegui la procedura di Amazon RDS `rdsadmin.rds_file_util.read_text_file`. La query seguente restituisce i contenuti del file bdump `dbtask-1546988886389-2444.log`. 

```
SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-1546988886389-2444.log'));
```

Per ulteriori informazioni sulla procedura `rdsadmin.rds_file_util.read_text_file` di Amazon RDS, consulta [Lettura dei file in una directory di istanze database](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles).