Oracle Management Agent untuk Kontrol Cloud Enterprise Manager

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 dan Overview of Oracle Enterprise Manager cloud control 13c dalam dokumentasi Oracle.

Persyaratan untuk Agen Manajemen

Berikut ini adalah persyaratan umum untuk menggunakan Agen Manajemen:

Prasyarat komunikasi host OMS

Pastikan host OMS dan instans DB Amazon RDS Anda dapat berkomunikasi. Lakukan hal-hal berikut:

Batasan untuk Management Agent

Berikut adalah beberapa batasan dalam menggunakan Management Agent:

Pengaturan opsi untuk Management Agent

Amazon RDS mendukung pengaturan berikut untuk opsi Management Agent.

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

Step1: Menambahkan opsi Agen Manajemen ke instans DB Anda

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

Jika Anda mengalami kesalahan, periksa dokumen My Oracle Support 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.

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

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

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

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

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.

Langkah 3: Menambahkan target Anda ke konsol Management Agent

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. Jika database Anda menggunakan arsitektur CDB, tambahkan CDB$ROOT kontainer secara terpisah sebagai target.

Mengelola Agen Manajemen

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.

Mendapatkan status Management Agent

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 melihat hasilnya dengan menampilkan file output tugas, lihat Melihat status tugas yang sedang berlangsung.

Memulai ulang Management Agent

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 melihat hasilnya dengan menampilkan file output tugas, lihat Melihat status tugas yang sedang berlangsung.

Membuat daftar target yang dipantau oleh Management Agent

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 melihat hasilnya dengan menampilkan file output tugas, lihat Melihat status tugas yang sedang berlangsung.

Membuat daftar utas koleksi yang dipantau oleh Management Agent

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 melihat hasilnya dengan menampilkan file output tugas, lihat Melihat status tugas yang sedang berlangsung.

Menghapus status Management Agent

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 melihat hasilnya dengan menampilkan file output tugas, lihat Melihat status tugas yang sedang berlangsung.

Membuat Management Agent mengunggah OMS-nya

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 melihat hasilnya dengan menampilkan file output tugas, lihat Melihat status tugas yang sedang berlangsung.

Mengirim ping pada OMS

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 melihat hasilnya dengan menampilkan file output tugas, lihat Melihat status tugas yang sedang berlangsung.

Melihat status tugas yang sedang berlangsung

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.

Menambahkan opsi Management Agent

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: