Angela Smith cad1dcb5f2 REST connector for Brocade zone driver
Add REST connector for switches with firmware
FOS 8.2.1 and greater.

Change-Id: I4a205c0e1040d743d94c900318fd3b6edfe667ef
2019-02-18 01:07:42 -08:00

152 lines
4.8 KiB
ReStructuredText

.. _fc_zone_manager:
==========================
Fibre Channel Zone Manager
==========================
The Fibre Channel Zone Manager allows FC SAN Zone/Access control
management in conjunction with Fibre Channel block storage. The
configuration of Fibre Channel Zone Manager and various zone drivers are
described in this section.
Configure Block Storage to use Fibre Channel Zone Manager
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If Block Storage is configured to use a Fibre Channel volume driver that
supports Zone Manager, update ``cinder.conf`` to add the following
configuration options to enable Fibre Channel Zone Manager.
Make the following changes in the ``/etc/cinder/cinder.conf`` file under a
``[fc-zone-manager]`` section.
.. config-table::
:config-target: zoning
cinder.zonemanager.fc_zone_manager
To use different Fibre Channel Zone Drivers, use the parameters
described in this section.
.. note::
When multi backend configuration is used, provide the
``zoning_mode`` configuration option as part of the volume driver
configuration where ``volume_driver`` option is specified.
.. note::
Default value of ``zoning_mode`` is ``None`` and this needs to be
changed to ``fabric`` to allow fabric zoning.
.. note::
``zoning_policy`` can be configured as ``initiator-target`` or
``initiator``
Brocade Fibre Channel Zone Driver
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Brocade Fibre Channel Zone Driver performs zoning operations
through HTTP, HTTPS, or SSH.
Set the following options in the ``cinder.conf`` configuration file under the
``[fc-zone-manager]`` section.
.. config-table::
:config-target: Brocade zoning manager
cinder.zonemanager.drivers.brocade.brcd_fc_zone_driver
Configure SAN fabric parameters under a section matching the name used in
``fc_fabric_names`` as described in the example below:
.. config-table::
:config-target: Brocade zoning fabrics
cinder.zonemanager.drivers.brocade.brcd_fabric_opts
.. note::
Define a fabric group for each fabric using the fabric names used in
``fc_fabric_names`` configuration option as group name.
.. note::
To define a fabric group for a switch which has Virtual Fabrics
enabled, include the ``fc_virtual_fabric_id`` configuration option
and ``fc_southbound_protocol`` configuration option set to ``HTTP``,
``HTTPS``, ``REST_HTTP`` or ``REST_HTTPS`` in the fabric group.
Zoning on VF enabled fabric using ``SSH`` southbound protocol is
not supported.
.. note::
On switches running Fabric OS v8.2.1 or greater, the use of the
REST interface is recommended for southbound communication. Set
the ``fc_southbound_protocol`` configuration option to ``REST_HTTP``
or ``REST_HTTPS`` in the fabric group.
System requirements
-------------------
Brocade Fibre Channel Zone Driver requires firmware version FOS v6.4 or
higher.
As a best practice for zone management, use a user account with
``zoneadmin`` role. Users with ``admin`` role (including the default
``admin`` user account) are limited to a maximum of two concurrent SSH
sessions.
For information about how to manage Brocade Fibre Channel switches, see
the Brocade Fabric OS user documentation.
Cisco Fibre Channel Zone Driver
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Cisco Fibre Channel Zone Driver automates the zoning operations through
SSH. Configure Cisco Zone Driver, Cisco Southbound connector, FC SAN
lookup service and Fabric name.
Set the following options in the ``cinder.conf`` configuration file.
.. code-block:: ini
[fc-zone-manager]
zone_driver = cinder.zonemanager.drivers.cisco.cisco_fc_zone_driver.CiscoFCZoneDriver
fc_san_lookup_service = cinder.zonemanager.drivers.cisco.cisco_fc_san_lookup_service.CiscoFCSanLookupService
fc_fabric_names = CISCO_FABRIC_EXAMPLE
cisco_sb_connector = cinder.zonemanager.drivers.cisco.cisco_fc_zone_client_cli.CiscoFCZoneClientCLI
.. config-table::
:config-target: Cisco zoning manager
cinder.zonemanager.drivers.cisco.cisco_fc_zone_driver
Configure SAN fabric parameters under a section matching the name used in
``fc_fabric_names`` as described in the example below:
.. config-table::
:config-target: Cisco zoning fabrics
cinder.zonemanager.drivers.cisco.cisco_fabric_opts
.. note::
Define a fabric group for each fabric using the fabric names used in
``fc_fabric_names`` configuration option as group name.
The Cisco Fibre Channel Zone Driver supports basic and enhanced
zoning modes.The zoning VSAN must exist with an active zone set name
which is same as the ``fc_fabric_names`` option.
System requirements
-------------------
Cisco MDS 9000 Family Switches.
Cisco MDS NX-OS Release 6.2(9) or later.
For information about how to manage Cisco Fibre Channel switches, see
the Cisco MDS 9000 user documentation.