관리 클라이언트 사용

관리 클라이언트는 Oracle GoldenGate 및 OCI GoldenGate에서 작업을 제어하고 구성하기 위한 명령행 유틸리티입니다.

액세스 AdminClient

AdminClient을 사용하여 OCI GoldenGate에 접속하여 작업을 구성하고 프로세스 정보와 로그 메시지를 볼 수 있습니다. 두 가지 방법 중 하나로 AdminClient를 실행할 수 있습니다.

  • 배치 세부정보 페이지에서 AdminClient 실행을 누릅니다.
  • CloudShell을 실행하고 AdminClient를 실행합니다.

주:

컴퓨트 인스턴스에서 실행 중인 Oracle GoldenGate Marketplace 버전이 있는 경우 관리 클라이언트에 액세스하여 OCI GoldenGate 배치에 접속할 수 있습니다.

IAM 인증이 사용으로 설정된 배치의 경우 AdminClient를 사용하려면 먼저 액세스 토큰을 생성해야 합니다. 액세스 토큰을 생성하고 관리 클라이언트에 로그인하려면 다음과 같이 하십시오.

  1. Oracle Cloud 글로벌 탐색 표시줄에서 프로파일, 내 프로파일 순으로 누릅니다.
  2. 프로파일 페이지의 리소스에서 내 액세스 토큰을 누릅니다.
  3. 개인 액세스 토큰 생성에 대해 다른 API 호출을 선택합니다.
  4. AdminClient를 사용하여 접속할 배치를 선택합니다.
  5. 토큰 만료를 30분으로 설정합니다.
  6. 토큰 다운로드를 누릅니다.
  7. 다운로드한 토큰 파일을 열고 내용을 복사합니다.
  8. AdminClient에서 다음 명령을 실행하여 배치에 접속합니다. <deployment_url>를 배치의 세부정보 페이지에서 콘솔 URL로 바꾸고 <token>를 다운로드한 토큰 콘텐츠로 바꾸어야 합니다.
    connect <deployment_url> <token> !

자세한 내용은 AdminClient를 사용하여 IDCS 통합을 사용하여 GoldenGate에 연결하는 방법을 참조하십시오.

Cloud Shell을 통해 관리 클라이언트에 접속

Cloud Shell에서 공용 끝점을 사용하여 OCI GoldenGate 배치에 접속하려면 다음 명령을 실행합니다.
adminclient
connect <deployment-public-url-or-ip> as <goldengate-user> password <goldengate-password> !

주:

  • 배치의 URL 및 퍼블릭 IP 주소는 해당 배치 세부정보 페이지에서 찾을 수 있습니다.
  • 오류가 발생하는 경우 bash: adminclient: command not found, 다음 단계에 따라 Cloud Shell의 구조를 변경합니다.
    1. Cloud Shell의 작업 메뉴에서 아키텍처를 선택합니다.
    2. [구조] 대화상자에서 선호 아키텍처에 대해 X86_64을 선택한 다음 확인을 누릅니다.
배치에 전용 끝점이 있을 경우 배스천, 배스천 세션 및 SSH 터널을 생성해야 합니다.

주:

기본적으로 Cloud Shell은 Cloud Shell 관리 공용 네트워크를 사용으로 설정하지 않은 경우 테넌시 홈 영역의 OCI 내부 리소스에 대한 네트워크 액세스를 제한합니다. 관리자는 Cloud Shell 퍼블릭 네트워크를 사용으로 설정하도록 ID 정책을 구성해야 합니다. 자세한 내용은 Cloud Shell 네트워킹을 참조하십시오.

관리 클라이언트에서 프라이빗 OCI GoldenGate 배치에 접속하려면 다음과 같이 하십시오.

  1. Oracle Cloud 콘솔 전역 탐색 표시줄에서 Cloud Shell을 누릅니다. Cloud Shell에 처음 접속하는 경우 몇 분 정도 걸립니다.
  2. 다음 명령을 실행하여 SSH 키를 생성하거나, 배스천을 생성할 때 이 단계를 건너뛰고 키를 생성할 수 있습니다.
    ssh-keygen -t rsa

    기본 파일 이름을 유지하고 메시지가 표시되면 문장암호를 입력하지 마십시오. 개인 키는 ~/ssh/id_rsa에 있고 공개 키는 ~/ssh/id_rsa.pub에 있습니다.

  3. 배포 세부정보 페이지에서 배포의 개인 IP 및 서브넷 정보를 기록합니다.
  4. 배스천 생성.
    1. Oracle Cloud 콘솔 메뉴에서 ID 및 보안, 배스천을 차례로 선택합니다.
    2. 배스천 생성을 누릅니다.
    3. [배스천 생성] 패널에서 이름을 입력한 다음 배치가 상주하는 것과 동일한 서브넷을 선택합니다.
    4. CIDR 블록 허용 목록에 대해 0.0.0.0/0을 입력합니다.
    5. Create bastion을 누릅니다.
  5. 세션 생성.
    1. 배스천이 활성 상태가 되면 배스천 세부정보 페이지에서 세션 생성을 누릅니다.
    2. 세션 유형의 경우 SSH Port forwarding session을 선택합니다.
    3. 세션의 이름을 입력합니다.
    4. Connect to target using에 대해 IP Address를 선택한 다음 배치의 프라이빗 IP를 입력합니다.
    5. [포트]에 443을 입력합니다.
    6. Add SSH Key(SSH 키 추가)의 경우 Cloud Shell에서 퍼블릭 키(~/ssh/id_rsa.pub)의 콘텐츠를 복사하여 붙여넣습니다.
    7. 세션 생성을 누릅니다.
  6. 배스천 세션 상태가 활성인 후 작업 메뉴(줄임표 아이콘)에서 View SSH command를 선택합니다.
  7. View SSH command 대화 상자에서 <private-key> 대신 개인 키에 대한 경로(~/ssh/id_rsa)를 입력하고 <localport>를 배스천으로 연결을 전달할 Cloud Shell의 포트로 바꿉니다.

    주:

    Cloud Shell은 sudo 액세스 권한이 있는 포트에서 포트 전달을 허용하지 않으므로 7443과 같이 권한이 없는 포트를 사용해야 합니다. 명령이 포그라운드에서 한 번 실행되어 Bastion 호스트를 known_hosts에 추가한 후 다음에 백그라운드에서 실행할 수 있도록 명령 끝에 amperstand(&)를 추가할 수 있습니다.
  8. 명령을 복사한 다음 Cloud Shell에서 실행합니다. bind: Cannot assign requested address 메시지는 무시해도 됩니다.
  9. 관리 클라이언트를 시작합니다.
    adminclient
  10. OCI GoldenGate 배포에 연결합니다.
    connect 127.0.0.1:7443 as <goldengate-user> password <goldengate-password> !

    주:

    명령 끝에 있는 느낌표(!)는 매우 중요합니다. 이 명령이 없으면 명령이 실패하고 오류를 반환합니다.

관리 클라이언트 사용

성공적으로 연결한 후 다음 명령을 실행할 수 있습니다.

  • OCI GoldenGate 프로세스의 상태를 표시합니다.
    info all
  • 추출에 대한 통계 보기:
    view stats
  • ggserror 로그 파일의 내용을 확인합니다.
    view messages
  • 추출에서 더 이상 사용되지 않는 추적 파일 비우기:
    purge exttrail <trail-file-name>

전체 명령 목록은 AdminClient Command Line Interface Commands을 참조하십시오.

알려진 문제

AdminClient: <ip-address> 포트 22와 협상할 수 없음: 일치하는 호스트 키 유형을 찾을 수 없습니다.

Cloud Shell에서 AdminClient을 사용하여 배치에 접속할 때 다음 메시지가 발생할 수 있습니다.
FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Action completed. Waiting until the work request has entered state: ('SUCCEEDED',)
FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Cannot create ssh tunnelnel

해결 방법: 다음 단계를 완료합니다.

  1. 새 Cloud Shell 세션을 엽니다.
  2. 다음 명령을 사용하여 파일을 만듭니다.
    cat .ssh/config
  3. .ssh/config 파일에 다음을 입력하고 저장합니다.
    HostkeyAlgorithms ssh-rsa,ssh-ed25519
PubkeyAcceptedKeyTypes ssh-ed25519,ssh-rsa
  4. 기존 .ssh/known_hosts 파일이 있는 경우 삭제합니다.
  5. Cloud Shell 세션을 닫습니다.
  6. 배치 세부정보 페이지에서 관리 클라이언트 실행을 누릅니다.