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. |
Command Modes
Class map configuration submode.
Command History
|
|
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)# 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
|
|
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. |
Command Modes
IPsec crypto map configuration submode.
Command History
|
|
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)# crypto map domain ipsec x 1
switch(config-crypto-map-ip)# match address UserACL
Related Commands
|
|
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. |
Command Modes
Configuration mode.
Command History
|
|
2.0(x) |
This command was introduced. |
Examples
The following example shows how to configure the multicast root VSAN:
switch(config)# mcast root principal vsan 4001
Related Commands
|
|
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. |
Command Modes
Fcalias configuration submode.
Command History
|
|
3.0(1) |
This command was introduced. |
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
|
|
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. |
Command Modes
IVR zone configuration submode.
Command History
|
|
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 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:
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
|
|
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
|
|
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:
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
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 zoneset 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
The following example shows how to assign an iSCSI IPv6 address-based membership into a zone:
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
|
|
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. |
Command Modes
Zone set configuration submode.
Command History
|
|
1.0(2) |
This command was introduced. |
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
|
|
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. |
Command Modes
iSLB initiator configuration submode.
Command History
|
|
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)# 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
|
|
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. |
Command Modes
EXEC
Command History
|
|
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:
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
|
|
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. |
Command Modes
Configuration submode.
Command History
|
|
NX-OS 4.2(1) |
This command was introduced. |
Examples
The following example shows how to configure the GCM mode for the interface:
switch(config-if-esp)# mode gcm
The following example shows how to configure the GMAC mode for the interface:
switch(config-if-esp)# mode gmac
Related Commands
|
|
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. |
Command Modes
EXEC mode.
Command History
|
|
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
– Cisco MDS 9000 Series 32-Port 8-Gbps Advanced Fiber Channel Switching Module – Cisco MDS 9000 Series 48-Port 8-Gbps Advanced Fibre Channel Switching Module
- Cisco MDS 9700 Series Switch
– 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
– Cisco MDS 9000 Series 32-Port 8-Gbps Advanced Fiber Channel Switching Module – Cisco MDS 9000 Series 48-Port 8-Gbps Advanced Fibre Channel Switching Module
- Cisco MDS 9700 Series Switch
– 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
|
|
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
|
|
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. |
Command Modes
Configuration Port Group Monitor mode.
Command History
|
|
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:
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:
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
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
|
|
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.
Command Modes
Configuration Port Group Monitor mode.
Command History
|
|
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:
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:
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
|
|
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.
Command Modes
Configuration Port Group Monitor mode.
Command History
|
|
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:
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:
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
|
|
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.
Command Modes
Configuration Port Group Monitor mode.
Command History
|
|
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:
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:
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
|
|
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. |
Command Modes
Configuration mode
Command History
|
|
6.2(1) |
This command was introduced. |
Examples
The following example shows how to configure a local SPAN session in RX mode:
switch(config)# monitor session 1 rx
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
Related Commandsa
|
|
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. |
Command Modes
EXEC mode.
Command History
|
|
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
|
|
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. |
Command Modes
iSCSI initiator configuration submode.
iSLB initiator configuration submode.
Command History
|
|
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):
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)# 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
|
|
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. |