9bd566c52e
Added documentation on the newly introduced ``update_shares_status_on_ensure`` configuration option, as well as how to run ensure shares and what to expect when it is running. Change-Id: I9cd1260b97bde665066a136b74a0390a134d3d93 Signed-off-by: Carlos Eduardo <ces.eduardo98@gmail.com>
2.1 KiB
Manage shares services
The Shared File Systems service provides API that allows to manage
running share services (Share
services API). Using the manila service-list command, it is possible to get
a list of all kinds of running services. To select only share services,
you can pick items that have field binary equal to
manila-share. Also, you can enable or disable share
services using raw API requests. Disabling means that share services are
excluded from the scheduler cycle and new shares will not be placed on
the disabled back end. However, shares from this service stay available.
With 2024.2 release, admin can schedule share on disabled back end using
only_host scheduler hint.
Recalculating the shares' export location
Until the 2024.2 release, recalculating a share's export location required restarting the corresponding manila-share manager service. This action triggered the backend driver's "ensure shares" operation, which would execute a series of steps to update the export locations.
Starting with the 2024.2 release, as an administrator, you can initiate export location recalculation without restarting the manila-share service. This can now be done directly through the "ensure shares" API.
It is possible to start the ensure shares procedure even if a service is already running it.
To start ensure shares on a given manila-share binary, run the openstack share service ensure shares command:
$ openstack share service ensure shares <host>Note
When this command is issued, the manila-share manager
will by default change the status of the shares to
ensuring, unless the common configuration option <manila-common>
named update_shares_status_on_ensure is changed to
False.
Note
The service will have its ensuring field set to
True while this operation is still in progress.