Table Of Contents

M Commands

match

match address

mcast root

member (fcalias configuration submode)

member (ivr zone configuration submode)

member (zone configuration and zoneset-zone configuration submode)

member (zoneset configuration submode)

mkdir

modem connect line

move

mutual-chap username (iSCSI initiator mode)

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

match

To configure QoS class map match criteria, use the match command in class map configuration submode. Remove QoS class map match criteria, use the no form of the command.

match {any | destination-address fc-id [mask address-mask] | destination-device-alias name | destination-wwn wwn-id | input-interface fc slot/port | source-address fc-id [mask address-mask] | source-device-alias name | source-wwn wwn-id}

no match {any | destination-address fc-id [mask address-mask] | destination-device-alias name | destination-wwn wwn-id | input-interface fc slot/port | source-address fc-id [mask address-mask] | source-device-alias name | source-wwn wwn-id}

Syntax Description

any	Enables matching of any frame.
destination-address fc-id	Specifies the destination FCID to match frames.
mask address-mask	Specifies an address mask to match frames. The range is 0x0 to 0xffffffff.
destination-device-alias name	Specifies the destination device alias to match frames. Maximum length is 64 characters.
destination-wwn wwn-id	Specifies the destination WWN to match frames.
input-interface fc slot/port	Specifies the source Fibre Channel interface to match frames.
source-address fc-id	Specifies the source FCID to match frames.
source-device-alias name	Specifies the source device alias to match frames. Maximum length is 64 characters.
source-wwn wwn-id	Specifies the source WWN to match frames.

Defaults

None.

Command Modes

Class map configuration submode.

Command History

Release	Modification
1.3(1)	This command was introduced.
2.0(1b)	Added the destination-device-alias and source-device-alias options.

Usage Guidelines

You can access this command only if you enable the QoS data traffic feature using the qos enable command.

Examples

The following example creates a class map called MyClass1 and places you in the class map configuration submode to match any (default) criteria specified for this class.

switch# config terminal

switch(config)# qos class-map MyClass1 match-any

switch(config-cmap)# match any

The following example specifies a destination address match for frames with the specified destination FCID.

switch(config-cmap)# match destination-address 0x12ee00 

The following example specifies a source address and mask match for frames with the specified source FCID. Mask refers to a single or entire area of FCIDs.

switch(config-cmap)# match source-address 0x6d1090 mask 0

The following example specifies a destination WWN to match frames.

switch(config-cmap)# match destination-wwn 20:01:00:05:30:00:28:df

Operation in progress. Please check class-map parameters

The following example specifies a source WWN to match frames.

switch(config-cmap)# match source-wwn 23:15:00:05:30:00:2a:1f

Operation in progress. Please check class-map parameters	

The following example specifies a source interface to match frames.

switch(config-cmap)# match input-interface fc 2/1

Operation in progress. Please check class-map parameters	

The following example removes a match based on the specified source interface.

switch(config-cmap)# no match input-interface fc 3/5 

Related Commands

Command	Description
qos enable	Enables QoS.
show qos	Displays QoS information.

match address

To configure match addresses in an IPsec crypto map with an access control list (ACL), use the match address command in IPsec crypto map configuration submode. To not match addresses, use the no form of the command.

match address acl-name

no match address [acl-name]

Syntax Description

acl-name

Specifies the ACL name. Maximum length is 64 characters.

Defaults

None.

Command Modes

IPsec crypto map configuration submode.

Command History

Release	Modification
2.0(1b)	This command was introduced.

Usage Guidelines

To use this command, the IKE protocol must be enabled using the crypto ike enable command.

Examples

The following example shows how to match addresses in an IPsec crypto map with an ACL.

switch# config terminal

switch(config)# crypto map domain ipsec x 1

switch(config-crypto-map-ip)# match address UserACL

Related Commands

Command	Description
crypto ike domain ipsec	Enters IKE configuration mode.
crypto ike enable	Enables the IKE protocol.
show crypto map domain ipsec	Displays IPsec crypto map information.

mcast root

To configure the multicast feature, use the mcast root command in configuration mode. To revert to the default, use the no form of the command.

mcast root {lowest | principal} vsan vsan-id

no mcast root {lowest | principal} vsan vsan-id

Syntax Description

lowest	Specifies the lowest domain switch as root.
principal	Specifies the principal switch as root.
vsan vsan-id	Specifies the VSAN ID. The range is 1 to 4093.

Defaults

principal

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 configure the multicast root VSAN.

switch# config terminal

switch(config)# mcast root principal vsan 4001

Related Commands

Command	Description
show mcast	Displays multicast information.

member (fcalias configuration submode)

To add a member name to an Fibre Channel alias on a VSAN, use the member command in fcalias configuration submode. To remove a member name from an FC alias, use the no form of the command.

member {device-alias aliasname [lun lun-id] |
domain-id domain-id [lun lun-id] |
fcid fc-id [lun lun-id] |
fwwn fwwn-id |
interface fc slot/port [domain-id domain-id | swwn swwn-id] |
ip-address ipv4|ipv6 |
pwwn pwwn-id [lun lun-id] |
symbolic-nodename nodename}

no member {device-alias aliasname [lun lun-id] |
domain-id domain-id [lun lun-id] |
fcid fc-id [lun lun-id] |
fwwn fwwn-id |
interface fc slot/port [domain-id domain-id | swwn swwn-id] |
ip-address ipv4|ipv6 |
pwwn pwwn-id [lun lun-id] |
symbolic-nodename nodename}

Syntax Description

device-alias aliasname	Specifies the member device alias. Maximum length is 64 characters.
lun lun-id	Specifies the member LUN ID. The format is 0xhhhh[:hhhh[:hhhh[:hhhh]]], where h is a hexadecimal digit.
domain-id domain-id	Specifies the member domain ID. The range is 1 to 239.
fcid fc-id	Specifies the member FC ID. The format is 0xhhhhhh, where h is a hexadecimal digit.
fwwn fwwn-id	Specifies the member fWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit.
interface fc slot/port	Specifies the member interface ID.
swwn swwn-id	Specifies the member sWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit.
ip-address ipv4|ipv6	Specifies a member IP address in either IPv4 format, A.B.C.D, or IPv6format, X:X:X::X/n.
pwwn pwwn-id	Specifies the member pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit.
symbolic-nodename nodename	Specifies the member symbolic node name. The maximum length is 255 characters.

Defaults

None.

Command Modes

Fcalias configuration submode.

Command History

Release	Modification
2.0(1b)	This command was introduced.

Usage Guidelines

None.

Examples

The following example shows how to add a member to an FC alias called samplealias.

switch# config terminal

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config)# fcalias name samplealias

switch(config-fcalias)# 

The following example defines an IPv6 address for the member.

switch(switch(config-fcalias)# member ip-address 2020:dbc0:80::4076

The following example shows how to delete the specified member.

switch(config-fcalias)# no member ip-address 2020:dbc0:80::4076

Related Commands

Command	Description
fcalias name	Configures an FC alias.
show fcalias	Displays the member name information in an FC alias.

member (ivr zone configuration submode)

To add a member name to an Inter-VSAN Routing (IVR) zone, use the member command in IVR zone configuration submode. To remove a member name from an fcalias, use the no form of the command.

member {device-alias aliasname {lun lun-id vsan vsan-id autonomous-fabric-id afid |
vsan vsan-id autonomous-fabric-id afid} |
pwwn pwwn-id {lun lun-id vsan vsan-id autonomous-fabric-id afid | vsan vsan-id autonomous-fabric-id afid}}

no member {device-alias aliasname {lun lun-id vsan vsan-id autonomous-fabric-id afid |
vsan vsan-id autonomous-fabric-id afid} |
pwwn pwwn-id {lun lun-id vsan vsan-id autonomous-fabric-id afid | vsan vsan-id autonomous-fabric-id afid}}

Syntax Description

device-alias aliasname	Specifies the member device alias. Maximum length is 64 characters.
lun lun-id	Specifies the member LUN ID. The format is 0xhhhh[:hhhh[:hhhh[:hhhh]]], where h is a hexadecimal digit.
vsan vsan-id	Specifies the VSAN ID. The range is 1 to 4093.
autonomous-fabric-id afid	Specifies the AFID to the local VSAN.
pwwn pwwn-id	Specifies the member pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit.

Defaults

None.

Command Modes

IVR zone configuration submode.

Command History

Release	Modification
1.3(1)	This command was introduced.
2.1(1a)	Added lun parameter.

Usage Guidelines

You can configure an IVR zone member based on the specified pWWN and LUN value or, based on the specified pWWN, LUN value, and AFID.

Examples

The following example shows how to configures an IVR zone member based on the device alias VSAN, and the AFID.

switch# config terminal

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config)# ivr zone name IvrLunZone

switch(config-ivr-zone)# member device-alias Switch4 vsan 1 autonomous-fabric-id 14 

The following example shows how to configures an IVR zone member based on the pWWN, VSAN, and the AFID.

switch# config terminal

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config)# ivr zone name IvrLunZone

switch(config-ivr-zone)# member pwwn 29:00:00:05:30:00:06:ea vsan 1 autonomous-fabric-id 
14

Related Commands

Command	Description
show ivr zone	Displays the IVR zone information.

member (zone configuration and zoneset-zone configuration submode)

To add a member name to a Fibre Channel zone set zone member, use the member command in zone set zone configuration submode. To remove a member name from a zone set zones, use the no form of the command.

member {device-alias aliasname [lun lun-id] | domain-id domain-id port-number port |
fcalias alias-name [lun lun-id] | fcid fc-id [lun lun-id] | fwwn fwwn-id |
interface fc slot/port [domain-id domain-id | swwn swwn-id] | ip-address ip-address |
pwwn pwwn-id [lun lun-id] | symbolic-nodename nodename}

no member {device-alias aliasname [lun lun-id] | domain-id domain-id port-number port |
fcid fc-id [lun lun-id] | fwwn fwwn-id | interface fc slot/port [domain-id domain-id |
swwn swwn-id] | ip-address ip-address | pwwn pwwn-id [lun lun-id] |
symbolic-nodename nodename}

Syntax Description

device-alias aliasname	Specifies the member device alias. Maximum length is 64 characters.
lun lun-id	Specifies the member LUN ID. The format is 0xhhhh[:hhhh[:hhhh[:hhhh]]], where h is a hexadecimal digit.
domain-id domain-id	Specifies the member domain ID. The range is 1 to 239.
alias-name	The name of the fcalias. Maximum length is 64 characters.
port-number port	Specifies the member port number. The range is 0 to 255.
fcid fc-id	Specifies the member FCID. The format is 0xhhhhhh, where h is a hexadecimal digit.
fwwn fwwn-id	Specifies the member fWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit.
interface fc slot/port	Specifies the member interface ID.
swwn swwn-id	Specifies the member sWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit.
ip-address ip-address	Specifies a member IP address.
pwwn pwwn-id	Specifies the member pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal digit.
symbolic-nodename nodename	Specifies the member symbolic node name. The maximum length is 255 characters.

Defaults

This command can be used in both zone configuration submode and zoneset-zone configuration submode.

Command Modes

Zone set zone configuration submode and zoneset-zone configuration submode.

Command History

Release	Modification
1.0(2)	This command was introduced.
2.1(1a)	Added zoneset-zone configuration submode.

Usage Guidelines

Create a zone set zone member only if you need to add member to a zone from the zone set prompt.

Examples

The following example shows how to add a member to a zone called zs1 on VSAN 1.

switch# config terminal

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config)# zone name zs1 vsan 1

switch(config-zone)# member fcid 0x111112

switch(config-zone)# 

The following example shows how to add a zone to a zone set called ZoneSet1 on VSAN 1.

switch# config terminal

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config)# zoneset name ZoneSet1 vsan 1

switch(config-zoneset-zone)# member fcid 0x111112 

Related Commands

Command	Description
zoneset (configuration mode)	Used to specify a name for a zone set.
zone name (zone set configuration submode)	Configures a zone in a zoneset.
show zoneset	Displays zone set information.

member (zoneset configuration submode)

To configure zone set zone members, use the member command in zone set configuration submode. To remove a zone set member, use the no form of the command.

member member-name

no member member-name

Syntax Description

member-name

Specifies the member name. Maximum length is 64 characters.

Defaults

None.

Command Modes

Zone set configuration submode.

Command History

Release	Modification
1.0(2)	This command was introduced.

Usage Guidelines

None.

Examples

The following example shows how to add a member zone to a zone set.

switch# config terminal

switch(config)# zoneset name Zoneset1 vsan 10

switch(config-zoneset)# member ZoneA

Related Commands

Command	Description
show zone	Displays zone information.
zoneset name	Creates a zone set.

mkdir

To create a directory in the Flash file system, use the mkdir command in EXEC mode.

mkdir directory

Syntax Description

directory

Name of the directory to create.

Defaults

None.

Command Modes

EXEC

Command History

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

Usage Guidelines

This command is only valid on Class C Flash file systems.

You can specify whether to create the directory on bootflash:, slot0, or volatile:. If you do not specify the device, the switch creates the directory on the current directory.

Examples

The following example creates a directory called test in the slot0: directory.

switch# mkdir slot0:test 

The following example creates a directory called test at the current directory level. If the current directory is slot0:mydir, this command creates a directory called slot0:mydir/test.

switch# mkdir test

Related Commands

Command	Description
dir	Displays a list of files on a file system.
rmdir	Removes an existing directory in the Flash file system.

modem connect line

To enable a modem connection when the switch is already in operation, use the modem connect line command in EXEC mode.

modem connect line {com1 | console}

Syntax Description

com1	Connects the modem through a COM1 line connection
console	Connects the modem through a console line connection

Defaults

Disabled.

Command Modes

EXEC mode.

Command History

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

Usage Guidelines

If the switch is already in operation when the modem is connected, issue this command to notify the software that a modem is going to be added.

You must issue the modem connect line command before setting the user-input string for initialization.

Examples

The following example announces a modem connection from the line console.

switch# modem connect line console

The following example announces a modem connection from the COM1 port.

switch# modem connect line com1

move

To remove a file from the source file and place it in the destination file, use the move command in EXEC mode.

move {bootflash: | slot0: | volatile:}[directory/]filename
{bootflash: | slot0: | volatile:}[directory/]filename

Syntax Description

bootflash:	Source or destination location for internal bootflash memory.
slot0:	Source or destination location for the CompactFlash memory or PCMCIA card.
volatile:	Source or destination location for volatile memory.
directory	Specifies the name of the directory.
filename	Specifies the name of the file to move or create.

Defaults

None.

Command Modes

EXEC mode.

Command History

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

Usage Guidelines

If you do not specify the directory name in the command line, the switch prompts you for it.

Examples

The following example moves the file called samplefile from the slot0 directory to the mystorage directory.

switch# move slot0:samplefile slot0:mystorage/samplefile

Related Commands

Command	Description
dir	Displays a list of files on a file system.
mkdir	Creates a directory in the Flash file system.
rmdir	Removes an existing directory in the Flash file system.

mutual-chap username (iSCSI initiator mode)

To assign a username and password for initiator challenge (mutual CHAP) to an iSCSI initiator, use the mutual-chap username command in iSCSI initiator configuration submode. To disable this feature, use the no form of the command.

mutual-chap username username password {0|7} password

no mutual-chap username username password {0|7} password

Syntax Description

username	Specifies the username for iSCSI login authentication.
password	Configures the password for the username.
0	Specifies that the password is a cleartext CHAP password.
7	Specifies that the password is an encrypted CHAP password.
password	Specifies a password for the username.

Defaults

None.

Command Modes

iSCSI initiator configuration submode.

Command History

Release	Modification
2.0(1b)	This command was introduced.

Usage Guidelines

None.

Examples

The following example shows how to configuring a username, password type, and password for initiator challenge (mutual CHAP).

switch# config terminal 

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config)# iscsi initiator name iqn.1987-02.com.cisco.initiator

switch(config-iscsi-init)# mutual-chap username userName password 0 cisco

switch(config-iscsi-init)#

Related Commands

Command	Description
iscsi initiator name	Assigns an iSCSI name and changes to iSCSI initiator configuration submode.
show iscsi initiator	Displays information about configured iSCSI initiators.