Cisco MDS 9000 Family Command Reference, Release 1.3 (from Release 1.3(1) through Release 1.3(6))
Z Commands

Table Of Contents

Z Commands

zone copy

zone default-zone

zone name

zoneset (EXEC mode)

zoneset (configuration 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 copy

To copy the active zone set to the full zoneset, 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 zoneset to the full zoneset.

switch# zone copy active-zoneset full-zoneset vsan 1

The following example copies the active zoneset 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 t
switch(config)# zone default-zone permit vsan 2 

Related Commands

Command
Description

show zone

Displays zone information.


zone name

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 read-only

member
{domain-id domain-id port-number port-number |
fcalias name | fcid fcid-value [lun lun-id] | fwwn fwwn-value |
interface fc slot/port [domain-id domain-id | swwn swwn-id] |
ip-address ip-address [subnet-mask] | pwwn pwwn-value [lun lun-id] |
symbolic-nodename identifier}

no zone name zone-name vsan vsan-id
no attribute read-only

no member
{domain-id domain-id port-number port-number |
fcalias name | fcid fcid-value [lun lun-id] | fwwn fwwn-value |
interface fc slot/port [domain-id domain-id | swwn swwn-id] |
ip-address ip-address [subnet-mask] | pwwn pwwn-value [lun lun-id] |
symbolic-nodename identifier}

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

member

(Optional) Adds a member to zone.

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 -port number association.

fcalias fcalias-name

Adds a member using the fcalias name.

fcid fcid-value

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 nodename in the form of a name or an IP address


Defaults

None.

Command Modes

Configuration mode.

Command History

This command was modified in Cisco MDS SAN-OS Release 1.2(1).

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.

Examples

The following example configures a member for the specified zone (Zone1) based on the type (pWWN, fabric pWWN, FC ID, or FC alias) and value specified.

switch# config t
switch(config)# zone name Sample vsan 1

switch(config-zone)# attribute read-only

pWWN example:

sswitch(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.


zoneset (EXEC mode)

To merge zoneset 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 zoneset in the fabric.

export

Exports the zoneset database to the adjacent switch on the specified interface. The active zone set in this switch becomes the activated zone set of the merged SAN.

import

Imports the zoneset database to the adjacent switch on the specified interface. The active zoneset 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 zoneset 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 zoneset database from the adjacent switch connected through the VSAN 2 interface.

switch# zoneset import interface fc1/3 vsan 2

The following example exports the zoneset 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 zoneset information.


zoneset (configuration mode)

To group zones under one zoneset, use the zoneset command in configuration mode. Use the no form of the command to negate the command or revert to the factory defaults.

zoneset {activate [name zoneset-name] | distribute full | name zoneset-name} vsan vsan-id

Syntax Description

activate

Activate a zoneset

name zoneset-name

Configures a zone set. 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 id of the VSAN is from 1 to 4093.


Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

Zones are activated by activating the parent zone set.

Examples

The following example activates a zoneset named gottons in VSAN 333.

switch# conf t
switch(config)# zoneset activate name gottons vsan 333
Zoneset Activation initiated. check zone status

Related Commands

Command
Description

show zoneset

Displays zoneset information.