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