openstack-manuals/doc/user-guide-admin/source/cli_manage_shares.rst
Xing Yang de8f0d0ed0 Update admin and user guide for Manila CLI
This patch updates admin and user guide for Manila CLI.

Change-Id: I29961d91f35b1e57b1c84733014cf7a5112d4e5a
2015-10-11 23:09:19 -04:00

1.1 KiB

Manage shares

A share is provided by file storage. You can give access to a share to instances. To create and manage shares, you use manila client commands.

Migrate a share

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.

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.