7.2.2 Oracle GoldenGateでOKVを構成するための前提条件

Oracle GoldenGateでOKVを設定するための前提条件について学習します。

次のステップは、Oracle GoldenGateインスタンスが実行されているマシンのOKV構成の場合です。

1. Oracle GoldenGateがデプロイメントと同じシステム・ユーザーとしてデプロイされるOKVサーバーから、okvrestservices.jarをダウンロードします。

2. エンドポイント・ファイル(okvclient.jar)を、Oracle GoldenGateがデプロイメントと同じシステム・ユーザーとしてデプロイされるOKVサーバーからダウンロードしてインストールします。たとえば、

   OS> java -jar okvclient.jar -d /u01/app/oracle/OKV

3. キーを作成します。ウォレットの名前は、OKV管理者によって指定されます。次の例は、キーの作成方法を示しています。

   OS> java -jar okvrestservices.jar kmip 
           --config /u01/app/oracle/OKV/conf/okvclient.ora
           --service create_key 
           --algorithm AES 
           --length 256 
           --mask "ENCRYPT,DECRYPT,TRANSLATE_ENCRYPT,TRANSLATE_DECRYPT,TRANSLATE_WRAP,TRANSLATE_UNWRAP" 
           --wallet OKV_WALLET76876ABA-B06D-4F35-BF7C-D9306D29764B

   また、次の例に示すように、独自のキーを登録することもできます。

   OS>java -jar okvrestservices.jar kmip 
               --config ./conf/okvclient.ora --service reg_key -ENCRYPT,DECRYPT,TRANSLATE_ENCRYPT,TRANSLATE_DECRYPT,TRANSLATE_WRAP,TRANSLATE_UNWRAP 
               --wallet OGG_WALLET 
               --object /u01/key.txt64B3AAD0-BE77-1821-E053-0100007FD178

4. OKV_HOME環境変数を設定します。

   OS> setenv OKV_HOME /u01/app/oracle/OKV

   サブディレクトリ構造には、OKV環境に必要なライブラリ、バイナリおよび構成ファイルが含まれています。OKVサーバーでの構成の詳細は、『Oracle Key Vault管理者ガイド』のエンドポイントへのOKVソフトウェアのインストールに関する項を参照してください。

5. 次の例に示すように、キーをアクティブ化します。

   OS> java -jar okvrestservices.jar kmip 
               --config /u01/app/oracle/OKV/conf/okvclient.ora
               --service activate 
               --uid 76876ABA-B06D-4F35-BF7C-D9306D29764B
   INFO: Success

6. Oracle GoldenGate関連のキー属性(KeyName、KeyVersion)を構成に追加します。キー名は、Oracle GoldenGate内で作成されたKMS暗号化プロファイルのマスター・キー名と一致する必要があります。キー値はマスター・キーのバージョン番号と一致する必要があります。

   OS> java -jar okvrestservices.jar kmip 
               --config /u01/app/oracle/OKV/conf/okvclient.ora
               --service add_custom_attr 
               --uid 76876ABA-B06D-4F35-BF7C-D9306D29764B 
               --attribute x-OGG-KeyName 
               --type TEXT 
               --value OGG_Masterkey 
   INFO: Success

   OS> java -jar okvrestservices.jar kmip 
               --config /u01/app/oracle/OKV/conf/okvclient.ora
               --service add_custom_attr 
               --uid 76876ABA-B06D-4F35-BF7C-D9306D29764B 
               --attribute x-OGG-KeyVersion 
               --type TEXT 
               --value 1
   INFO: Success

7. okvutilを使用して構成設定をリストし、エンドポイントのステータスを確認します。次に例を示します。

   OS>okvutil list -v 4
   okvutil version 18.2.0.0.0
   Endpoint type: Oracle (non-database)
   Configuration file: /u01/app/oracle/OKV/conf/okvclient.ora
   Server: 10.245.64.45:5696 10.245.64.46:5696
   Standby Servers:Read Servers: 10.245.64.48:5696
   Auto-login wallet found, no password needed
   Trying to connect to 10.245.64.45:5696 ...
   Connected to 10.245.64.45:5696.
   Unique ID Type Identifier
   72B673E8-840B-4AD6-8400-CB77B68D74B5 Template Default template for OGG_EP
   76876ABA-B06D-4F35-BF7C-D9306D29764B Symmetric Key -

この次のステップでは、Oracle GoldenGate内のAdmin Clientから管理を実施します。