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 “About the CLI Command Modes” section to determine the appropriate mode for each command.

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

(Optional) 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(x)

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(x)

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(x)

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

(Optional) Specifies the member LUN ID. The format is 0 x hhhh [ : 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 0 x hhhhhh, 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

(Optional) 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

3.0(1)

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)

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 0 x hhhh [ : 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.

note.gif

Noteblank.gif The CLI interprets the LUN identifier value as a hexadecimal value whether or not the 0x prefix is included.

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 both initiator target [ 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 ipv4|ipv6 |
pwwn pwwn-id [ lun lun-id ] | symbolic-nodename nodename }

no member { device-alias aliasname both initiator target [ 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 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.

both

Specifies the device type as both.

initiator

Specifies the device type as initiator.

target

Specifies the device type as target.

lun lun-id

(Optional) Specifies the member LUN ID. The format is 0 x hhhh [ : 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 FC ID. The format is 0 x hhhhhh, 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

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

5.2(6)

Added the keywords both, initiator, target to the syntax description.

1.0(2)

This command was introduced.

2.1(1a)

Added zoneset-zone configuration submode.

3.0(1)

Added the IPv6 IP address format.

 
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 enter the device type as target:

switch# config terminal
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# zone name zs1 vsan 1
switch(config-zone)# member device-alias a target
switch(config-zone)#

 

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 zoneset 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
 

The following example shows how to assign an iSCSI IPv6 address-based membership into a zone:

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 ipv6-address 2001:0DB8:800:200C::417A

 

The following example shows how to delete the specified device from a zone:

switch(config-zoneset-zone)# no member ipv6-address 2001:0DB8:800:200C::417A

 
Related Commands

Command
Description

show zoneset

Displays zone set information.

zoneset (configuration submode)

Used to specify a name for a zone set.

zone name (zone set configuration submode)

Configures a zone in a zoneset.

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.

metric (iSLB initiator configuration)

To assign a load-balancing metric for an iSLB initiator, use the metric command in iSLB initiator configuration submode. To revert to the default load-balancing metric, use the no form of the command.

metric metric

no metric metric

 
Syntax Description

metric metric

Specifies a load-balancing metric. The range is 10 to 10000.

 
Defaults

1000

 
Command Modes

iSLB initiator configuration submode.

 
Command History

Release
Modification

3.0(1)

This command was introduced.

 
Usage Guidelines

You can assign a load metric to each initiator for weighted load balancing. The load calculated is based on the number of initiators on a given iSCSI interface. This feature accommodates initiators with different bandwidth requirements. For example, you could assign a higher load metric to a database server than to a web server. Weighted load balancing also accommodates initiators with different link speeds.

Examples

The following example specifies a load-balancing metric for the iSLB initiator:

switch# config t
switch(config)# islb initiator ip-address 100.10.10.10
switch (config-islb-init)# metric 100
 

The following example reverts to the default load-balancing metric:

switch (config-islb-init)# no metric 100

 
Related Commands

Command
Description

islb initiator

Assigns an iSLB name and IP address to the iSLB initiator and enters iSLB initiator configuration submode.

show islb initiator configured

Displays iSLB initiator information for the specified configured initiator.

show islb initiator detail

Displays detailed iSLB initiator information.

show islb initiator summary

Displays iSLB initiator summary information.

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

Release
Modification

1.0(2)

This command was introduced.

 
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.

mode

To configure the ESP mode, use the mode command. To delete the ESP mode, use the no form of the command.

mode {gcm | gmac}

no mode {gcm | gmac}

 
Syntax Description

gcm

Specifies the GCM mode for the interface.

gmac

Specifies the GMAC mode for the interface.

 
Defaults

None.

 
Command Modes

Configuration submode.

 
Command History

Release
Modification

NX-OS 4.2(1)

This command was introduced.

 
Usage Guidelines

None.

Examples

The following example shows how to configure the GCM mode for the interface:

switch(config-if-esp)# mode gcm
switch(config-if-esp)#
 

The following example shows how to configure the GMAC mode for the interface:

switch(config-if-esp)# mode gmac
switch(config-if-esp)#

 
Related Commands

Command
Description

fcsp enable

Enables FCSP.
 

 

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

Release
Modification

1.2(2)

This command was introduced.

 
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
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

monitor counter (port-monitor configuration mode)

To configure monitoring of a specific counter within a Port Monitor policy, use the monitor counter command. To remove polling functionality for a specific counter within Port Monitor policy, use the no form of the command.

monitor counter { credit-loss-reco | err-pkt-from-port | err-pkt-from-xbar | err-pkt-to-xbar | invalid-crc | invalid-words | link-loss | lr-rx | lr-tx | rx-datarate | signal-loss | state-change | sync-loss | timeout-discards | tx-credit-not-available | tx-datarate | tx-discards | tx-slowport-count | tx-slowport-oper-delay | txwait }

no monitor counter {all | credit-loss-reco | err-pkt-from-port | err-pkt-from-xbar | err-pkt-to-xbar | invalid-crc | invalid-words | link-loss | lr-rx | lr-tx | rx-datarate | signal-loss | state-change | sync-loss | timeout-discards | tx-credit-not-available | tx-datarate | tx-discards | tx-slowport-count | tx-slowport-oper-delay | txwait }

 
Syntax Description

all

Only available in the no monitor counter command. Turns off monitoring for all counters. This command will not be in the configuration but will expand into all applicable no monitor counter countername commands.

credit-loss-reco

Configures the credit loss recovery counter to be monitored.

err-pkt-from-port

Configures the err-pkt-from-port counter to be monitored 1.3.6.1.4.1.9.9.779.1.1.1.1.4.0.1.

err-pkt-from-
xbar

Configures the err-pkt-from-xbar counter to be monitored 1.3.6.1.4.1.9.9.779.1.1.1.1.4.0.2.

err-pkt-to-xbar

Configures the err-pkt-to-xbar counter to be monitored 1.3.6.1.4.1.9.9.779.1.1.1.1.4.0.3.

invalid-crc

Configures the invalid crc counter to be monitored.

invalid-words

Configures the invalid words counter to be monitored.

link-loss

Configures the link failure counter to be monitored.

lr-rx

Configures the number of link reset responses received by the Fc port.

lr-tx

Configures link reset responses transmitted by the FC port.

rx-datarate

Configures the rx performance counter to be monitored.

signal-loss

Configures the signal loss counter to be monitored.

state-change

Configures the state-change counter to be monitored.
The state-change counter records the port down to port up as one state-change

sync-loss

Configures the sync loss counter to be monitored.

timeout-discards

Configures the timeout discards counter to be monitored.

tx-credit-not-available

Configures the credit not available counter to be monitored.

tx-datarate

Configures the tx performance counter to be monitored.

tx-discards

Configures the tx discards counter to be monitored.

tx-slowport-count

Configure the tx slow port count counter to be monitored. This is a count of slowport-monitor events in the polling-interval.

This counter is applicable only for Cisco MDS 9500 Series Switch with the following modules:

  • Cisco MDS 9000 Series 1/2/4/8-Gbps 4/44-Port Host-Optimized FC Module
  • Cisco MDS 9000 Series 1/2/4/8-Gbps 48-Port FC Module
  • Cisco MDS 9000 Series 1/2/4/8-Gbps 24-Port FC Module

Note system timeout slowport-monitor command must be configured for this to alert. See the system timeout slowport-monitor command for more information.

tx-slowport-oper-delay

Configure tx slow port operational delay. This is a value in ms of the average operational delay as reported by the slowport-monitor.

This counter is applicable only for the following switches and modules:

  • Cisco MDS 9500 Series Switch

–blank.gif Cisco MDS 9000 Series 32-Port 8-Gbps Advanced Fiber Channel Switching Module

–blank.gif Cisco MDS 9000 Series 48-Port 8-Gbps Advanced Fibre Channel Switching Module

  • Cisco MDS 9700 Series Switch

–blank.gif Cisco MDS 9000 Series 48-Port 16-Gbps Fibre Channel Switching Module

  • Cisco MDS 9148S 16G Multilayer Fabric Switch
  • Cisco MDS 9250i Multiservice Fabric Switch
  • Cisco MDS 9396S 16G Multilayer Fabric Switch

Note system timeout slowport-monitor command must be configured for this to alert. See the system timeout slowport-monitor command for more information.

txwait

Configure tx total wait counter to be monitored. This is the aggregate amount of time that a port is at zero Tx B2B credits while there are frames enqueued in a polling interval. This is not a continuous interval, but a total amount of time the TxWait counter has increased during the polling-interval. It is configured as a percentage of the polling interval. Typically the polling-interval should be 1 second. So if a value of 40% is used that represents 40% of 1 second or 400ms of aggregate TxWait on an interface.

This counter is applicable only for the following switches and modules:

  • Cisco MDS 9500 Series Switch

–blank.gif Cisco MDS 9000 Series 32-Port 8-Gbps Advanced Fiber Channel Switching Module

–blank.gif Cisco MDS 9000 Series 48-Port 8-Gbps Advanced Fibre Channel Switching Module

  • Cisco MDS 9700 Series Switch

–blank.gif Cisco MDS 9000 Series 48-Port 16-Gbps Fibre Channel Switching Module

  • Cisco MDS 9148S 16G Multilayer Fabric Switch
  • Cisco MDS 9250i Multiservice Fabric Switch
  • Cisco MDS 9396S 16G Multilayer Fabric Switch

 
Defaults

All counters applicable to the switch except for err-pkt-from-port, err-pkt-to-xbar, err-pkt-from-xbar, and state-change are monitored by default.

 
Command Modes

Configuration Port Monitor mode.

 
Command History

Release
Modification

6.2(17)

Added the state-change keyword.

6.2(13)

Added the tx-slowport-count, tx-slowport-oper-delay, and txwait keywords.

5.2(8)

Added the all keyword.

5.2(2a)

Added err-pkt-from-port, err-pkt-from-xbar, err-pkt-to-xbar keywords.

4.2(1)

This command was introduced.

 
Usage Guidelines

  • When the no monitor counter command is used in the config-port-monitor mode, it turns-off the monitoring of that specific counter (or all counters) in the given policy.
    This command is available in port-monitor-configuration mode.
  • It is recommended not to have a port guard action set to the state-change counter when an interface state is changed from down state to up state.

Examples

The following example shows how to configure the credit loss recovery counter within a Port Monitor policy:

switch# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# port-monitor name PMON_policy
switch(config-port-monitor)# monitor counter credit-loss-reco
switch(config-port-monitor)#
 

The following example shows how to configure the state-change counter:

switch# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)#port-monitor name PMON_policy
switch(config-port-monitor)# counter state-change poll-interval 60 delta rising-threshold 100 event 2 warning-threshold 50 falling-threshold 0 event 4 portguard
switch(config-port-monitor)#

 
Related Commands

Command
Description

counter

Configure individual counters in a port-monitor policy to use non-default values.

port-monitor counter

Displays the individual counter.

port-monitor name policy-name

Configures a port-monitor policy.

show port-monitor

Displays Port Monitor information.
 

monitor counter (port-group-monitor configuration mode)

To configure monitoring of a specific counter within a Port Group Monitor policy, use the monitor counter command. To remove polling functionality for a specific counter within Port Group Monitor policy, use the no form of the command.

monitor counter {rx-performance | tx-performance} poll-interval interval {delta} rising-threshold rising threshold falling-threshold low threshold

no monitor counter{ rx-performance | tx-performance} poll-interval interval {delta} rising-threshold rising threshold falling-threshold low threshold

 
Syntax Description

rx-performance

Counfigures RX performance counter.

tx-performance

Configures TX performance counter.

poll-interval

Configures poll interval for counter.

interval

Displays poll interval in seconds. The range is from 0 to 2147483647.

delta

Displays the threshold type.

rising-threshold

Configures the upper threshold value.

rising-threshold

Sets numerical upper threshold limit. The range is from 0 to 100.

falling-threshold

Configures the lower threshold value.

low-threshold

Sets numerical low threshold limit. The range is from 0 to 100.

 
Defaults

None.

 
Command Modes

Configuration Port Group Monitor mode.

 
Command History

Release
Modification

NX-OS 4.2(1)

This command was introduced.

 
Usage Guidelines

When the no monitor counter command is used in the config-port-group-monitor mode, it turns-off the monitoring of that specific counter in the given policy.

Examples

The following example shows how to configure monitoring of a specific counter within a Port Group Monitor policy:

switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)#port-group-monitor name pgmon
switch(config-port-group-monitor)# monitor counter rx-performance
switch(config-port-group-monitor)# monitor counter tx-performance
switch(config-port-group-monitor)#
 

The following example shows how to turn off the monitoring of a specific counter in the given policy:

switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# no port-group-monitor name pgmon
switch(config-port-group-monitor)# no port-group-monitor rx-performance
switch(config-port-group-monitor)# no port-group-monitor tx-performance
switch(config-port-group-monitor)#show port-group-monitor
--------------------------------------------------------------------------------
-----------
Port Group Monitor : enabled
--------------------------------------------------------------------------------
-----------
Policy Name : pgmon
Admin status : Not Active
Oper status : Not Active
Port type : All Port Groups
-------------------------------------------------------------------------------------------
Counter Threshold Interval %ge Rising Threshold %ge Falling Threshold portguard
------- --------- -------- -------------------- ---------------------- ------
RX Performance Delta 60 80 20 Yes
TX Performance Delta 60 80 20 No
------------------------------------------------------------------------

 
Related Commands

Command
Description

show port-group-monitor

Displays Port Group Monitor information.
 

monitor counter tx-slowport-count

To configure monitoring of the tx-slowport-count counter, use the monitor counter tx-slowport-count command. To remove monitoring of tx-slowport-count, use the no form of the command.

monitor counter tx-slowport-count

no monitor counter tx-slowport-count

 
Syntax Description

There are no keywords or arguments for this command.

 
Defaults

None.

 
Command Modes

Configuration Port Group Monitor mode.

 
Command History

Release
Modification

6.2(13)

This command was introduced.

Examples

The following example shows how to configure monitoring of the tx-slowport-count counter within a Port Monitor policy:

switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# port-monitor name pmon
switch(config-port-monitor)# monitor counter tx-slowport-count
switch(config-port-monitor)#

 

The following example shows how to turn off monitoring of the tx-slowport-count counter within a Port Monitor policy:

switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# port-monitor name pmon
switch(config-port-monitor)# no monitor counter tx-slowport-count

switch(config-port-monitor)#

 
Related Commands

Command
Description

show port-monitor

Displays Port Monitor information.

monitor counter tx-slowport-oper-delay

To configure monitoring of the tx-slowport-oper-delay counter, use the monitor counter tx-slowport-oper-delay command. To remove monitoring of tx-slowport-count, use the no form of the command.

monitor counter tx-slowport-oper-delay

no monitor counter tx-slowport-oper-delay

 
Syntax Description

There are no keywords or arguments for this command.

 
Defaults

None.

 
Command Modes

Configuration Port Group Monitor mode.

 
Command History

Release
Modification

6.2(13)

This command was introduced.

Examples

The following example shows how to configure monitoring of the tx-slowport-oper-delay counter within a Port Monitor policy:

switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# port-monitor name pmon
switch(config-port-monitor)# monitor counter tx-slowport-oper-delay
switch(config-port-monitor)#

 

The following example shows how to turn off monitoring of the tx-slowport-oper-delay counter within a Port Monitor policy:

switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# port-monitor name pmon
switch(config-port-monitor)# no monitor counter tx-slowport-oper-delay

switch(config-port-monitor)#

 
Related Commands

Command
Description

show port-monitor

Displays Port Monitor information.

monitor counter txwait

To configure monitoring of the txwait counter, use the no monitor counter txwait command. To remove monitoring of txwait, use the no form of the command.

monitor counter txwait

no monitor counter txwait

 
Syntax Description

There are no keywords or arguments for this command.

 
Defaults

None.

 
Command Modes

Configuration Port Group Monitor mode.

 
Command History

Release
Modification

6.2(13)

This command was introduced.

Examples

The following example shows how to configure monitoring of the txwait counter within a Port Monitor policy:

switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# port-monitor name pmon
switch(config-port-monitor)# monitor counter txwait
switch(config-port-monitor)#

 

The following example shows how to turn off monitoring of the txwait counter within a Port Monitor policy:

switch# config t
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# port-monitor name pmon
switch(config-port-monitor)# no monitor counter txwait

switch(config-port-monitor)#

 
Related Commands

Command
Description

show port-monitor

Displays Port Monitor information.

monitor session

To configure a SPAN session, use the monitor session command. To remove a configured SPAN feature or revert it to factory defaults, use the no form of the command.

monitor session { session-id }

no span session { session-id }

 
Syntax Description

session-id

Specifies the SPAN session ID. The range is 1 to 48.

 
Defaults

None.

 
Command Modes

Configuration mode

 
Command History

Release
Modification

6.2(1)

This command was introduced.

 
Usage Guidelines

None.

Examples

The following example shows how to configure a local SPAN session in RX mode:

switch# config terminal
switch(config)# monitor session 1 rx
switch(config-monitor)#
 

The following example shows how to delete a local SPAN session in RX mode:

switch(config)# no monitor session 1 rx
 

The following example shows how to configure a local SPAN with port-channel as source in tx mode:

switch(config)# monitor session 1 tx
switch(config-monitor)#
 

 
Related Commandsa

Command
Description

destination interface

Configures a SPAN destination interface.

source

Configures a SPAN source.

show monitor session

Displays specific information about a SPAN session.

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

(Optional) Specifies the name of the directory.

filename

(Optional) Specifies the name of the file to move or create.

 
Defaults

None.

 
Command Modes

EXEC mode.

 
Command History

Release
Modification

1.0(2)

This command was introduced.

 
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 configuration and iSLB initiator configuration)

To assign a username for the initiator’s challenge, use the mutual-chap username command in iSCSI initiator configuration submode. To remove the username, use the no form of the command.

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

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

 
Syntax Description

username username

Specifies a username. The maximum size is 32.

password

Specifies a password for the initiator’s challenge.

0 cleartext-password

Specifies that the password is a cleartext CHAP password.

7 encrypted-password

Specifies that the password is an encrypted CHAP password.

password

Specifies a password for the username. The maximum size is 32.

 
Defaults

None.

 
Command Modes

iSCSI initiator configuration submode.
iSLB initiator configuration submode.

 
Command History

Release
Modification

2.0(1b)

This command was introduced.

3.0(1)

Added iSLB initiator configuration submode.

 
Usage Guidelines

The iSLB initiator can authenticate the Cisco MDS switch’s initiator target during the iSCSI login phase. This authentication requires the user to configure a username and password for the switch to present to the iSLB initiator. The provided password is used to calculate a CHAP response to a CHAP challenge sent to the IPS port by the initiator.

Examples

The following example shows how to configure a username, password type, and password for an iSCSI 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)#

 

The following example assigns a username and password to the initiator’s challenge for an iSLB initiator:

switch# config t
switch(config)# islb initiator ip-address 100.10.10.10
switch (config-islb-init)# mutual-chap username tester password K9c4*1
 

The following example removes the username and password from the initiator’s challenge for an iSLB initiator:

switch (config-islb-init)# no mutual-chap username tester password K9c4*1

 
Related Commands

Command
Description

islb initiator

Assigns an iSLB name and IP address to the iSLB initiator and enter s iSLB initiator configuration submode.

iscsi initiator name

Assigns an iSCSI name and changes to iSCSI initiator configuration submode.

show iscsi initiator

Displays iSCSI initiator information.

show iscsi initiator configured

Displays iSCSI initiator information for the configured iSCSI initiator.

show iscsi initiator detail

Displays detailed iSCSI initiator information.

show iscsi initiator summary

Displays iSCSI initiator summary information.

show islb initiator

Displays iSLB initiator information.

show islb initiator configured

Displays iSLB initiator information for the configured iSLB initiator.

show islb initiator detail

Displays detailed iSLB initiator information.

show islb initiator summary

Displays iSLB initiator summary information.