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)# 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)# 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)# 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.
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# fcalias name samplealias
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.
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.
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.
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# zone name zs1 vsan 1
switch(config-zone)# member fcid 0x111112
The following example shows how to add a zone to a zone set called ZoneSet1 on VSAN 1.
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
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)# 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.
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.
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).
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.
|