Skip to main content
Version: 2.6

Set a running migration limit

Setting a running migration limit lets you control how many data migrations can run simultaneously, excluding those in a live or recurring state.

Data Migrator starts more migrations as previously-started migrations reach a LIVE state. High priority migrations are processed first, followed by Normal and Low priority migrations. Migrations with the same priority start in order of creation date, oldest to newest. See Prioritize migrations for more information on migration priorities.

info

Creating new migrations can affect the order of migrations waiting to start and can impact currently running migrations. For example, with a migration limit of 1, and 1 lower-priority migration running, when a new higher-priority migration is started, Data Migrator will move this new migration to the RUNNING state. The lower-priority migration will remain running but Data Migrator will prioritize processing of the higher-priority migration.

note

You must have the admin role assigned to update the running migration limit.

Set a running migration limit with the UI

  1. On the Dashboard page, select the relevant instance from the Instances panel.
  2. Select Data Migrations from the Migrations menu on the left side.
  3. Under Running Migrations, enter the number of migrations you want to be able to run simultaneously. This number excludes migrations in a live or recurring state.
    info

    The default migration limit is 10. Setting the Running Migration Limit value to 0 indicates no limit.

  4. Select Save.

Set a running migration limit with the CLI

Set a running migration limit with the CLI by running the following command:

Set a running migration limit of 15 migrations
configuration set --key migration.max.running.migrations --value 15

Check the current running migration limit by running the following command:

Check the current running migration limit
configuration get --key migration.max.running.migrations