1. Microservices Architectureドキュメント
  2. デプロイ
  3. デプロイメントの追加

デプロイメントの追加

このページの手順に従って、OGGCAウィザードを使用してデプロイメントを追加します。

デプロイメントを追加する前に

セキュアなデプロイメント(本番データベースまたは安全でないネットワークに推奨)が必要な場合は、OGGCAウィザードの「サービス・マネージャ・オプションの選択」画面で「セキュリティの有効化」オプションを確認してください。

OGGCAウィザードの起動

デプロイメントの追加は、データのレプリケーションのプラットフォームを設定するプロセスの最初のタスクです。デプロイメントはService Managerで管理します。

Oracle GoldenGate Microservices Architectureのインストールを完了すると、Oracle GoldenGate Configuration Assistant (OGGCA)ウィザードを使用して最初のデプロイメントとそれ以降のデプロイメントを追加できます。

また、OGGCAはサイレント・モードでも実行できます。OGGCAをサイレント・モードで実行するステップは、「OGGCAを使用したサイレント・モードでのデプロイメントの追加」を参照してください。

ノート:

ホストごとにService Managerを1つ保持して、Oracle GoldenGateのリリースに伴うアップグレードとメンテナンスのタスクの重複を回避することをお薦めします。

OGGCAウィザードを起動するには:

  1. $OGG_HOME/binディレクトリに移動して、Oracle GoldenGate Configuration Assistant (oggca)ユーティリティにアクセスします。

  2. Linuxでは、oggca.shプログラムを実行します。

    または、

    Windowsでは、oggca.batプログラムを右クリックします。

Oracle GoldenGate Configuration Assistant (oggca)ウィザードが表示されます。

以降の各トピックでは、OGGCAウィザードの各画面で設定できる構成の詳細を示します。

Service Managerオプションの選択

  1. OGGCAを初めて実行する場合は、Service Managerの新規作成オプションを選択します。OGGCAを初めて実行するときは、既存のService Managerオプションは無効になっています。初めてでない場合は、「既存のサービス・マネージャ」オプションを選択できます。これにより、既存のサービス・マネージャ用に構成されたポートおよびその他の設定がロードされます。デプロイメントはこのService Managerに追加されます。


    サービス・マネージャ・デプロイメントのオプション

  2. 新しいサービス・マネージャ・デプロイメントの場合は、次の表の説明に従ってオプションを構成します。
    オプション 説明

    新規サービス・マネージャの作成

    このオプションはOGGCAを初めて起動したときに事前選択され、他のサービス・マネージャ・インスタンスは実行されていません。

    ソフトウェア・ホーム

    Oracle GoldenGateソフトウェアの場所を参照して選択します。

    デプロイメント・ホーム

    新しいサービス・マネージャ・デプロイメントの場合は、デプロイメント・ディレクトリの格納に使用するディレクトリを参照して入力します。Oracleでは、Service Managerファイルを格納するために、デプロイメント・サブディレクトリ構造内にServiceManagerディレクトリを作成することをお薦めします。

    ホスト名/IPアドレス

    Oracle GoldenGateインスタンスのサーバー詳細を入力します。

    リスニング・ポート

    サービス・マネージャがサービス・コールをリスニングするポート番号を入力します。

    サービス・マネージャをシステム・サービス/デーモンとして登録

    マシンが再起動された場合に手動による開始および停止を回避するには、このチェック・ボックスを選択します。これにより、サービス・マネージャは、サーバー起動時に自動的に起動するか、サーバーの再起動後に再起動します。

    XAGと統合

    OracleのOracle Grid Infrastructureにデプロイメントを統合するには、このオプションを選択します。このオプションは、Oracle Grid Infrastructureによって管理されるクラスタ環境を使用する場合にのみ適用できます。

    StatsD

    「StatsD」チェック・ボックスを選択して、サービス・マネージャのメトリックの記録を有効にします。

    StatsDホスト

    StatsDサーバーのホスト名またはIPアドレスを入力します。この情報は、StatsDホストに接続するためにサービス・マネージャによって使用されます。

    StatsDポート

    StatsDホストのポート番号を入力します。デフォルトのポート番号は8125です。

    セキュリティの有効化

    デフォルトで選択されています。Service Managerで構成するセキュリティ・オプションを指定します。セキュリティ・オプションを使用すると、サーバー、クライアントおよび信頼できるrootCA証明書を追加したり、TLSのプロトコル・オプションを設定することもできます。

    TLS 1.2

    TLS 1.2プロトコルを使用する場合は、このチェック・ボックスを選択します。

    TLS 1.3

    TLS 1.3プロトコルを使用する場合は、このチェック・ボックスを選択します。

    サーバー証明書

    サービス・マネージャに関連付けるサーバー証明書ファイル(.pem)を参照して選択します。

    サーバー秘密キー

    サーバー証明書のサーバー証明書秘密キー・ファイル(.key)を参照して選択します。

    サーバーCA証明書

    サービス・マネージャの信頼できるRootCA証明書を参照して選択します。

    FIPSの有効化

    Oracle GoldenGateサービスが連邦情報処理標準(FIPS)に準拠できるようにします。

    構成サービス


    「構成サービス」ダイアログ・ボックス

    Oracle GoldenGate構成ファイルを高可用性のファイルシステムやデータベースなどの別の場所に格納する場合は、このサービスを有効にします。

    サービス・マネージャの「デプロイメント・オプション」画面で「構成サービス」ボタンをクリックします。「構成サービス」ダイアログが表示されます。

    「構成サービスの有効化」チェック・ボックスを選択し、バックエンド・オプションを設定します。デフォルト・オプションはファイルシステムです。

    「Oracle Database」オプションを選択した場合は、ソース/ターゲット・データベースを使用するか、レプリケーション以外の別のデータベースを使用できます。

    データベースに指定する必要がある詳細を次に示します。

    • ユーザー名: データベース・ユーザーのユーザー名。

    • パスワード: データベース・ユーザー資格証明のパスワード。

    • 接続文字列: データベースの接続に使用されるURL。これはバックエンド接続文字列です。接続文字列では、データ・ソースをhost [:port]/service_nameまたはTNS_ALIASの形式で使用できます。

      たとえば、 localhost:1521/cdb1_pdb1.rdbms.oracle.com は、ホスト名、ポート番号およびサービス名の形式の例です。

    • 表名: 構成ファイルが格納されるデータベース・バックエンド表名。バックエンド表はどのスキーマにも存在する可能性があります。この例では、Oracle GoldenGate管理スキーマ(ggadmin)が使用されています。

      例:

      ggadmin.ggs_backendtable。

    構成サービスの使用方法の詳細は、「構成サービス」を参照してください。

サービス・マネージャ管理者アカウント

この画面で、サービス・マネージャのログイン資格証明を入力します。セキュリティを向上させるために、強力なパスワード・ポリシーを有効にしてください。強力なパスワードの条件は次のとおりです。

  • 1つの大文字(A - Z)

  • 1つの小文字(a -z)

  • 1つの数字(0 - 9)

  • 1つの特殊文字(- ! @ % & * . # _)

  • パスワードの長さは、8文字から30文字の間にしてください


サービス・マネージャ管理者アカウント

様々なタイプのユーザーの詳細は、デプロイメントへの新規ユーザーの追加を参照してください。

ユーザー・デプロイメント

次のステップの説明に従って、「ユーザー・デプロイメント」画面からデプロイメント・オプションを構成します。

  1. 次の表を使用して、デプロイメント・オプションを構成します。
    オプション 説明

    デプロイメント名

    デプロイメント名を指定します。

    デプロイメント・ホーム

    デプロイメントの場所を参照して選択します。

    この場所は、サービス・マネージャおよびOracle GoldenGateのインストール場所の外部にある必要があります。

    カスタマイズ

    「カスタマイズ」ボタンをクリックして、構成ディレクトリに別の場所を指定します(OGG_ETC_HOME、OGG_CONF_HOME、OGG_SSL_HOME、OGG_VAR_HOME、OGG_DATA_HOME、OGG_ARCHIVE_HOME、Performance Metrics DataStore Homeなど)。

    ポート

    各Microservicesで使用されるポート番号を入力します。

    管理サービス

    分散サービス

    レシーバ・サービス

    パフォーマンス・メトリック・サービス。

    データ・ストア・タイプ

    パフォーマンス・メトリック・データの格納に必要なデータ・ストアのタイプを選択します。オプションには、BDBおよびLMDBがあります。

    データ・ストア・ホーム

    データ・ストア・ホーム・ディレクトリの場所を参照して選択します。

    StatsD

    デプロイメントに接続する必要があるStatsDサーバーの接続詳細を指定するには、このチェック・ボックスを選択します。StatsD有効チェック・ボックスを選択した後に、有効にするオプションを使用して、StatsDサーバーのホスト名と一意のポート番号を指定する必要があります。

    StatsDホスト

    StatsDサーバーのホスト名またはIPアドレスを入力します。この情報は、StatsDホストに接続するためにサービス・マネージャによって使用されます。StatsDサーバーは、Oracle GoldenGateデプロイメントが存在するホスト・マシンと同じ場所に配置でき、リモート・ホストに配置することもできます。

    StatsDポート

    StatsDホストのポート番号を入力します。デフォルトのポート番号は8125です。

    サーバー証明書

    サービス・マネージャのオプションの構成中にサーバー証明書ファイル(.pem)がすでに選択されているため、このボックスは無効になっています。

    サーバー秘密キー

    サーバー証明書秘密キー・ファイル(.key)は事前選択されています。

    サーバーCA証明書

    信頼できるRootCA証明書も事前選択されています。

    クライアント証明書

    必要に応じて、クライアント証明書ファイル(.pem)を参照して選択します。

    クライアント秘密キー

    関連付けられたクライアント証明書のクライアント証明書秘密キー・ファイル(.key)を参照して選択します。

    クライアントCA証明書

    関連付けられたクライアント証明書を検証する信頼できるrootCA証明書を参照して選択します。

    TNS_ADMIN

    (Oracleのみ)tnsnames.oraおよびsqlnet.oraファイルの場所に基づいて、この環境変数の値を入力します。

    TNS_ADMINパラメータは、 tnsnames.oraやsqlnet.oraなどのファイルが存在するOracle Net Servicesのディレクトリ・パスを指定します。tnsnames.oraファイルは、データベース・サービスの接続記述子にマップされるネット・サービス名を含む構成ファイルです。

    レプリケーション・スキーマ

    デプロイメントのGGSCHEMAパラメータを設定します。この設定の詳細は、Oracle GoldenGateパラメータおよび機能リファレンスのGGSCHEMAを参照してください。

    環境変数

    このボタンをクリックして、「環境変数」ダイアログ・ボックスを開きます。これには、事前設定された環境変数$OGG_HOMEおよび$LD_LIBRARY_PATHのパスが含まれます。

    一部の変数は固定で、その他の変数は拡張可能で、さらに変数を追加できます。

    Db2 z/OSの場合は、デプロイメントの作成を開始する前に、IBMCLIDRIVERおよびLD_LIBRARY_PATHが設定されていることを確認してください。これらの環境変数を設定するには、「Oracle GoldenGate for Db2 z/OSの環境変数の設定」を参照してください。


    OGGCAの「ユーザー・デプロイメント」画面

  2. 「次」をクリックして、「ユーザー・デプロイメント管理者」画面に移動します。

ユーザー・デプロイメント管理者

この画面では、デプロイメント専用の別のローカル管理者ユーザーを作成できます。このユーザーは、サービス・マネージャ管理者と同じにすることもできます。


OGGCAの「ユーザー・デプロイメント管理者」ユーザー画面

「サービス・マネージャの管理者資格証明と同じ」オプションを選択した場合、ユーザー・デプロイメント管理者に別のログイン資格証明セットを指定する必要はありません。サービス・マネージャへのログインに使用されるのと同じログイン資格証明を使用して、管理サービスおよび他のマイクロサービスにログインできます。

デプロイメント専用の新しい管理者ユーザーを作成するには、「サービス・マネージャの管理者資格証明と同じ」オプションの選択を解除します。デプロイメント管理者のユーザー名とパスワードを指定し、強力なパスワード・ポリシーを使用してセキュリティを確保します。

このユーザーは、管理サービスおよび他のマイクロサービスにログインできます。ただし、サービス・マネージャにログインするには、サービス・マネージャ管理者のログイン資格証明が必要です。

サマリー

  1. 続行する前に、次のイメージに示すように、デプロイメントの詳細な構成設定を確認します。


    デプロイメントの構築を開始する前に構成されたすべてのオプションが表示されたOGGCAの「サマリー」画面

  2. (オプション)構成情報をレスポンス・ファイルに保存できます。Oracleでは、レスポンス・ファイルを保存することをお薦めします。このファイルを入力として使用して、コマンドラインからインストーラを実行し、他のシステムで成功した構成の結果を複製します。このファイルを編集することも、提供されているテンプレートから新しいものを作成することもできます。

    ノート:

    レスポンス・ファイルに保存するとき、管理者パスワードはセキュリティの理由から保存されません。他のシステムで使用するためにレスポンス・ファイルを再利用する場合は、レスポンス・ファイルを編集してパスワードを入力する必要があります。

  3. 「終了」をクリックして「次」をクリックします。

デプロイメントの構成

この画面には、デプロイメントの作成と構成の進捗状況が表示されます。Service Managerがサービスとして登録されている場合、進行中に通知が発生する可能性があります。

ポップアップが表示され、スクリプトを実行してサービスを登録する方法が示されます。Configuration Assistantによって、これらのスクリプトが実行されたことが確認されます。実行しなかった場合は、続行するかどうかを尋ねられます。「はい」をクリックすると、構成が正常に完了します。「いいえ」をクリックすると一時的な失敗ステータスが設定され、「Retry」をクリックするとスクリプトが実行されます。

スクリプトが実行された後で「OK」をクリックして続行します。

作成および構成プロセスが完了すると、デプロイメントが正常に追加されたことを示すメッセージが表示されます。「次」をクリックします。

終了

「終了」画面で、「閉じる」をクリックしてOGGCAを終了します。