diff --git a/manila/share/drivers/service_instance.py b/manila/share/drivers/service_instance.py index fc6a6ade64..37481e742e 100644 --- a/manila/share/drivers/service_instance.py +++ b/manila/share/drivers/service_instance.py @@ -93,8 +93,18 @@ share_servers_handling_mode_opts = [ cfg.StrOpt( "interface_driver", default="manila.network.linux.interface.OVSInterfaceDriver", - help="Vif driver. Used only with Neutron and " - "if driver_handles_share_servers=True."), + help="Module path to the Virtual Interface (VIF) driver class. This " + "option is used only by drivers operating in " + "`driver_handles_share_servers=True` mode that provision " + "OpenStack compute instances as share servers. This option is " + "only supported with Neutron networking. " + "Drivers provided in tree work with Linux Bridge " + "(manila.network.linux.interface.BridgeInterfaceDriver) and OVS " + "(manila.network.linux.interface.OVSInterfaceDriver). If the " + "manila-share service is running on a host that is connected to " + "the administrator network, a no-op driver " + "(manila.network.linux.interface.NoopInterfaceDriver) may " + "be used."), cfg.BoolOpt( "connect_share_server_to_tenant_network", default=False, diff --git a/releasenotes/notes/generic-driver-noop-interface-driver-24abcf7af1e08ff9.yaml b/releasenotes/notes/generic-driver-noop-interface-driver-24abcf7af1e08ff9.yaml new file mode 100644 index 0000000000..6186fd1b97 --- /dev/null +++ b/releasenotes/notes/generic-driver-noop-interface-driver-24abcf7af1e08ff9.yaml @@ -0,0 +1,9 @@ +--- +features: + - | + A "no-op" interface driver (manila.network.linux.interface.NoopInterfaceDriver) + has been introduced to work with drivers that create and manage + lifecycle of share servers (``driver_handles_share_servers=True``) + through service instance virtual machines using OpenStack Compute. This + interface driver can be used when manila-share is running on a machine + that has access to the administrator network used by Manila.