# 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 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.

this page last updated: 2026-04-22 07:00:00

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug