Amazon RDS for Oracle와 함께 OEM_AGENT 옵션을 사용할 때 발생하는 일반적인 오류를 해결하려면 어떻게 해야 합니까?

해결 방법

참고: AWS Command Line Interface(AWS CLI) 명령 실행 시 오류가 발생하는 경우, AWS CLI 오류 문제 해결을 참고하세요. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하세요.

Amazon RDS는 OEM_AGENT 옵션을 통해 Oracle Enterprise Manager(OEM) 관리 에이전트를 지원합니다.

먼저 DB 인스턴스에서 사전 점검을 실행한 다음 관련 오류 섹션을 확인합니다. OEM_AGENT 옵션을 사용할 때 발생하는 문제를 해결하려면 이러한 로그를 Amazon CloudWatch로 내보낸 후 OEM 에이전트 로그를 검토하세요. 자세한 내용을 알아보려면 Amazon CloudWatch 로그에 Oracle 로그 게시를 참조하세요.

사전 점검

해결 단계를 시작하기 전에 DB 인스턴스에서 다음 사전 점검을 완료하세요.

1. add-option-to-option-group AWS CLI를 사용하여 옵션 및 DB 인스턴스에 OEM_AGENT를 적용합니다.

2. 옵션 그룹 상태를 확인하려면 다음 AWS CLI 명령을 실행합니다.

   aws rds describe-db-instances --db-instance-identifier <db-instance-name> --query 'DBInstances[*].[Engine,DBInstanceStatus,OptionGroupMemberships]'

3. 출력 옵션 그룹 상태가 in-sync인지 확인합니다.
   옵션 그룹 상태가 INVALID 상태인 경우, 네트워크 구성 설정 및 기타 사전 요구 사항 문제로 인해 OEM_AGENT가 설치되지 않은 것입니다. AWS Management Console에서 Amazon RDS DB 인스턴스의 이벤트 탭을 검토하여 OEM_AGENT 옵션의 설치 상태를 확인합니다. 또한 AWS CLI 명령 describe-events를 사용할 수 있습니다. 이벤트에 OEM_AGENT 옵션 설치 또는 네트워크 구성에 문제가 있는 것으로 표시되면 OEM_AGENT 전제 조건이 충족되는지 확인하세요.

4. DB 인스턴스 네트워크 구성을 확인합니다. DB 인스턴스 보안 그룹은 OEM_AGENT 포트(기본값은 3872)와 RDS 포트(기본값은 1521)를 수신할 수 있도록 OMS_HOST를 허용해야 합니다.

5. Oracle Management Service(OMS) 서버에서 OEM_AGENT 포트 및 데이터베이스 포트의 DB 인스턴스로 텔넷 테스트를 실행하여 연결을 확인합니다.

6. 네트워크 구성 확인 예를 들어 네트워크 액세스 제어 목록(ACL) 및 라우팅 테이블을 확인하세요. 이렇게 하면 차단이나 명시적 거부의 가능성을 배제할 수 있습니다.

7. OMS와 RDS 간의 방화벽이 DB 리스너 포트와 OEM_AGENT 포트 모두에서 트래픽을 허용하는지 확인하세요.

이 단계를 완료한 후 OEM_AGENT 업로드가 제대로 작동하는지 확인하세요. 자세한 내용을 알아보려면 관리 에이전트를 통해 OMS 업로드하기를 참조하세요.

오류 문제 해결

OEM 콘솔의 대상 자동 검색에 DB 인스턴스가 표시되지 않습니다

이 문제는 OMS 서버가 SSH에서 기본 호스트에 연결할 수 없을 때 발생합니다. 이 연결은 자동 검색이 제대로 작동하기 위한 OS 수준의 전제 조건입니다. 이 오류를 해결하려면 수동으로 Oracle DB 인스턴스를 대상으로 추가해야 합니다. 자세한 내용을 알아보려면 관리 에이전트의 제한 사항을 참조하세요.

에이전트 암호가 잘못되었거나 만료되어 Oracle OEM_AGENT를 설치할 수 없습니다

상담원 비밀번호가 정확하고 만료되지 않았는지 확인하세요. OEM 서버를 사용하여 에이전트 등록 암호를 수정하거나 새 암호를 생성합니다.

DB 인스턴스가 OMS 호스트에 연결할 수 없어서 Oracle OEM_AGENT를 설치할 수 없습니다

RDS 호스트에서 OMS 호스트/포트에 연결할 수 없기 때문에 OEM_AGENT 설치에 실패하면 이 오류가 발생합니다. 이 오류를 해결하려면 DB 인스턴스에서 OMS 호스트에 연결할 수 있는지 확인하세요.

OMS 서버와 OEM_AGENT 간의 네트워크 연결을 확인하려면 Oracle용 RDS 인스턴스와 OMS 서버 간의 연결을 테스트하세요. 이렇게 하면 액세스 제어 목록(ACL) 및 UTL_TCP 패키지를 활용할 수 있습니다.

• 네트워크 ACL을 관리하기 위한 인터페이스를 제공하는 DBMS_NETWORK_ACL_ADMIN 패키지를 사용하세요. 자세한 내용을 알아보려면 오라클 웹 사이트의 DBMS_NETWORK_ACL_ADMIN 사용을 참조하세요.
• TCP/IP 연결을 나타내는 데 사용되는 PL/SQL 레코드 유형인 UTL_TCP.CONNECTION을 사용하세요. 자세한 내용을 알아보려면 Oracle 웹사이트의 UTL_TCP 사용을 참조하세요.

다음 단계를 완료하세요.

1. Amazon Elastic Compute Cloud(Amazon EC2) 콘솔을 엽니다.

2. DB 인스턴스와 동일한 네트워크 설정(SG/ACL) 으로 Amazon EC2 인스턴스를 시작합니다.

3. Amazon EC2 인스턴스에서 포트 4903의 OMS 호스트로 다음 텔넷 명령을 실행합니다.

   telnet OMS_HOST 4903

4. 연결을 확인하려면 OEM 호스트에서 OMS 서버에서 DB 인스턴스로 다음 텔넷 테스트 명령을 실행합니다.

   telnet RDS-instance-endpoint 1521 (RDS default port)

5. RDS 호스트가 OMS 호스트 이름을 IP 주소로 확인할 수 있는지 확인하려면 다음 명령을 실행합니다.

   SQL> SELECT UTL_INADDR.get_host_address('OMS_Host_Name') FROM dual;

6. TCP Traceroute를 실행하여 트래픽이 차단된 위치를 확인합니다.

OEM_AGENT 옵션을 DB 인스턴스에 설치했습니다. 보안 그룹이 제대로 구성되지 않았을 수 있습니다

설치가 제대로 완료되더라도 DB 인스턴스와 연결된 RDS 보안 그룹의 구성이 누락되었을 수 있습니다. 이러한 구성을 통해 OMS 호스트와 DB 인스턴스 간의 통신이 가능합니다.

이 오류를 해결하려면 에이전트의 보안 그룹이 인바운드 트래픽을 허용하는지 확인하세요. 그리고 OMS 호스트는 에이전트 포트에 액세스할 수 있는 보안 그룹에 속해 있어야 합니다. 자세한 내용을 알아보려면 Oracle 웹사이트의 Enterprise Manager 클라우드 컨트롤 보안 가이드를 참조하세요.

OMS 호스트 버전 x.x.x.x가 에이전트 버전 x.x.x.x와 호환되지 않기 때문에 Oracle OEM_AGENT를 설치할 수 없습니다.

OEM_AGENT 버전과 OMS 호스트 버전 간에 호환성 문제가 있는 경우 이 오류가 나타납니다. OEM_AGENT는 두 구성 요소가 모두 호환되는 경우 OMS와 통합됩니다. 이 오류를 해결하려면 OMS 호스트와 OEM 에이전트 모두에 대해 호환되는 버전을 선택하세요. 자세한 내용을 알아보려면 관리 에이전트 요구 사항을 참조하세요.

OMS 호스트가 신뢰할 수 없는 타사 인증서를 사용합니다

OEM_AGENT 옵션을 성공적으로 설치했지만 OMS 호스트가 신뢰할 수 없는 타사 인증서를 사용하는 경우 이 오류가 발생합니다. 이 오류를 해결하려면 타사의 필수 신뢰 인증을 사용하여 OMS 호스트를 구성하세요.

OEM_AGENT 옵션에 필수 옵션 설정이 누락되었습니다(Service: AmazonRDS; Status Code: 400; Error Code: InvalidParameterValue)

OEM_AGENT에 필수 설정이 누락된 경우 이 오류가 나타납니다. 이 설정을 지정해야 합니다. OEM_AGENT의 필수 설정에 대한 자세한 내용을 알아보려면 관리 에이전트의 옵션 설정을 참조하세요.

하트비트 상태: OMS가 잘못 응답했습니다 [ERROR - Failed to Update Target Type Metadata]

OEM_AGENT 옵션을 Amazon RDS에 연결한 후 OMS 호스트를 교체하면 이 오류가 발생합니다.

이 오류를 해결하려면 다음 단계를 완료하세요.

1. 에이전트 상태를 지우거나 OEM_AGENT를 다시 시작합니다. 자세한 내용을 알아보려면 관리 에이전트 관리를 참조하세요.

2. OMS 호스트와의 연결을 다시 설정합니다.

3. OMS 버전 및 OEM_AGENT 버전과의 호환성 문제를 확인하세요. 테이블에 옵션 그룹에 사용된 OEM_AGENT 버전이 표시되는지 확인하려면 다음 명령을 실행합니다.

   select type_meta_ver from sysman.mgmt_target_type_versions where target_type = 'oracle_emd';

4. mgmt_target_type_versions 출력에 옵션 그룹에 사용된 OEM_AGENT 버전이 포함되어 있지 않으면 명령 출력에 나열된 OEM_AGENT 버전을 설치합니다. 이 오류는 필요한 OMS 측 패치 및 플러그인이 누락되었음을 나타냅니다. OMS가 올바르게 설정되고 필요한 패치가 모두 적용되었는지 확인하세요.

에이전트가 차단된 경우 OEM 콘솔에서 다음 단계를 완료하여 에이전트를 재동기화하세요.

1. Cloud Control 콘솔에 로그인합니다.
2. 설정을 선택하고 Cloud Control 관리를 선택한 다음 에이전트를 선택합니다.
3. 재동기화하려는 에이전트를 선택합니다.
4. 에이전트 메뉴에서 **재동기화...**를 선택합니다.
5. 에이전트 재동기화가 성공적으로 완료되면 에이전트 차단 해제를 선택합니다.
6. 계속을 선택합니다. 재동기화 작업이 작업으로 제출되었습니다.
7. 작업 이름 링크를 선택하여 재동기화 작업의 상태를 확인합니다.

작업이 완료된 후 재동기화한 에이전트와 모니터링된 모든 대상의 상태를 확인합니다.

참고: OEM 모니터링이 효과적으로 작동하려면 DNS 서버에 지속적인 기능이 있어야 합니다. 에이전트는 하트비트를 내보내고 상태 업데이트를 OMS 호스트에 푸시합니다. 에이전트에서 OMS 호스트에 장기간 연결할 수 없는 경우 OMS는 에이전트와 데이터베이스가 작동 중지되었음을 표시합니다. DNS 서버가 제대로 작동하는지 확인하세요.

Oracle Management 에이전트가 관련 OMS를 업로드하도록 하려면 다음 명령을 실행합니다. 이 명령을 실행할 때는 emctl 업로드 에이전트 명령을 실행할 때와 동일합니다. 자세한 내용을 알아보려면 Oracle 웹사이트의 관리 에이전트에 대한 EMCTL 명령을 참조하세요.

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

에이전트 상태가 지워진 후 OEM 에이전트를 다시 시작하려면 다음 명령을 실행합니다.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent() as TASK_ID from DUAL;

Oracle Management Agent 13c 릴리스 4(13.4.0.0.0)에는 Oracle Enterprise Manager Cloud Control 13c 릴리스 4(13.4.0.0)만 배포할 수 있습니다. OMS가 13c 릴리스 4로 업그레이드된 후에는 이전 버전의 Oracle Management Agent(13.2 및 13.3)를 새로 배포하는 것이 지원되지 않습니다. 자세한 내용을 알아보려면 Oracle 웹사이트에서 Enterprise Manager System 설치를 시작하기 전에를 참조하세요.

에이전트 포트가 OMS 포트와 충돌하므로 OEM_AGENT 옵션을 설치할 수 없습니다. 옵션 설정을 업데이트하고 다시 시도하세요

OEM_AGENT가 제대로 작동하도록 잘못 구성했기 때문에 이 오류가 나타납니다. OMS 포트와 OEM_AGENT 포트 모두에 동일한 포트 번호를 지정했을 수 있습니다. 이 오류를 해결하려면 OMS 포트 또는 OEM_AGENT 포트 번호를 변경하세요. 다음 관리 에이전트 옵션 설정을 검토하세요.

• AGENT_PORT. DB 인스턴스의 이 포트는 OMS 호스트를 수신합니다. 기본값은 3872입니다. OMS 호스트는 이 포트에 액세스할 수 있는 보안 그룹에 속해야 합니다.
• OMS_PORT. OMS 호스트의 이 HTTPS 포트는 관리 에이전트를 수신합니다. HTTPS 업로드 포트를 찾으려면 OMS 호스트에 연결하고 다음 명령을 실행합니다.

  emctl status oms -details

DB 인스턴스에 충분한 스토리지가 없기 때문에 Oracle OEM_AGENT를 설치할 수 없습니다. 옵션 그룹이 DB 인스턴스 클래스 및 구성에서 지원되는지 확인합니다. 그렇다면 모든 옵션 그룹 설정을 확인하고 다시 시도하세요

OEM_AGENT 사전 요구 사항에 정의된 대로 DB 인스턴스의 스토리지에 사용 가능한 스토리지가 충분하지 않을 때 이 오류가 발생합니다. 스토리지 공간을 늘린 다음 OEM_AGENT 옵션을 다시 설치합니다.

Filesystem / has X.XX% available space

Oracle용 RDS 인스턴스의 OEM_AGENT 옵션의 사용 제한으로 인해 이 오류가 발생합니다. 호스트 메트릭과 프로세스 목록은 실제 시스템 상태를 반영하지 않을 수 있습니다. OEM을 사용하여 루트 파일 시스템 또는 마운트 지점 파일 시스템을 모니터링하지 마세요. 자세한 내용을 알아보려면 관리 에이전트의 제한 사항을 참조하세요.

Amazon RDS 인스턴스의 루트 파일 시스템은 내부 자동화 시스템에서 유지 관리합니다. 이 자동화 시스템은 정기적으로 루트 파일 시스템을 모니터링하여 파일 시스템에 충분한 공간이 있는지 확인합니다. 스토리지 부족이 감지되면 자동화 시스템이 루트 파일 시스템에 적절한 공간을 추가합니다. 자동화 시스템이 루트 파일 시스템의 공간을 관리하므로 이 오류는 무시해도 됩니다.

관련 정보

Enterprise Manager Cloud Control용 Oracle 관리 에이전트