관리 클라이언트 사용

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

AdminClient 접근

관리 클라이언트를 사용하여 OCI GoldenGate에 접속하여 작업을 구성하고 프로세스 정보 및 로그 메시지를 봅니다. 다음 두 가지 방법 중 하나를 사용하여 관리 클라이언트를 실행할 수 있습니다.

• 배포 세부정보 페이지에서 관리 클라이언트 실행을 선택합니다.

• CloudShell을 실행한 다음 관리 클라이언트를 실행합니다.

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

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

1. Oracle Cloud 전역 탐색 표시줄에서 프로파일, 내 프로파일 순으로 선택합니다.

2. 프로파일 페이지의 리소스에서 내 액세스 토큰을 선택합니다.

3. 개인 액세스 토큰 생성에 대해 다른 API 호출을 선택합니다.

4. 관리 클라이언트를 사용하여 접속할 배치를 선택합니다.

5. 토큰 만료를 30분으로 설정합니다.

6. 토큰 다운로드를 선택합니다.

7. 다운로드한 토큰 파일을 열고 내용을 복사합니다.

8. 관리 클라이언트에서 다음 명령을 실행하여 배치에 연결합니다. <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. 배스천 생성을 선택합니다.

5. 세션 생성.

   1. 배스천이 활성 상태인 후 배스천 세부정보 페이지에서 세션 생성을 선택합니다.

   2. 세션 유형의 경우 SSH 포트 전달 세션 선택을 수행합니다.

   3. 세션에 대한 이름을 입력합니다.

   4. Connect to target using에 대해 IP Address를 선택한 다음 배치의 전용 IP를 입력합니다.

   5. Port에 443을 입력합니다.

   6. SSH 키 추가의 경우 Cloud Shell에서 공개 키(~/ssh/id_rsa.pub) 콘텐츠를 복사하여 붙여넣습니다.

   7. 세션 생성을 선택합니다.

6. 배스천 세션 상태가 활성화된 후 해당 작업 메뉴(줄임표 아이콘)에서 SSH 명령 보기를 선택합니다.

7. View SSH command 대화 상자에서 <private-key> 대신 개인 키(~/ssh/id_rsa)에 대한 경로를 입력하고 <local-port>를 배스천으로 연결을 전달할 Cloud Shell의 포트로 바꿉니다.

   주: Cloud Shell에서는 sudo 액세스 권한이 있는 포트에서 포트 전달을 허용하지 않으므로 권한이 없는 포트(예: 7443)를 사용해야 합니다. 명령이 포그라운드에서 한 번 실행되어 배스천 호스트를 known_hosts에 추가한 후 다음에 백그라운드에서 실행할 수 있도록 명령 끝에 앰퍼샌드(&)를 추가할 수 있습니다.

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

• Extract에 대한 통계 보기:

  view stats

• ggserror 로그 파일의 내용을 확인합니다.

  view messages

• Extract에서 더 이상 사용되지 않는 추적 파일 비우기:

  purge exttrail <trail-file-name>

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

알려진 문제

AdminClient: info profile 명령에 문제 발생

AdminClient에서 info profile 명령을 사용하면 오류 302가 반환됩니다.

임시해결책: 다음 REST API 명령을 사용합니다.

GET https://<deployment URL>/services/adminsrvr/v2/config/types/ogg:managedProcessSettings/values/ogg:managedProcessSettings:Default

AdminClient: 협상할 수 없음: 일치하는 호스트 키 유형을 찾을 수 없습니다.

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. 배포 세부정보 페이지에서 관리 클라이언트 실행을 선택합니다.