1. Oracle GoldenGate Microservices Architectureの使用
  2. Admin Clientを使用する方法

A Admin Clientを使用する方法

Admin Clientはコマンドライン・ユーティリティです(クラシックGGSCIユーティリティに似ています)。これは、MAサーバーによって公開されたREST APIを使用して、Oracle GoldenGateデプロイメントでの管理と構成のタスクを実行します。

Admin Clientは、MAを使用するかわりに、プロセスを作成、変更および削除するために使用します。Administration ServerやDistribution ServerなどのMAサービスでは使用されません。たとえば、Extractの作成や新しいExtractアプリケーションのカスタマイズに必要なすべてのコマンドを実行するためにAdmin Clientを使用することも、Extractを構成するためにMAで利用可能なAdministration Serverを使用することもできます。

注意:

OGG_HOME、OGG_VAR_HOMEおよびOGG_ETC_HOMEが環境で正しく設定されていることを確認します。

環境変数の詳細は、「環境変数の設定」を参照してください。

Admin Clientを実行するには:

  1. 環境変数のOGG_HOME、OGG_ETC_HOME、OGG_VAR_HOMEを設定します。

  2. $OGG_HOME/binに移動して、次のコマンドを実行します。
    [oracle@bigdatalite bin]$ ./adminclient
Oracle GoldenGate Administration Client for Oracle
Version 18.1.0.0.0 OGGCORE_18.1.0.0.0_PLATFORMS_yymmdd.HHMM_FBO

Copyright (C) 1995, 2018, Oracle and/or its affiliates. All rights reserved.

Linux, x64, 64bit (optimized) on Dec 31 2016 23:58:36
Operating system character set identified as UTF-8.

OGG (not connected) 1>

    Admin ClientのすべてのコマンドのリストはHELPコマンドを使用して表示できます。

  3. Admin ClientからService Managerにのみ接続します。

    管理者の資格証明を使用して、https://localhost:<service_manager_port>ソース・デプロイメントに接続します。

    重要:

    接続文字列ではhttpまたはhttpsを使用する必要があります。そうしないとAdmin Clientは接続しなくなります。この例では非SSL接続が使用されています。

    DBLOGINを使用する場合は、USERIDが使用できないため、USERIDALIASを使用する必要があります。

    デフォルトでは、サーバー証明書が無効のときに、Admin ClientはHTTPSを使用してサーバーに接続できません。この動作をオーバーライドするには、CONNECTコマンドに!修飾子を使用します。たとえば、管理クライアントを使用して、自己署名SSL証明書で保護されているOracle GoldenGate Microservices Architectureサービスに接続する際には、次に示すように!修飾子を持つコマンドを使用する必要があります。

    CONNECT http://myserver.example.org as oggadmin !

不正確なデプロイメント名を入力すると、デプロイメントのリストが表示されます。次のシナリオで説明するように、Admin Clientでデプロイメントに接続するために選択したオプションに応じて異なる出力が生成されます。

  • デプロイメント名を使用せずに接続すると、デフォルトのデプロイメントが接続先になり出力に表示されます。

    次に例を示します。

    OGG (not connected) 1>  connect https://localhost:9000 as admin password adminpw  
Using default deployment 'D1' 

    この例では、D1はデプロイメントの名前です。

  • デプロイメントで接続が発生すると、Admin Clientはデプロイメントに接続しますが、そのデプロイメント名は出力に示されません。

    次に例を示します。

    OGG (not connected) 1> connect https://localhost:9000 deployment D1 as admin password adminpw  

    コマンドは成功しますが、出力はありません。

  • デプロイメント名とユーザー名を使用してデプロイメントに接続するときにパスワードがないと、Admin Clientは出力は表示せずにパスワードを待機します。

    次に例を示します。

    OGG (not connected) 1>  connect https://localhost:9000 deployment D1 as admin ! 
Password for 'admin' at 'https://localhost:9000': 

OGG (https://localhost:9000D1) 2>