manila/releasenotes/notes/manage-unmanage-share-servers-cd4a6523d8e9fbdf.yaml
Rodrigo Barbieri d877b61c5e Add manage/unmanage of shares in DHSS=True
This patch adds Manage/Unmanage of share servers in
Manila. It also updates the Manage Share API to accept
a "share_server_id" parameter, and updates Unmanage
of Share and Snapshots API to allow unmanaging of
shares and snapshots in DHSS=True.

Managed share servers are not deleted automatically
by manila, and if a single share is unmanaged in
DHSS=True, the respective share server will not be
deleted automatically as well.

Managing share servers require that the driver
implements 2 functions:
- get_share_server_network_info: obtain IPs from
  share server.
- manage_server: perform required operations to
  manage and return dict of backend_details.

Unmanaging share servers require that the driver
overrides unmanage_server function.

The IPs obtained from the backend are validated
by the Network plugin, so ports with the exact
IPs must exist in the subnet and admin subnet
associated with the share network specified
when managing the share server (unless
StandaloneNetworkPlugin is used).

It is recommended to rename the backend resource
if possible when managing the share server, to
prevent issues with re-managing a share server
that has already been managed.

This patch bumps the API microversion to 2.49.

APIImpact
DocImpact

Depends-On: I17c74b2aa242918188eeff368232c762a4b31093
Partially-implements: bp manage-unmanage-with-share-servers
Change-Id: I108961e7436ba13550ef2b8f02079c6e599a6166
2019-03-05 16:03:29 -03:00

25 lines
1.1 KiB
YAML

---
features:
- Added APIs with default policy set to
'rule:admin_api' that allow managing and
unmanaging share servers. Managing Share servers
is useful for importing pre-existing shares and
snapshots into Manila's management when the driver
is configured in ``driver_handles_share_servers``
enabled mode. Unmanaging removes manila share
servers from the database without removing them
from the back end. Managed share servers, or share
servers that have had one or more shares unmanaged will
not be deleted automatically when they do not have
any shares managed by Manila, even if the config options
[DEFAULT]/delete_share_server_with_last_share or
[DEFAULT]/automatic_share_server_cleanup have been
set to True.
- Updated Manage Share API to be able to manage shares
in ``driver_handles_share_servers`` enabled driver
mode by supplying the Share Server ID.
- Updated Unmanage Share and Unmanage Snapshot APIs
to allow unmanaging shares and snapshots in
``driver_handles_share_servers`` enabled driver
mode.