CLI Guide

dm migration cancel
Cancels an existing data migration.
Contexts
All contexts.
In all data-migration (device or extent) contexts, command is migration cancel.
In data-migrations/extent-migrations context, command is cancel.
Syntax
dm migration cancel
[-m|--migrations] context-path,context-path...
[-f|--force]
Arguments
Required arguments
[-m|--migrations]
* List of one or more migrations to cancel. Entries must be separated by commas.
Optional arguments
[-f|--force]
Forces the cancellation of the specified migrations.
* - argument is positional.
Description
Use the dm migration cancel --force --migrations context-path command to cancel a migration.
Specify the migration by name if that name is unique in the global namespace. Otherwise, specify a full context path.
Migrations can be canceled in the following circumstances:
● The migration is in progress or paused. The command stops the migration, and frees any resources it was using.
● The migration has not been committed. The command returns source and target devices or extents to their pre-migration
state.
A migration cannot be canceled if it has been committed.
To remove the migration record from the context tree, see the dm migration move command.
Example
Cancel a migration from device-migration context:
VPlexcli:/data-migrations/device-migrations> dm migration cancel --force --migrations
migrate_012
Cancel a device migration from root context:
VPlexcli:> dm migration cancel --force --migrations /data-migrations/device-migrations/
migrate_012
Commands
139