Install and quick start

Install the Data Migrator and run your first data migration.

Prerequisites

• Java 21+
• Running Camunda 8 (SaaS or self-managed)
• Access to Camunda 7 database
• Models migrated and deployed to C8

Installation

1. Download the latest release from the GitHub releases page:
   • https://github.com/camunda/camunda-7-to-8-data-migrator/releases
2. Extract the archive to your preferred directory.
3. Navigate to the extracted directory.

Quick start

1. Make sure Camunda 8 is up and running, and all process models to migrate are deployed.

   To be used with the Runtime Data Migrator, every process model requires:

   • A blank start event (you must add one if the process model doesn't have one already).
   • An execution listener at the end of your blank start event with the job type migrator. You have to add this manually, or let it be added by the Migration Analyzer & Diagram Converter.

    <bpmn:startEvent id="StartEvent_1">
      <bpmn:extensionElements>
        <zeebe:executionListeners>
          <zeebe:executionListener eventType="end" type="migrator" />
        </zeebe:executionListeners>
      </bpmn:extensionElements>
    </bpmn:startEvent>

   • Hint: For automatic resource deployment, you can also drop your BPMN files into the configuration/resources folder.

2. Drop your JDBC driver into the configuration/userlib folder (for example, postgresql-42.2.5.jar for PostgreSQL).

3. Prepare your configuration file (configuration/application.yml):

   camunda.client:
     mode: self-managed
     grpc-address: http://localhost:26500
     rest-address: http://localhost:8088
   
   camunda.migrator.c7.data-source:
     jdbc-url: jdbc:postgresql://localhost:5432/camunda7
     username: your-username
     password: your-password

4. Run the Data Migrator:

   # On Linux/macOS
   ./start.sh --help
   
   # On Windows
   start.bat --help

5. Monitor the migration progress in the console output and log files.