1 2.. _fc_zone_manager: 3 4========================== 5Fibre Channel Zone Manager 6========================== 7 8The Fibre Channel Zone Manager allows FC SAN Zone/Access control 9management in conjunction with Fibre Channel block storage. The 10configuration of Fibre Channel Zone Manager and various zone drivers are 11described in this section. 12 13Configure Block Storage to use Fibre Channel Zone Manager 14~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 15 16If Block Storage is configured to use a Fibre Channel volume driver that 17supports Zone Manager, update ``cinder.conf`` to add the following 18configuration options to enable Fibre Channel Zone Manager. 19 20Make the following changes in the ``/etc/cinder/cinder.conf`` file. 21 22.. include:: ../tables/cinder-zoning.inc 23 24To use different Fibre Channel Zone Drivers, use the parameters 25described in this section. 26 27.. note:: 28 29 When multi backend configuration is used, provide the 30 ``zoning_mode`` configuration option as part of the volume driver 31 configuration where ``volume_driver`` option is specified. 32 33.. note:: 34 35 Default value of ``zoning_mode`` is ``None`` and this needs to be 36 changed to ``fabric`` to allow fabric zoning. 37 38.. note:: 39 40 ``zoning_policy`` can be configured as ``initiator-target`` or 41 ``initiator`` 42 43Brocade Fibre Channel Zone Driver 44~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 45 46Brocade Fibre Channel Zone Driver performs zoning operations 47through HTTP, HTTPS, or SSH. 48 49Set the following options in the ``cinder.conf`` configuration file. 50 51.. include:: ../tables/cinder-zoning_manager_brcd.inc 52 53Configure SAN fabric parameters in the form of fabric groups as 54described in the example below: 55 56.. include:: ../tables/cinder-zoning_fabric_brcd.inc 57 58.. note:: 59 60 Define a fabric group for each fabric using the fabric names used in 61 ``fc_fabric_names`` configuration option as group name. 62 63.. note:: 64 65 To define a fabric group for a switch which has Virtual Fabrics 66 enabled, include the ``fc_virtual_fabric_id`` configuration option 67 and ``fc_southbound_protocol`` configuration option set to ``HTTP`` 68 or ``HTTPS`` in the fabric group. Zoning on VF enabled fabric using 69 ``SSH`` southbound protocol is not supported. 70 71System requirements 72------------------- 73 74Brocade Fibre Channel Zone Driver requires firmware version FOS v6.4 or 75higher. 76 77As a best practice for zone management, use a user account with 78``zoneadmin`` role. Users with ``admin`` role (including the default 79``admin`` user account) are limited to a maximum of two concurrent SSH 80sessions. 81 82For information about how to manage Brocade Fibre Channel switches, see 83the Brocade Fabric OS user documentation. 84 85Cisco Fibre Channel Zone Driver 86~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 87 88Cisco Fibre Channel Zone Driver automates the zoning operations through 89SSH. Configure Cisco Zone Driver, Cisco Southbound connector, FC SAN 90lookup service and Fabric name. 91 92Set the following options in the ``cinder.conf`` configuration file. 93 94.. code-block:: ini 95 96 [fc-zone-manager] 97 zone_driver = cinder.zonemanager.drivers.cisco.cisco_fc_zone_driver.CiscoFCZoneDriver 98 fc_san_lookup_service = cinder.zonemanager.drivers.cisco.cisco_fc_san_lookup_service.CiscoFCSanLookupService 99 fc_fabric_names = CISCO_FABRIC_EXAMPLE 100 cisco_sb_connector = cinder.zonemanager.drivers.cisco.cisco_fc_zone_client_cli.CiscoFCZoneClientCLI 101 102.. include:: ../tables/cinder-zoning_manager_cisco.inc 103 104Configure SAN fabric parameters in the form of fabric groups as 105described in the example below: 106 107.. include:: ../tables/cinder-zoning_fabric_cisco.inc 108 109.. note:: 110 111 Define a fabric group for each fabric using the fabric names used in 112 ``fc_fabric_names`` configuration option as group name. 113 114 The Cisco Fibre Channel Zone Driver supports basic and enhanced 115 zoning modes.The zoning VSAN must exist with an active zone set name 116 which is same as the ``fc_fabric_names`` option. 117 118System requirements 119------------------- 120 121Cisco MDS 9000 Family Switches. 122 123Cisco MDS NX-OS Release 6.2(9) or later. 124 125For information about how to manage Cisco Fibre Channel switches, see 126the Cisco MDS 9000 user documentation. 127