Cisco MDS 9000 Family Command Reference, Release 2.x
Z Commands

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 terminal
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.

switch# config terminal
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 terminal
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 terminal
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 terminal
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 terminal
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 terminal
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
Fabric pWWN example:
switch(config-zone)# member fwwn 10:01:10:01:10:ab:cd:ef
FC ID example:
switch(config-zone)# member fcid 0xce00d1
FC alias example:
switch(config-zone)# member fcalias Payroll
Domain ID example:
switch(config-zone)# member domain-id 2 portnumber 23
FC alias example:
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 terminal
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.

switch# config terminal
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 terminal
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 terminal
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 terminal
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.