Denodo 6.0 からのアップグレード: 現在のインストール環境からの設定とメタデータのエクスポート¶

ここでは、 Denodo Platform 6.0 の各モジュールの設定とメタデータをエクスポートする手順について説明します。

使用していないモジュールのメタデータと設定をエクスポートする必要はありません。

Java 8 Update 161 への変更

Denodo 6.0 をインストールする際には、Denodo Platform の Java Runtime Environment (JRE) を JRE version 8 update 161 に更新します。インストール作業の終わりに、現行の JRE に戻すことができます。

Java 8 update 161 を入手するには、以下の方法があります。

1. Denodo 7.0 のインストール環境を利用できる場合、このバージョンの Denodo には必要なバージョンの JRE が含まれています (Denodo 8.0 に含まれている JRE は Java 11 であるため、Denodo 8.0 の JRE をコピーしないでください)。

2. または、以下の OpenJDK 8 - HotSpot をダウンロードします。

   • Windows の場合: OpenJDK x64 - JRE for Windows

   • Linux の場合: OpenJDK x64 - JRE for Linux

   • その他のアーキテクチャの場合、 AdoptOpenJDK プロジェクト のダウンロードページで適切な JRE 1.8 - HotSpot を選択します。JRE の更新プログラムは、161 から 252 のバージョンのいずれかである必要があります。

   AdoptOpenJDK プロジェクトでは、信頼性の高い OpenJDK バイナリをすべてのプラットフォームで提供しています。

3. または、Oracle のダウンロードにアクセスできる場合、 Java SE 8 Archive Downloads から Java Runtime Environment (JRE) をダウンロードします。

AdoptOpenJDK と Oracle JRE はいずれもサポートされています。

その後、以下の手順に従って実施してください。

1. カレントディレクトリ <DENODO_HOME_6_0>/jre の名前を jre_1.7 に変更します。

2. 新バージョンの Java をディレクトリ <DENODO_HOME_6_0>/jre に置きます。その結果、ファイル <DENODO_HOME_6_0>/jre/bin/java になります。

3. ファイル <DENODO_HOME_6_0>/jre_1.7/lib/security/cacerts を {<DENODO_HOME_6_0>}/jre/lib/security/cacerts` へコピーします (ファイル置換)。

   このファイルは トラストストア であり、Denodo が開く SSL コネクションが引き続き動作するために必要なものです。

4. コマンドラインから以下を実行して、想定通りのパスに JRE が存在することを確認します。

<DENODO_HOME_6_0>/jre/bin/java -version

<DENODO_HOME_6_0>\jre\bin\java.exe -version

次のようなテキストが出力されます。

openjdk version "1.8.0_275"
OpenJDK Runtime Environment (AdoptOpenJDK)(build 1.8.0_275-b01)
OpenJDK 64-Bit Server VM (AdoptOpenJDK)(build 25.275-b01, mixed mode)

または次のようになります。

java version "1.8.0_162"
Java(TM) SE Runtime Environment (build 1.8.0_162-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.162-b12, mixed mode)

JRE version 8 update 161 への切り替えは必須です。これは、Denodo 6.0 が使用する暗号化アルゴリズムよりも強力な、Denodo 8.0 が使用する暗号化アルゴリズムを用いて、ユーザーとデータソースのパスワードをエクスポートするためです。

JRE version 8 update 161 を入手できない場合は、Java 8 update 171 ～ 255 の更新プログラムを使用しても構いません。ただし、Java 9 以降のバージョンは使用できません。

Virtual DataPort

Virtual DataPort のメタデータと設定をエクスポートするにあたって、2 つのファイルを取得します。

1. メタデータファイル: データソース、ビュー、Web サービスなどの CREATE コマンドや、設定を変更するコマンドなどが含まれているファイルです。

2. リソースファイル: Virtual DataPort の「リソース」が含まれているファイルです。具体的には、以下のようなリソースです。

   • データソースで使用される JDBC ドライバーのうち、Denodo Platform に同梱されていないもの。たとえば、Teradata データソースがある場合は Teradata ドライバーを必要としますが、この VQL ファイルに Teradata ドライバー自体が含まれるため、新しいインストール環境にコピーする必要はありません。

   • Administration Tool の [File] メニュー > [Extension management] を使用してインポートした DenodoConnect コンポーネントとその他の拡張機能。

   • keytab ファイルと krb5 ファイル (Kerberos を有効にした場合)。

   • SAP Java Connector (JcO)。このコネクターをインポートした場合、これもリソースファイルに含まれます。

   • その他の類似するリソース。

   このファイルには、上記のリソースが Base64 でエンコードされた状態で含まれています。

   以前のバージョンの Denodo にアップグレードする場合、Denodo に同梱されていないドライバーは、手動で新しいインストール環境にコピーする必要がありました。リソースファイルを生成することで、Denodo 8.0 にアップグレードするプロセスが簡単になります。

1. Virtual DataPort 6.0 の Administration Tool を開いて、管理者アカウントでログインします。

2. VQL シェルから以下のコマンドを実行します。

   SET 'com.denodo.exportMigrationCompatibility80' = 'true';
   SET 'com.denodo.exportOnlyResourcesAndJars' = 'true';
   SET 'com.denodo.vdb.catalog.exportMigrationCompatibility.migrateDateTypes' = 'true';
   

   プロパティ migrateDateTypes の設定は必須ではなく推奨です。このプロパティについては、後述の「 ビューの自動変換による新しい日時データ型の使用 」を参照してください。

3. Virtual DataPort サーバーを再起動して、プロパティの値の変更を適用します。

4. Denodo Platform 6.0 がインストールされているコンピュータに接続し、コマンドラインから以下のコマンドを実行します。

   • Windows の場合:

     cd <DENODO_HOME_6_0>
     cd bin
     export.bat --login <user name> --password "<password>" --file resources_denodo.vql --server "localhost:9999" -P includeJars=yes -P includeScanners=yes -P includeCustomComponents=yes -P replaceExistingElements=yes
     

   • Linux の場合:

     cd <DENODO_HOME_6_0>
     cd bin
     ./export.sh --login <user name> --password "<password>" --file resources_denodo.vql --server "localhost:9999" -P includeJars=yes -P includeScanners=yes -P includeCustomComponents=yes -P replaceExistingElements=yes
     

   このコマンドの <user name> と <password> を管理者ユーザーの資格情報に置き換えてください。

   このスクリプトを実行すると、リソースファイル (resources_denodo.vql) がフォルダ <DENODO_HOME_6_0/bin に生成されます。これを自分のコンピュータにコピーします。

5. VQL シェルに戻って、以下を実行します。

   -- You do NOT need to restart to apply this change.
   SET 'com.denodo.exportOnlyResourcesAndJars' = NULL;
   SET 'com.denodo.vdb.catalog.exportMigrationCompatibilityIncludeResources' = 'false';
   

6. コマンドラインから以下のコマンドを実行します (パラメータ --file の値が、手順 3 とは異なることに注意)。

   • Windows の場合:

     cd <DENODO_HOME_6_0>
     cd bin
     export.bat --login <user name> --password "<password>" --file metadata_denodo.vql --server "localhost:9999" -P cluster=yes -P includeScanners=yes -P includeCustomComponents=yes -P includeStatistics=yes -P includeDeployments=yes -P replaceExistingElements=yes
     

   • Linux の場合:

     cd <DENODO_HOME_6_0>
     cd bin
     ./export.sh --login <user name> --password "<password>" --file metadata_denodo.vql --server "localhost:9999" -P cluster=yes -P includeScanners=yes -P includeCustomComponents=yes -P includeStatistics=yes -P includeDeployments=yes -P replaceExistingElements=yes
     

   このスクリプトを実行すると、メタデータファイル (metadata_denodo.vql) がフォルダ <DENODO_HOME_6_0/bin に生成されます。これを自分のコンピュータにコピーします。

7. スクリプト「export」の実行後に次のメッセージが表示された場合、

   MIGRATION TO 8.0 - WARNINGS SUMMARY
   

   すぐ下に表示されたメッセージをコピーしてください。この情報は、アップグレードプロセスの次の手順で必要となります。

   この警告メッセージが 表示されなかった場合 、変更を加えることなく、この VQL ファイルを Virtual DataPort 8.0 にインポートできます。

8. VQL シェルから以下のコマンドを実行します。

   SET 'com.denodo.exportMigrationCompatibility80' = NULL;
   SET 'com.denodo.exportOnlyResourcesAndJars' = NULL;
   SET 'com.denodo.vdb.catalog.exportMigrationCompatibilityIncludeResources' = NULL;
   SET 'com.denodo.vdb.catalog.exportMigrationCompatibility.migrateDateTypes' = NULL;
   

9. Virtual DataPort サーバーを再起動して、プロパティの値の変更を適用します。

Information Self-Service Tool

10. 管理者アカウントで Information Self-Service Tool 6.0 にログインします。

11. Information Self-Service Tool から、全ユーザーの保存済みクエリをすべてエクスポートします。この手順の詳細については、「 Saved Queries 」 (Denodo 6.0 のマニュアル) を参照してください。

Scheduler および Scheduler Index

12. ファイル <DENODO_HOME_6_0>/conf/scheduler/ConfigurationParameters.properties を編集して、次の行を追加します。

    com.denodo.exportMigrationCompatibility80=true
    

13. ファイル <DENODO_HOME_6_0>/conf/arn-index/ConfigurationParameters.properties を編集して、次の行を追加します。

    com.denodo.exportMigrationCompatibility80=true
    

14. Scheduler と Scheduler Index を再起動します。

15. Scheduler 6.0 に管理者アカウントでログインして、すべてをエクスポートします。これを行うには、[Configuration] > [Server configuration] に移動し、[Export] をクリックします。表示されたページで、以下を行います。

    1. すべてのプロジェクトを選択します。

    2. すべてのオプションを選択します。

16. Denodo Platform 6.0 がインストールされているコンピュータに接続し、以下を実行します。

    • Windows の場合:

      cd <DENODO_HOME_6_0>
      cd tools\arn-index
      
      export.bat -h localhost -p 9000 -l <user name> -P <password> -f scheduler-index_upgrade.zip
      

    • Linux の場合:

      cd <DENODO_HOME_6_0>
      cd tools/arn-index
      
      ./export.sh -h localhost -p 9000 -l <user name> -P <password> -f scheduler-index_upgrade.zip
      

    このコマンドの <user name> と <password> を管理者ユーザーの資格情報に置き換えてください。

    このスクリプトを実行すると、ファイル scheduler-index_upgrade.zip (フォルダ <DENODO_HOME>/bin) が生成されます。このファイルには、Scheduler Index の構成とインデックスが含まれています。このファイルを Denodo Platform 8.0 をインストールしたコンピュータにコピーします。

17. Scheduler と Scheduler Index を停止します。

18. 次の行を

    com.denodo.exportMigrationCompatibility80=true
    

    以下のファイルから削除します。

    • <DENODO_HOME_6_0>/conf/scheduler/ConfigurationParameters.properties

    • <DENODO_HOME_6_0>/conf/arn-index/ConfigurationParameters.properties

19. Scheduler と Scheduler Index を起動します。

ITPilot

20. Wrapper Generation Tool 6.0 を開いて、ITPilot ラッパーをすべてエクスポートします。これを行うには、[File] メニュー > [Export] をクリックします。詳細については、『Generation Environment Guide』のページ「 Migrating Wrappers Between Generation Environments: Import and Export 」(英語) を参照してください。

最終手順

Denodo Platform 6.0 は Java 8 と互換性がありますが、カスタマイズの内容が失われないようにするため、アップグレードプロセスの開始時に置き換えた Java Runtime Environment バージョン 6 を復元します。つまり、カレントフォルダ jre を削除し、フォルダ名を jre_1.7 から jre に変更します。