

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Amazon RDS mendukung Oracle Enterprise Manager (OEM). OEMadalah lini produk Oracle untuk manajemen terintegrasi teknologi informasi perusahaan. 

OEMAmazon RDS mendukung Oracle Database 19c non- CDBs atau. CDBs Tabel berikut menjelaskan OEM opsi yang didukung.


****  

| Opsi | ID Opsi | OEMRilis yang didukung | 
| --- | --- | --- | 
|  [OEM Database Express](Appendix.Oracle.Options.OEM_DBControl.md)  |  `OEM`  |  OEMDatabase Ekspres 19c  | 
|  [OEM Management Agent](Oracle.Options.OEMAgent.md)  |  `OEM_AGENT`  |  OEMCloud Control untuk 13c  | 

**catatan**  
Anda dapat menggunakan OEM Database atau Agen OEM Manajemen, tetapi tidak keduanya.

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

Amazon RDS mendukung Oracle Enterprise Manager Database Express (EM Express) melalui penggunaan opsi OEM. Amazon RDS mendukung EM Express untuk Oracle Database 19c menggunakan arsitektur CDB atau non-CDB.

EM Express adalah alat manajemen basis data berbasis web yang disertakan dalam database Anda dan hanya tersedia saat terbuka. Ini mendukung manajemen kinerja utama dan fungsi administrasi basis data dasar. Untuk informasi selengkapnya, lihat [Pengantar 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) dalam dokumentasi Oracle Database.

**catatan**  
EM Express tidak didukung pada kelas instans db.t3.small DB. Untuk informasi selengkapnya tentang kelas instans DB, lihat [RDS untuk kelas instans Oracle DB](Oracle.Concepts.InstanceClasses.md).

## Pengaturan opsi OEM
<a name="Appendix.Oracle.Options.OEM_DBControl.Options"></a>

Amazon RDS mendukung pengaturan berikut untuk opsi OEM. 


****  

| Pengaturan opsi | Nilai valid | Deskripsi | 
| --- | --- | --- | 
| **Port** | Nilai bilangan bulat |  Port pada instans RDS untuk Oracle DB yang mendengarkan EM Express. Defaultnya adalah 5500.  | 
| **Grup Keamanan** | — |  Grup keamanan yang memiliki akses ke **Port**.   | 

## Langkah 1: Menambahkan opsi OEM
<a name="Appendix.Oracle.Options.OEM_DBControl.Add"></a>

Proses umum untuk menambahkan opsi OEM ke instans DB adalah sebagai berikut: 

1. Buat grup opsi baru, atau salin atau ubah grup opsi yang ada.

1. Tambahkan opsi ke grup opsi.

1. Kaitkan grup opsi dengan instans DB Anda.

Saat Anda menambahkan opsi OEM, pemadaman singkat terjadi saat instans DB Anda dimulai ulang secara otomatis. 

**Untuk menambahkan opsi OEM ke instans DB**

1. Tentukan grup opsi yang ingin Anda gunakan. Anda dapat membuat grup opsi baru atau menggunakan grup opsi yang ada. Jika Anda ingin menggunakan grup opsi yang ada, lanjutkan ke langkah berikutnya. Jika tidak, buat grup opsi DB kustom dengan pengaturan berikut: 

   1. Untuk **Mesin** pilih edisi Oracle untuk instans DB Anda. 

   1. Untuk **Versi mesin utama**, pilih versi instans DB Anda. 

   Untuk informasi lebih lanjut, lihat [Membuat grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. Tambahkan opsi OEM ke grup opsi dan konfigurasikan pengaturan opsi. Untuk informasi selengkapnya tentang cara menambahkan opsi, lihat [Menambahkan opsi ke grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Untuk informasi selengkapnya tentang setiap pengaturan, lihat [Pengaturan opsi OEM](#Appendix.Oracle.Options.OEM_DBControl.Options). 
**catatan**  
Jika Anda menambahkan opsi OEM ke grup opsi yang ada yang sudah dilampirkan ke satu atau beberapa instans DB, pemadaman singkat terjadi sementara semua instans DB dimulai ulang secara otomatis. 

1. Terapkan grup opsi ke instans DB baru atau yang sudah ada:
   + Untuk instans DB baru, terapkan grup opsi saat Anda meluncurkan instans. Untuk informasi lebih lanjut, lihat [Membuat instans DB Amazon RDS](USER_CreateDBInstance.md). 
   + Untuk instans DB yang sudah ada, terapkan grup opsi dengan memodifikasi instans dan menambahkan grup opsi baru. Saat Anda menambahkan opsi OEM, pemadaman singkat terjadi saat instans DB Anda dimulai ulang secara otomatis. Untuk informasi selengkapnya, lihat [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). 

**catatan**  
Anda juga dapat menggunakan AWS CLI untuk menambahkan opsi OEM. Sebagai contoh, lihat [Menambahkan opsi ke grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).

## Langkah 2: (Hanya CDB) Membuka kunci akun pengguna DBSNMP
<a name="Appendix.Oracle.Options.OEM_DBControl.DBSNMP"></a>

Jika instans DB Anda menggunakan arsitektur CDB, Anda harus masuk ke EM Express sebagai`DBSNMP`. dalam CDB, `DBSNMP` adalah pengguna umum. Secara default, akun ini terkunci. Jika instans DB Anda tidak menggunakan arsitektur CDB, lewati langkah ini.

**Untuk membuka kunci akun pengguna DBSNMP dalam instance CDB**

1. Di SQL\$1 Plus atau aplikasi Oracle SQL lainnya, masuk ke instans DB Anda sebagai pengguna utama Anda.

1. Jalankan prosedur tersimpan berikut untuk membuka kunci `DBSNMP` akun:

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

   Jika Anda menerima kesalahan yang menyatakan bahwa prosedur tidak ada, reboot instance CDB Anda untuk menginstalnya secara otomatis. Untuk informasi selengkapnya, lihat [Mem-boot ulang instans DB DB](USER_RebootInstance.md).

## Langkah 3: Mengakses EM Express melalui browser Anda
<a name="Appendix.Oracle.Options.OEM_DBControl.Using"></a>

Ketika Anda mengakses EM Express dari browser web Anda, jendela login muncul yang meminta Anda untuk nama pengguna dan kata sandi.

**Untuk mengakses EM Express melalui browser Anda**

1. Identifikasi titik akhir dan port EM Express untuk instans Amazon RDS DB Anda. Untuk informasi tentang cara menemukan titik akhir untuk instans DB Amazon RDS Anda, lihat [Menemukan titik akhir instans DB RDS for Oracle](USER_Endpoint.md).

1. Masukkan URL di bilah pencari browser Anda menggunakan format berikut. 

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

   Misalnya, jika titik akhir untuk instans Amazon RDS DB Anda`mydb.a1bcde234fgh.us-east-1.rds.amazonaws.com`, dan port EM Express Anda`1158`, gunakan URL berikut untuk mengakses EM Express.

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

1. Ketika diminta untuk rincian login Anda, lakukan salah satu tindakan berikut, tergantung pada arsitektur database Anda:  
**Database Anda adalah non-CDB.**  
Ketikkan nama pengguna master dan kata sandi master untuk instans DB Anda.  
**Database Anda adalah CDB.**  
Masukkan `DBSNMP` untuk pengguna dan `DBSNMP` kata sandi. Biarkan `Container` bidang kosong.

## Mengubah pengaturan OEM Database
<a name="Appendix.Oracle.Options.OEM_DBControl.ModifySettings"></a>

Setelah Anda mengaktifkan OEM Database, Anda dapat mengubah pengaturan Grup Keamanan untuk opsi tersebut. 

Anda tidak dapat mengubah nomor port OEM setelah Anda mengaitkan grup opsi dengan instans DB. Untuk mengubah nomor port OEM untuk instans DB, lakukan hal berikut: 

1. Buat grup opsi baru.

1. Tambahkan opsi OEM dengan nomor port baru ke grup opsi baru. 

1. Hapus grup opsi yang ada dari instans DB.

1. Tambahkan grup opsi baru ke instans DB.

Untuk informasi selengkapnya tentang cara mengubah pengaturan opsi, lihat [Memodifikasi pengaturan opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.ModifyOption). Untuk informasi selengkapnya tentang setiap pengaturan, lihat [Pengaturan opsi OEM](#Appendix.Oracle.Options.OEM_DBControl.Options). 

## Menjalankan tugas OEM Database Express
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks"></a>

Anda dapat menggunakan prosedur Amazon RDS untuk menjalankan tugas OEM Database Express tertentu. Dengan menjalankan prosedur ini, Anda dapat melakukan tugas berikut.

**catatan**  
Tugas OEM Database Express berjalan secara asinkron.

**Topics**
+ [Mengalihkan frontend situs web untuk OEM Database Express ke Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash)
+ [Mengalihkan frontend situs web untuk OEM Database Express ke Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET)

### Mengalihkan frontend situs web untuk OEM Database Express ke Adobe Flash
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash"></a>

**catatan**  
Tugas ini hanya tersedia untuk Oracle Database 19c non-. CDBs

Dimulai dengan Oracle Database 19c, Oracle tidak lagi menggunakan antarmuka pengguna OEM Database Express lama, yang didasarkan pada Adobe Flash. Sebagai gantinya, OEM Database Express sekarang menggunakan antarmuka yang dibangun dengan Oracle JET. Jika Anda mengalami kesulitan dengan antarmuka baru ini, Anda dapat beralih kembali ke antarmuka berbasis Flash yang sudah tidak digunakan lagi. Kesulitan yang mungkin Anda alami dengan antarmuka baru termasuk mengalami macet di layar `Loading` setelah masuk ke OEM Database Express. Anda mungkin juga tidak mendapati fitur tertentu yang ada di versi berbasis Flash dari OEM Database Express.

Untuk mengalihkan frontend situs web OEM Database Express ke Adobe Flash, jalankan prosedur `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash` Amazon RDS. Prosedur ini setara dengan perintah SQL `execemx emx`.

Praktik terbaik keamanan mencegah penggunaan Adobe Flash. Meskipun Anda dapat kembali ke OEM Database Express berbasis Flash, kami merekomendasikan penggunaan situs web OEM Database Express berbasis JET jika memungkinkan. Jika Anda kembali menggunakan Adobe Flash dan ingin beralih kembali menggunakan Oracle JET, gunakan prosedur `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Setelah peningkatan basis data Oracle, versi terbaru dari Oracle JET mungkin dapat menyelesaikan masalah terkait JET di OEM Database Express. Untuk informasi lebih lanjut tentang cara beralih ke Oracle JET, lihat [Mengalihkan frontend situs web untuk OEM Database Express ke Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET).

**catatan**  
Menjalankan tugas ini dari instans DB sumber untuk replika baca juga menyebabkan replika baca mengalihkan frontend situs web OEM Database Express ke Adobe Flash.

Invokasi prosedur berikut membuat tugas untuk mengalihkan situs web OEM Database Express ke Adobe Flash dan menampilkan ID tugas.

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

Anda dapat melihat hasilnya dengan menampilkan file output tugas.

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

Ganti *`task-id`* dengan ID tugas yang ditampilkan oleh prosedur. Untuk informasi lebih lanjut tentang prosedur `rdsadmin.rds_file_util.read_text_file` Amazon RDS, lihat [Membaca file di direktori instans DB](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 

Anda juga dapat melihat isi file output tugas di Konsol Manajemen AWS dengan mencari entri log di bagian **Log & peristiwa** untuk. `task-id`

### Mengalihkan frontend situs web untuk OEM Database Express ke Oracle JET
<a name="Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET"></a>

**catatan**  
Tugas ini hanya tersedia untuk Oracle Database 19c non-. CDBs

Untuk mengalihkan frontend situs web OEM Database Express ke Oracle JET, jalankan prosedur `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet` Amazon RDS. Prosedur ini setara dengan perintah SQL `execemx omx`.

Secara default, situs web OEM Database Express untuk instans DB Oracle yang menjalankan 19c atau versi yang lebih baru menggunakan Oracle JET. Jika Anda telah menggunakan prosedur `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash` untuk mengalihkan frontend situs web OEM Database Express ke Adobe Flash, Anda dapat beralih kembali ke Oracle JET. Untuk melakukan ini, gunakan prosedur `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Untuk informasi lebih lanjut tentang cara beralih ke Adobe Flash, lihat [Mengalihkan frontend situs web untuk OEM Database Express ke Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash).

**catatan**  
Menjalankan tugas ini dari instans DB sumber untuk replika baca juga menyebabkan replika baca mengalihkan frontend situs web OEM Database Express ke Oracle JET.

Invokasi prosedur berikut membuat tugas untuk mengalihkan situs web OEM Database Express ke Oracle JET dan menampilkan ID tugas tersebut.

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

Anda dapat melihat hasilnya dengan menampilkan file output tugas.

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

Ganti *`task-id`* dengan ID tugas yang ditampilkan oleh prosedur. Untuk informasi lebih lanjut tentang prosedur `rdsadmin.rds_file_util.read_text_file` Amazon RDS, lihat [Membaca file di direktori instans DB](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 

Anda juga dapat melihat isi file output tugas di Konsol Manajemen AWS dengan mencari entri log di bagian **Log & peristiwa** untuk. `task-id`

## Menghapus opsi OEM Database
<a name="Appendix.Oracle.Options.OEM_DBControl.Remove"></a>

Anda dapat menghapus opsi OEM dari instans DB. Saat Anda menghapus opsi OEM, pemadaman singkat terjadi saat instans Anda dimulai ulang secara otomatis. Oleh karena itu, setelah Anda menghapus opsi OEM, Anda tidak perlu memulai ulang instans DB Anda.

Untuk menghapus opsi OEM dari instans DB, lakukan salah satu hal berikut ini:
+ Hapus opsi OEM dari grup opsi yang mencakupnya. Perubahan ini memengaruhi semua instans DB yang menggunakan grup opsi tersebut. Untuk informasi lebih lanjut, lihat [Menghapus opsi dari grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). 
+ Ubah instans DB dan tentukan grup opsi berbeda yang tidak menyertakan opsi OEM. Perubahan ini memengaruhi instans DB tunggal. Anda dapat menentukan grup opsi default (kosong) atau grup opsi kustom yang berbeda. Untuk informasi selengkapnya, lihat [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). 

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

Oracle Enterprise Manager (OEM) Management Agent adalah komponen perangkat lunak yang memantau target yang berjalan pada host dan mengomunikasikan informasi tersebut ke Oracle Management Service (OMS) tingkat menengah. Amazon RDS mendukung Management Agent melalui penggunaan opsi `OEM_AGENT`. 

Untuk informasi lebih lanjut, lihat [Overview of Oracle Enterprise Manager cloud control 12c](http://docs.oracle.com/cd/E24628_01/doc.121/e25353/overview.htm) dan [Overview of Oracle Enterprise Manager cloud control 13c](http://docs.oracle.com/cd/E63000_01/EMCON/overview.htm#EMCON109) dalam dokumentasi Oracle.

**Topics**
+ [Persyaratan untuk Agen Manajemen](#Oracle.Options.OEMAgent.PreReqs)
+ [Prasyarat komunikasi host OMS](#Oracle.Options.OEMAgent.PreReqs.host)
+ [Batasan untuk Management Agent](#Oracle.Options.OEMAgent.limitations)
+ [Pengaturan opsi untuk Management Agent](#Oracle.Options.OEMAgent.Options)
+ [Mengaktifkan opsi Agen Manajemen untuk instans DB Anda](#Oracle.Options.OEMAgent.Enable)
+ [Menambahkan opsi Management Agent](#Oracle.Options.OEMAgent.Remove)
+ [Melakukan tugas basis data dengan Management Agent](#Oracle.Options.OEMAgent.DBTasks)

## Persyaratan untuk Agen Manajemen
<a name="Oracle.Options.OEMAgent.PreReqs"></a>

Berikut ini adalah persyaratan umum untuk menggunakan Agen Manajemen: 
+ Instans DB Anda harus menjalankan Oracle Database 19c (19.0.0.0). Anda dapat menggunakan arsitektur CDB atau non-CDB.
+ Anda harus menggunakan Oracle Management Service (OMS) yang dikonfigurasi untuk terhubung ke instans DB Anda. Perhatikan persyaratan OMS berikut:
  + Agen Manajemen versi 13.5.0.0.v2 dan 13.5.0.0.v3 memerlukan OMS versi 13.5.0.23 atau 24.1.
  + Agen Manajemen versi 13.5.0.0.v1 membutuhkan OMS versi 13.5.0.0 atau 24.1.
  + Management Agent versi 13.4.0.9.v1 dan 13.4.0.9.v2 memerlukan OMS versi 13.4.0.9 atau yang lebih baru dan patch 32198287.
+ Dalam kebanyakan kasus, Anda harus mengonfigurasi VPC Anda untuk mengizinkan koneksi dari OMS ke instans DB Anda. Jika Anda tidak familier dengan Amazon Virtual Private Cloud (Amazon VPC), kami menyarankan Anda menyelesaikan langkah-langkah di [Tutorial: Buat VPC untuk digunakan dengan ) IPv4](CHAP_Tutorials.WebServerDB.CreateVPC.md) sebelum melanjutkan. 
+ Anda dapat menggunakan Management Agent dengan Oracle Enterprise Manager Cloud Control untuk 12c dan 13c. Pastikan Anda memiliki ruang penyimpanan yang cukup untuk rilis OEM Anda:
  + Setidaknya 8,5 GiB untuk OEM 13c Rilis 5
  + Setidaknya 8,5 GiB untuk OEM 13c Rilis 4
  + Setidaknya 8,5 GiB untuk OEM 13c Rilis 3
  + Setidaknya 5,5 GiB untuk OEM 13c Rilis 2
  + Setidaknya 4,5 GiB untuk OEM 13c Rilis 1
  + Setidaknya 2,5 GiB untuk OEM 12c
+ Jika Anda menggunakan versi Agen Manajemen `OEM_AGENT 13.2.0.0.v3` dan`13.3.0.0.v2`, dan jika Anda ingin menggunakan konektivitas TCPS, ikuti petunjuk dalam [Mengonfigurasi sertifikat CA pihak ketiga untuk komunikasi dengan database target](https://docs.oracle.com/cd/E73210_01/EMSEC/GUID-8337AD48-1A32-4CD5-84F3-256FAE93D043.htm#EMSEC15996) dalam dokumentasi Oracle. Selain itu, perbarui JDK di OMS Anda dengan mengikuti petunjuk di dokumen Oracle, yaitu Oracle Doc ID 2241358.1. Langkah ini memastikan bahwa OMS mendukung semua rangkaian penyandian yang didukung basis data tersebut.
**catatan**  
Konektivitas TCPS antara Management Agent dan instans DB didukung untuk Management Agent `OEM_AGENT 13.2.0.0.v3`, `13.3.0.0.v2`, `13.4.0.9.v1`, dan versi yang lebih tinggi.

## Prasyarat komunikasi host OMS
<a name="Oracle.Options.OEMAgent.PreReqs.host"></a>

Pastikan host OMS dan instans DB Amazon RDS Anda dapat berkomunikasi. Lakukan hal-hal berikut: 
+ Untuk terhubung dari Agen Manajemen ke host OMS Anda ketika host OMS Anda berada di belakang firewall, tambahkan alamat IP instans DB Anda ke firewall. Pastikan firewall untuk OMS memungkinkan lalu lintas jaringan berikut:  
Dari host OMS ke instans DB Anda  
Konfigurasikan aturan firewall satu arah yang memungkinkan lalu lintas dari host OMS ke port pendengar database (default 1521) dan port Agen OEM (default 3872).  
Dari instans DB Anda ke host OMS  
Konfigurasikan aturan firewall satu arah yang memungkinkan lalu lintas dari instans DB ke port HTTP OMS (default 4903).
+ Untuk menyambung dari OMS Anda ke Management Agent, jika OMS Anda memiliki nama host yang dapat diselesaikan secara publik, tambahkan alamat OMS ke grup keamanan. Grup keamanan Anda harus memiliki aturan masuk yang memungkinkan akses ke port pendengar DB dan port Management Agent. Untuk contoh pembuatan keamanan dan menambahkan aturan masuk, lihat [Tutorial: Buat VPC untuk digunakan dengan ) IPv4](CHAP_Tutorials.WebServerDB.CreateVPC.md). 
+ Untuk menyambungkan dari OMS Anda ke Management Agent, jika OMS Anda tidak memiliki nama host yang dapat diselesaikan secara publik, gunakan salah satu dari yang berikut ini: 
  + Jika OMS Anda di-hosting di instans Amazon Elastic Compute Cloud (Amazon EC2) di VPC privat, Anda dapat menyiapkan peering VPC untuk menghubungkan dari OMS ke Management Agent. Untuk informasi lebih lanjut, lihat [Instans DB dalam VPC yang diakses oleh instans EC2 dalam VPC yang sama](USER_VPC.Scenarios.md#USER_VPC.Scenario3). 
  + Jika OMS Anda di-hosting secara on-premise, Anda dapat menyiapkan koneksi VPN untuk mengizinkan akses dari OMS ke Management Agent. Untuk informasi lebih lanjut, lihat [Instans DB dalam VPC yang diakses oleh aplikasi klien melalui internet](USER_VPC.Scenarios.md#USER_VPC.Scenario4) atau [koneksi VPN](https://docs.aws.amazon.com/vpc/latest/userguide/vpn-connections.html). 
+ Untuk menghubungkan Agen Manajemen OEM versi 13.5.0.0 (v1-v3) ke host OMS 24.1, atur `MINIMUM_TLS_VERSION` untuk menggunakan protokol TLS 1.2 di opsi konfigurasi Anda. `TLSv1.2`

## Batasan untuk Management Agent
<a name="Oracle.Options.OEMAgent.limitations"></a>

Berikut adalah beberapa batasan dalam menggunakan Management Agent: 
+ Anda tidak dapat memberikan gambar Agen Manajemen Oracle kustom.
+ Tugas administratif seperti pelaksanaan pekerjaan dan patch basis data, yang memerlukan kredensial host, tidak didukung. 
+ Metrik host dan daftar proses belum tentu mencerminkan status sistem yang sebenarnya. Dengan demikian, Anda tidak boleh menggunakan OEM untuk memantau sistem file root atau sistem file titik pemasangan. Untuk informasi lebih lanjut tentang memantau sistem operasi, lihat [Memantau metrik OS dengan Pemantauan yang Ditingkatkan](USER_Monitoring.OS.md).
+ Penemuan otomatis tidak didukung. Anda harus menambahkan target basis data secara manual. 
+ Ketersediaan modul OMS tergantung pada edisi basis data Anda. Misalnya, modul penyesuaian dan diagnosis performa basis data hanya tersedia untuk Oracle Database Enterprise Edition. 
+ Management Agent menggunakan memori tambahan dan sumber daya komputasi. Jika Anda mengalami masalah performa setelah mengaktifkan opsi `OEM_AGENT`, sebaiknya naikkan skala ke kelas instans DB yang lebih besar. Untuk informasi lebih lanjut, lihat [ DB](Concepts.DBInstanceClass.md) dan [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). 
+ Pengguna yang menjalankan `OEM_AGENT` pada host Amazon RDS tidak memiliki akses sistem operasi ke log peringatan. Dengan demikian, Anda tidak dapat mengumpulkan metrik untuk `DB Alert Log` dan `DB Alert Log Error Status` di OEM.

## Pengaturan opsi untuk Management Agent
<a name="Oracle.Options.OEMAgent.Options"></a>

Amazon RDS mendukung pengaturan berikut untuk opsi Management Agent.


| Pengaturan opsi | Dibutuhkan | Nilai valid | Deskripsi | 
| --- | --- | --- | --- | 
|  **Versi** (`AGENT_VERSION`)  |  Ya  |  `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`  |  Versi perangkat lunak Management Agent. Versi minimum yang didukung adalah`13.1.0.0.v1`. Nama AWS CLI opsinya adalah`OptionVersion`.  Di AWS GovCloud (US) Wilayah, versi 13.1 tidak tersedia.   | 
|  **Port** (`AGENT_PORT`)  |  Ya  |  Nilai integer  |  Port pada instans DB yang mendengarkan host OMS. Default-nya adalah 3872. Host OMS Anda harus tercakup dalam grup keamanan yang memiliki akses ke port ini.  Nama AWS CLI opsinya adalah`Port`.  | 
|  **Grup Keamanan**  |  Ya  |  Grup keamanan yang ada  |  Grup keamanan yang memiliki akses ke **Port**. Host OMS Anda harus tercakup dalam grup keamanan ini.  Nama AWS CLI opsinya adalah `VpcSecurityGroupMemberships` atau`DBSecurityGroupMemberships`.  | 
|  **OMS\$1HOST**  |  Ya  |  Sebuah nilai string, misalnya *my.example.oms*   |  Nama host atau alamat IP OMS yang dapat diakses publik.  Nama AWS CLI opsinya adalah`OMS_HOST`.  | 
|  **OMS\$1PORT**  |  Ya  |  Nilai integer  |  Port upload HTTPS di OMS Host yang mendengarkan Management Agent.  Untuk menentukan port upload HTTPS, sambungkan ke host OMS, dan jalankan perintah berikut (yang memerlukan kata sandi `SYSMAN`): emctl status oms -details  Nama AWS CLI opsinya adalah`OMS_PORT`.  | 
|  **AGENT\$1REGISTRATION\$1PASSWORD**  |  Ya  |  Nilai string.  |  Kata sandi yang digunakan Management Agent untuk mengautentikasi dirinya sendiri dengan OMS. Kami menyarankan Anda untuk membuat kata sandi yang persisten di OMS Anda sebelum mengaktifkan opsi `OEM_AGENT`. Dengan kata sandi yang persisten, Anda dapat berbagi satu grup opsi Management Agent dengan beberapa basis data Amazon RDS.  Nama AWS CLI opsinya adalah`AGENT_REGISTRATION_PASSWORD`.  | 
|  **ALLOW\$1TLS\$1ONLY**  |  Tidak  |  `true`, `false` (default)  |  Nilai yang mengonfigurasi OEM Agent untuk hanya mendukung protokol `TLSv1` saat agen mendengarkan sebagai server. Pengaturan ini tidak lagi didukung. Management Agent versi 13.1.0.0.v1 dan dukungan yang lebih tinggi Transport Layer Security (TLS) secara default.   | 
|  **MINIMUM\$1TLS\$1VERSION**  |  Tidak  |  `TLSv1` (default), `TLSv1.2`  |  Nilai yang menentukan versi TLS minimum yang didukung oleh OEM Agent saat agen mendengarkan sebagai server. Versi agen yang tidak didukung hanya mendukung pengaturan. `TLSv1` Untuk menghubungkan 13.5.0.0 (v1-v3) ke host OMS 24.1, setel ini ke. `TLSv1.2`  | 
|  **TLS\$1CIPHER\$1SUITE**  |  Tidak  |  Lihat [Pengaturan opsi untuk Management Agent](#Oracle.Options.OEMAgent.Options).  |  Nilai yang menentukan rangkaian penyandian TLS yang digunakan oleh OEM Agent saat agen mendengarkan sebagai server.   | 

Tabel berikut mencantumkan rangkaian penyandian TLS yang mendukung opsi Management Agent.


| Rangkaian Penyandian | Versi Agent yang didukung | Sesuai FedRAMP | 
| --- | --- | --- | 
| TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | Semua | Tidak | 
| TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 | 13.1.0.0.v1 dan lebih tinggi | Tidak | 
| TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 dan lebih tinggi | Tidak | 
| TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA256 | 13.2.0.0.v3 dan lebih tinggi | Tidak | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | 13.2.0.0.v3 dan lebih tinggi | Ya | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 dan lebih tinggi | Ya | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 | 13.2.0.0.v3 dan lebih tinggi | Ya | 
| TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | 13.2.0.0.v3 dan lebih tinggi | Ya | 
| TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1 SHA384 | 13.4.0.9.v1 dan lebih tinggi | Ya | 
| TLS\$1ECDHE\$1ECDSA\$1DENGAN\$1AES\$1256\$1CBC\$1 SHA384 | 13.4.0.9.v1 dan lebih tinggi | Ya | 

### Kompatibilitas sertifikat dengan cipher suite
<a name="Oracle.Options.OEMAgent.CertificateCompatibility"></a>

RDS untuk Oracle mendukung sertifikat RSA dan Elliptic Curve Digital Signature Algorithm (ECDSA). Saat Anda mengonfigurasi opsi Agen OEM untuk instans DB Anda, Anda harus memastikan bahwa rangkaian sandi yang Anda tentukan dalam pengaturan `TLS_CIPHER_SUITE` opsi kompatibel dengan jenis sertifikat yang digunakan oleh instans DB Anda.

Tabel berikut menunjukkan kompatibilitas antara jenis sertifikat dan cipher suite:


| Jenis sertifikat | Suite cipher yang kompatibel | Suite cipher yang tidak kompatibel | 
| --- | --- | --- | 
| Sertifikat RSA (rds-ca-2019, 2048-g1, 4096-g1) rds-ca-rsa rds-ca-rsa |  TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384  |  TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1 SHA384 TLS\$1ECDHE\$1ECDSA\$1DENGAN\$1AES\$1256\$1CBC\$1 SHA384  | 
| Sertifikat ECDSA (384-g1) rds-ca-ecc |  TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1 SHA384 TLS\$1ECDHE\$1ECDSA\$1DENGAN\$1AES\$1256\$1CBC\$1 SHA384  |  TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384  | 

Saat Anda menentukan cipher suite dalam pengaturan `TLS_CIPHER_SUITE` opsi, pastikan itu kompatibel dengan jenis sertifikat yang digunakan oleh instans DB Anda. Jika Anda mencoba mengaitkan grup opsi dengan opsi Agen OEM yang berisi rangkaian sandi yang tidak kompatibel dengan jenis sertifikat instans DB, operasi akan gagal dengan pesan kesalahan yang menunjukkan ketidakcocokan.

## Mengaktifkan opsi Agen Manajemen untuk instans DB Anda
<a name="Oracle.Options.OEMAgent.Enable"></a>

Untuk mengaktifkan opsi Agen Manajemen, gunakan langkah-langkah berikut:

**Topics**
+ [Langkah 1: Menambahkan opsi Agen Manajemen ke instans DB Anda](#Oracle.Options.OEMAgent.Add)
+ [Langkah 2: Membuka kunci akun pengguna DBSNMP](#Oracle.Options.OEMAgent.DBSNMP)
+ [Langkah 3: Menambahkan target Anda ke konsol Management Agent](#Oracle.Options.OEMAgent.Using)

### Langkah 1: Menambahkan opsi Agen Manajemen ke instans DB Anda
<a name="Oracle.Options.OEMAgent.Add"></a>

Untuk menambahkan opsi Agen Manajemen ke instans DB Anda, lakukan hal berikut:

1. Buat grup opsi baru, atau salin atau ubah grup opsi yang ada.

1. Tambahkan opsi ke grup opsi.

1. Kaitkan grup opsi tersebut dengan instans DB.

Jika Anda mengalami kesalahan, periksa dokumen [My Oracle Support](https://support.oracle.com/) untuk informasi tentang menyelesaikan masalah tertentu.

Setelah opsi Management Agent ditambahkan, instans DB tidak perlu dimulai ulang. Segera setelah grup opsi aktif, OEM Agent aktif. 

Jika host OMS Anda menggunakan sertifikat pihak ketiga yang tidak tepercaya, Amazon RDS mengembalikan kesalahan berikut.

```
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.
```

Jika kesalahan ini dikembalikan, opsi Management Agent tidak diaktifkan hingga masalah diperbaiki. Untuk informasi tentang memperbaiki masalah tersebut, lihat dokumen My Oracle Support [2202569.1](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2202569.1).

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

**Untuk menambahkan opsi Agen Manajemen ke instans DB Anda**

1. Tentukan grup opsi yang ingin Anda gunakan. Anda dapat membuat grup opsi baru atau menggunakan grup opsi yang ada. Jika Anda ingin menggunakan grup opsi yang ada, lanjutkan ke langkah berikutnya. Jika tidak, buat grup opsi DB kustom dengan pengaturan berikut: 

   1. Untuk **Mesin** pilih edisi Oracle untuk instans DB Anda. 

   1. Untuk **Versi mesin utama**, pilih versi instans DB Anda. 

   Untuk informasi selengkapnya, lihat [Membuat grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. Tambahkan opsi **OEM\$1AGENT** ke grup opsi dan konfigurasikan pengaturan opsi. Untuk informasi selengkapnya tentang cara menambahkan opsi, lihat [Menambahkan opsi ke grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Untuk informasi selengkapnya tentang setiap pengaturan, lihat [Pengaturan opsi untuk Management Agent](#Oracle.Options.OEMAgent.Options). 

1. Terapkan grup opsi ke instans DB baru atau yang sudah ada: 
   + Untuk instans DB baru, Anda menerapkan grup opsi saat Anda meluncurkan instans. Untuk informasi selengkapnya, lihat [Membuat instans DB Amazon RDS](USER_CreateDBInstance.md). 
   + Untuk instans DB yang ada, Anda menerapkan grup opsi dengan memodifikasi instans dan melampirkan grup opsi baru. Untuk informasi selengkapnya, lihat [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). 

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

Contoh berikut menggunakan perintah AWS CLI [add-option-to-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) untuk menambahkan `OEM_AGENT` opsi ke grup opsi yang disebut`myoptiongroup`. 

Untuk Linux, macOS, atau 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
```

Untuk 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
```

### Langkah 2: Membuka kunci akun pengguna DBSNMP
<a name="Oracle.Options.OEMAgent.DBSNMP"></a>

Agen Manajemen menggunakan akun `DBSNMP` pengguna untuk terhubung ke database dan melaporkan masalah ke Oracle Enterprise Manager. Dalam CDB, `DBSNMP` adalah pengguna umum. Akun pengguna ini diperlukan untuk Agen Manajemen dan OEM Database Express. Secara default, akun ini terkunci. Prosedur untuk membuka kunci akun ini berbeda tergantung pada apakah database Anda menggunakan arsitektur non-CDB atau CDB.

**Untuk membuka kunci akun pengguna DBSNMP**

1. Di SQL\$1 Plus atau aplikasi Oracle SQL lainnya, masuk ke instans DB Anda sebagai pengguna utama Anda.

1. Lakukan salah satu tindakan berikut, tergantung pada arsitektur database:  
**Database Anda adalah non-CDB.**  
Jalankan pernyataan SQL berikut:  

   ```
   1. ALTER USER dbsnmp IDENTIFIED BY new_password ACCOUNT UNLOCK;
   ```  
**Database Anda adalah CDB.**  
Jalankan prosedur tersimpan berikut untuk membuka kunci `DBSNMP` akun:  

   ```
   1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password');
   ```
Jika Anda menerima kesalahan yang menyatakan bahwa prosedur tidak ada, reboot instance CDB Anda untuk menginstalnya secara otomatis. Untuk informasi selengkapnya, lihat [Mem-boot ulang instans DB DB](USER_RebootInstance.md).

### Langkah 3: Menambahkan target Anda ke konsol Management Agent
<a name="Oracle.Options.OEMAgent.Using"></a>

Untuk menambahkan instance DB sebagai target, pastikan Anda mengetahui titik akhir dan port. Untuk informasi tentang cara menemukan titik akhir untuk instans DB Amazon RDS Anda, lihat [Menemukan titik akhir instans DB RDS for Oracle](USER_Endpoint.md). Jika database Anda menggunakan arsitektur CDB, tambahkan `CDB$ROOT` kontainer secara terpisah sebagai target.

**Untuk menambahkan target ke konsol Management Agent**

1. Di konsol OMS Anda, pilih **Pengaturan**, **Tambahkan Target**, **Tambahkan Target Secara Manual**. 

1. Pilih **Tambahkan Target Secara Deklaratif dengan Menentukan Properti Pemantauan Target**.

1. Untuk **Jenis Target**, pilih **Instans Basis Data**.

1. Untuk **Agen Pemantau**, pilih agen dengan pengidentifikasi yang sama dengan pengidentifikasi instans DB RDS Anda. 

1. Pilih **Tambahkan Secara Manual**.

1. Masukkan titik akhir untuk instans Amazon RDS DB Anda, atau pilih dari daftar nama host. Pastikan bahwa nama host yang ditentukan cocok dengan titik akhir dari instans DB Amazon RDS.

1. Tentukan properti basis data berikut:
   + Untuk **Nama target**, masukkan nama. 
   + Untuk **Nama sistem basis data**, masukkan nama.
   + Untuk **Nama pengguna pemantauan**, masukkan **dbsnmp**. 
   + Untuk **kata sandi Monitor**, masukkan kata sandi dari[Langkah 2: Membuka kunci akun pengguna DBSNMP](#Oracle.Options.OEMAgent.DBSNMP). 
   + Untuk **Peran**, masukkan **normal**. 
   + Untuk **Jalur beranda Oracle**, masukkan **/oracle**. 
   + Untuk **Nama Mesin Pendengar**, pengidentifikasi agen sudah muncul. 
   + Untuk **Port**, masukkan port basis data. Port default RDS adalah 1521. 
   + Untuk **Nama basis data**, masukkan nama basis data Anda. Jika database Anda adalah CDB, nama ini adalah`RDSCDB`. 

1. Pilih **Uji Koneksi**. 

1. Pilih **Berikutnya**. Basis data target muncul di daftar sumber daya yang dipantau. 

## Menambahkan opsi Management Agent
<a name="Oracle.Options.OEMAgent.Remove"></a>

Anda dapat menghapus OEM Agent dari instans DB. Setelah OEM Agent dihapus, instans DB tidak perlu dimulai ulang. 

Untuk menghapus OEM Agent dari instans DB, lakukan salah satu hal berikut ini: 
+ Hapus OEM Agent dari grup opsi tempatnya berada. Perubahan ini memengaruhi semua instans DB yang menggunakan grup opsi tersebut. Untuk informasi lebih lanjut, lihat [Menghapus opsi dari grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). 
+ Ubah instans DB dan tentukan grup opsi lain yang tidak menyertakan OEM Agent tersebut. Perubahan ini memengaruhi satu instans DB. Anda dapat menentukan grup opsi default (kosong) atau grup opsi kustom yang berbeda. Untuk informasi selengkapnya, lihat [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). 

## Melakukan tugas basis data dengan Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks"></a>

Anda dapat menggunakan prosedur Amazon RDS untuk menjalankan perintah EMCTL tertentu di Management Agent. Dengan menjalankan prosedur ini, Anda dapat melakukan tugas-tugas berikut ini.

**catatan**  
Tugas dijalankan secara asinkron.

**Topics**
+ [Mengamankan Agen Manajemen](#Oracle.Options.OEMAgent.DBTasks.SecureAgent)
+ [Mendapatkan status Management Agent](#Oracle.Options.OEMAgent.DBTasks.GetAgentStatus)
+ [Memulai ulang Management Agent](#Oracle.Options.OEMAgent.DBTasks.RestartAgent)
+ [Membuat daftar target yang dipantau oleh Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListTargets)
+ [Membuat daftar utas koleksi yang dipantau oleh Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads)
+ [Menghapus status Management Agent](#Oracle.Options.OEMAgent.DBTasks.ClearState)
+ [Membuat Management Agent mengunggah OMS-nya](#Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS)
+ [Mengirim ping pada OMS](#Oracle.Options.OEMAgent.DBTasks.PingOMS)
+ [Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus)

### Mengamankan Agen Manajemen
<a name="Oracle.Options.OEMAgent.DBTasks.SecureAgent"></a>

Untuk mengamankan Agen Manajemen, jalankan prosedur `rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent` Amazon RDS. Prosedur ini setara dengan menjalankan perintah `emctl secure agent`.

Prosedur berikut membuat tugas untuk mengamankan Agen Manajemen dan mengembalikan ID tugas:

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

Untuk menampilkan file output untuk tugas dan melihat hasilnya, lihat[Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Mendapatkan status Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.GetAgentStatus"></a>

Untuk mendapatkan status Management Agent, jalankan prosedur `rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent` Amazon RDS. Prosedur ini setara dengan perintah `emctl status agent`.

Prosedur berikut membuat tugas untuk mendapatkan status Management Agent dan mengembalikan ID tugas.

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

Untuk menampilkan file output untuk tugas dan melihat hasilnya, lihat[Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

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

Untuk memulai ulang Management Agent, jalankan prosedur `rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent` Amazon RDS. Prosedur ini setara dengan menjalankan perintah `emctl stop agent` dan `emctl start agent`.

Prosedur berikut membuat tugas untuk memulai ulang Management Agent dan mengembalikan ID tugas.

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

Untuk menampilkan file output untuk tugas dan melihat hasilnya, lihat[Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Membuat daftar target yang dipantau oleh Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ListTargets"></a>

Untuk membuat daftar target yang dipantau oleh Management Agent, jalankan prosedur `rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent` Amazon RDS. Prosedur ini setara dengan menjalankan perintah `emctl config agent listtargets`.

Prosedur berikut membuat tugas untuk membuat daftar target yang dipantau oleh Management Agent dan mengembalikan ID tugas.

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

Untuk menampilkan file output untuk tugas dan melihat hasilnya, lihat[Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Membuat daftar utas koleksi yang dipantau oleh Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads"></a>

Untuk membuat daftar semua utas koleksi yang sedang berjalan, sudah siap, dan terjadwal yang dipantau oleh Management Agent, jalankan prosedur `rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent` Amazon RDS. Prosedur ini setara dengan perintah `emctl status agent scheduler`.

Prosedur berikut membuat tugas untuk membuat daftar utas koleksi dan mengembalikan ID tugas.

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

Untuk menampilkan file output untuk tugas dan melihat hasilnya, lihat[Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Menghapus status Management Agent
<a name="Oracle.Options.OEMAgent.DBTasks.ClearState"></a>

Untuk menghapus Management Agent, jalankan prosedur `rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent` Amazon RDS. Prosedur ini setara dengan menjalankan perintah `emctl clearstate agent`.

Prosedur berikut membuat tugas yang menghapus status Management Agent dan mengembalikan ID tugas.

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

Untuk menampilkan file output untuk tugas dan melihat hasilnya, lihat[Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Membuat Management Agent mengunggah OMS-nya
<a name="Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS"></a>

Agar Management Agent mengunggah Oracle Management Server (OMS) yang terkait dengannya, jalankan prosedur `rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent` Amazon RDS. Prosedur ini setara dengan menjalankan perintah `emclt upload agent`.

Prosedur berikut membuat tugas yang membuat Management Agent mengunggah OMS terkaitnya dan mengembalikan ID tugas.

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

Untuk menampilkan file output untuk tugas dan melihat hasilnya, lihat[Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Mengirim ping pada OMS
<a name="Oracle.Options.OEMAgent.DBTasks.PingOMS"></a>

Untuk mengirim ping ke OMS Management Agent, jalankan prosedur `rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent` Amazon RDS. Prosedur ini setara dengan menjalankan perintah `emctl pingOMS`.

Prosedur berikut membuat tugas yang mengirim ping ke OMS Management Agent dan mengembalikan ID tugas.

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

Untuk menampilkan file output untuk tugas dan melihat hasilnya, lihat[Melihat status tugas yang sedang berlangsung](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus).

### Melihat status tugas yang sedang berlangsung
<a name="Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus"></a>

Anda dapat melihat status tugas yang sedang berlangsung di file bdump. File bdump terletak di direktori `/rdsdbdata/log/trace`. Setiap nama file bdump memiliki format berikut.

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

Saat Anda ingin memantau tugas, ganti `task-id` dengan ID tugas yang ingin Anda pantau.

Untuk melihat konten file bdump, jalankan prosedur `rdsadmin.rds_file_util.read_text_file` Amazon RDS. Misalnya, kueri berikut mengembalikan konten file bdump `dbtask-1546988886389-2444.log`. 

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

Untuk informasi lebih lanjut tentang prosedur `rdsadmin.rds_file_util.read_text_file` Amazon RDS, lihat [Membaca file di direktori instans DB](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles).