アップグレード

アップグレード： MarkLogicデータハブ 5.2

前提条件：

以下が必要です。

• Java SE JDK 8以降
• MarkLogicサーバー（「バージョン互換性」を参照してください）
• Gradle 4.6以降
• ChromeまたはFirefox（QuickStart用）

5.1や5.0から

このタブの注意と手順は、以下のアップグレードパスに対応しています。

• Data Hub 5.1 » 5.2
• Data Hub 5.0 » 5.2

手順

1. プロジェクトのルートディレクトリで、Gradeのプロパティプラグイン設定とデータハブプラグイン設定を使用して、build.gradleファイルを作成します。

   以下をbuild.gradleファイルにコピーし、com.marklogic.ml-data-hubのバージョン番号を、使用しているデータハブのバージョンに置き換えます。

   plugins {
      // Gradle Properties plugin
      id 'net.saliman.properties' version '1.4.6'

      // データハブ plugin
      id 'com.marklogic.ml-data-hub' version '5.2.0'
  }

<table class="table-light-border">

2. プロジェクトのルートで、**hubUpdate**を実行します。

   -iオプション（infoモード）を使用して**hubUpdate**タスクを実行すると、タスクの詳細（変更された設定など）が表示されます。

   Unix systems

./gradlew hubUpdate -i

**Windows**

gradlew.bat hubUpdate -i

3. Gradle.propertiesfairuwoファイルをアップデートします。
   • mlDHFVersionの値を5.2.0に変更します。

mlDHFVersion=5.2.0

*   （推奨）モジュールにおいて新規Data Hub 5.2のデフォルトパーミッション（`data-hub-module-reader,read,data-hub-module-reader,execute,data-hub-module-writer,update,rest-extension-user,execute`）を使用するには`mlModulePermissions`を削除します。

4. Gradleタスク**mlRedeploy**を実行します。

   Unix systems

./gradlew mlRedeploy -i

**Windows**

gradlew.bat mlRedeploy -i

4.3から

このタブの注意と手順は、以下のアップグレードパスに対応しています。

• DHF 4.3 » Data Hub 5.2

手順

1. プロジェクトのルートディレクトリで、Gradeのプロパティプラグイン設定とデータハブプラグイン設定を使用して、build.gradleファイルを作成します。

   以下をbuild.gradleファイルにコピーし、com.marklogic.ml-data-hubのバージョン番号を、使用しているデータハブのバージョンに置き換えます。

   plugins {
      // Gradle Properties plugin
      id 'net.saliman.properties' version '1.4.6'

      // データハブ plugin
      id 'com.marklogic.ml-data-hub' version '5.2.0'
  }

<table class="table-light-border">

2. プロジェクトのルートで、**hubUpdate**を実行します。

   -iオプション（infoモード）を使用して**hubUpdate**タスクを実行すると、タスクの詳細（変更された設定など）が表示されます。

   Unix systems

./gradlew hubUpdate -i

**Windows**

gradlew.bat hubUpdate -i

**`hubUpdate`**により、以下のアーティファクトが自動的に新しいプロジェクトに移動されます。

<table class="table-light-border">

 
    <p><i>input</i>フォルダおよび<i>harmonize</i>フォルダは、同じ<i>plugins/entities/entity*</i>フォルダ内に残ります。</p></td>
   <td>
```bash
   your-project-root/entities/entity1.entity.json
  ...
  your-project-root/entities/entityN.entity.json

3. Gradle.propertiesfairuwoファイルをアップデートします。
   • mlDHFVersionの値を5.2.0に変更します。

mlDHFVersion=5.2.0

*   （推奨）モジュールにおいて新規Data Hub 5.2のデフォルトパーミッション（`data-hub-module-reader,read,data-hub-module-reader,execute,data-hub-module-writer,update,rest-extension-user,execute`）を使用するには`mlModulePermissions`を削除します。

4. Gradleタスク**mlRedeploy**を実行します。

   Unix systems

./gradlew mlRedeploy -i

**Windows**

gradlew.bat mlRedeploy -i

4.2、4.1、4.0から

このタブの注意と手順は、以下のアップグレードパスに対応しています。

• DHF 4.2 » Data Hub 5.2
• DHF 4.1 » Data Hub 5.2
• DHF 4.0 » Data Hub 5.2

手順

1. DHF 4.3にアップグレードして新しいロールを適用します。
2. DHF 4.3からデータハブ 5.2.0にアップグレードします。

それ以前のバージョンから

このタブの注意と手順は、以下のアップグレードパスに対応しています。

• DHF 3.x以前のバージョン » Data Hub 5.2

手順

1. DHF 4.3にアップグレードします。

   データハブ 4.xリリースでは極めて大きな変更がなされました（プロジェクトディレクトリ構造、セキュリティロール、データベースなど）。これらの変更のため、手作業で設定ファイルを更新し、データハブ 4.3.2バージョンのGradleタスクを実行し、プロジェクトおよび環境を正しく再構成する必要があります。その後、データハブのアップグレードに進む前にテストを実行してください。詳細については、Upgrade to DHF 4.3の「Upgrade Notes」および「Additional Upgrade Notes」セクションを参照してください。

   データハブフレームワーク2.x、3.x、4.xで読み込みおよび処理したデータは、データハブ 5.xとの互換性はありません。このため、アップグレードする代わりに5.xを直接インストールすることもできますが、その際、2.x/3.x/4.xのフローやステップを5.xで再度作る必要があります。またカスタムコードをアップデートする必要もあるでしょう。

2. DHF 4.3からデータハブ 5.2.0にアップグレードします。

See Also

関連タスク

• インストール データハブ 5.2

関連資料

• バージョン互換性

関連情報

• ダウンロード
• MarkLogicデータハブ 5.2 - リリースノート