Skip to main content
Version: 1.20.0

Create a one-time migration

One-time migrations do not track activity in your data during a migration. If you create a one-time migration, Data Migrator doesn't scan your source filesystem for updates to the data as the migration progresses.

A one-time migration does not write a marker file to the source filesystem. When the scan of the source filesystem is finished (to determine which files and directories are to be migrated), the data migration state changes to completed. Data Migrator doesn't scan the source again.

This means you can perform one-time migrations without write access, and without the need to operate the migration as the hdfs user.

Create a one-time migration with the UI#

To create a one-time migration with the UI, deselect the Live Migration option when creating a migration. Unlike a live migration, one-time migrations won't display a live state in the UI.

A successful one-time migration appears in the UI as completed.

You can't rerun a completed migration. To detect new changes to the source, you can add a specific path for rescanning.

Create a one-time migration with the CLI#

There are two ways to create a one-time migration through the CLI:

  1. Start a migration with a source filesystem configured for one-time migrations.
  2. Enter the --scan-only flag when you create the migration.

For more information, see the migration add and the optional parameters sections of the Command reference.