關於管理從屬端

「管理從屬端」是命令行公用程式。它使用 Microservices 發布的 REST API 完成 Oracle GoldenGate 部署中的控制與組態作業。

「管理從屬端」是一個命令行公用程式，可用於建立、修改及移除 Oracle GoldenGate 處理作業，並可用於取代 MA Web 使用者介面。「管理從屬端」程式位於 $OGG_HOME/bin 目錄中，其中 $OGG_HOME 是 Oracle GoldenGate 本位目錄。「管理從屬端」程式的名稱是 adminclient。

如果您需要經由部署來自動化「管理從屬端」連線，可以使用 Oracle Wallet 儲存使用者證明資料。儲存的證明資料必須具有下列特性：

單一使用者名稱 (帳戶) 與密碼
位於執行「管理從屬端」的本機環境
只有目前已登入的使用者可使用
由「管理從屬端」管理
使用證明資料名稱的參照
可用於 Oracle GoldenGate 部署與代理主機連線。

若要使用「管理從屬端」來執行管理作業，您必須具備「服務管理程式」和「管理服務」都能夠使用的使用者證明資料。下列為使用「管理從屬端」所需的組態：

請確定 Oracle Software 的 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 命令，瞭解詳細資訊。

注意：部署證明資料無法儲存為證明資料存放區中的 USERIDALIAS，因為用來儲存資料庫證明資料的 Oracle 公事包是由「管理服務」所管理。但是系統會為「管理從屬端」建立個別的 Oracle Wallet。此 Oracle Wallet 儲存於使用者的本位目錄中。

下列範例顯示如何新增 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 指令來檢視特定指令的語法。