openstack-manuals/doc/admin-guide/source/shared-file-systems-manage-shares-cli.rst

Migrate shares

As an administrator, you can migrate a share with its data from one location to another in a manner that is transparent to users and workloads. You can use manila client commands to complete a share migration.

Possible use cases for data migration include:

• Bring down a physical storage device for maintenance without disrupting workloads.
• Modify the properties of a share.
• Free up space in a thinly-provisioned back end.

Migrate a share with the manila migrate command, as shown in the following example:

$ manila migrate shareID destinationHost --force-host-copy True|False

In this example, --force-host-copy True forces the generic host-based migration mechanism and bypasses any driver optimizations. destinationHost is in this format host#pool which includes destination host and pool.

Note

If the user is not an administrator, the migration fails.