Upgrade

Upgrade to MarkLogic Data Hub 5.0

Prerequisites

You need:

• Java SE JDK 8
• MarkLogic Server (See Version Compatibility.)
• Gradle 4.6 or later
• Chrome or Firefox for QuickStart

From 5.0 or 4.3

The notes and steps in this tab are for the following upgrade paths:

• DHF 5.0 » 5.0
• DHF 4.3 » 5.0

Procedure

1. In your project root directory, create a build.gradle file with the Grade Properties plugin setting and the Data Hub plugin setting.

   Copy the following to your build.gradle file and replace the com.marklogic.ml-data-hub version number with the Data Hub version that you are using.

   Copy

      plugins {
         // Gradle Properties plugin
         id 'net.saliman.properties' version '1.4.6'
   
         // Data Hub plugin
         id 'com.marklogic.ml-data-hub' version '5.0.4'
     }
   
   

   net.saliman.properties	Gradle Properties plugin	Allows you to create different environments for your Gradle deployment and set up a gradle-{env}.properties file, where {env} is the environment name. When running a Gradle task, you can specify the target environment with the environmentName option. For more information, see https://github.com/stevesaliman/gradle-properties-plugin.
   com.marklogic.ml-data-hub	Data Hub plugin	Extends the ml-gradle plugin with Data Hub-specific commands.

2. At your project root, run the Gradle task hubUpdate.

   Running the hubUpdate task with the -i option (info mode) displays specifically what the task does, including configuration settings that changed.

   Unix systems

   Copy

   ./gradlew hubUpdate -i
   

   Windows

   Copy

   gradlew.bat hubUpdate -i
   

   hubUpdate automatically moves the following artifacts to the new project.

   From old project	To Data Hub 5.0.4 project
   your-project-root/plugins/entities/entity1/entity1.entity.json ... your-project-root/plugins/entities/entityN/entityN.entity.json The input and harmonize folders remain in the same plugins/entities/entity* folders.	your-project-root/entities/entity1.entity.json ... your-project-root/entities/entityN.entity.json
   your-project-root/plugins/mappings (the entire directory)	your-project-root/mappings

3. Update your gradle.properties file to change the value of mlDHFVersion to 5.0.4.

   Copy

   mlDHFVersion=5.0.4
   

4. Run the Gradle task mlRedeploy.

   Unix systems

   Copy

   ./gradlew mlRedeploy -i
   

   Windows

   Copy

   gradlew.bat mlRedeploy -i
   

   Tip: You can use Gradle's -i option to enable info-level logging.

5. (Optional) Migrate your 4.3 flows to 5.x steps.

From 4.2, 4.1, or 4.0

The notes and steps in this tab are for the following upgrade paths:

• DHF 4.2 » 5.0
• DHF 4.1 » 5.0
• DHF 4.0 » 5.0

Procedure

1. Upgrade to DHF 4.3 to adopt the new roles.
2. Upgrade from DHF 4.3 to Data Hub 5.0.4.

From earlier versions

The notes and steps in this tab are for the following upgrade paths:

• DHF 3.x and earlier » 5.0

Procedure

1. Upgrade to DHF 4.3.
2. Upgrade from DHF 4.3 to Data Hub 5.0.4.

See Also

• Migrating 4.3 Flows to 5.x Steps

Related tasks

• Install Data Hub 5.0

Related reference

• Version Compatibility

Related information

• MarkLogic Data Hub 5.0 - Release Notes