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

최종 업데이트 날짜: 2020년 12월 3일

Oracle을 실행하는 Amazon Relational Database Service(Amazon RDS) DB 인스턴스가 있습니다. DB 인스턴스에서 OEM_AGENT 옵션을 사용하려고 하면 오류가 발생합니다. OEM_AGENT 옵션을 사용할 때 발생하는 일반적인 오류를 해결하고 문제를 해결하려면 어떻게 해야 합니까?

간략한 설명

Amazon RDS는 OEM_AGENT 옵션을 사용하여 Oracle Enterprise Manager(OEM) 관리 에이전트를 지원합니다. Amazon RDS Oracle DB 인스턴스에서 OEM_AGENT 옵션을 사용할 때 이 문서에서 설명하는 오류 중 하나가 발생할 수 있습니다.

참고: 문제 해결 단계를 진행하기 전에 DB 인스턴스에 대해 다음과 같은 사전 검사를 실행하세요.

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

2. OMS 서버에서 OEM 에이전트 포트 및 데이터베이스 포트의 DB 인스턴스로 텔넷 테스트를 실행하여 연결을 확인합니다.

3. ACL(네트워크 액세스 제어 목록) 및 라우팅 테이블 등 네트워크 구성을 확인합니다. 구성을 확인하면 차단 기능 또는 명시적 거부의 가능성이 배제됩니다.

4. OMS 서버에서 대상 DB 인스턴스로의 포트가 열려 있는지 확인합니다.

    위의 검사를 완료한 후 OEM_AGENT 업로드가 작동하는지 확인합니다. OEM_AGENT 사전 조건에 대한 자세한 내용은 Oracle Management Agent for Enterprise Manager Cloud Control을 참조하세요.

    발생한 오류나 문제에 따라 이 문서의 단계를 따릅니다.

    해결 방법

    오류: 에이전트 암호가 잘못되었거나 만료되어 Oracle OEM_AGENT를 설치할 수 없음

    에이전트 암호가 올바른지, 만료되지 않았는지 확인합니다. OEM 서버에서 기존 에이전트 등록 암호를 수정하거나 새 암호를 만들 수 있습니다.

    오류: DB 인스턴스가 OMS 호스트에 도달할 수 없으므로 Oracle OEM_AGENT를 설치할 수 없음

    RDS 호스트에서 OMS 호스트/포트에 연결할 수 없음으로 인해 OEM_AGENT가 설치되지 않을 때 이 오류가 발생합니다. 이 문제를 해결하려면 DB 인스턴스에서 OMS 호스트에 연결할 수 있는지 확인합니다.

    1. DB 인스턴스와 동일한 네트워크 설정(SG/ACL)을 사용하여 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스를 시작합니다.

    2. 포트 4903에서 OMS 호스트에 대해 텔넷 명령을 실행합니다.

    From EC2 instance: telnet OMS_HOST 4903

    3. OMS 서버에서 DB 인스턴스로 텔넷 테스트를 실행하여 연결을 확인합니다.

    From OMS host: telnet RDS-instance-endpoint 1521 (RDS default port)

    4. RDS 호스트가 OMS 호스트 이름을 IP 주소로 확인할 수 있는지 점검합니다.

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

    오류: DB 인스턴스에 OEM_AGENT 옵션을 성공적으로 설치했습니다. 보안 그룹이 올바르게 구성되지 않았을 수 있음

    설치가 올바르게 완료되더라도, DB 인스턴스와 연결된 RDS 보안 그룹에 OMS 호스트와 DB 인스턴스 간의 통신을 허용하는 구성이 누락되었을 수 있습니다.

    이 오류를 해결하려면 에이전트 포트가 인바운드 트래픽을 허용하고 OMS 호스트가 에이전트 포트에 대한 액세스 권한이 있는 보안 그룹에 속하는지 확인합니다. 자세한 내용은 Oracle Management Agent for Enterprise Manager Cloud Control을 참조하세요.

    오류: OMS 호스트 버전 13.3.0.0이 에이전트 버전 12.1.0.5와 호환되지 않으므로 Oracle OEM_AGENT를 설치할 수 없습니다.

    OEM_AGENT 버전과 OMS 호스트 버전 간에 호환성 문제가 있는 경우 이 오류가 발생합니다. 현재 OEM_AGENT는 두 구성 요소가 동일한 버전을 실행할 때 OMS와 통합됩니다. 이 오류를 해결하려면 OMS 호스트 및 OEM 에이전트에 대해 호환되는 버전을 선택합니다.

    오류: OMS 호스트가 신뢰할 수 없는 타사 인증서를 사용하고 있음

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

    오류: OEM_AGENT 옵션에 필요한 옵션 설정이 누락되었습니다(서비스: AmazonRDS, 상태 코드: 400; 오류 코드: InvalidParameterValue;

    OEM_AGENT에 필요한 설정 중 하나가 누락되어 업데이트해야 할 때 이 오류가 발생합니다. OEM_AGENT의 필수 설정에 대한 자세한 내용은 Option settings for Management Agent를 참조하세요.

    이 오류를 해결하려면 OEM_AGENT 옵션의 설정을 검토합니다.

    1. Amazon RDS 콘솔을 엽니다.

    2. 탐색 페이지에서 [옵션 구성(Option configuration)]을 선택합니다.

    3. [옵션 설정(Option settings)] 섹션에서 OMS_HOST 구성을 찾습니다. 옵션 설정 패널에는 기본적으로 5개의 리소스만 표시되므로 한 페이지에 모든 설정을 표시하도록 기본 설정을 업데이트해야 합니다.

    4. 필요한 설정을 입력한 후 옵션 그룹에 대한 OEM_AGENT 옵션을 추가합니다.

      오류: 하트비트 상태: OMS가 잘못 응답함 [오류 - 대상 업데이트 실패]

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

      1. 에이전트 상태를 지우거나 Management Agent를 사용한 데이터베이스 태스크 수행의 단계를 사용하여 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_version 출력에 옵션 그룹에 사용된 OEM_AGENT 버전이 포함되어 있지 않으면 명령 출력에 나열된 OEM_AGENT 버전을 설치합니다.

      오류: 데이터베이스 인스턴스가 OEM 콘솔의 대상에 표시되지 않음

      기본 호스트에 대한 SSH가 Amazon RDS에서 제한되어 있기 때문에 이 오류가 발생합니다. 자동 검색이 올바르게 작동하기 위한 OS 수준에서의 필수 조건입니다.

      대상 Oracle DB 인스턴스를 추가할 때 사용되는 마법사 기반 자동 검색과는 달리 Oracle DB 인스턴스를 대상으로 수동으로 추가해야 합니다. 이는 Oracle DB 인스턴스의 기본 호스트에 대한 제한으로 인해 필요합니다.

      Agent 제한에 대한 자세한 내용은 Oracle Management Agent for Enterprise Manager Cloud Control을 참조하세요.

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

      OEM_AGENT가 올바르게 작동하기 위한 구성이 잘못되었기 때문에 이 오류가 발생합니다. 예를 들어, OMS 포트와 OEM_AGENT 포트 모두에 대해 동일한 포트 번호를 지정했을 수 있습니다. 이 문제를 해결하려면 OMS 포트 또는 OEM_AGENT 포트 번호를 변경합니다.

      다음 Management Agent 설정을 검토합니다.

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

      emctl status oms -details

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

      DB 인스턴스에 대해 프로비저닝된 스토리지에 OEM_AGENT 사전 조건에 따라 필요시 사용 가능한 스토리지가 충분하지 않은 경우 이 오류가 발생합니다. 자세한 내용은 관리 에이전트의 사전 조건을 참조하세요. 스토리지 공간을 늘린 다음 OEM_AGENT 옵션을 다시 설치합니다.