openstack-manuals/doc/config-reference/block-storage/section_fc-zoning.xml
Yamini Umapathy f6380f6f5a Add Documentation for CISCOFCZoneDriver
Added a new section for CiscoFCZoneDriver in Config Reference Guide

Closes bug 1398790
Change-Id: I19640e210bd039b4dd92de85f3f2a334ea3afe8b
2014-12-04 12:17:42 +05:30

100 lines
5.0 KiB
XML

<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="section_fc-zoning">
<title>Fibre Channel Zone Manager</title>
<para>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.</para>
<section xml:id="enable-fc-zone-manager">
<title>Configure Block Storage to use Fibre Channel Zone Manager
</title>
<para>If Block Storage is configured to use a Fibre Channel volume
driver that supports Zone Manager, update
<filename>cinder.conf</filename> to add the following
configuration options to enable Fibre Channel Zone Manager.
</para>
<para>Make the following changes in the
<filename>/etc/cinder/cinder.conf</filename>
file.</para>
<xi:include href="../../common/tables/cinder-zoning.xml"/>
<para>To use different Fibre Channel Zone Drivers, use the
parameters described in this section.</para>
<note>
<para>When multi backend configuration is used, provide
the <option>zoning_mode</option> configuration option as
part of the volume driver configuration where
<option>volume_driver</option> option is specified.</para>
</note>
<note>
<para>Default value of <option>zoning_mode</option> is
<literal>None</literal> and this needs to be changed to
<literal>fabric</literal> to allow fabric zoning.</para>
</note>
<note>
<para><option>zoning_policy</option> can be configured as
<literal>initiator-target</literal> or
<literal>initiator</literal>
</para>
</note>
</section>
<section xml:id="brcd-fc-zone-driver">
<title>Brocade Fibre Channel Zone Driver</title>
<para>Brocade Fibre Channel Zone Driver performs zoning operations
via SSH. Configure Brocade Zone Driver and lookup service by
specifying the following parameters:</para>
<xi:include href="../../common/tables/cinder-zoning_manager.xml"/>
<para>Configure SAN fabric parameters in the form of fabric
groups as described in the example below:</para>
<xi:include href="../../common/tables/cinder-zoning_fabric.xml"/>
<note>
<para>Define a fabric group for each fabric using the fabric names
used in <option>fc_fabric_names</option> configuration option
as group name.
</para>
</note>
<section xml:id="brcd-zone-driver-sys-reqs">
<title>System requirements</title>
<para>Brocade Fibre Channel Zone Driver requires firmware version
FOS v6.4 or higher.</para>
<para>As a best practice for zone management, use a user account
with <literal>zoneadmin</literal> role.
Users with <literal>admin</literal> role (including the default
<literal>admin</literal> user account) are limited to a maximum
of two concurrent SSH sessions.
</para>
<para>For information about how to manage Brocade Fibre Channel
switches, see the Brocade Fabric OS user documentation.</para>
</section>
</section>
<section xml:id="cisco-fc-zone-driver">
<title>Cisco Fibre Channel Zone Driver</title>
<para>Cisco Fibre Channel Zone Driver performs zoning operations
via SSH. Configure Cisco Zone Driver and lookup service by
specifying the following parameters:</para>
<xi:include href="../../common/tables/cinder-zoning_manager_cisco.xml"/>
<para>Configure SAN fabric parameters in the form of fabric
groups as described in the example below:</para>
<xi:include href="../../common/tables/cinder-zoning_fabric_cisco.xml"/>
<note>
<para>Define a fabric group for each fabric using the fabric names
used in <option>fc_fabric_names</option> configuration option
as group name.
</para>
<para>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 <option>fc_fabric_names</option> parameter.
</para>
</note>
<section xml:id="cisco-zone-driver-sys-reqs">
<title>System requirements</title>
<para>Cisco MDS 9000 Family Switches.</para>
<para>Cisco MDS NX-OS Release 6.2(9) or later.</para>
<para>For information about how to manage Cisco Fibre Channel
switches, see the Cisco MDS 9000 user documentation.</para>
</section>
</section>
</section>