# Oracle Enterprise Manager Amazon RDS는 Oracle Enterprise Manager(OEM)를 지원합니다. OEM은 엔터프라이즈 정보 기술의 통합 관리를 위한 Oracle 제품 라인입니다. Amazon RDS는 Oracle Database 19c 비CDB 또는 CDB에서만 OEM을 지원합니다. 다음 표에서는 지원되는 OEM 옵션에 대해 설명합니다. **** | 옵션 | 옵션 ID | 지원되는 OEM 릴리스 | | --- | --- | --- | | [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 for 13c | **참고** OEM 데이터베이스 또는 OEM Management Agent를 사용할 수 있지만 둘 다 사용할 수는 없습니다. # Oracle Enterprise Manager Database Express Amazon RDS는 OEM 옵션 사용을 통해 Oracle Enterprise Manager Database Express(EM Express)를 지원합니다. Amazon RDS는 CDB 또는 비CDB 아키텍처를 사용하여 Oracle Database 19c용 EM Express를 지원합니다. EM Express는 데이터베이스에 포함된 웹 기반 데이터베이스 관리 도구이며 개방되었을 때만 사용할 수 있습니다. 주요 성능 관리 및 기본 데이터베이스 관리 기능을 지원합니다. 자세한 내용은 Oracle 설명서의 [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)를 참조하세요. **참고** EM Express는 db.t3.small DB 인스턴스 클래스에서 지원되지 않습니다. DB 인스턴스 클래스에 대한 자세한 내용은 [RDS for Oracle DB 인스턴스 클래스](Oracle.Concepts.InstanceClasses.md) 섹션을 참조하세요. ## OEM 옵션 설정 Amazon RDS는 OEM 옵션에 대해 다음 설정을 지원합니다. **** | 옵션 설정 | 유효한 값 | 설명 | | --- | --- | --- | | **포트** | 정수 값 | EM Express를 수신하는 RDS for Oracle DB 인스턴스의 포트입니다. 기본값은 5500입니다. | | ** 보안 그룹** | — | **Port(포트)**에 액세스할 수 있는 보안 그룹입니다. | ## 1단계: OEM 옵션 추가 OEM 옵션을 DB 인스턴스에 추가하는 일반적인 프로세스는 다음과 같습니다. 1. 새 옵션 그룹을 생성하거나 기존 옵션 그룹을 복사 또는 수정합니다. 1. 옵션을 옵션 그룹에 추가합니다. 1. 옵션 그룹과 DB 인스턴스를 연결합니다. OEM 옵션을 추가하는 경우 DB 인스턴스를 자동으로 다시 시작하는 동안 잠시 작동이 중단됩니다. **DB 인스턴스에 OEM 옵션을 추가하려면** 1. 사용할 옵션 그룹을 결정합니다. 새 옵션 그룹을 생성하거나 기존 옵션 그룹을 사용합니다. 기존 옵션 그룹을 사용하려면 다음 단계로 건너뛰십시오. 그렇지 않으면 다음 설정을 사용하여 사용자 지정 DB 옵션을 생성합니다. 1. [**Engine**]에서 DB 인스턴스의 Oracle 에디션을 선택합니다. 1. **메이저 엔진 버전**에서 DB 인스턴스의 버전을 선택합니다. 자세한 내용은 [옵션 그룹 생성](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create) 섹션을 참조하세요. 1. OEM 옵션을 옵션 그룹에 추가하고 옵션 설정을 구성합니다. 옵션 추가에 대한 자세한 내용은 [옵션 그룹에 옵션 추가](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption) 섹션을 참조하세요. 각 설정에 대한 자세한 내용은 [OEM 옵션 설정](#Appendix.Oracle.Options.OEM_DBControl.Options) 섹션을 참조하십시오. **참고** 하나 이상의 DB 인스턴스에 이미 연결되어 있는 기존 옵션 그룹에 OEM 옵션을 추가하면 모든 DB 인스턴스가 자동으로 다시 시작되는 동안 인스턴스가 잠시 중단됩니다. 1. 옵션 그룹을 새 DB 인스턴스 또는 기존 DB 인스턴스에 적용합니다: + 새 DB 인스턴스의 경우, 인스턴스를 시작할 때 옵션 그룹을 적용하십시오. 자세한 내용은 [Amazon RDS DB 인스턴스 생성](USER_CreateDBInstance.md) 섹션을 참조하세요. + 기존 DB 인스턴스의 경우, 해당 인스턴스를 수정하고 새 옵션 그룹을 연결하여 옵션 그룹을 적용하십시오. OEM 옵션을 추가하는 경우 DB 인스턴스를 자동으로 다시 시작하는 동안 잠시 작동이 중단됩니다. 자세한 내용은 [Amazon RDS DB 인스턴스 수정](Overview.DBInstance.Modifying.md) 섹션을 참조하세요. **참고** AWS CLI를 사용하여 OEM 옵션을 추가할 수도 있습니다. 예제는 [옵션 그룹에 옵션 추가](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption)을 참조하세요. ## 2단계: (CDB만 해당) DBSNMP 사용자 계정 잠금 해제 DB 인스턴스는 CDB 아키텍처를 사용하므로, EM Express에 `DBSNMP`로 로그인해야 합니다. `DBSNMP`는 CDB에서 일반 사용자입니다. 기본적으로 이 계정은 잠겨 있습니다. DB 인스턴스가 CDB 아키텍처를 사용하지 않는 경우 이 단계를 건너뛰세요. **CDB 인스턴스에서 DBSNMP 사용자 계정을 잠금 해제하려면** 1. SQL\$1Plus 또는 다른 Oracle SQL 애플리케이션에서 마스터 사용자로 DB 인스턴스에 로그인합니다. 1. 다음 저장 프로시저를 실행하여 `DBSNMP` 계정을 잠금 해제합니다. ``` 1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password'); ``` 프로시저가 존재하지 않는다는 오류 메시지가 표시되면 CDB 인스턴스를 재부팅하여 자동으로 설치합니다. 자세한 내용은 [ DB 인스턴스 재부팅](USER_RebootInstance.md) 섹션을 참조하세요. ## 3단계: 브라우저를 통해 EM Express에 액세스 웹 브라우저에서 EM Express에 액세스하면 사용자 이름과 암호를 묻는 로그인 창이 나타납니다. **브라우저를 통해 EM Express에 액세스하려면** 1. 사용자의 Amazon RDS DB 인스턴스에 대한 엔드포인트와 EM Express 포트를 식별합니다. 사용자의 Amazon RDS DB 인스턴스에 대한 엔드포인트를 찾는 방법은 [RDS for Oracle DB 인스턴스의 엔드포인트 찾기](USER_Endpoint.md) 섹션을 참조하십시오. 1. 브라우저 로케이터 표시줄에 다음 형식을 사용하여 URL을 입력합니다. ``` https://endpoint.rds.amazonaws.com:port/em ``` 예를 들어, Amazon RDS DB 인스턴스의 엔드포인트가 `mydb.a1bcde234fgh.us-east-1.rds.amazonaws.com`이고 EM Express 포트가 `1158`인 경우 다음 URL을 사용하여 EM Express에 액세스합니다. ``` 1. https://mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com:1158/em ``` 1. 로그인 세부 정보를 입력하라는 메시지가 표시되면 데이터베이스 아키텍처에 따라 다음 작업 중 하나를 수행합니다. **데이터베이스가 CDB가 아닙니다.** DB 인스턴스에 대한 마스터 사용자 이름과 마스터 암호를 입력합니다. **데이터베이스가 CDB입니다.** 사용자 및 `DBSNMP` 암호에 `DBSNMP`를 입력합니다. `Container` 필드는 비워둡니다. ## OEM Database 설정 수정 OEM Database를 활성화한 후 옵션의 보안 그룹 설정을 수정할 수 있습니다. 옵션 그룹을 DB 인스턴스와 연동한 이후에는 OEM 포트 번호를 수정할 수 없습니다. DB 인스턴스의 OEM 포트 번호를 변경하려면 다음과 같이 합니다. 1. 새 옵션 그룹을 생성합니다. 1. 새 포트 번호가 포함된 OEM 옵션에 새 옵션 그룹을 추가합니다. 1. DB 인스턴스에서 기존 옵션 그룹을 제거합니다. 1. 새 옵션 그룹을 DB 인스턴스에 추가합니다. 옵션 설정을 변경하는 방법에 대한 자세한 내용은 [옵션 설정 수정](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.ModifyOption)을(를) 참조하십시오. 각 설정에 대한 자세한 내용은 [OEM 옵션 설정](#Appendix.Oracle.Options.OEM_DBControl.Options) 단원을 참조하십시오. ## OEM Database Express 작업 실행 Amazon RDS 절차를 통해 특정 OEM Database Express 작업을 실행할 수 있습니다. 이 프로시저를 실행하면 다음과 같은 작업을 수행할 수 있습니다. **참고** OEM Database Express 작업은 비동기식으로 실행됩니다. **Topics** + [OEM Database Express의 웹 사이트 프런트 엔드를 Adobe Flash로 전환](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash) + [OEM Database Express의 웹 사이트 프런트 엔드를 Oracle JET로 전환](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET) ### OEM Database Express의 웹 사이트 프런트 엔드를 Adobe Flash로 전환 **참고** 이 작업은 Oracle Database 19c 비 CDB의 경우에만 가능합니다. Oracle Database 19c부터 Oracle은 Adobe Flash 기반의 이전 OEM Database Express 사용자 인터페이스를 더 이상 사용하지 않습니다. 대신, 이제 OEM Database Express에서 Oracle JET로 구축된 인터페이스를 사용합니다. 새 인터페이스 사용에 문제가 있는 경우 더 이상 사용하지 않는 Flash 기반 인터페이스로 다시 전환할 수 있습니다. 새 인터페이스 사용 시 발생할 수 있는 문제에는 OEM Database Express에 로그인한 후 `Loading` 화면이 멈추는 것이 포함됩니다. Flash 기반의 OEM Database Express 버전에 있는 특정 기능을 사용하지 못할 수도 있습니다. OEM Database Express 웹 사이트 프런트 엔드를 Adobe Flash로 전환하려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash`를 실행하십시오. 이 프로시저는 `execemx emx` SQL 명령과 동일합니다. 보안 모범 사례에서는 Adobe Flash의 사용을 권장하지 않습니다. Flash 기반의 OEM Database Express로 되돌릴 수 있지만 가능하면 JET 기반의 OEM Database Express 웹 사이트를 사용하는 것이 좋습니다. Adobe Flash를 사용하도록 되돌리고 Oracle JET를 사용하도록 다시 전환하려면 `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet` 프로시저를 사용하십시오. Oracle Database 업그레이드 후 최신 버전의 Oracle JET에서 OEM Database Express의 JET 관련 문제를 해결할 수 있습니다. Oracle JET로의 전환에 대한 자세한 내용은 [OEM Database Express의 웹 사이트 프런트 엔드를 Oracle JET로 전환](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET) 단원을 참조하십시오. **참고** 읽기 전용 복제본의 원본 DB 인스턴스에서 이 작업을 실행하면 읽기 전용 복제본이 해당 OEM Database Express 웹 사이트 프런트 엔드를 Adobe Flash로 전환하게 됩니다. 다음 프로시저 호출은 OEM Database Express 웹 사이트에서 Adobe Flash로 전환하는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash() as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 볼 수 있습니다. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log')); ``` *`task-id`*를 절차에서 반환된 작업 ID로 대체합니다. Amazon RDS 프로시저 `rdsadmin.rds_file_util.read_text_file`에 대한 자세한 내용은 [DB 인스턴스 디렉터리의 파일 목록 읽기](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 단원을 참조하십시오. AWS Management Console에 대한 **Logs & events(로그 및 이벤트)** 섹션에서 로그 항목을 검색하여 `task-id`에서 작업의 출력 파일 내용을 볼 수도 있습니다. ### OEM Database Express의 웹 사이트 프런트 엔드를 Oracle JET로 전환 **참고** 이 작업은 Oracle Database 19c 비 CDB의 경우에만 가능합니다. OEM Database Express 웹 사이트 프런트 엔드를 Oracle JET로 전환하려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`를 실행합니다. 이 프로시저는 `execemx omx` SQL 명령과 동일합니다. 기본적으로 19c 이상을 실행하는 Oracle DB 인스턴스에 대한 OEM Database Express 웹 사이트에서는 Oracle JET를 사용합니다. `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash` 프로시저를 사용하여 OEM Database Express 웹 사이트 프런트 엔드를 Adobe Flash로 전환한 경우 Oracle JET로 다시 전환할 수 있습니다. 이렇게 하려면 `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet` 프로시저를 사용하십시오. Adobe Flash로 전환하는 방법에 대한 자세한 내용은 [OEM Database Express의 웹 사이트 프런트 엔드를 Adobe Flash로 전환](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash) 단원을 참조하십시오. **참고** 읽기 전용 복제본의 원본 DB 인스턴스에서 이 작업을 실행하면 읽기 전용 복제본이 해당 OEM Database Express 웹 사이트 프런트 엔드를 Oracle JET로 전환하게 됩니다. 다음 프로시저 호출은 OEM Database Express 웹 사이트를 Oracle JET로 전환하는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet() as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 볼 수 있습니다. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log')); ``` *`task-id`*를 절차에서 반환된 작업 ID로 대체합니다. Amazon RDS 프로시저 `rdsadmin.rds_file_util.read_text_file`에 대한 자세한 내용은 [DB 인스턴스 디렉터리의 파일 목록 읽기](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 단원을 참조하십시오. AWS Management Console에 대한 **Logs & events(로그 및 이벤트)** 섹션에서 로그 항목을 검색하여 `task-id`에서 작업의 출력 파일 내용을 볼 수도 있습니다. ## OEM Database 옵션 제거 DB 인스턴스에서 OEM 옵션을 제거할 수 있습니다. OEM 옵션을 제거하는 경우 인스턴스를 자동으로 다시 시작하는 동안 인스턴스가 잠시 중단됩니다. 따라서 OEM 옵션을 제거한 후 DB 인스턴스를 다시 시작할 필요가 없습니다. DB 인스턴스에서 OEM 옵션을 제거하려면 다음 중 하나를 수행합니다. + OEM Agent가 속한 옵션 그룹에서 OEM 옵션을 제거합니다. 이 변경은 해당 옵션 그룹을 사용하는 모든 DB 인스턴스에 영향을 미칩니다. 자세한 내용은 [옵션 그룹에서 옵션 제거](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption) 섹션을 참조하세요. + DB 인스턴스를 수정하고, OEM 옵션이 포함되지 않은 다른 옵션 그룹을 지정합니다. 이 변경은 단일 DB 인스턴스에 영향을 미칩니다. 기본(빈) 옵션 그룹을 지정하거나 다른 사용자 지정 옵션 그룹을 지정할 수 있습니다. 자세한 내용은 [Amazon RDS DB 인스턴스 수정](Overview.DBInstance.Modifying.md) 섹션을 참조하세요. # Oracle Management Agent for Enterprise Manager Cloud Control Oracle Enterprise Manager(OEM) Management Agent는 호스트에서 실행되는 대상을 모니터링하고 해당 정보를 미들티어 Oracle Management Service(OMS)에 전달하는 소프트웨어 구성 요소입니다. Amazon RDS는 `OEM_AGENT` 옵션 사용을 통해 Management Agent를 지원합니다. 자세한 내용은 Oracle 설명서에서 [Overview of Oracle Enterprise Manager Cloud Control 12c](http://docs.oracle.com/cd/E24628_01/doc.121/e25353/overview.htm) 및 [Overview of Oracle Enterprise Manager Cloud Control 13c](http://docs.oracle.com/cd/E63000_01/EMCON/overview.htm#EMCON109) 섹션을 참조하십시오. **Topics** + [Management Agent 요구 사항](#Oracle.Options.OEMAgent.PreReqs) + [OMS 호스트 통신 사전 요구 사항](#Oracle.Options.OEMAgent.PreReqs.host) + [Management Agent의 제한 사항](#Oracle.Options.OEMAgent.limitations) + [Management Agent 옵션 설정](#Oracle.Options.OEMAgent.Options) + [Management Agent 옵션을 DB 인스턴스에 활성화](#Oracle.Options.OEMAgent.Enable) + [Management Agent 옵션 제거](#Oracle.Options.OEMAgent.Remove) + [Management Agent를 사용하여 데이터베이스 작업 수행](#Oracle.Options.OEMAgent.DBTasks) ## Management Agent 요구 사항 다음은 Management Agent 사용을 위한 일반적인 요구 사항입니다. + DB 인스턴스는 Oracle Database 19c(19.0.0.0)를 실행해야 합니다. CDB 아키텍처 또는 비CDB 아키텍처를 사용할 수 있습니다. + DB 인스턴스에 연결하도록 구성된 Oracle Management Service(OMS)를 사용해야 합니다. 다음과 같은 OMS 요구 사항을 확인합니다. + Management Agent 버전 13.5.0.0.v2 및 13.5.0.0.v3에는 OMS 버전 13.5.0.23 또는 24.1이 필요합니다. + Management Agent 버전 13.5.0.0.v1에는 OMS 버전 13.5.0.0 또는 24.1이 필요합니다. + Management Agent 버전 13.4.0.9.v1 및 13.4.0.9.v2에는 OMS 버전 13.4.0.9 이상과 32198287 패치가 필요합니다. + 대부분의 경우 OMS에서 DB 인스턴스로 연결을 허용하도록 VPC를 구성해야 합니다. Amazon Virtual Private Cloud(Amazon VPC)에 익숙하지 않은 경우 계속하기 전에 [자습서: DB 인스턴스에 사용할 Amazon VPC 생성(IPv4 전용)](CHAP_Tutorials.WebServerDB.CreateVPC.md)의 단계를 완료하는 것이 좋습니다. + 12c 및 13c용 Oracle Enterprise Manager Cloud Control과 함께 Management Agent를 사용할 수 있습니다. OEM 릴리스를 위한 충분한 스토리지 공간이 있는지 확인합니다. + OEM 13c 릴리스 5의 경우 최소 8.5GiB이 필요합니다. + OEM 13c 릴리스 4의 경우 최소 8.5GiB + OEM 13c 릴리스 3의 경우 최소 8.5GiB + OEM 13c 릴리스 2의 경우 최소 5.5GiB + OEM 13c 릴리스 1의 경우 최소 4.5GiB가 필요합니다. + OEM 12c의 경우 최소 2.5GiB + Management Agent 버전 `OEM_AGENT 13.2.0.0.v3` 및 `13.3.0.0.v2`를 사용 중이고 TCPS 연결을 사용하려면 Oracle 설명서의 [대상 데이터베이스와의 통신을 위한 서드 파티 CA 인증서 구성](https://docs.oracle.com/cd/E73210_01/EMSEC/GUID-8337AD48-1A32-4CD5-84F3-256FAE93D043.htm#EMSEC15996)에 설명된 지침을 따르세요. 또한 Oracle Doc ID가 2241358.1인 Oracle 문서의 지침에 따라 OMS에서 JDK를 업데이트하십시오. 그러면 데이터베이스가 지원하는 모든 암호 그룹을 OMS에서 지원하게 됩니다. **참고** Management Agent와 DB 인스턴스 간 TCPS 연결은 Management Agent `OEM_AGENT 13.2.0.0.v3`, `13.3.0.0.v2`, `13.4.0.9.v1` 이상 버전에서 지원됩니다. ## OMS 호스트 통신 사전 요구 사항 OMS 호스트와 Amazon RDS DB 인스턴스가 통신해야 합니다. 해결 방법: + OMS 호스트가 방화벽 뒤에 있는 경우 Management Agent에서 OMS 호스트로 연결하려면 DB 인스턴스의 IP 주소를 방화벽에 추가합니다. OMS용 방화벽이 다음 네트워크 트래픽을 허용하도록 합니다. OMS 호스트에서 DB 인스턴스로의 기준 OMS 호스트에서 데이터베이스 리스너 포트(기본값 1521) 및 OEM 에이전트 포트(기본값 3872)로의 트래픽을 허용하는 단방향 방화벽 규칙을 구성합니다. DB 인스턴스에서 OMS 호스트로의 기준 DB 인스턴스에서 OMS HTTP 포트(기본값 4903)로의 트래픽을 허용하는 단방향 방화벽 규칙을 구성합니다. + OMS에 공개적으로 확인할 수 있는 호스트 이름이 있는 경우 OMS에서 Management Agent로 연결하려면 OMS 주소를 보안 그룹에 추가합니다. 보안 그룹에는 DB 리스너 포트 및 Management Agent 포트에 대한 액세스를 허용하는 인바운드 규칙이 있어야 합니다. 보안을 생성하고 인바운드 규칙을 추가하는 방법의 예는 [자습서: DB 인스턴스에 사용할 Amazon VPC 생성(IPv4 전용)](CHAP_Tutorials.WebServerDB.CreateVPC.md) 섹션을 참조하십시오. + OMS에 공개적으로 확인할 수 있는 호스트 이름이 없는 경우 OMS에서 Management Agent로 연결하려면 다음 중 하나를 사용합니다. + OMS가 프라이빗 VPC의 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에 호스팅된 경우 VPC 피어링을 설정하여 OMS에서 Management Agent로 연결할 수 있습니다. 자세한 내용은 [VPC에 있는 DB 인스턴스에 다른 VPC에 있는 EC2 인스턴스가 액세스](USER_VPC.Scenarios.md#USER_VPC.Scenario3) 섹션을 참조하세요. + OMS가 온프레미스에 호스팅된 경우 VPN 연결을 설정하여 OMS에서 Management Agent로 액세스를 허용할 수 있습니다. 자세한 내용은 [클라이언트 애플리케이션이 인터넷을 통해 VPC에 있는 DB 인스턴스에 액세스](USER_VPC.Scenarios.md#USER_VPC.Scenario4) 또는 [VPN 연결](https://docs.aws.amazon.com/vpc/latest/userguide/vpn-connections.html)을 참조하십시오. + OEM Management Agent 버전 13.5.0.0(v1\$1v3)을 24.1 OMS 호스트에 연결하려면 구성 옵션에서 TLS 1.2 프로토콜 `TLSv1.2`를 사용하도록 `MINIMUM_TLS_VERSION`을 설정합니다. ## Management Agent의 제한 사항 다음은 Management Agent를 사용할 때 적용되는 몇 가지 제한 사항입니다. + 사용자 지정 Oracle 관리 에이전트 이미지는 제공할 수 없습니다. + 작업 실행 및 데이터베이스 패치 적용과 같이 호스트 자격 증명이 필요한 관리 작업은 지원되지 않습니다. + 호스트 측정치 및 프로세스 목록에는 실제 시스템 상태가 반영되지 않을 수 있습니다. 따라서 OEM을 사용하여 루트 파일 시스템이나 마운트 지점 파일 시스템을 모니터링하면 안 됩니다. 운영 체제 모니터링에 대한 자세한 내용은 [Enhanced Monitoring을 사용하여 OS 지표 모니터링](USER_Monitoring.OS.md) 섹션을 참조하십시오. + 자동 검색은 지원되지 않습니다. 데이터베이스 대상을 수동으로 추가해야 합니다. + OMS 모듈 가용성은 데이터베이스 에디션에 따라 다릅니다. 예를 들어, 데이터베이스 성능 진단 및 튜닝 모듈은 Oracle Database Enterprise Edition에만 사용할 수 있습니다. + Management Agent는 추가 메모리 및 컴퓨팅 리소스를 사용합니다. `OEM_AGENT` 옵션을 활성화한 후 성능 문제가 발생할 경우 더 큰 DB 인스턴스 클래스로 조정하는 것이 좋습니다. 자세한 내용은 [DB 인스턴스 클래스](Concepts.DBInstanceClass.md) 및 [Amazon RDS DB 인스턴스 수정](Overview.DBInstance.Modifying.md) 섹션을 참조하십시오. + Amazon RDS 호스트에서 `OEM_AGENT`를 실행 중인 사용자에게는 경고 로그에 대한 운영 체제 액세스 권한이 없습니다. 따라서 OEM에서 `DB Alert Log` 및 `DB Alert Log Error Status`에 대한 지표를 수집할 수 없습니다. ## Management Agent 옵션 설정 Amazon RDS는 Management Agent 옵션에 대해 다음 설정을 지원합니다. | 옵션 설정 | 필수 | 유효한 값 | 설명 | | --- | --- | --- | --- | | **버전** (`AGENT_VERSION`) | 예 | `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` | Management Agent 소프트웨어의 버전입니다. 현재 지원되는 최소 버전은 `13.1.0.0.v1`입니다. AWS CLI 옵션 이름은 `OptionVersion`입니다. AWS GovCloud (US) 리전에서는 13.1 버전을 사용할 수 없습니다. | | **포트** (`AGENT_PORT`) | 예 | 정수 값 | OMS 호스트에 대해 수신 대기하는 DB 인스턴스의 포트입니다. 기본값은 3872입니다. OMS 호스트는 이 포트에 액세스할 수 있는 보안 그룹에 속해야 합니다. AWS CLI 옵션 이름은 `Port`입니다. | | ** 보안 그룹** | 예 | 기존 보안 그룹 | **Port(포트)**에 액세스할 수 있는 보안 그룹입니다. OMS 호스트는 이 보안 그룹에 속해야 합니다. AWS CLI 옵션 이름은 `VpcSecurityGroupMemberships` 또는 `DBSecurityGroupMemberships`입니다. | | **OMS\$1HOST** | 예 | 문자열 값, 예: *my.example.oms* | OMS의 공개적으로 액세스할 수 있는 호스트 이름 또는 IP 주소입니다. AWS CLI 옵션 이름은 `OMS_HOST`입니다. | | **OMS\$1PORT** | 예 | 정수 값 | Management Agent에 대해 수신 대기하는 OMS 호스트의 HTTPS 업로드 포트입니다. HTTPS 업로드 포트를 결정하려면 OMS 호스트를 연결하고 다음 명령을 실행합니다(`SYSMAN` 암호 필요). emctl status oms -details AWS CLI 옵션 이름은 `OMS_PORT`입니다. | | **AGENT\$1REGISTRATION\$1PASSWORD** | 예 | 문자열 값 | Management Agent가 OMS에 자신을 인증하기 위해 사용하는 암호입니다. `OEM_AGENT` 옵션을 활성화하기 전에 OMS에서 지속적인 암호를 생성하는 것이 좋습니다. 지속적인 암호가 있으면 단일 Management Agent 옵션 그룹을 여러 Amazon RDS 데이터베이스 간에 공유할 수 있습니다. AWS CLI 옵션 이름은 `AGENT_REGISTRATION_PASSWORD`입니다. | | **ALLOW\$1TLS\$1ONLY** | 아니요 | `true`, `false`(기본값) | 에이전트가 서버로서 수신하는 동안 OEM 에이전트가 `TLSv1` 프로토콜만 지원하도록 구성하는 값입니다. 해당 설정은 더 이상 지원되지 않습니다. Management Agent 버전 13.1.0.0.v1 이상은 기본적으로 TLS(전송 계층 보안)를 지원합니다. | | **MINIMUM\$1TLS\$1VERSION** | 아니요 | `TLSv1` (default)`TLSv1.2` | 에이전트가 서버로서 수신하는 동안 OEM 에이전트에서 지원하는 최소 TLS 버전을 지정하는 값입니다. 지원되지 않는 에이전트 버전에서는 `TLSv1` 설정만 지원합니다. 13.5.0.0(v1\$1v3)을 24.1 OMS 호스트에 연결하려면 이 값을 `TLSv1.2`로 설정합니다. | | **TLS\$1CIPHER\$1SUITE** | 아니요 | [Management Agent 옵션 설정](#Oracle.Options.OEMAgent.Options)을(를) 참조하세요. | 에이전트가 서버로서 수신하는 동안 OEM 에이전트가 사용하는 TLS 암호 그룹을 지정하는 값입니다. | 다음 표에는 관리 에이전트 옵션에서 지원하는 TLS 암호 그룹이 나와 있습니다. | 암호 그룹 | 지원되는 에이전트 버전 | FedRAMP 규정 준수 | | --- | --- | --- | | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | 모두 | 아니요 | | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 | 13.1.0.0.v1 이상 | 아니요 | | TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 이상 | 아니요 | | TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 | 13.2.0.0.v3 이상 | 아니요 | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | 13.2.0.0.v3 이상 | 예 | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 이상 | 예 | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 | 13.2.0.0.v3 이상 | 예 | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | 13.2.0.0.v3 이상 | 예 | | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 | 13.4.0.9.v1 이상 | 예 | | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | 13.4.0.9.v1 이상 | 예 | ### 암호 제품군과의 인증서 호환성 RDS for Oracle은 RSA 및 타원 곡선 디지털 서명 알고리즘(ECDSA) 인증서를 모두 지원합니다. DB 인스턴스에 OEM 에이전트 옵션을 구성할 때 `TLS_CIPHER_SUITE` 옵션 설정에서 지정한 암호 제품군이 DB 인스턴스에서 사용하는 인증서 유형과 호환되는지 확인해야 합니다. 다음 표는 인증서 유형과 암호 제품군 간의 호환성을 보여 줍니다. | 인증서 유형 | 호환되는 암호 제품군 | 호환되지 않는 암호 제품군 | | --- | --- | --- | | RSA 인증서(rds-ca-2019, rds-ca-rsa2048-g1, rds-ca-rsa4096-g1) | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | | ECDSA 인증서(rds-ca-ecc384-g1) | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | `TLS_CIPHER_SUITE` 옵션 설정에서 암호 제품군을 지정할 때 DB 인스턴스에서 사용하는 인증서 유형과 호환되는지 확인합니다. 옵션 그룹을 DB 인스턴스의 인증서 유형과 호환되지 않는 암호 제품군이 포함된 OEM 에이전트 옵션과 연결하려고 하면 비호환성을 나타내는 오류 메시지와 함께 작업이 실패합니다. ## Management Agent 옵션을 DB 인스턴스에 활성화 Management Agent 옵션을 활성화하려면 다음 단계를 사용합니다. **Topics** + [1단계: Management Agent 옵션을 DB 인스턴스에 추가](#Oracle.Options.OEMAgent.Add) + [2단계: DBSNMP 사용자 계정 잠금 해제](#Oracle.Options.OEMAgent.DBSNMP) + [3단계: Management Agent 콘솔에 대상 추가](#Oracle.Options.OEMAgent.Using) ### 1단계: Management Agent 옵션을 DB 인스턴스에 추가 DB 인스턴스에 Management Agent 옵션을 추가하려면 다음을 수행하세요. 1. 새 옵션 그룹을 생성하거나 기존 옵션 그룹을 복사 또는 수정합니다. 1. [] 옵션을 옵션 그룹에 추가합니다. 1. 옵션 그룹을 DB 인스턴스에 연동시킵니다. 오류가 발생할 경우 [My Oracle Support](https://support.oracle.com/) 문서에서 특정 문제를 해결하는 자세한 내용을 확인합니다. Management Agent 옵션을 추가한 후 DB 인스턴스를 재시작할 필요가 없습니다. 옵션 그룹이 활성화되자마자 OEM Agent가 활성화됩니다. OMS 호스트가 신뢰할 수 없는 타사 인증서를 사용하는 경우 Amazon RDS가 다음 오류를 반환합니다. ``` 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. ``` 이 오류가 반환되면 문제가 해결될 때까지 관리 에이전트 옵션을 사용할 수 없습니다. 문제 해결에 대한 정보는 My Oracle Support 설명서 [2202569.1](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2202569.1)을 참조하십시오. #### 콘솔 **Management Agent 옵션을 DB 인스턴스에 추가하려면** 1. 사용할 옵션 그룹을 결정합니다. 새 옵션 그룹을 생성하거나 기존 옵션 그룹을 사용합니다. 기존 옵션 그룹을 사용하려면 다음 단계로 건너뛰십시오. 그렇지 않으면 다음 설정을 사용하여 사용자 지정 DB 옵션을 생성합니다. 1. [**Engine**]에서 DB 인스턴스의 Oracle 에디션을 선택합니다. 1. **메이저 엔진 버전**에서 DB 인스턴스의 버전을 선택합니다. 자세한 내용은 [옵션 그룹 생성](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create) 섹션을 참조하세요. 1. [**OEM\$1AGENT**] 옵션을 옵션 그룹에 추가하고 옵션 설정을 구성합니다. 옵션 추가에 대한 자세한 내용은 [옵션 그룹에 옵션 추가](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption) 섹션을 참조하세요. 각 설정에 대한 자세한 내용은 [Management Agent 옵션 설정](#Oracle.Options.OEMAgent.Options) 섹션을 참조하십시오. 1. 옵션 그룹을 새 DB 인스턴스 또는 기존 DB 인스턴스에 적용합니다: + 새 DB 인스턴스의 경우, 인스턴스를 시작할 때 옵션 그룹을 적용합니다. 자세한 내용은 [Amazon RDS DB 인스턴스 생성](USER_CreateDBInstance.md) 섹션을 참조하세요. + 기존 DB 인스턴스의 경우, 해당 인스턴스를 수정하고 새 옵션 그룹을 연결하여 옵션 그룹을 적용합니다. 자세한 내용은 [Amazon RDS DB 인스턴스 수정](Overview.DBInstance.Modifying.md) 섹션을 참조하세요. #### AWS CLI 다음 예에서는 AWS CLI [add-option-to-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) 명령을 사용하여 `OEM_AGENT` 옵션을 `myoptiongroup`이라는 옵션 그룹에 추가합니다. 대상 LinuxmacOS, 또는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 ``` 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 ``` ### 2단계: DBSNMP 사용자 계정 잠금 해제 Management Agent는 `DBSNMP` 사용자 계정을 사용하여 데이터베이스에 연결하고 Oracle Enterprise Manager에 문제를 보고합니다. CDB에서 `DBSNMP`는 일반 사용자입니다. 이 사용자 계정은 Management Agent와 OEM Database Express 모두에 필요합니다. 기본적으로 이 계정은 잠겨 있습니다. 이 계정의 잠금을 해제하는 절차는 데이터베이스가 비CDB 아키텍처를 사용하는지 아니면 CDB 아키텍처를 사용하는지에 따라 달라집니다. **DBSNMP 사용자 계정을 잠금 해제하려면** 1. SQL\$1Plus 또는 다른 Oracle SQL 애플리케이션에서 마스터 사용자로 DB 인스턴스에 로그인합니다. 1. 데이터베이스 아키텍처에 따라 다음 작업 중 하나를 수행합니다. **데이터베이스가 CDB가 아닙니다.** 다음 SQL 문을 실행합니다. ``` 1. ALTER USER dbsnmp IDENTIFIED BY new_password ACCOUNT UNLOCK; ``` **데이터베이스가 CDB입니다.** 다음 저장 프로시저를 실행하여 `DBSNMP` 계정을 잠금 해제합니다. ``` 1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password'); ``` 프로시저가 존재하지 않는다는 오류 메시지가 표시되면 CDB 인스턴스를 재부팅하여 자동으로 설치합니다. 자세한 내용은 [ DB 인스턴스 재부팅](USER_RebootInstance.md) 섹션을 참조하세요. ### 3단계: Management Agent 콘솔에 대상 추가 DB 인스턴스를 대상으로 추가하려면 엔드포인트와 포트를 알고 있어야 합니다. 사용자의 Amazon RDS DB 인스턴스에 대한 엔드포인트를 찾는 방법은 [RDS for Oracle DB 인스턴스의 엔드포인트 찾기](USER_Endpoint.md) 섹션을 참조하십시오. 데이터베이스에서 CDB 아키텍처를 사용하는 경우 `CDB$ROOT` 컨테이너를 별도로 대상으로 추가하세요. **Management Agent 콘솔에 대상을 추가하려면** 1. OMS 콘솔에서 [**Setup**], [**Add Target**], [**Add Targets Manually**]를 선택합니다. 1. [**Add Targets Declaratively by Specifying Target Monitoring Properties**]를 선택합니다. 1. [**Target Type**]에서 [**Database Instance**]를 선택합니다. 1. **Monitoring Agent(모니터링 에이전트)**에서 RDS DB 인스턴스 식별자와 동일한 식별자가 있는 에이전트를 선택합니다. 1. [**Add Manually**]를 선택합니다. 1. Amazon RDS DB 인스턴스의 엔드포인트를 입력하거나 호스트 이름 목록에서 이를 선택합니다. 지정된 호스트 이름이 Amazon RDS DB 인스턴스의 엔드포인트와 일치하는지 확인합니다. 1. 다음 데이터베이스 속성을 지정합니다. + **대상 이름**에 이름을 입력합니다. + **Database system name(데이터베이스 시스템 이름)**에 이름을 입력합니다. + **Monitor username(모니터 사용자 이름)**에 **dbsnmp**를 입력합니다. + **모니터 암호**에 [2단계: DBSNMP 사용자 계정 잠금 해제](#Oracle.Options.OEMAgent.DBSNMP)의 암호를 입력합니다. + **역할**에 **normal**을 입력합니다. + **Oracle home path(Oracle 홈 경로)**에 **/oracle**을 입력합니다. + [**Listener Machine name**]에는 에이전트 식별자가 이미 나타나 있습니다. + **포트**에 데이터베이스 포트를 입력합니다. RDS 기본 포트는 1521입니다. + **데이터베이스 이름**에 데이터베이스 이름을 입력합니다. 데이터베이스가 CDB인 경우 이름은 `RDSCDB`입니다. 1. [**Test Connection**]을 선택합니다. 1. [**Next**]를 선택합니다. 모니터링되는 리소스 목록에 대상 데이터베이스가 나타납니다. ## Management Agent 옵션 제거 DB 인스턴스에서 OEM Agent를 제거할 수 있습니다. OEM Agent를 제거한 후 DB 인스턴스를 재시작할 필요가 없습니다. DB 인스턴스에서 OEM Agent를 제거하려면 다음 중 하나를 수행합니다. + OEM Agent가 속한 옵션 그룹에서 OEM Agent 옵션을 제거합니다. 이 변경은 해당 옵션 그룹을 사용하는 모든 DB 인스턴스에 영향을 미칩니다. 자세한 내용은 [옵션 그룹에서 옵션 제거](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption) 섹션을 참조하세요. + DB 인스턴스를 수정하고, OEM Agent 옵션이 포함되지 않은 다른 옵션 그룹을 지정합니다. 이 변경은 단일 DB 인스턴스에 영향을 미칩니다. 기본(빈) 옵션 그룹을 지정하거나 다른 사용자 지정 옵션 그룹을 지정할 수 있습니다. 자세한 내용은 [Amazon RDS DB 인스턴스 수정](Overview.DBInstance.Modifying.md) 섹션을 참조하세요. ## Management Agent를 사용하여 데이터베이스 작업 수행 Amazon RDS 프로시저를 사용하여 Management Agent에서 특정 EMCTL 명령을 실행할 수 있습니다. 이 프로시저를 실행하면 다음과 같은 작업을 수행할 수 있습니다. **참고** 작업은 비동기식으로 실행됩니다. **Topics** + [Management Agent 보호](#Oracle.Options.OEMAgent.DBTasks.SecureAgent) + [Management Agent의 상태 가져오기](#Oracle.Options.OEMAgent.DBTasks.GetAgentStatus) + [Management Agent 다시 시작](#Oracle.Options.OEMAgent.DBTasks.RestartAgent) + [Management Agent가 모니터링하는 대상 나열](#Oracle.Options.OEMAgent.DBTasks.ListTargets) + [Management Agent가 모니터링하는 수집 스레드 나열](#Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads) + [Management Agent 상태 지우기](#Oracle.Options.OEMAgent.DBTasks.ClearState) + [Management Agent에서 OMS 업로드](#Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS) + [OMS에 대해 ping 실행](#Oracle.Options.OEMAgent.DBTasks.PingOMS) + [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) ### Management Agent 보호 Management Agent를 보호하려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent`를 실행합니다. 이 프로시저는 `emctl secure agent` 명령을 실행하는 것과 동일합니다. 다음 프로시저에서는 Management Agent를 보호하는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 보려면 [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) 섹션을 참조하세요. ### Management Agent의 상태 가져오기 Management Agent의 상태를 가져오려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent`를 실행합니다. 이 프로시저는 `emctl status agent` 명령과 동일합니다. 다음 절차에서는 Management Agent의 상태를 가져오는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent() as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 보려면 [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) 섹션을 참조하세요. ### Management Agent 다시 시작 Management Agent를 다시 시작하려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent`를 실행합니다. 이 프로시저는 `emctl stop agent` 및 `emctl start agent` 명령을 실행하는 것과 동일합니다. 다음 절차에서는 Management Agent를 다시 시작하는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 보려면 [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) 섹션을 참조하세요. ### Management Agent가 모니터링하는 대상 나열 Management Agent가 모니터링하는 대상을 나열하려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent`를 실행합니다. 이 프로시저는 `emctl config agent listtargets` 명령을 실행하는 것과 동일합니다. 다음 절차에서는 Management Agent가 모니터링하는 대상을 나열하는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 보려면 [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) 섹션을 참조하세요. ### Management Agent가 모니터링하는 수집 스레드 나열 Management Agent가 모니터링하는 실행 중, 준비된 및 예약된 수집 스레드를 모두 나열하려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent`를 실행합니다. 이 프로시저는 `emctl status agent scheduler` 명령과 동일합니다. 다음 절차에서는 컬렉션 스레드를 나열하는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent() as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 보려면 [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) 섹션을 참조하세요. ### Management Agent 상태 지우기 Management Agent 상태를 지우려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent`를 실행합니다. 이 프로시저는 `emctl clearstate agent` 명령을 실행하는 것과 동일합니다. 다음 절차에서는 Management Agent의 상태를 지우는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent() as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 보려면 [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) 섹션을 참조하세요. ### Management Agent에서 OMS 업로드 Management Agent가 관련 OMS(Oracle Management Server)를 업로드하도록 하려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent`를 실행합니다. 이 프로시저는 `emclt upload agent` 명령을 실행하는 것과 동일합니다. 다음 절차에서는 Management Agent가 연관된 OMS를 업로드하는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent() as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 보려면 [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) 섹션을 참조하세요. ### OMS에 대해 ping 실행 Management Agent의 OMS에 대해 ping을 실행하려면 Amazon RDS 프로시저 `rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent`를 실행합니다. 이 프로시저는 `emctl pingOMS` 명령을 실행하는 것과 동일합니다. 다음 절차에서는 Management Agent의 OMS에 대해 ping을 수행하는 작업을 생성하고 작업 ID를 반환합니다. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent() as TASK_ID from DUAL; ``` 작업의 출력 파일을 표시하여 결과를 보려면 [진행 중인 작업 상태 보기](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) 섹션을 참조하세요. ### 진행 중인 작업 상태 보기 진행 중인 작업의 상태를 bdump 파일에서 볼 수 있습니다. 이 bdump 파일은 `/rdsdbdata/log/trace` 디렉터리에 위치합니다. 각 bdump 파일 이름은 다음 형식으로 되어 있습니다. ``` dbtask-task-id.log ``` 작업을 모니터링하려면 `task-id`를 모니터링하려는 작업의 ID로 바꾸십시오. bdump 파일의 콘텐츠를 보려면 Amazon RDS 프로시저 `rdsadmin.rds_file_util.read_text_file`을 실행합니다. 다음 쿼리는 `dbtask-1546988886389-2444.log` bdump 파일의 콘텐츠를 반환합니다. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-1546988886389-2444.log')); ``` Amazon RDS 프로시저 `rdsadmin.rds_file_util.read_text_file`에 대한 자세한 내용은 [DB 인스턴스 디렉터리의 파일 목록 읽기](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) 섹션을 참조하십시오.