Table Of Contents
Z Commands
zone broadcast enable vsan
zone clone
zone copy
zone default-zone
zone merge-control restrict vsan
zone mode enhanced vsan
zone name (configuration mode)
zone name (zone set configuration submode)
zone rename
zone-attribute-group clone
zone-attribute-group name
zone-attribute-group rename
zoneset (configuration mode)
zoneset (EXEC mode)
Z Commands
The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the "Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.
zone broadcast enable vsan
To enable zone broadcast frames for a VSAN in basic zoning mode, use the zone broadcast enable command in configuration mode. To disable this feature, use the no form of the command.
zone broadcast enable vsan vsan-id
no zone broadcast enable vsan vsan-id
Syntax Description
vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
Defaults
None.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
2.0(1b)
|
This command was introduced.
|
Usage Guidelines
Broadcast frames are sent to all Nx Ports.
If any NL port attached to an FL port shares a broadcast zone with the source of the broadcast frame,
then the frames are broadcast to all devices in the loop.
This command only applies to basic zoning mode.
Examples
The following example shows how to enable zone configuration broadcasting over the fabric.
switch(config)# zone broadcast enable vsan 10
Related Commands
Command
|
Description
|
show zone
|
Displays zone information.
|
zone clone
To clone a zone name, use the zone clone command in configuration mode.
zone clone origZone-Name cloneZone-Name vsan vsan-id
Syntax Description
origZone-Name cloneZone-Name
|
Clones a zone attribute group from the current name to a new name. Maximum length of names is 64 characters.
|
vsan vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
Defaults
None.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
2.1(1a)
|
This command was introduced.
|
Usage Guidelines
Use the no form of the zone name (configuration mode) command to delete the zone name.
Examples
The following example creates a clone of the original zone group named origZone into the clone zone group cloneZone on VSAN 45.
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# zone clone origZone cloneZone vsan 45
Related Commands
Command
|
Description
|
show zone
|
Displays zone information.
|
zone copy
To copy the active zone set to the full zone set, use the zone copy command in EXEC mode. Use the no form of the command to negate the command or revert to the factory defaults.
zone copy active -zoneset full-zoneset vsan vsan-id
zone copy vsan vsan-id active-zoneset {bootflash: ftp: | full-zoneset | scp: | sftp: | tftp: |
volatile:}
Syntax Description
active-zoneset
|
Copies from the active zone set.
|
vsan vsan-id
|
Configures to copy active zone set on a VSAN to full zone set.The ID of the VSAN is from 1 to 4093.
|
full-zoneset
|
Copies the active-zone set to the full-zone set.
|
bootflash:
|
Copies the active-zone set to a location in the bootflash: directory.
|
ftp:
|
Copies the active-zone set to a remote location using the FTP protocol.
|
scp:
|
Copies the active-zone set to a remote location using the SCP protocol.
|
sftp:
|
Copies the active-zone set to a remote location using the SFTP protocol.
|
slot0:
|
Copies the active-zone set to a location in the slot0: directory.
|
tftp:
|
Copies the active-zone set to a remote location using the TFTP protocol.
|
volatile:
|
Copies the active-zone set to a location in the volatile: directory.
|
Defaults
None.
Command Modes
EXEC.
Command History
This command was modified in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example copies the active zone set to the full zone set.
switch# zone copy active-zoneset full-zoneset vsan 1
The following example copies the active zone set in VSAN 3 to a remote location using SCP.
switch# zone copy vsan 3 active-zoneset scp://guest@myserver/tmp/active_zoneset.txt
Related Commands
Command
|
Description
|
show zone
|
Displays zone information.
|
zone default-zone
To define whether a default zone (nodes not assigned a created zone) permits or denies access to all in the default zone, use the zone default-zone command in configuration mode. Use the no form of the command to negate the command or revert to the factory defaults.
zone default-zone [permit] vsan vsan-id
no zone default-zone [permit] vsan vsan-id
Syntax Description
permit
|
Permits access to all in the default zone.
|
vsan vsan-id
|
Sets default zoning behavior for the specified VSAN. The ID of the VSAN is from 1 to 4093.
|
Defaults
All default zones are permitted access.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example permits default zoning in VSAN 2.
switch(config)# zone default-zone permit vsan 2
Related Commands
Command
|
Description
|
show zone
|
Displays zone information.
|
zone merge-control restrict vsan
To restrict zone database merging, use the zone merge-control restrict vsan command in configuration mode. To disable this feature, use the no form of the command.
zone merge-control restrict vsan vsan-id
no zone merge-control restrict vsan vsan-id
Syntax Description
vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
2.0(1b)
|
This command was introduced.
|
Usage Guidelines
If merge control setting is restricted and the two databases are not identical, the ISLs between the switches are isolated.
Examples
The following example shows how to configure zone merge control.
switch(config)# zone merge-control restrict vsan 10
Related Commands
Command
|
Description
|
show zone
|
Displays zone information.
|
zone mode enhanced vsan
To enable enhanced zoning for a VSAN, use the zone mode enhanced vsan command in configuration mode. To disable this feature, use the no form of the command.
zone mode enhanced vsan vsan-id
no zone mode enhanced vsan vsan-id
Syntax Description
vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
2.0(1b)
|
This command was introduced.
|
Usage Guidelines
Before using the zone mode enhanced vsan command, verify that all switches in the fabric are capable of working in enhanced zoning mode. If one or more switches are not capable of working in enhanced zoning mode, then the request to enable enhanced zoning mode is rejected.
When the zone mode enhanced vsan command completes successfully, the software automatically starts a session, distributes the zoning database using the enhanced zoning data structures, applies the configuration changes, and sends a release change authorization (RCA) to all switches in the fabric. All switches in the fabric then enable enhanced zoning mode.
Examples
The following example shows how to enable enhanced zoning mode.
switch(config)# zone mode enhanced vsan 10
Related Commands
Command
|
Description
|
show zone
|
Displays zone information.
|
zone name (configuration mode)
To create a zone, use the zone name command in configuration mode. Use the no form of the command to negate the command or revert to the factory defaults.
zone name zone-name vsan vsan-id
attribute {broadcast | qos priority {high | low | medium} | read-only}
attribute-group group-name
member {device-alias alias-name [lun lun-id] |
domain-id domain-id port-number port-number |
fcalias name | fcid fcid-value [lun lun-id] | fwwn fwwn-id |
interface fc slot/port [domain-id domain-id | swwn swwn-id] |
ip-address ip-address [subnet-mask] | pwwn pwwn-id [lun lun-id] |
symbolic-nodename identifier}
zone name zone-name vsan vsan-id
no attribute {broadcast | qos priority {high | low | medium} | read-only}
no attribute-group group-name
no member {device-alias alias-name [lun lun-id] |
domain-id domain-id port-number port-number |
fcalias name | fcid fcid-value [lun lun-id] | fwwn fwwn-id |
interface fc slot/port [domain-id domain-id | swwn swwn-id] |
ip-address ip-address [subnet-mask] | pwwn pwwn-id [lun lun-id] |
symbolic-nodename identifier}
no zone name zone-name vsan vsan-id
Syntax Description
zone-name
|
Specifies the name of the zone. Maximum length is 64 characters.
|
vsan vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
attribute
|
(Optional) Sets zone attributes.
|
read-only
|
Sets read-only attribute for the zone (default is read-write).
|
broadcast
|
Sets broadcast attribute for the zone.
|
qos priority {high | low | medium}
|
Sets QoS attribute for the zone (default is low).
|
attribute-group group-name
|
Configures an attribute group. Maximum length is 64 characters.
|
member
|
(Optional) Adds a member to a zone.
|
device-alias alias-name
|
Adds a member using the device alias name.
|
lun lun-id
|
Specifies the LUN number in hexadecimal format.
|
domain-id domain-id
|
Adds a member using the domain ID.
|
port-number port-number
|
Adds a member using the port number of the domain ID portnumber association.
|
fcalias name
|
Adds a member using the fcalias name.
|
fcid fcid-id
|
Adds a member using the FCID member in the format 0xhhhhhh.
|
fwwn fwwn-id
|
Adds a member using the fabric port WWN in the format hh:hh:hh:hh:hh:hh:hh:hh.
|
interface fc slot/port
|
Adds a member using the Fibre Channel interface.
|
swwn swwn-id
|
Specifies the switch WWN in the format hh:hh:hh:hh:hh:hh:hh:hh.
|
ip-address ip-address
|
Adds a member using the IP address.
|
subnet-mask
|
Specifies an optional subnet mask.
|
pwwn pwwn-id
|
Adds a member using the port WWN in the format hh:hh:hh:hh:hh:hh:hh:hh.
|
symbolic-nodename identifier
|
Adds a member using the symbolic node name in the form of a name or an IP address.
|
Defaults
Zone attribute is read-only.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
1.0(2)
|
This command was introduced.
|
1.2(1)
|
Added the attribute, interface, and lun subcommands.
|
2.0(1b)
|
•Added the broadcast and qos priority options to the attribute subcommand.
•Added the attribute-group subcommand.
•Added the device-alias aliasname [lun lun-id] option to the member subcommand.
|
Usage Guidelines
Zones are assigned to zone sets, zone sets are then activated from one switch and propagate across the fabric to all switches. Zones allow security by permitting and denying access between nodes (hosts and storage). zone name commands are issued from the configuration mode. Configure a zone for a VSAN from the config-zone submode.
Use the show wwn switch command to retrieve the sWWN. If you do not provide a sWWN, the software automatically uses the local sWWN.
Broadcast frames are sent to all Nx ports.
If any NL port attached to an FL port shares a broadcast zone with the source of the broadcast frame,
then the frames are broadcast to all devices in the loop.
Examples
The following example configures attributes for the specified zone (Zone1) based on the member type (pWWN, fabric pWWN, FCID, or FC alias) and value specified.
switch(config)# zone name Zone1 vsan 10
switch(config-zone)# attribute broadcast
switch(config-zone)# attribute read-only
The following example configures members for the specified zone (Zone2) based on the member type (pWWN, fabric pWWN, FCID, or FC alias) and value specified.
switch(config)# zone name Zone2 vsan 10
switch(config-zone)# attribute broadcast
switch(config-zone)# attribute read-only
pWWN example:
switch(config-zone)# member pwwn 10:00:00:23:45:67:89:ab
switch(config-zone)# member fwwn 10:01:10:01:10:ab:cd:ef
switch(config-zone)# member fcid 0xce00d1
switch(config-zone)# member fcalias Payroll
switch(config-zone)# member domain-id 2 portnumber 23
switch(config-zone)# member ipaddress 10.15.0.0 255.255.0.0
Local sWWN interface example:
switch(config-zone)# member interface fc 2/1
Remote sWWN interface example:
switch(config-zone)# member interface fc2/1 swwn 20:00:00:05:30:00:4a:de
Domain ID interface example:
switch(config-zone)# member interface fc2/1 domain-id 25
Related Commands
Command
|
Description
|
show zone
|
Displays zone information.
|
zone rename
|
Renames zones.
|
zone-attribute-group name
|
Configures zone attribute groups.
|
zone name (zone set configuration submode)
To configure a zone in a zone set, use the zone name command in zone set configuration submode. To delete the zone from the zone set, use the no form of the command.
zone name zone-name
no zone name zone-name
Syntax Description
zone-name
|
Specifies the name of the zone. Maximum length is 64 characters.
|
Defaults
None.
Command Modes
Zone set configuration mode.
Command History
This command was modified in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example configure a zone in a zone set.
switch(config)# zoneset name Sample vsan 1
switch(config-zoneset)# zone name MyZone
The following example deletes a zone from a zone set.
switch(config-zoneset)# no zone name Zone2
Related Commands
Command
|
Description
|
show zoneset
|
Displays zone set information.
|
zone name (configuration mode)
|
Configure zones.
|
zoneset
|
Configures zone set attributes.
|
zone rename
To rename a zone, use the zone rename command in configuration mode.
zone rename current-name new-name vsan vsan-id
Syntax Description
current-name
|
Specifies the current fcalias name. Maximum length is 64 characters.
|
new-name
|
Specifies the new fcalias name. Maximum length is 64 characters.
|
vsan vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
Defaults
None.
Command Modes
EXEC mode.
Command History
Release
|
Modification
|
2.0(1b)
|
This command was introduced.
|
Usage Guidelines
None.
Examples
The following example shows how to rename a zone.
switch# zone rename ZoneA ZoneB vsan 10
Related Commands
Command
|
Description
|
show zone
|
Displays zone information.
|
zone name
|
Creates and configures zones.
|
zone-attribute-group clone
To clone a zone attribute group, use the zone-attribute-group clone command in configuration mode.
zone attribute clone origAttGrp-Name cloneAttGrp-Name vsan vsan-id
Syntax Description
origAttGrp-Name cloneAttGrp-Name
|
Clones a zone attribute group from the current name to a new name. Maximum length of names is 64 characters.
|
vsan vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
Defaults
None.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
2.1(1a)
|
This command was introduced.
|
Usage Guidelines
To remove the zone attribute group, use the no form of the zone-attribute-group name command.
Examples
The following example shows how to clone a zone attribute group with the original name origZoneAttGrp to a copy named cloneZoneAttGrp on VSAN 45.
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# zone-attribute-group clone origZoneAttGrp cloneZoneAttGrp vsan 45
Related Commands
Command
|
Description
|
show zone-attribute-group
|
Displays zone attribute group information.
|
zone-attribute-group name
To create and configure a zone attribute group for enhanced zoning, use the zone-attribute-group name command in configuration mode. To remove the zone attribute group, use the no form of the command.
zone attribute group name zone-name vsan vsan-id
no zone attribute group name zone-name vsan vsan-id
Syntax Description
zone-name
|
Specifies the zone attribute name. Maximum length is 64 characters.
|
vsan vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
Defaults
None.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
2.0(1b)
|
This command was introduced.
|
Usage Guidelines
You can use this command to create a zone attribute group and to modify an existing zone attribute group.
Zone attribute groups are only supported for enhanced zoning. You can enable enhanced zoning using the zone mode enhanced vsan command.
Examples
The following example shows how to create a zone attribute group and enter attribute group configuration submode.
switch(config)# zone-attribute-group name admin-attributes vsan 10
switch(config-attribute-group)#
Related Commands
Command
|
Description
|
show zone-attribute-group
|
Displays zone attribute group information.
|
zone mode enhanced vsan
|
Enables enhanced zoning for a VSAN.
|
zone-attribute-group rename
To rename a zone attribute group, use the zone-attribute-group rename command in configuration mode.
zone attribute group rename current-name new-name vsan vsan-id
Syntax Description
current-name
|
Specifies the current zone attribute name. Maximum length is 64 characters.
|
new-name
|
Specifies the new zone attribute name. Maximum length is 64 characters.
|
vsan vsan-id
|
Specifies the VSAN ID. The range is 1 to 4093.
|
Defaults
None.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
2.0(1b)
|
This command was introduced.
|
Usage Guidelines
None.
Examples
The following example shows how to rename a zone attribute group.
switch(config)# zone-attribute-group rename Group1 Group2 vsan 10
Related Commands
Command
|
Description
|
show zone-attribute-group
|
Displays zone attribute group information.
|
zoneset (configuration mode)
To group zones under one zone set, use the zoneset command in configuration mode. To negate the command or revert to the factory defaults, use the no form of the command.
zoneset {activate name zoneset-name vsan vsan-id |
clone zoneset-currentName zoneset-cloneName |
distribute full vsan vsan-id |
name zoneset-name vsan vsan-id |
rename current-name new-name vsan vsan-id}
no zoneset {activate name zoneset-name vsan vsan-id |
clone zoneset-currentName zoneset-cloneName |
distribute full vsan vsan-id |
name zoneset-name vsan vsan-id |
rename current-name new-name vsan vsan-id}
Syntax Description
activate
|
Activates a zone set
|
clone zoneset-currentName zoneset-cloneName
|
Clones a zone set from the current name to a new name. Maximum length of names is 64 characters.
|
name zoneset-name
|
Specifies a name for a zone set. Maximum length is 64 characters.
|
distribute full
|
Enables zone set propagation.
|
vsan vsan-id
|
Activates a zone set on the specified VSAN. The range is 1 to 4093.
|
rename
|
Renames a zone set.
|
current-name
|
Specifies the current fcalias name.
|
new-name
|
Specifies the new fcalias name.
|
Defaults
None.
Command Modes
Configuration mode.
Command History
Release
|
Modification
|
1.0(2)
|
This command was introduced.
|
2.0(1b)
|
Added the rename option.
|
2.1(1a)
|
Added the clone option.
|
Usage Guidelines
Zones are activated by activating the parent zone set.
Examples
The following example activates a zone set named gottons in VSAN 333.
switch(config)# zoneset activate name gottons vsan 333
Zoneset Activation initiated. check zone status
The following example clones a zone set named zSet1 into a new zoneset named zSetClone in VSAN 45.
switch(config)# zoneset clone existing zSet1 zSetClone vsan 45
Related Commands
Command
|
Description
|
show zoneset
|
Displays zone set information.
|
zoneset (EXEC mode)
To merge zone set databases, use the zoneset command in EXEC mode.
zoneset {distribute | export | import interface {fc slot-number | fcip interface-number |
port-channel port-number}} vsan vsan-id
Syntax Description
distribute
|
Distributes the full zone set in the fabric.
|
export
|
Exports the zone set database to the adjacent switch on the specified VSAN. The active zone set in this switch becomes the activated zone set of the merged SAN.
|
import
|
Imports the zone set database to the adjacent switch on the specified interface. The active zone set in the adjacent switch becomes the activated zone set of the merged SAN.
|
interface
|
Configures the interface.
|
fc slot-number
|
Configures a Fibre Channel interface for the specified slot number and port number.
|
fcip interface-number
|
Selects the FCIP interface to configure the specified interface from 1 to 255.
|
port-channel port-number
|
Specifies PortChannel interface.
|
vsan vsan-id
|
Merges the zone set database of a VSAN on the specified interface. The ID of the VSAN is from 1 to 4093.
|
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(2).
Usage Guidelines
You can also issue the zoneset import and the zoneset export commands for a range of VSANs.
The zoneset distribute vsan vsan-id command is supported in interop 2 and interop 3 modes—not in interop 1 mode.
Examples
The following example imports the zone set database from the adjacent switch connected through the VSAN 2 interface.
switch# zoneset import interface fc1/3 vsan 2
The following example exports the zone set database to the adjacent switch connected through VSAN 5.
switch# zoneset export vsan 5
The following example distributes the zone set in VSAN 333.
switch# zoneset distribute vsan 333
Zoneset distribution initiated. check zone status
Related Commands
Command
|
Description
|
show zone status vsan
|
Displays the distribution status for the specified VSAN.
|
show zoneset
|
Displays zone set information.
|