openstack-manuals/doc/config-reference/block-storage/section_fc-zoning.xml
Christian Berendt d7c3f88004 Fix usage of option and parameter
Change-Id: I78e99862dbf16829342d4e618f09e5d75b6debdf
2015-04-23 22:02:08 +02:00

106 lines
5.6 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
through 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 automates the zoning operations
through SSH. Configure Cisco Zone Driver, Cisco Southbound connector,
FC SAN lookup service and Fabric name.</para>
<para>Set the following options in the <filename>cinder.conf</filename> configuration file.</para>
<programlisting language="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 = <replaceable>CISCO_FABRIC_EXAMPLE</replaceable>
cisco_sb_connector = cinder.zonemanager.drivers.cisco.cisco_fc_zone_client_cli.CiscoFCZoneClientCLI</programlisting>
<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> option.
</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>