관리 클라이언트 정보

관리 클라이언트는 명령행 유틸리티입니다. 마이크로 서비스가 게시한 REST API를 사용하여 Oracle GoldenGate 배치의 제어 및 구성 작업을 수행합니다.

관리 클라이언트는 Oracle GoldenGate 프로세스를 작성, 수정 및 제거하는 데 사용할 수 있는 명령행 유틸리티이며, MA 웹 사용자 인터페이스 대신 사용할 수 없습니다. 관리 클라이언트 프로그램은 $OGG_HOME/bin 디렉토리에 있습니다. 여기서 $OGG_HOME는 Oracle GoldenGate 홈 디렉토리입니다. 관리 클라이언트 프로그램의 이름은 adminclient입니다.

관리 클라이언트와 배치 간의 접속을 자동화해야 하는 경우 Oracle 전자 지갑을 통해 사용자 인증서를 저장할 수 있습니다. 저장된 인증서의 특성은 다음과 같아야 합니다.

단일 사용자 이름(계정) 및 비밀번호
관리 클라이언트가 실행되는 환경의 로컬
현재 로그인된 사용자에게만 제공
관리 클라이언트가 관리
인증서 이름을 사용하여 참조
Oracle GoldenGate 배치 및 프록시 접속에 대해 사용 가능.

관리 작업에 관리 클라이언트를 사용하려면 Service Manager와 관리 서비스에서 작동하는 사용자 인증서가 필요합니다. 관리 클라이언트 작업에 필요한 구성은 다음과 같습니다.

Oracle 소프트웨어의 bin 디렉토리가 PATH 환경 변수의 일부인지 확인합니다.
```
 export PATH=ogg_install_location/bin:$PATH
```
SSL 인증서 파일(.pem 또는 .der)을 사용하여 보안 배치를 구성하는 경우 OGG_CLIENT_TLS_CAPATH 환경 변수를 추가해야 합니다. 이는 관리 클라이언트에서 배치에 접속하는 데 필요합니다. 이 변수는 호스트에서 인증서 파일이 있는 위치를 지정하는 데 사용됩니다. 서버 인증서 검증만 필요한 클라이언트의 경우 OGG_CLIENT_TLS_CAPATH 환경 변수는 클라이언트가 접속되어야 하는 서버와 공유되는 신뢰할 수 있는 CA 인증서가 포함된 파일을 참조해야 합니다.
```
 export OGG_CLIENT_TLS_CAPATH = <em>deployment_rootCA_certificate_location</em>
```
주: Microsoft Windows의 경우 기본 인증서 파일 형식은 .der이며 기타 모든 플랫폼은 .pem을 기본 형식으로 사용합니다.
다음과 같이 명령을 실행합니다.
```
 [oracle]$ adminclient
```
출력에는 관리 클라이언트에서 배치에 접속할 수 있는 Oracle GoldenGate 관리 클라이언트 프롬프트가 표시됩니다. 사용자 이름과 비밀번호에 대한 별칭을 생성하고, 스크립트에서 별칭 이름을 사용하여 서버에 접속할 수 있습니다.
```
 OGG (not connected) 1> ADD CREDENTIALS admin USER ggadmin PASSWORD *********
```
여기서는 서버의 실제 사용자 ggadmin과 비밀번호 **에 대해 admin이라는 별칭이 생성됩니다.

이제 아래 명령을 사용하여 관리 클라이언트에서 서비스에 접속합니다. Adminclient는 스크립트를 실행하는 사용자의 $HOME 디렉토리에 있는 전자 지갑에서 실제 사용자 이름과 비밀번호를 가져오고, 해당 인증서를 사용하여 서비스에 접속합니다.
```
CONNECT http(s)://my.gg.server.com AS admin
```
보안 사용자로 관리 클라이언트에서 배치 또는 프록시 서버에 접속합니다. 이는 OGGCA를 사용하여 Oracle GoldenGate 인스턴스에 대한 배치를 추가하는 동안 생성한 사용자입니다.

CONNECT http(s)://localhost:port DEPLOYMENT deployment name AS security role user PASSWORD password

주: 관리 클라이언트에서 보안 또는 비보안 배치에 접속할 비밀번호의 끝에 느낌표(!)가 있을 때 단일 행에서 CONNECT 명령을 사용할 때 큰 따옴표 안에 비밀번호를 입력해야 합니다. 그렇지 않으면 비밀번호가 수락되지 않고 접속이 실패합니다. 이는 강력한 비밀번호 정책을 사용하는 모든 배치에 필요합니다.

구문:
```
CONNECT server-url [ DEPLOYMENT deployment-name]
                     [ ( (   AS       deployment-credentials-name
                           | USER     deployment-user-name )
                           [ PASSWORD deployment-password  ] )
                     | TOKEN [ access-token ] ]
                     [ PROXY      proxy-uri
                     [ ( AS       proxy-credentials-name
                     |   USER     proxy-user-name      )
                       [ PASSWORD proxy-password ] ] ] [ ! ]
```
자세한 내용은 Oracle GoldenGate에 대한 명령줄 인터페이스 참조의 CONNECT 명령을 참조하십시오.

주: 데이터베이스 인증서 저장에 사용되는 Oracle 전자 지갑이 관리자 서비스에서 관리되므로 배치 인증서는 인증서 저장소에 USERIDALIAS로 저장할 수 없습니다. 대신 별도의 Oracle 전자 지갑이 관리 클라이언트용으로 생성됩니다. Oracle 전자 지갑은 사용자 홈 디렉토리에 저장됩니다.

다음 예에서는 관리 클라이언트에서 배치에 접속하기 위해 Oracle GoldenGate 배치 사용자를 추가하는 방법을 보여줍니다.
```
ADD CREDENTIALS admin USER ggadmin PASSWORD *********
```
사용자에 대한 비밀번호는 숨겨진 GoldenGate 디렉토리 $HOME에 저장됩니다.

출력:
```
2019-02-14T00:35:38Z  INFO OGG-15114  Credential store altered.
```
다음 예에서는 사용자 이름과 비밀번호에 대한 별칭을 추가하고 이를 사용하여 관리 클라이언트에서 배치에 접속하는 방법을 보여줍니다.
```
 ADD CREDENTIALS admin USER ggadmin PASSWORD *********
```
관리 클라이언트는 스크립트를 실행하는 사용자의 $HOME 디렉토리에 있는 전자 지갑에서 실제 유저 이름과 암호를 가져와서 해당 인증서를 사용하여 서비스에 연결합니다.

출력:
```
2019-02-14T00:35:38Z  INFO OGG-15114  Credential store altered.
```
다음 예에서는 관리 클라이언트에서 배치에 접속하기 위해 Oracle GoldenGate 배치 프록시 사용자를 추가하는 방법을 보여줍니다.
```
ADD CREDENTIALS proxy USER proxyadmin PASSWORD ********
```
다음은 관리 클라이언트를 사용하여 배치에 액세스하기 위해 CONNECT 명령을 사용하는 예입니다.
```
OGG (Not Connected)4> CONNECT http://www.example.com:12000 deployment EAST PROXY http:111.1.1.1:3128 as proxyadmin password oggadmin-A2
Using default deployment 'Local'
OGG (http://www.example.com:12000 Local) 4>
```
HELP 명령을 사용하여 관리 클라이언트 명령의 전체 목록을 볼 수 있습니다. HELP SHOWSYNTAX 명령을 사용하여 특정 명령에 대한 구문을 볼 수 있습니다.