-
Cisco MDS 9020 Fabric Switch Configuration Guide and Command Reference, Release 2.x
-
Index
-
Preface
-
Product Overview
-
Before You Begin
-
Initial Configuration
-
Software Images
-
Managing System Hardware
-
Configuring Interfaces
-
Configuring and Managing Zones
-
Managing FLOGI and FDMI
-
Configuring Switch Security
-
Configuring SNMP
-
Configuring Fibre Channel Routing Services and Protocols
-
Configuring IP Services
-
Configuring Domain Parameters
-
Configuring System Message Logging
-
Advanced Features and Concepts
-
Monitoring System Processes and Logs
-
Cisco SAN-OS Features Supported in CiscoFabricWare
-
Command Reference
-
FeedbackTable Of Contents
Command Reference
The commands in this appendix apply to the Cisco MDS 9020 Fabric Switch. 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.
•
cd
•
•
•
•
•
•
•
•
•
cd
To change the default file system, use the cd command in EXEC mode.
cd [bootflash: | volatile:]
Syntax Description
bootflash:
Flash image on the non-volatile file system.
volatile:
Flash image on the volatile file system.
Defaults
bootflash:
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example changes the file system to the bootflash: file system and displays the contents.
switch# cd bootflash:switch# dir656 Apr 25 22:04:33 2005 running-configUsage for bootflash://14336 bytes used2668544 bytes free2682880 bytes totalRelated Commands
clear counters interface
To clear the interface counters, use the clear counters interface command in EXEC mode.
clear counters interface {all | fc 1/port}
Syntax Description
all
Clears all interface counters.
fc
Fibre Channel interface for which to clear counters.
1/port
Specifies slot 1 and the port number. The port number is in the range 1 to 20.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The following table lists the keywords and number ranges for the clear counters interface types:
This command clears counters displayed in the show interface command output.
Examples
The following is an example of how to clear counters for a Fibre Channel interface 1/3:
switch# clear counters interface fc 1/3Related Commands
clear fspf counters
To clear the Fabric Shortest Path First statistics, use the clear fspf counters command in EXEC mode.
clear fspf counters [interface fc 1/port]
Syntax Description
interface fc
(Optional) Fibre Channel interface.
1/port
FC interface number where the slot number is 1 and the interface number is the port number in the range 1 to 20.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
If the interface is not specified, then all of the FC interface counters are cleared. If the interface is specified, then the counters of the specific interface are cleared.
Examples
The following example clears FSPF statistics specific to Fibre Channel interface 1/3.
switch# clear fspf counters interface fc 1/3Related Commands
clear ip access-list counters
To clear IP access list counters, use the clear ip access-list counters command in EXEC mode.
clear ip access-list counters list-name
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC.
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example clears the counters for an IP access list.
switch# clear ip access-list counters adminlistRelated Commands
clear zone database
To clear all configured information in the zone server, use the clear zone database command in EXEC mode.
clear zone database
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
After entering a clear zone database command, you need to explicitly enter the copy running-config startup-config command to ensure that the running configuration is used when you next start the switch.
Examples
The following example shows how to clear all configured information in the zone server.
switch# clear zone databaseRelated Commands
clock
To configure the time zone and summer-time-of-day (daylight savings), use the clock command in configuration mode.
clock
{summer-time daylight-timezone-name start-week start-day start-month start-time end-week end-day end-month end-time daylight-offset-to-be-added-in-minutes |
time-zone timezone-name hours-offset minutes-offset}To disable the daylight savings time adjustment or to set the time zone to the default, use the no form of this command.
no clock {summer-time | time-zone}
Syntax Description
Defaults
The default time zone is Coordinated Universal Time (UTC), which is the same as Greenwich Mean Time (GMT).
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example adjusts the daylight savings time for the Pacific time zone by 60 minutes starting on the first Sunday in April at 2 a.m. and ending on the last Sunday in October at 2 a.m.
switch# configswitch(config)# clock summer-time Pacific 1 Sun Apr 02:00 5 Sun Oct 02:00 60switch(config)# no clock summer-timeswitch(config)# exitswitch#Related Commands
clock set
To change the system time, use the clock set command in EXEC mode.
clock set HH:MM:SS DD Month YYYY
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
If the system is synchronized with an NTP clock server, you do not need to set the system clock. Use this command if no other time sources are available. The time specified in this command is relative to the configured time zone.
The clock set command changes are saved across system resets.
Examples
The following example displays the clock set command:
switch# clock set 15:58:15 15 August 2005Mon Aug 15 15:58:00 PDT 2005config terminal
To enter the configuration mode, use the config command in EXEC mode.
config terminal
Syntax Description
This command had no arguments or keywords.
Defaults
None.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example enters the configuration mode:
switch# config terminalEnter configuration commands, one per line.switch(config)#The following example enters the configuration mode using an abbreviated format of the command:
switch# configEnter configuration commands, one per line.switch(config)#copy
To save a backup of the system software, use the copy command in EXEC mode.
copy source destination
Syntax Description
The following table lists the aliases for source and destination URLs.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
This command be used to make the running and the backup copy of the configuration identical.
The copy function will not be completed if the required space is not available in the file system. First change to the required file system (for example, cd bootflash:) and verify the available space (for example, dir bootflash:).
Examples
The following example saves your configuration to the startup configuration.
switch# copy running-config startup-configThe following example creates a snapshot of the current running configuration.
switch# copy running-config bootflash:running-snapshotThe following example saves a backup copy of the startup configuration.
switch# copy startup-config bootflash:startup-backupThe following example saves a copy of the startup configuration on a remote host.
switch# copy startup-config ftp://10.20.102.98/configs/q100-startupRelated Commands
delete
To delete a file, use the delete command in EXEC mode.
delete {bootflash:filename | volatile:filename}
Syntax Description
bootflash:
Flash image that resides on the non-volatile file system.
volatile:
Flash image that resides on the volatile file system.
filename
The name of the file to be deleted.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
When you delete a file, the software erases the file.
Caution
Examples
The following example deletes a file from the volatile file system.
switch# delete volatile:my_fileRelated Commands
cd
Changes the default file system.
dir
Displays a list of files on a file system.
move
Moves a file to another filename.
dir
To display the contents of the current file system or the specified file system, use the dir command in EXEC mode.
dir [bootflash:filename | volatile:filename]
Syntax Description
Defaults
The default file system is specified by the cd command.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example shows how to list the files on the volatile file system.
switch# dir volatile:1446 Apr 04 20:08:06 2005 image_01446 Apr 04 20:09:34 2005 image_11446 Apr 04 20:09:32 2005 image_21446 Apr 04 20:09:30 2005 image_31446 Apr 04 20:09:28 2005 ilc1.bin1446 Apr 04 20:09:27 2005 startup-con_11446 Apr 04 20:09:24 2005 startuup-con_21446 Apr 04 20:09:22 2005 startuup-con_31446 Apr 04 20:09:20 2005 startuup-con_41446 Apr 04 20:10:43 2005 zzzffpUsage for volatile://40960 bytes used20930560 bytes free20971520 bytes totalRelated Commands
do
Use the do command to execute an EXEC mode command from any configuration mode or submode.
do command
Syntax Description
Defaults
No default behavior or values.
Command Modes
All
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Use this command to execute EXEC commands while configuring your switch. After the EXEC command is executed, the system returns to the mode from which you entered the do command.
Examples
The following example displays the logging levels using the do command in configuration mode.
switch(config)# do show logging levelFacility Default Severity Current Session Severity-------- ---------------- ------------------------fcns 6 2fcs 6 2zone 6 2auth 6 2ipconf 6 2module 6 2ntp 6 2sysmgr 6 2user 6 2port 6 2fcdomain 6 2fspf 6 2end
To exit any of the configuration modes and return to EXEC mode, use the end command in configuration mode.
end
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
None.
Examples
The following example sets the time zone to GMT. Entering the end command causes the system to exit configuration mode and return to EXEC mode.
switch(config)# clock timezonegeorge(config)# endswitch#Related Commands
exit
To exit any configuration mode or close an active terminal session and terminate the EXEC, use the exit command at the system prompt.
exit
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
All.
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Use the exit command at the EXEC levels to exit the EXEC mode. Use the exit command at the configuration level to return to privileged EXEC mode. Use the exit command in interface configuration submode to return to configuration mode. You also use the end command, from any configuration mode to return to EXEC mode.
Examples
The following example displays an exit from the interface configuration submode to return to the configuration mode.
switch(config-if)# exitswitch(config)#The following example shows how to log out of an active session.
switch# exitRelated Commands
fcalias name
To configure an FC alias, use the fcalias name command in configuration mode.
fcalias name alias-name
Entering the fcalias name command opens the config-fcalias submode which provides access to the member subcommand:
member pwwn pwwn-id
To disable an FC alias, use the no form of this command.
no fcalias name alias-name
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
To include multiple members in any alias, use the pWWN value.
Examples
The following examples show how to configure an FC alias called AliasSample.
switch# configswitch(config)# fcalias name AliasSampleswitch(config-fcalias)#Related Commands
fcalias rename
To rename an FC alias, use the fcalias rename command in configuration mode.
fcalias rename current-name new-name
Syntax Description
current-name
The current name of the fcalias.
new-name
The new name of the fcalias. Maximum length is 64 characters.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following examples show how to rename an fcalias called AliasSample.
switch# configswitch(config)# fcalias rename AliasSample AliasNewswitch(config-fcalias)#Related Commands
fcdomain
To configure the Fibre Channel domain feature, use the fcdomain command in configuration mode.
fcdomain {domain id {preferred | static} priority value | restart [disruptive]}
To disable the FC domain, use the no form of this command.
no fcdomain {domain id {preferred | static} priority value | restart [disruptive]}
Syntax Description
Defaults
Enabled.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
You can use this command to select the principle switch, domain ID distribution, reconfigure fabric, and allocate FC IDs.
Examples
The following examples show how to configure the Fibre Channel domain feature.
switch# configswitch(config)# fcdomain domain 3 preferredswitch(config)# no fcdomain domain 3 preferredswitch(config)# fcdomain domain 2 staticswitch(config)# no fcdomain domain 2 staticswitch(config)# fcdomain restartswitch(config)# fcdomain restart disruptiveswitch(config)# fcdomain priority 25switch(config)# no fcdomain priority 25Related Commands
fctimer
To change the default Fibre Channel timers, use the fctimer command in configuration mode.
fctimer {d_s_tov milliseconds | e_d_tov milliseconds | r_a_tov milliseconds}
To revert to the default values, use the no form of this command.
no fctimer {d_s_tov milliseconds | e_d_tov milliseconds | r_a_tov milliseconds}
Syntax Description
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
In accordance with the FC-SW2 standard, the timeout values must be the same on each switch in the fabric.
Examples
The following example shows how to change the default Fibre Channel timers.
switch# configswitch(config)# fctimer e_d_tov 5000switch(config)# fctimer r_a_tov 7000Related Commands
fspf cost
To configure FSPF link cost for an interface, use the fspf cost command in interface configuration submode.
fspf cost link-cost
To revert to the default value, use the no form of this command.
no fspf cost link-cost
Syntax Description
Defaults
1000 for 1 Gbps
500 for 2 Gbps
250 for 4 Gbps
Command Modes
Interface configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Access this command from the switch(config-if)# submode.
FSPF tracks the state of links on all switches in the fabric, associates a cost with each link in its database, and then chooses the path with a minimal cost. The cost associated with an interface can be changed using the fspf cost command to implement the FSPF route selection.
Examples
The following example shows how to set the FSPF link cost to 5000.
switch# configswitch(config)# interface fc1/1switch(config-if)# fspf cost 5000Related Commands
fspf dead-interval
To set the maximum interval for which a hello message must be received before the neighbor is considered lost, use the fspf dead-interval command in interface configuration submode.
fspf dead-interval seconds
To revert to the default value, use the no form of this command.
no fspf dead-interval seconds
Syntax Description
Defaults
80 seconds
Command Modes
Interface configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Access this command from the switch(config-if)# submode.
Note
Caution
Examples
switch# configswitch(config)# interface fc1/1switch(config-if)# fspf dead-interval 4000Related Commands
fspf hello-interval
To verify the health of the link, use the fspf hello-interval command in interface configuration submode.
fspf hello-interval seconds
To revert to the default value, use the no form of this command.
no fspf hello-interval seconds
Syntax Description
Defaults
20 seconds
Command Modes
Interface configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Access this command from the switch(config-if)# submode.
This command configures FSPF for the specified FC interface.
Note
Examples
switch# configswitch(config)# interface fc1/1switch(config-if)# fspf hello-interval 3Related Commands
fspf retransmit-interval
To specify the time after which an unacknowledged link state update should be transmitted on the interface, use the fspf retransmit-interval command in interface configuration submode.
fspf retransmit-interval seconds
To revert to the default value, use the no form of this command.
no fspf retransmit-interval seconds
Syntax Description
Defaults
5 seconds
Command Modes
Interface configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Access this command from the switch(config-if)# submode.
Note
Examples
switch# configswitch(config)# interface fc 1/1switch(config-if)# fspf retransmit-interval 6Related Commands
help
To display a list of available commands and arguments in the current command mode, use the ? command in any mode. No carriage return is needed with this command.
?
command ?
command argument ?
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
All
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The ? command alone displays available commands based on the command mode.
To display the arguments for a command, enter the command name, then a space, then the ? command.
To display the keywords for an argument, enter the command, the argument, a space, then the ? command.
Examples
The following example displays the list of commands for EXEC mode.
switch# ?cd Change current directoryclear Reset functionsclock Manage the system clockconfig Enter configuration modecopy Copy from one file to anotherdelete Delete a filedir List files in a directoryexit Exit from the EXEChelp Press '?' key to display available commandsinstall Upgrade softwaremove Move filesping Send echo messagesreload Reboot the entire boxrun-script Run shell scriptssetup Run the basic SETUP command facilityshow Show running system informationsleep Sleep for the specified number of secondssystem System management commandsterminal Set terminal line parameterswrite Write current configurationzone Execute zone server commandszoneset Execute zoneset commandsThe following example displays the arguments for the copy command.
switch# copy ?bootflash: Select source filesystemftp: Select source filesystemrunning-config Copy running configuration to destinationstartup-config Copy startup configuration to destinationtftp: Select source filesystemvolatile: Select source filesysteminstall all
To upgrade firmware on the switch, use the install all command in EXEC mode. The install all command will attempt a nondisruptive upgrade; if a nondisruptive upgrade is not possible, a disruptive upgrade will occur.
install all system volatile:filename
Syntax Description
system
Upgrades the system image.
volatile:
The volatile file system.
filename
The source file to be installed.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The firmware image must be downloaded to the volatile file system before it can be installed. Use the copy ftp: or copy tftp: command to download the firmware image file.
Examples
The following example downloads the firmware image to the volatile file system, installs the firmware, and resets the switch.
switch# copy ftp://10.20.102.98/firmware/latest_mpc volatile:latest_mpcswitch# install all system volatile:latest_mpcPerforming configuration copy.[########################################] 100%Unpacking image - this may take several seconds...Related Commands
copy
Copies a file from one location to another.
show version
Displays software image version information.
interface fc
To configure a Fibre Channel interface, use the interface fc command in configuration mode. This will place the switch in the interface configuration submode.
interface fc 1/port[ - portn]
Syntax Description
port
Specifies a port number or the first port number in a range from 1 to 20.
portn
Specifies the second port in the range from 1 to 20.
Defaults
Disabled.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
You can specify a range of interfaces by entering a command with the following example format:
interfacespacefcspace1/1space-space5
Use the no shutdown command to enable the interface.
Examples
The following example configures ports 1 to 4.
switch# configEnter configuration commands, one per line. End with CNTL/Z.switch(config)# int fc 1/1 - 4The following example enables the Fibre Channel interface.
switch# configswitch(config)# interface fc 1/1switch(config-if)# no shutdownRelated Commands
show interface
Displays an interface configuration for a specified interface.
shutdown
Disables and enables an interface.
interface mgmt
To configure management interface 0 on a switch, use the interface mgmt command in configuration mode.
interface mgmt 0
Syntax Description
Defaults
Disabled.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
When you try to shutdown a management interface (mgmt0), a follow-up message confirms your action before performing the operation. Use the shutdown force command to bypass this confirmation, if required.
Examples
The following example configures the management interface, displays the options available for the configured interface, and exits to configuration mode.
switch# configswitch(config)#switch(config)# interface mgmt 0switch(config-if)# exitswitch(config)#The following example shuts down the interface without using the force option:
switch# configswitch(config)# interface mgmt 0switch(config-if)# shutdownShutting down this interface will drop all telnet sessions.Do you wish to continue (y/n)? yThe following example shuts down the interface using the force option:
switch# configswitch(config)# interface mgmt 0switch(config-if)# shutdown forceswitch(config-if)#Related Commands
shutdown
Disables and enables an interface.
show interface mgmt
Displays interface configuration for specified interface.
ip access-group
To create an access group to use an access list, use the ip access-group command in interface configuration submode.
ip access-group group-name [in | out]
To negate a previously entered command or revert to factory defaults, use the no form of this command.
no ip access-group group-name [in | out]
Syntax Description
Defaults
Groups are created for both ingress and egress traffic.
Command Modes
Interface configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The access-group command controls access to an interface. Each interface can only be associated with one access list. The access group becomes active on creation.
We recommend creating all rules in an access list, before creating the access group that uses this
access list.If you create an access group before the access-list, all packets in that interface are dropped, because the access list is empty.
The access group configuration for the ingress traffic applies to both local and remote traffic. The access-group configuration for the egress traffic applies only to local traffic. You can create a different access-group for each type of traffic.
Examples
The following example creates an access group called SampleName for both the ingress and egress traffic (default).
switch# configswitch(config)# interface mgmt 0switch(config-if)# ip access-group SampleNameThe following example deletes the access group called NotRequired.
switch(config-if)# no ip access-group NotRequiredThe following example creates an access group called SampleName (if it does not already exist) for ingress traffic.
switch(config-if)# ip access-group SampleName1 inThe following example deletes the access group called SampleName for ingress traffic.
switch(config-if)# no ip access-group SampleName1 inThe following example creates an access group called SampleName (if it does not already exist) for local egress traffic.
switch(config-if)# ip access-group SampleName2 outThe following example deletes the access group called SampleName for local egress traffic.
switch(config-if)# no ip access-group SampleName2 outRelated Commands
ip access-list
To configure IP access control lists (ACL), use the ip access-list command in configuration mode. The first ip access-list command entry creates the ACL. Subsequent ip access-list command entries add filters to the ACL definition.
ip access-list list-name {deny | permit} ip-protocol
{src-addr src-wildcard}
{dest-addr dest-wildcard | operator port-value}
[operator port port-value]
[established | icmp-type icmp-value]
[tos tos-value]To negate a previously entered command or revert to factory defaults, use the no form of this command.
no ip access-list list-name {deny | permit} ip-protocol
{src-addr src-wildcard}
{dest-addr dest-wildcard | operator port-value}
[operator port port-value]
[established | icmp-type icmp-value]
[tos tos-value]Syntax Description
Defaults
Denied.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example configures an IP-ACL called List1 and permits IP traffic from any source address to any destination address.
switch# configswitch(config)# ip access-list List1 permit ip any anyThe following example removes the IP-ACL called List1.
switch# configswitch(config)# no ip access-list List1 permit ip any anyThe following example updates List1 to deny TCP traffic from any source address to any destination address.
switch# configswitch(config)# ip access-list List1 deny tcp any anyThe following example defines an IP-ACL that permits this network. Subtracting 255.255.248.0 (normal mask) from 255.255.255.255 yields 0.0.7.255.
switch# configswitch(config)# ip access-list List1 permit udp 192.168.32.0 0.0.7.255The following example permits all IP traffic from and to the specified networks.
switch# configswitch(config)# ip access-list List1 permit ip 10.1.1.0 0.0.0.255 172.16.1.0 0.0.0.255The following example denies TCP traffic from 10.2.3.0 through source port 5 to any destination.
switch# configswitch(config)# ip access-list List2 deny tcp 10.2.3.0 0.0.0.255 eq port 5 anyThe following example removes this entry from the IP-ACL.
switch# configswitch(config)# no ip access-list List2 deny tcp 10.2.3.0 0.0.0.255 eq port 5 anyThe following example creates an access group called List1 for both the ingress and egress traffic (default).
switch# configswitch(config)# interface mgmt0switch(config-if)# ip access-group List1The following example deletes the access group called NotRequired.
switch# configswitch(config)# interface mgmt0switch(config-if)# no ip access-group NotRequiredRelated Commands
ip access-group
Creates an IP access group.
show ip access-list
Displays the IP-ACL configuration information.
ip address
To assign an IP address to the Ethernet management port, use the ip address command in interface configuration submode. Enter the interface mgmt command to open the config-if submode.
ip address address netmask
To remove the IP address, us the no form of this command.
no ip address address netmask
Syntax Description
Defaults
The IP address default is 10.0.0.1. The network mask default is 255.0.0.0.
Command Modes
Interface configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
switch# configswitch(config)# interface mgmt 0switch(config-if)# ip address 10.5.1.1 255.255.0.0Related Commands
interface mgmt
Configures the management interface and opens the config-if submode.
show interface
Displays information about an interface.
ip default-gateway
To configure the IP address of the default gateway, use the ip default-gateway command in configuration mode.
ip default-gateway destination-ip-address
To disable the IP address of the default gateway, use the no form of this command.
no ip default-gateway destination-ip-address
Syntax Description
Defaults
10.0.0.254
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following examples configures the IP default gateway to 10.1.1.4.
switch# configswitch(config)# ip default-gateway 10.1.1.4Related Commands
logging level
To modify message logging facilities, use the logging level command in configuration mode.
logging level all severity-level
To negate the previously entered command or to revert to factory defaults, use the no form of this command.
no logging level all severity-level
Syntax Description
Defaults
The default severity level is critical (2).
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The switch logs messages at or above the configured severity level.
Examples
Configures the logging level at level 4 (warning). As a result, logging messages with a severity level of 4 or above will be displayed.
switch# configswitch(config)# logging level all 4logging monitor
To set monitor message logging, use the logging monitor command in configuration mode.
logging monitor severity level
To negate the previously entered command or to revert to factory defaults, use the no form of the command.
no logging monitor severity level
Syntax Description
severity level
Severity level. The range is 0 to 7, where
•
•
•
•
•
•
•
•
Defaults
Severity level: 0 - emergency; 1 - alert
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example sets terminal line (monitor) message logging at level 2.
switch# configswitch(config)# logging monitor 2Related Commands
logging server
To set the IP address of the remote message logging server, use the logging server command in configuration mode.
logging server ip address
To negate the previously entered command or to revert to factory defaults, use the no form of this command.
no logging server ip address
Syntax Description
Defaults
10.0.0.254
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
Change the IP address of the remote message logging server to 10.20.30.40.
switch# configswitch(config)# logging sever 10.20.30.40Related Commands
move
To move a file to another filename, use the move command in EXEC mode.
move source destination
Syntax Description
Defaults
The default source or destination file system is the current file system, bootflash: or volatile:.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example moves latest_mpc from the bootflash file system to the volatile file system.
switch# move bootflash:latest_mpc volatile:latest_mpcRelated Commands
cd
Changes the default file system.
copy
Copies a file to a new location.
dir
Displays a list of files on a file system.
ntp server
To configure a Network Time Protocol (NTP) server, use the ntp server command in configuration mode.
ntp server ip-address
Syntax Description
Defaults
0.0.0.0.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
This example forms a server association with a server.
switch(config)# ntp server 10.10.10.10switch(config)#ping
To diagnose basic network connectivity, use the ping (packet internet groper) command in EXEC mode.
ping ip-address
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The ping program sends an echo request packet to an address, and then awaits a reply. The ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.
Verify connectivity to the TFTP server using the ping command.
To abnormally terminate a ping session, type the Ctrl-C escape sequence
Examples
The following example pings system 192.168.7.27.
switch# ping 192.168.7.27PING 192.168.7.27 (192.168.7.27): 10 data bytes18 bytes from 192.168.7.27: icmp_seq=0 ttl=64 time=0.5 ms--- 192.168.7.27 ping statistics ---1 packets transmitted, 1 packets received, 0% packet lossround-trip min/avg/max = 0.5/0.5/0.5 msradius-server host
To configure RADIUS server, use the radius-server host command in configuration mode.
radius-server host {server-name | ip-address}
[key shared-secret] [accounting]
[auth-port port-number] [authentication]
[retransmit count] [timeout seconds [retransmit count]]To revert to the factory defaults, use the no form of this command.
no radius-server host {server-name | ip-address}
[key shared-secret] [accounting]
[auth-port port-number] [authentication]
[retransmit count] [timeout seconds [retransmit count]]Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example configures RADIUS server authentication parameters.
switch# config tswitch(config)# radius-server host 10.10.2.3 key HostKeyswitch(config)# radius-server host 10.10.2.3 auth-port 2003switch(config)# radius-server host 10.10.2.3 accountingswitch(config)# radius-server host radius2 key abcdefgh01234567Related Commands
reload
To reboot the switch, use the reload command in EXEC mode.
reload
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example uses the reload command to reboot the system.
switch# reloadThis command will reboot the system. (y/n)? yRelated Commands
install
Installs a new software image.
copy
Copies a file from one location to another.
run-script
To execute the commands specified in a file, use the run-script command in EXEC mode.
run-script [filename | running-config | startup-config | volatile:filename | bootflash:filename]
Syntax Description
Defaults
Uses the current default file system.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
You must create the script file on an external host, then use the copy ftp or copy tftp command to download the file to the volatile or bootflash file system.
Examples
The file, testfile, contains the following commands:
conf tinterface fc 1/1no shutdownendsh interface fc1/1The following example executes the CLI commands specified in the testfile.
switch# run-script testfile'conf t'Enter configuration commands, one per line. End with CNTL/Z.'interface fc 1/1''no shutdown''end''sh interface fc1/1'fc1/1 is Down (Administratively down)Hardware is Fibre Channel, SFP is long wave laserPort WWN is 20:00:00:0d:ec:19:cb:0eAdmin port mode is autoReceive data field Size is 2112Beacon is turned off5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec0 frames input, 0 bytes0 discards, 0 errors0 CRC0 too long, 0 too short0 frames output, 0 bytes0 errors0 input OLS, 0 LRR, 0 loop initssetup
To enter the switch setup mode, use the setup command in EXEC mode.
setup
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The setup utility guides you through the basic configuration process. Type Ctrl-c at any prompt to skip the remaining configuration options and proceed with what is configured until that point.
If you do not wish to answer a previously-configured question, or if you wish to skip answers to any questions press Enter. If a default answer is not available (for example switch name), the switch uses what is previously configured and skips to the next question.
Examples
The following example shows how to enter switch setup mode.
switch# setup---- Basic System Configuration Dialog ----This setup utility will guide you through the basic configuration ofthe system. Setup configures only enough connectivity for managementof the system.*Note: setup is mainly used for configuring the system initially,when no configuration is present. So setup always assumes systemdefaults and not the current system configuration values.Press Enter if you want to skip any dialog. Use ctrl-c at anytimeto skip all remaining dialogs.Would you like to enter the basic configuration dialog (yes/no): yesCreate another login account (yes/no) [n]: yesEnter the user login ID: user_nameEnter the password for user_name: user-passwordEnter the user role [network-operator]:network_adminConfigure read-only SNMP community string (yes/no) [n]: yesSNMP community string: snmp_communityEnter the switch name: switch_nameContinue with Out-of-band (mgmt0) management configuration? [yes/no]: yesMgmt0 IP address: ip_addressMgmt0 IP netmask: subnet_maskConfigure the default-gateway: (yes/no) [y]: yesIP address of the default-gateway: default_gatewayEnable the telnet service? (yes/no) [y]: yesEnabled SSH service? (yes/no) [n]: noConfigure NTP server? (yes/no) [n]: noConfigure default switchport interface state (shut/noshut) [shut]: noshutConfigure default zone policy (permit/deny) [deny]: denyThe following configuration will be applied:username admin password admin_pass role network-adminswitchname switchinterface mgmt0ip address ip_address subnet_maskip default-gateway 10.0.0.254telnet server enableno ssh server enableno system default switchport shutdownno zone default-zone permitWould you like to edit the configuration? (yes/no) [n]: noUse this configuration and save it? (yes/no) [y]: yesshow accounting log
To display the accounting log contents, use the show accounting log command in EXEC mode.
show accounting log
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show accounting log command.
switch# show accounting log[1][Mon Apr 25 11:01:59.888 UTC 2005][AU][0000.00FF][None][Zoning Default Zone changed in Config default to False][2][Mon Apr 25 11:02:03.228 UTC 2005][AU][0000.0001][None][IP Unknown User admin@OB-session1 User Login][3][Mon Apr 25 11:02:07.376 UTC 2005][AU][0000.0001][None][IP Unknown User snmp@IB-session2 User Login][4][Mon Apr 25 11:02:07.379 UTC 2005][AU][0000.0001][None][IP Unknown User snmp@OB-session3 User Login][5][Mon Apr 25 15:58:40.548 UTC 2005][AU][0000.0001][None][IP 10.20.33.160 User admin@OB-session4 User Login][6][Mon Apr 25 16:08:38.188 UTC 2005][AU][0000.0001][None][IP 10.20.32.70 User admin@OB-session5 User Login]show accounting logsize
To display maximum size of the accounting log file, use the show accounting logsize command in EXEC mode.
show accounting logsize
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show accounting logsize command.
switch# show accounting logsizemaximum local accounting logentries: 1200show clock
To display the system date and time and verify the time zone configuration, use the show clock command in EXEC mode.
show clock
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show clock command..
switch# show clockFri Apr 22 00:00:49 CDT 2005show environment
To display all environment-related switch information, use the show environment command in EXEC mode.
show environment [power | temperature]
Syntax Description
power
Displays status of power supply module, power supply redundancy mode and power usage summary.
temperature
Displays switch temperature thresholds and alarm status of temperature sensors.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show environment command.
switch# show environmentTemperature:---------------------------Module CurTemp Status(Celsius)---------------------------1 36 okPower Supply:-------------PS Status-------------1 okRelated Commands
show fcalias
To display the member name information in a Fibre Channel alias (fcalias), use the show fcalias command in EXEC mode.
show fcalias [name fcalias-name]
Syntax Description
Defaults
Displays a list of all global fcaliases.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
To make use of fcaliases as device names instead of using the cryptic device name, add only one member per fcalias.
Examples
The following is sample output from the show fcalias command.
switch# show fcaliasfcalias name Alias2fcalias name Alias1pwwn 21:00:00:20:37:6f:db:ddpwwn 21:00:00:20:37:9c:48:e5Related Commands
show fcdomain
To display the Fibre Channel domain (fcdomain) information for the local switch or for all switches in the fabric, use the show fcdomain command in EXEC mode.
show fcdomain [domain-list]
Syntax Description
domain-list
Displays list of domain ids granted by the principal switch for all switches in the fabric.
Defaults
Displays domain information for the local switch.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show fcdomain command.
switch# show fcdomainThe local switch is the Principal Switch.Local switch run time information:Local switch WWN: 10:00:00:0d:ec:19:cb:0eRunning fabric name: 10:00:00:0d:ec:19:cb:0eRunning priority: 128Current domain ID: 0x69(105)Local switch configuration information:Configured fabric name:Configured priority: 128Configured domain ID: 0x0(0) (preferred)Principal switch run time information:Running priority: 128The following is sample output from the show fcdomain domain-list command.
switch# show fcdomain domain-listVSAN 1Number of domains: 1Domain ID WWN--------- -----------------------0x69(105) 10:00:00:0d:ec:19:cb:0e [Local] [Principal]show fcns database
To display the results of the discovery, or to display the name server database, use the show fcns database command in EXEC mode.
show fcns database [detail | domain domain-id | fcid fcid-id]
Syntax Description
detail
Displays all objects in each entry.
domain domain-id
Displays entries in a domain.
fcid fcid-id
Displays entry for the given port.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The discovery can take several minutes to complete, especially if the fabric is large fabric or if several devices are slow to respond.
Examples
The following is sample output from the show fcns database detail command.
switch# show fcns database detail-------------FCID:0x0101e1-------------port-wwn (vendor) : 21:00:00:20:37:d9:4f:66 ()node-wwn : 20:00:00:20:37:d9:4f:66class : 3node-ip-addr : 0.0.0.0fc4-types:fc4_features : FCPsymbolic-port-name : (NULL)symbolic-node-name (NULL)port-type : NLport-ip-addr : 0.0.0.0fabric-port-wwn : 20:01:00:c0:dd:06:fc:00-------------FCID:0x0101e2-------------port-wwn (vendor) : 21:00:00:20:37:d9:4d:61 ()node-wwn : 20:00:00:20:37:d9:4d:61class : 3node-ip-addr : 0.0.0.0fc4-types:fc4_features : FCPsymbolic-port-name : (NULL)symbolic-node-name : (NULL)port-type : NLport-ip-addr : 0.0.0.0fabric-port-wwn : 20:01:00:c0:dd:06:fc:00-------------FCID:0x0101e4-------------port-wwn (vendor) : 21:00:00:20:37:d9:4a:fa ()node-wwn : 20:00:00:20:37:d9:4a:faclass : 3node-ip-addr : 0.0.0.0fc4-types:fc4_features : FCPsymbolic-port-name : (NULL)symbolic-node-name : (NULL)port-type : NLport-ip-addr : 0.0.0.0fabric-port-wwn : 20:01:00:c0:dd:06:fc:00-------------FCID:0x0101e8-------------port-wwn (vendor) : 21:00:00:20:37:d9:4c:02 ()node-wwn : 20:00:00:20:37:d9:4c:02class : 3node-ip-addr : 0.0.0.0fc4-types:fc4_features : FCPsymbolic-port-name : (NULL)symbolic-node-name : (NULL)port-type : NLport-ip-addr : 0.0.0.0fabric-port-wwn : 20:01:00:c0:dd:06:fc:00The following is sample output from the show fcns database domain command
switch# show fcns database domain 1------------------------------------------------------------------------------------------FCID TYPE PWWN (VENDOR) FC4-TYPE:FEATURE------------------------------------------------------------------------------------------0x0101e1 NL 21:00:00:20:37:d9:4f:66 FCP0x0101e2 NL 21:00:00:20:37:d9:4d:61 FCP0x0101e4 NL 21:00:00:20:37:d9:4a:fa FCP0x0101e8 NL 21:00:00:20:37:d9:4c:02 FCPTotal number of entries = 4show fcs database
To display the status of the fabric configuration, use the show fcs database command in EXEC mode.
show fcs database
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show fcs database command.
switch# show fcs databaseFCS Local Database------------------Switch WWN : 1000000dec19cb0eSwitch Domain Id : 105Fabric-Name :Switch Logical-Name : switchSwitch Ports:---------------------------------------------------------------Interface fWWN Type Attached-pWWNs---------------------------------------------------------------fc1/1 20:00:00:0d:ec:19:cb:0e Unknown Nonefc1/2 20:01:00:0d:ec:19:cb:0e Unknown Nonefc1/3 20:02:00:0d:ec:19:cb:0e Unknown Nonefc1/4 20:03:00:0d:ec:19:cb:0e Unknown Nonefc1/5 20:04:00:0d:ec:19:cb:0e Unknown Nonefc1/6 20:05:00:0d:ec:19:cb:0e Unknown Nonefc1/7 20:06:00:0d:ec:19:cb:0e Unknown Nonefc1/8 20:07:00:0d:ec:19:cb:0e Unknown Nonefc1/9 20:08:00:0d:ec:19:cb:0e Unknown Nonefc1/10 20:09:00:0d:ec:19:cb:0e Unknown Nonefc1/11 20:0a:00:0d:ec:19:cb:0e Unknown Nonefc1/12 20:0b:00:0d:ec:19:cb:0e Unknown Nonefc1/13 20:0c:00:0d:ec:19:cb:0e Unknown Nonefc1/14 20:0d:00:0d:ec:19:cb:0e Unknown Nonefc1/15 20:0e:00:0d:ec:19:cb:0e Unknown Nonefc1/16 20:0f:00:0d:ec:19:cb:0e Unknown Nonefc1/17 20:10:00:0d:ec:19:cb:0e Unknown Nonefc1/18 20:11:00:0d:ec:19:cb:0e Unknown Nonefc1/19 20:12:00:0d:ec:19:cb:0e Unknown Nonefc1/20 20:13:00:0d:ec:19:cb:0e Unknown Noneshow fctimer
To view the Fibre Channel timers (fctimer), use the show fctimer command in EXEC mode.
show fctimer [d_s_tov | e_d_tov | f_s_tov | r_a_tov]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show fctimer command.
switch# show fctimerF_S_TOV D_S_TOV E_D_TOV R_A_TOV----------------------------------------5000 ms 5000 ms 2000 ms 10000 msRelated Commands
show fdmi database
To display the Fabric-Device Management Interface (FDMI) database information, use the show fdmi database command in EXEC mode.
show fdmi database [detail]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show fdmi database command.
switch# show fdmi databaseRegistered HBA List10:00:00:00:c9:32:8d:7721:01:00:e0:8b:2a:f6:54The following is sample output from the show fdmi database detail command.
switch# show fdmi database detailRegistered HBA List-------------------------------HBA-ID: 10:00:00:00:c9:32:8d:77-------------------------------Node Name :20:00:00:00:c9:32:8d:77Manufacturer :Emulex CorporationSerial Num :0000c9328d77Model :LP9002Model Description:Emulex LightPulse LP9002 2 Gigabit PCI Fibre Channel AdapterHardware Ver :2002606DDriver Ver :SLI-2 SW_DATE:Feb 27 2003, v5-2.20a12ROM Ver :3.11A0Firmware Ver :3.90A7OS Name/Ver :Window 2000CT Payload Len :1300000Port-id: 10:00:00:00:c9:32:8d:77-------------------------------HBA-ID: 21:01:00:e0:8b:2a:f6:54-------------------------------Node Name :20:01:00:e0:8b:2a:f6:54Manufacturer :QLogic CorporationSerial Num :\74262Model :QLA2342Model Description:QLogic QLA2342 PCI Fibre Channel AdapterHardware Ver :FC5010409-10Driver Ver :8.2.3.10 Beta 2 Test 1 DBG (W2K VI)ROM Ver :1.24Firmware Ver :03.02.13.OS Name/Ver :500CT Payload Len :2040Port-id: 21:01:00:e0:8b:2a:f6:54show flogi database
To list all the FLOGI sessions, use the show flogi database command in EXEC mode.
show flogi database
Syntax Description
This command had no arguments or keywords.
Defaults
Displays the entire FLOGI database.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
In a Fibre Channel fabric, each host or disk requires an FC ID. Use the show flogi database command to verify if a storage device is displayed in the Fabric login (FLOGI) table as in the examples below. If the required device is displayed in the FLOGI table, the fabric login is successful. Examine the FLOGI database on a switch that is directly connected to the host HBA and connected ports.
Examples
The following is sample output from the show flogi database command.
switch# show flogi database---------------------------------------------------------------------INTERFACE FCID PORT NAME NODE NAME---------------------------------------------------------------------fc1/2 0x6101e1 21:00:00:04:cf:03:36:2f 20:00:00:04:cf:03:36:2ffc1/2 0x6101e2 21:00:00:04:cf:03:38:6e 20:00:00:04:cf:03:38:6efc1/2 0x6101e4 21:00:00:04:cf:03:38:24 20:00:00:04:cf:03:38:24fc1/2 0x6101e8 21:00:00:04:cf:03:38:4b 20:00:00:04:cf:03:38:4bTotal number of flogi = 4Related Commands
show fspf
To display global FSPF information, use the show fspf command in EXEC mode.
show fspf [interface]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
FSPF information includes:
•
•
•
•
•
Examples
The following is sample output from the show fspf command.
switch# show fspfFSPF routing administration status is enabledFSPF routing operational status is UPMinLsArrival = 1000 msec , MinLsInterval = 5000 msecLocal Domain is 0x69(105)Number of LSRs = 0Protocol constants :LS_REFRESH_TIME = 30 minutes (1800 sec)MAX_AGE = 60 minutes (3600 sec)Statistics counters :Number of LSR that reached MaxAge = 0Number of SPF computations = 0Number of Checksum Errors = 0Number of Transmitted packets : LSU 0 LSA 0 Hello 0 Retranmsitted LSU 0Number of Received packets : LSU 0 LSA 0 Hello 0 Error Packets 0The following is sample output from the show fspf interface command.
switch# show fspf interfaceFSPF interface fc1/1FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/2FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/3FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/4FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/5FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/6FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/7FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/8FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/9FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/10FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/11FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/12FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/13FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/14FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/15FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/16FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/17FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/18FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/19FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0FSPF interface fc1/20FSPF routing administrative state is activeInterface cost is 0Timer intervals configured, Hello 20 s, Dead 80 s, Retransmit 5 sFSPF State is DOWNNeighbor Domain Id is 0x0(0), Neighbor Interface index is 0x00000000Statistics counters :Number of packets received : LSU 0 LSA 0 Hello 0 Error packets 0Number of packets transmitted : LSU 0 LSA 0 Hello 0 Retransmitted LSU 0show hardware
To display switch hardware inventory details, use the show hardware command in EXEC mode.
show hardware
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show hardware command
switch# show hardwareCisco MDS 9000 FabricWareCopyright (C) 2002-2005, by Cisco Systems, Inc.and its suppliers. All rights reserved.Copyrights to certain works contained herein are owned bythird parties, and used and distributed under license.Portions of this software are governed by the GNU Public License,which is available at http://www.gnu.org/licenses/gpl.html.Softwaresystem: 2.1(2)system compile time: Thu Apr 21 12:48:49 2005Hardwareswitch uptime is 0 days 5 hours 44 minute(s) 42 second(s)Last reset at 20682 usecs after Mon Apr 25 11:01:12 2005Reason: PowerUp--------------------------------Switch hardware ID information--------------------------------MDS Switch is booted upModel number is DS-C9020-20K9H/W version is -------Part Number is 74-3811-01Part Revision is A0Serial number is 0426a07855CLEI code is COMMM00ARAshow interface
You can check the status of an interface at any time by using the show interface command in EXEC mode.
show interface {[brief] | counters [brief] | description | fc 1/port [brief] | mgmt 0 | transceiver}
Syntax Description
Defaults
Displays information for all interfaces on the switch.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show interface fc command.
switch# show interface fc 1/11fc1/11 is Down (Administratively down)Port WWN is 20:0a:00:0d:ec:19:cb:0eAdmin port mode is autoReceive data field Size is 2112Beacon is turned off5 minutes input rate 0 bits/sec, 0 bytes/sec, 0 frames/sec5 minutes output rate 0 bits/sec, 0 bytes/sec, 0 frames/sec0 frames input, 0 bytes0 discards, 0 errors0 CRC0 too long, 0 too short0 frames output, 0 bytes0 errors0 input OLS, 0 LRR, 0 loop inits5 output OLS, 0 LRR, 1 loop initsThe following is sample output from the show interface description command.
switch# show interface description-------------------------------------------------Interface Description-------------------------------------------------fc1/1 fc1/1fc1/2 fc1/2fc1/3 fc1/3fc1/4 fc1/4fc1/5 fc1/5fc1/6 fc1/6fc1/7 fc1/7fc1/8 fc1/8fc1/9 fc1/9fc1/10 fc1/10fc1/11 fc1/11fc1/12 fc1/12fc1/13 fc1/13fc1/14 fc1/14fc1/15 fc1/15fc1/16 fc1/16fc1/17 fc1/17fc1/18 fc1/18fc1/19 fc1/19fc1/20 fc1/20The following is sample output from the show interface brief command.
switch# show interface brief--------------------------------------------------------------Interface Admin Status FCOT Oper OperMode Mode Speed(Gbps)--------------------------------------------------------------fc1/1 auto down lwl --fc1/2 auto down swl --fc1/3 auto down -- --fc1/4 auto down -- --fc1/5 auto down -- --fc1/6 auto down -- --fc1/7 auto down -- --fc1/8 auto down -- --fc1/9 auto down swl --fc1/10 auto down -- --fc1/11 auto down -- --fc1/12 auto down -- --fc1/13 auto down unk --fc1/14 auto down -- --fc1/15 auto down -- --fc1/16 auto down swl --fc1/17 auto down -- --fc1/18 auto down -- --fc1/19 auto down -- --fc1/20 auto down elec -----------------------------------------------Interface Status IP Address---------------------------------------------mgmt0 up 10.20.83.122The following is sample output from the show interface counters brief command.
switch# show interface counters brief-------------------------------------------------------------------------------Interface Input (rate is 5 min avg) Output (rate is 5 min avg)----------------------------- -----------------------------Rate Total Rate TotalMB/s Frames MB/s Frames-------------------------------------------------------------------------------fc1/1 0 0 0 0fc1/2 0 0 0 0fc1/3 0 0 0 0fc1/4 0 0 0 0fc1/5 0 0 0 0fc1/6 0 0 0 0fc1/7 0 0 0 0fc1/8 0 0 0 0fc1/9 0 0 0 0fc1/10 0 0 0 0fc1/11 0 0 0 0fc1/12 0 0 0 0fc1/13 0 0 0 0fc1/14 0 0 0 0fc1/15 0 0 0 0fc1/16 0 0 0 0fc1/17 0 0 0 0fc1/18 0 0 0 0fc1/19 0 0 0 0fc1/20 0 0 0 0The following is sample output from the show interface transceiver command.
switch# show interface transceiverfc1/1 sfp is present but not supportedname is FINISAR CORP.part number is FTRJ-8519-3-2.5revision is X1serial number is E113LSFvendor specific data (bytes 96-127)0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF0xFF 0xFF 0xFF 0xFF 0xFF 0x00 0x00 0x000xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0x000x00 0x00 0xFF 0xFF 0xFF 0xFF 0xA7 0xCEfc1/2 sfp is present but not supportedname is FINISAR CORP.part number is FTRJ-8519-3-2.5revision is X1serial number is H112UZ3vendor specific data (bytes 96-127)0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF0xFF 0xFF 0xFF 0xFF 0xFF 0x00 0x00 0x000xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0x000x00 0x00 0xFF 0xFF 0xFF 0xFF 0xA7 0xCEfc1/3 sfp is not presentfc1/4 sfp is not presentfc1/5 sfp is not presentfc1/6 sfp is not presentfc1/7 sfp is not presentfc1/8 sfp is not presentfc1/9 sfp is present but not supportedname is FINISAR CORP.part number is FTRJ8524P2BNLrevision is Aserial number is P6G2333vendor specific data (bytes 96-127)0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00fc1/10 sfp is not presentfc1/11 sfp is not presentfc1/12 sfp is not presentfc1/13 sfp is present but not supportedname ispart number isrevision isserial number isvendor specific data (bytes 96-127)0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00fc1/14 sfp is not presentfc1/15 sfp is not presentfc1/16 sfp is present but not supportedname is FINISAR CORP.part number is FTRJ-8519-3-2.5revision is X1serial number is E113GL5vendor specific data (bytes 96-127)0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF0xFF 0xFF 0xFF 0xFF 0xFF 0x00 0x00 0x000xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0x000x00 0x00 0xFF 0xFF 0xFF 0xFF 0xA7 0xCEfc1/17 sfp is not presentfc1/18 sfp is not presentfc1/19 sfp is not presentfc1/20 sfp is present but not supportedname is Molex Inc.part number is 74720-0502revision is Dserial number is 33281334vendor specific data (bytes 96-127)0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x000x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00show ip access-list
To display the IP access control lists (IP-ACLs) currently active, use the show ip access-list command in EXEC mode.
show ip access-list [list-name | usage]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show ip access-list usage command.
switch# show ip access-list usageAccess List Name/Number Filters IF Status Creation Time-------------------------------- ------- ---- --------- -------------abc 3 7 active Tue Jun 24 17:51:40 2005x1 3 1 active Tue Jun 24 18:32:25 2005x3 0 1 not-ready Tue Jun 24 18:32:28 2005The following is sample output from the show ip access-list command.
switch# show ip access-list abcip access-list abc permit tcp any any (0 matches)ip access-list abc permit udp any any (0 matches)ip access-list abc permit icmp any any (0 matches)ip access-list abc permit ip 10.1.1.0 0.0.0.255 (2 matches)ip access-list abc permit ip 10.3.70.0 0.0.0.255 (7 matches)show ip route
To display the IP routing information, use the show ip route command in EXEC mode.
show ip route
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show ip route command.
switch# show ip routeCodes: C - connected, S - staticDefault gateway is 10.20.83.1C 10.20.83.0/24 is directly connected, mgmt0show logging
To display the current message logging configuration, use the show logging command in EXEC mode.
show logging [info | last lines | level | logfile | monitor | server]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show logging command.
switch# show loggingLogging monitor: disabledLogging server: disabledLogging logfile: enabled (Severity: critical)Facility Default Severity Current Session Severity-------- ---------------- ------------------------fcns 6 2fcs 6 2zone 6 2auth 6 2ipconf 6 2module 6 2ntp 6 2sysmgr 6 2user 6 2port 6 2fcdomain 6 2fspf 6 2[1][Mon Apr 25 11:02:03.228 UTC 2005][I][8400.0022][Switch][Successful login user (admin@OB-session1) with admin privilege][2][Mon Apr 25 11:02:03.337 UTC 2005][W][8A00.0000][CLI][Error while processing 'copy' command: Source file does not exist][3][Mon Apr 25 11:02:03.358 UTC 2005][A][1005.0040][Port: if1/2][Unsupported SFP within port.][4][Mon Apr 25 11:02:03.393 UTC 2005][A][1005.0040][Port: if1/9][Unsupported SFP within port.][5][Mon Apr 25 11:02:03.431 UTC 2005][A][1005.0040][Port: if1/13][Unsupported SFP within port.]The following is sample output from the show logging info command.
switch# show logging infoLogging monitor: disabledLogging server: disabledLogging logfile: enabled (Severity: critical)Facility Default Severity Current Session Severity-------- ---------------- ------------------------fcns 6 2fcs 6 2zone 6 2auth 6 2ipconf 6 2module 6 2ntp 6 2sysmgr 6 2user 6 2port 6 2fcdomain 6 2fspf 6 2The following is sample output from the show logging last command.
switch# show logging last 2[7][Fri Jan 21 22:45:07.672 UTC 2005][I][8400.0023][Switch][Successful login user (admin@OB-session3) with admin privilege from address 10.0.0.254][8][Fri Jan 21 22:49:06.768 UTC 2005][I][8400.0023][Switch][Successful login user (maint@OB-session4) with admin privilege from address 10.0.0.254]The following is sample output from the show logging monitor command.
switch# show logging monitorLogging monitor: enabledThe following is sample output from the show logging server command.
switch# show logging serverLogging server: disabledRelated Commands
show module
To verify the status of a module, use the show module command in EXEC mode.
show module [uptime]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Use the uptime option to display the time that a module goes online after a disruptive upgrade or reset.
Examples
The following is sample output from the show module command.
switch# show moduleMod Ports Module-Type Model Status--- ----- ------------------------------- ------------------ ------------1 20 1/2/4 Gbps FC/Supervisor DS-C9020-20K9 active *Mod Sw Hw World-Wide-Name (WWN)--- ------------ ------ --------------------------------------------------1 2.1(2) ------- 10:00:00:0d:ec:19:cb:01Mod MAC-Address Serial-Num--- -------------------------------------- ----------1 00-c0-dd-03-d4-e4 0426a07855* this terminal sessionThe following is sample output from the show module uptime command.
switch# show module uptime------ Module 1 -----Module Start Time: Mon Apr 25 11:01:12 2005Up Time: 0 days, 9 hours, 7 minutes, 56 secondsshow processes
To display general information about all the processes, use the show processes command in EXEC mode.
show processes {log [details]}
Syntax Description
log
Displays information about process logs or backtrace files.
details
Displays detailed process log information.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show processes command.
switch# show processesPID PPID %CPU TIME ELAPSED COMMAND178 148 0.0 00:00:00 09:46:25 cns179 148 0.0 00:00:00 09:46:25 ens180 148 0.0 00:00:00 09:46:25 dlog181 148 0.0 00:00:05 09:46:24 ds182 148 0.0 00:00:02 09:46:24 mgmtApp183 148 0.0 00:00:00 09:46:24 sys2swlog236 148 0.0 00:00:00 09:45:38 fc2237 148 0.0 00:00:00 09:45:38 nserver238 148 0.0 00:00:00 09:45:38 mserver239 148 0.0 00:00:00 09:45:38 util240 148 0.0 00:00:01 09:45:37 snmpservicepath241 148 0.0 00:00:00 09:45:37 eport242 148 0.0 00:00:00 09:45:37 PortApp243 148 0.0 00:00:00 09:45:37 port_mon244 148 0.0 00:00:00 09:45:37 zoning245 148 0.0 00:00:00 09:45:37 diagApp265 148 0.0 00:00:00 09:45:31 snmpd266 148 0.0 00:00:00 09:45:31 snmpmain269 266 0.0 00:00:00 09:45:29 snmpmain270 269 0.0 00:00:00 09:45:29 snmpmainThe following is sample output from the show processes log command.
switch# show processes logProcess Log-create-time---------------------- ---------------backtrace-clishco Tue Apr 26 18:45:39 2005show radius-server
To display all configured RADIUS server parameters, use the show radius-server command in EXEC mode.
show radius-server
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Only administrators can view the RADIUS pre-shared key.
Examples
The following is sample output from the show radius-server command.
switch# show radius-servertotal number of servers:2following RADIUS servers are configured:10.20.11.5:available for authentication on port:1812available for accounting on port:1813RADIUS shared secret:timeout:2retries:010.20.11.7:available for authentication on port:1812available for accounting on port:1813RADIUS shared secret:timeout:2retries:0show running-config
To display the running configuration file, use the show running-config command in EXEC mode.
show running-config [diff]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
If the running configuration is different from the startup configuration, enter the show startup-config diff command to view the differences.
Examples
The following is sample output from the show running-config command.
switch# show running-configip default-gateway 10.20.83.1logging level fcdomain 2logging level fspf 2logging level fcns 2logging level fcs 2logging level port 2logging level zone 2logging level auth 2logging level ipconf 2logging level module 2logging level ntp 2logging level sysmgr 2interface mgmt0ip address 10.20.83.122 255.255.255.0interface fc1/1interface fc1/2interface fc1/3interface fc1/4interface fc1/5interface fc1/6interface fc1/7interface fc1/8interface fc1/9interface fc1/10interface fc1/11interface fc1/12interface fc1/13interface fc1/14interface fc1/15interface fc1/16interface fc1/17interface fc1/18interface fc1/19interface fc1/20The following is sample output from the show running-config diff command.
switch# show running-config diffswitchname rtp-9020-topip default-gateway 172.18.172.1ssh server enablelogging level fcdomain 2logging level fspf 2logging level fcns 2logging level fcs 2logging level port 2logging level zone 2logging level auth 2logging level ipconf 2logging level module 2logging level ntp 2logging level sysmgr 2snmp-server community public rosnmp-server community private rwinterface mgmt0ip address 172.18.172.160 255.255.255.0no shutdowninterface fc1/1+ no shutdowninterface fc1/2interface fc1/3interface fc1/4interface fc1/5interface fc1/6interface fc1/7interface fc1/8interface fc1/9interface fc1/10interface fc1/11interface fc1/12interface fc1/13interface fc1/14interface fc1/15interface fc1/16interface fc1/17interface fc1/18interface fc1/19interface fc1/20show snmp
To display SNMP status and setting information, use the show snmp command in EXEC mode.
show snmp [community | host | user]
Syntax Description
community
Displays SNMP community strings.
host
Displays SNMP host information.
user
Displays SNMP users.
Defaults
Displays the system contact, system location, and community information.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show snmp command.
switch# show snmpsys contact: <sysContact undefined>sys location: <sysLocation undefined>Community Group/Access--------- ------------public network-operatorThe following is sample output from the show snmp community command.
switch# show snmp communityCommunity Group/Access--------- ------------public network-operatorThe following is sample output from the show snmp user command.
switch# show snmp userHost Port Version Type SecName____ ____ _______ _____ ______10.0.0.254 162 2c trap publicThe following is sample output from the show snmp host command.
switch# show snmp hostHost Port Version Level Type SecName____ ____ _______ ______ ____ ______172.16.126.34 2162 v2c noauth trap public172.16.75.106 2162 v2c noauth trap public172.31.124.81 2162 v2c noauth trap public172.31.157.193 2162 v2c noauth trap public172.31.157.98 2162 v2c noauth trap public172.31.49.25 2162 v2c noauth trap public172.31.49.32 2188 v2c noauth trap public172.31.49.49 2162 v2c noauth trap public172.31.49.49 3514 v2c noauth trap public172.31.49.54 2162 v2c noauth trap public172.31.58.54 2162 v2c noauth trap public172.31.58.81 2162 v2c noauth trap public172.31.58.97 1635 v2c noauth trap public172.31.58.97 2162 v2c auth trap public172.31.58.97 3545 v2c auth trap public172.22.00.43 2162 v2c noauth trap public172.22.00.65 2162 v2c noauth trap public172.22.05.234 2162 v2c noauth trap public172.22.05.98 1050 v2c noauth trap publicThe following is sample output from the show snmp user command.
switch# show snmp userUser Group Auth Priv____ _____ ____ ____sadmin2 network-admin md5 dessadmin network-admin md5 dessoper network-operator md5 desshow sprom mgmt-module
To display the switch SPROM contents, use the show sprom mgmt-module command in EXEC mode.
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show sprom mgmt-module command.
switch# show sprom mgmt-moduleDISPLAY SAM sprom contents:Common block:OEM String : Cisco Systems, Inc.Product Number : DS-C9020-20K9Serial Number : 0426a07855Part Number : 74-3811-01Part Revision : A0Mfg Deviation : 0H/W Version : -------snmpOID : 1.3.6.1.4.1.1663.1.1.1.1.26CLEI Code : COMMM00ARAVID : V01MAC Address : 00-c0-dd-03-d4-e4WWN : 10:00:00:0d:ec:19:cb:0eshow ssh server
To display the status of the Secure Shell information (SSH) server, use the show ssh server command in EXEC mode.
show ssh server
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show ssh server command.
switch# show ssh serverssh service is enabledshow startup-config
To display the startup configuration file, use the show startup-config command in EXEC mode.
show startup-config
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show startup-config command.
switch# show startup-config## Startup config#switchname DS-C9020-20K9fcdomain domain 0 preferredinterface fc1/1no shutdownAutointerface fc1/2no shutdownAutointerface fc1/3no shutdownFxinterface fc1/4no shutdownAutointerface fc1/5no shutdownAutointerface fc1/6no shutdownAutointerface fc1/7no shutdownAutointerface fc1/8no shutdownAutointerface fc1/9no shutdownAutointerface fc1/10no shutdownAutointerface fc1/11no shutdownAutointerface fc1/12no shutdownAutoshow switchname
To display the switch network name, use the show switchname command in EXEC mode.
show switchname
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show switchname command.
switch# show switchnameswitch-123show system
To display the system information, use the show system command in EXEC mode.
show system [reset-reason | uptime]
Syntax Description
reset-reason
Displays the last reset reason code.
uptime
Displays how long the system has been up and running.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show system reset-reason command.
switch# show system reset-reason----- reset reason for module 1 -----1) At <USECS> usecs after Fri Jan 21 23:20:11 2005Reason: NormalResetThe following is sample output from the show system uptime command.
switch# show system uptimeSystem Start Time: Mon Apr 25 11:01:12 2005System Up Time: 0 days, 10 hours, 58 minutes, 38 secondsActive Supervisor Up Time: 0 days, 10 hours, 58 minutes, 38 secondsshow tech-support
To display information useful to technical support when reporting a problem, use the show tech-support command in EXEC mode.
show tech-support [brief | create | details | interface | module 1]
Syntax Description
Defaults
Displays the equivalent of all the following show commands.
•
•
•
•
•
•
•
•
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The show tech-support command is a compilation of several show commands and can be quite lengthy. For a sample display of the output of the show tech-support command, see the individual command explanations for the commands listed under Defaults.
Examples
The following is sample output from the show tech-support module command.
switch# show tech-support module 1CMD: show module 1---Mod Ports Module-Type Model Status--- ----- ------------------------------- ------------------ ------------1 20 1/2/4 Gbps FC/Supervisor DS-C9020-20K9 activeMod Sw Hw World-Wide-Name (WWN)--- ------------ ------ --------------------------------------------------1 2.1(2) ------- 10:00:00:0d:ec:19:cb:0eMod MAC-Address Serial-Num--- -------------------------------------- ----------1 00-c0-dd-03-d4-e4 0426a07855CMD: show environment---Fan:----------------------Fan Status----------------------1 Good2 GoodTemperature:---------------------------Module CurTemp Status(Celsius)---------------------------1 33 okPower Supply:-------------PS Status-------------1 ok2 okThe following is sample output from the show tech-support brief command.
switch# show tech-support briefCMD: show fcs database---FCS Local Database------------------Switch WWN : 1000000dec19cb0eSwitch Domain Id : 105Fabric-Name :Switch Logical-Name : switchSwitch Ports:--------------------------------------------------------------Interface fWWN Type Attached-pWWNs--------------------------------------------------------------fc1/1 20:00:00:0d:ec:19:cb:0e Unknown Nonefc1/2 20:01:00:0d:ec:19:cb:0e Unknown Nonefc1/3 20:02:00:0d:ec:19:cb:0e Unknown Nonefc1/4 20:03:00:0d:ec:19:cb:0e Unknown Nonefc1/5 20:04:00:0d:ec:19:cb:0e Unknown Nonefc1/6 20:05:00:0d:ec:19:cb:0e Unknown Nonefc1/7 20:06:00:0d:ec:19:cb:0e Unknown Nonefc1/8 20:07:00:0d:ec:19:cb:0e Unknown Nonefc1/9 20:08:00:0d:ec:19:cb:0e Unknown Nonefc1/10 20:09:00:0d:ec:19:cb:0e Unknown Nonefc1/11 20:0a:00:0d:ec:19:cb:0e Unknown Nonefc1/12 20:0b:00:0d:ec:19:cb:0e Unknown Nonefc1/13 20:0c:00:0d:ec:19:cb:0e Unknown Nonefc1/14 20:0d:00:0d:ec:19:cb:0e Unknown Nonefc1/15 20:0e:00:0d:ec:19:cb:0e Unknown Nonefc1/16 20:0f:00:0d:ec:19:cb:0e Unknown Nonefc1/17 20:10:00:0d:ec:19:cb:0e Unknown Nonefc1/18 20:11:00:0d:ec:19:cb:0e Unknown Nonefc1/19 20:12:00:0d:ec:19:cb:0e Unknown Nonefc1/20 20:13:00:0d:ec:19:cb:0e Unknown NoneCMD: show version---Cisco MDS 9000 FabricWareCopyright (C) 2002-2005, by Cisco Systems, Inc.and its suppliers. All rights reserved.Copyrights to certain works contained herein are owned bythird parties, and used and distributed under license.Portions of this software are governed by the GNU Public Licenwhich is available at http://www.gnu.org/licenses/gpl.html.Softwaresystem: 2.1(2)system compile time: Thu Apr 21 12:48:49 2005Hardwareswitch uptime is 0 days 11 hours 14 minute(s) 0 second(s)Last reset at 40440 usecs after Mon Apr 25 11:01:12 2005Reason: PowerUpCMD: show interface brief-----------------------------------------------------------------Interface Admin Status FCOT Oper OperMode Mode Speed(Gbps)--------------------------------------------------------------fc1/1 auto down lwl --fc1/2 auto down swl --fc1/3 auto down -- --fc1/4 auto down -- --fc1/5 auto down -- --fc1/6 auto down -- --fc1/7 auto down -- --fc1/8 auto down -- --fc1/9 auto down swl --fc1/10 auto down -- --fc1/11 auto down -- --fc1/12 auto down -- --fc1/13 auto down unk --fc1/14 auto down -- --fc1/15 auto down -- --fc1/16 auto down swl --fc1/17 auto down -- --fc1/18 auto down -- --fc1/19 auto down -- --fc1/20 auto down elec -----------------------------------------------Interface Status IP Address---------------------------------------------mgmt0 up 10.20.83.122The following is sample output from the show tech-support create command.
switch # show tech-support createThis may take several seconds...FTP the dump support file to another machine? (y/n) : yEnter IP Address of remote computer: 10.20.33.130Login name: soper1Enter a valid remote directory path within the user's home directory.Otherwise the file will be place in the user's home directory:Would you like to continue downloading support file? (y/n) : yConnected to 10.20.33.130 (10.20.33.130).220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready.331 Password required for soper1.Password:230 User soper1 logged in.cd /itasca/conf/imagesLocal directory now /itasca/conf/imagesbin200 Type set to I.put dump_support.tgzlocal: dump_support.tgz remote: dump_support.tgz227 Entering Passive Mode (10,20,33,130,144,7)150 Opening BINARY mode data connection for dump_support.tgz.226 Transfer complete.75614 bytes sent in 0.00731 secs (1e+04 Kbytes/sec)Remote system type is UNIX.Using binary mode to transfer files.221-You have transferred 75614 bytes in 1 files.221-Total traffic for this session was 76026 bytes in 1 transfers.221 Thank you for using the FTP service on localhost.localdomain.show telnet server
To display the state of the Telnet access configuration, use the show telnet server command in EXEC mode.
show telnet server
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show telnet server command.
switch# show telnet servertelnet service is enabledshow terminal
To display the terminal information, use the show terminal command
show terminal
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show terminal command.
switch# show terminalLength: 10 linesSession Timeout: 0 minutesshow user-account
To display configured information about user accounts, use the show user-account command in EXEC mode.
show user-account
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show user-account command.
switch# show user-accountshow user-accountuser:adminthis user account has no expiry dateroles:network-adminshow users
To display all users currently accessing the switch, use the show users command in EXEC mode.
show users
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show users command.
switch# show userssnmp@IB-session2 Mon Apr 25 11:02:07 2005 (Unknown)snmp@OB-session3 Mon Apr 25 11:02:07 2005 (Unknown)admin@OB-session11 Wed Apr 27 13:50:49 2005 (10.20.32.70)show version
To display the version of system software that is currently running on the switch, use the show version command in EXEC mode.
show version
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show version command.
switch# show versionCisco MDS 9000 FabricWareCopyright (C) 2002-2005, by Cisco Systems, Inc.and its suppliers. All rights reserved.Copyrights to certain works contained herein are owned bythird parties, and used and distributed under license.Portions of this software are governed by the GNU Public License,which is available at http://www.gnu.org/licenses/gpl.html.Softwaresystem: 2.1(2)system compile time: Thu Apr 21 12:48:49 2005Hardwareswitch uptime is 0 days 11 hours 34 minute(s) 3 second(s)Last reset at 41643 usecs after Mon Apr 25 11:01:12 2005Reason: PowerUpshow zone
To display zone information, use the show zone command in EXEC mode.
show zone [active | member {fcalias alias-name | pwwn wwn} | name string | status]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show zone command.
switch# show zonezone name Z1pwwn 10:00:00:c0:dd:07:00:f8fcalias name A1pwwn 10:00:00:c0:dd:07:00:f9The following is sample output from the show zone name command.
switch# show zone name Zone1zone name Z1pwwn 10:00:00:c0:dd:07:00:f8fcalias name A1pwwn 10:00:00:c0:dd:07:00:f9fcid 0x610005The following is sample output from the show zone member pwwn command.
switch# show zone member pwwn 10:00:00:c0:dd:07:00:f9fcalias name A1pwwn 10:00:00:c0:dd:07:00:f9The following is sample output from the show zone status command.
switch# show zone statusFull Zoning Database :Zonesets: 1 Zones: 1 Aliases: 1Active Zoning Database:Name: ZS1 Zonesets: 1 Zones: 1Status:show zoneset
To display the configured zone sets, use the show zoneset command in EXEC mode.
show zoneset [active | name zoneset-name]
Syntax Description
active
Displays only active zone sets.
name zoneset-name
Displays members of a specified zone set. Maximum length is 64 characters.
Defaults
Displays active zone set information.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following is sample output from the show zoneset command.
switch# show zonesetzoneset name ZS1zone name Z1pwwn 10:00:00:c0:dd:07:00:f8fcalias name A1pwwn 10:00:00:c0:dd:07:00:f9The following is sample output from the show zoneset active command.
switch# show zoneset activezoneset name ZS1zone name Z1pwwn 10:00:00:c0:dd:07:00:f8pwwn 10:00:00:c0:dd:07:00:f9shutdown
To disable an interface, use the shutdown command in interface configuration submode.
shutdown [force]
To enable an interface, use the no form of this command.
no shutdown [force]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
The default state for interfaces is shutdown. Use the no shutdown command to enable an interface to carry traffic.
When you try to shut down a management interface (mgmt0), a follow-up message confirms your action before performing the operation. Use the force option to bypass this confirmation, if required.
Examples
The following example shows how to enable an interface.
switch# configswitch(config)# interface fc 1/2switch(config-if)# no shutdownThe following example shows how to disable an interface.
switch# configswitch(config)# interface mgmt 0switch(config-if)# shutdownThe following example shows how to forcefully disable the mgmt0 interface.
switch# configswitch(config)# interface mgmt 0switch(config-if)# shutdown forceRelated Commands
interface
Specifies an interface and enters interface configuration submode.
show interface
Displays interface information.
sleep
To delay an action by a specified number of seconds, use the sleep command in EXEC mode.
sleep seconds
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
This command is useful within scripts.
Examples
The following example shows how to delay the switch prompt return.
switch# sleep 30You will see the switch prompt return after 30 seconds.
snmp-server
To configure the SNMP server information, switch location, and switch name, use the snmp-server command in configuration mode.
snmp-server {community string [ro | rw] | contact [name] | enable traps | location [location]}
To remove the SNMP server information, use the no form of this command.
no snmp-server {community string [ro | rw] | contact [name] | enable traps | location [location]}
Syntax Description
Defaults
The default community access is read-only (ro).
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example sets the contact information, switch location, and switch name.
switch# configswitch(config)# snmp-server contact NewUserswitch(config)# no snmp-server contact NewUserswitch(config)# snmp-server location SanJoseswitch(config)# no snmp-server location SanJoseswitch(config)# snmp-server name NewNameswitch(config)# no snmp-server name NewNameswitch(config)# no snmp-server user usernameARelated Commands
snmp-server host
To specify the recipient of an Simple Network Management Protocol notification operation, use the snmp-server host command in configuration mode.
snmp-server host host-address traps version [1 | 2c] community-string [udp-port port]
To remove the specified host, use the no form of this command.
no snmp-server host host-address traps version [1 | 2c ] community-string [udp-port port]
Syntax Description
Defaults
Sends SNMP traps.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
If you use the version keyword, one of the following must be specified: 1 or 2c.
Examples
The following example specify the recipient of an SNMP notification.
switch# configswitch(config)# snmp-server host 10.1.1.1 traps version 2c abcddsfsf udp-port 500ssh key
To generate an SSH key, use the ssh key command in configuration mode.
ssh key rsa [bits]
To delete the SSH keys, use the no form of this command.
no ssh key
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example shows how to generate an SSH key.
switch# configswitch(config)# ssh key rsa 1024generating rsa key.....generated rsa keyswitch(config)#switch(config)# no ssh keycleared RSA keysswitch(config)#Related Commands
show ssh key
Displays SSH key information.
ssh server enable
Enables SSH server.
ssh server enable
To enable the SSH server, use the ssh server enable command in configuration mode.
ssh server enable
To disable the SSH service, use the no form of this command.
no ssh server enable
Syntax Description
This command had no arguments or keywords.
Defaults
Disabled
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example enables the SSH server.
switch# configswitch(config)# ssh server enableupdatedswitch(config)# no ssh server enableupdatedRelated Commands
switchname
To change the name of the switch, use the switchname command in configuration mode.
switchname name
To revert the switch name to the default name, use the no form of this command.
no switchname
Syntax Description
Defaults
switch.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example changes the name of the switch to myswitch1.
switch# configswitch(config)# switchname myswitch1myswitch1(config)#myswitch1(config)# no switchnameswitch(config)#Related Commands
snmp-server
Sets the contact information, switch location, and switch name within the limit of 32 characters (without spaces).
switchport
To configure switchport parameter on a Fibre Channel interface, use the switchport command in interface configuration submode.
switchport {beacon |
description text |
mode [auto | E | F | FL | Fx] |
speed [1000 | 2000 | 4000 | auto]}To negate this command or revert to the factory defaults, user the no form of this command.
no switchport [beacon | description | mode | speed ]
Syntax Description
Defaults
The beacon is disabled.
The mode is auto.
The speed is auto.
Command Modes
Interface configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
You can specify a range of interfaces by entering a command with the following example format:
interface fc1/1-5
Examples
The following example configures switchport features for a Fibre Channel interface.
switch# configswitch(config)# interface fc1/1-4switch(config-if)# switchport description ISLsswitch(config-if)# switchport mode Eswitch(config-if)# switchport speed 4000Related Commands
telnet server enable
To enable the Telnet server, use the telnet server enable command in configuration mode.
telnet server enable
To disable this Telnet server, use the no telnet server command.
no telnet server enable
Syntax Description
This command had no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example enables the Telnet server.
switch(config)# telnet server enableterminal
To configure terminal attributes, use the terminal command in EXEC mode.
terminal [length lines | session-timeout minutes]
To revert to the defaults, use the no form of this command.
no terminal [length | session-timeout]
Syntax Description
Defaults
The default number of lines for the length is 20. The default width is 80 lines.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Remember that all terminal parameter-setting commands are set locally and do not remain in effect after a session is ended. You must perform this task at the EXEC prompt at each session to see the debugging messages.
If the length is not 20 and the width is not 80, then you need to set a length and width.
Examples
The following example sets the terminal length to 30.
switch# terminal length 30Related Commands
username
To define a user, use the username command in configuration mode.
username name {password user-password | [expire days] | role rolename}
To undo the configuration or revert to factory defaults, use the no form of this command.
no username name {expire days | password user-password [expire date] | role rolename}
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Deleting a user using either command results in the user being deleted for both SNMP and CLI.
User-role mapping changes are synchronized in SNMP and CLI.
Examples
The following example shows how to define a user.
switch(config)# username knuckles password testpw role network-operatorswitch(config)# do show user-accountuser:adminthis user account has no expiry dateroles:network-adminuser:knucklesthis user account has no expiry dateroles:network-operatorThe following example creates or updates the user account (usam) along with a password (abcd) that is set to expire on 2003-05-31.
switch(config)# username usam password abcd expire 2005-05-31The following example adds the specified user (usam) to the network-admin role.
switch(config)# username usam role network-adminRelated CommandsT
write erase
To clear a startup configuration, enter the write erase command in EXEC mode.
write erase [boot]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Once this command is entered, the switch's startup configuration reverts to factory defaults. The running configuration is not affected. The write erase command erases the entire startup configuration with the exception of the IP configuration of the mgmt0 IP configuration (IP address, netmask, and default gateway).
The write erase boot command erases the mgmt0 IP configuration information (IP address, netmask, and default gateway) and the startup configuration.
Examples
The following example clears only the startup configuration.
switch# write eraseThe following example clears the startup configuration and the mgmt0 IP configuration.
switch# write erase bootThis command will erase the boot variables and the ip configuration of interface mgmt 0zone default-zone
To define whether a default zone (nodes not assigned a created zone) permits or denies access to all in the default zone, use the zone default-zone command in configuration mode.
zone default-zone [permit]
To negate the command or revert to the factory defaults, use the no form of this command.
no zone default-zone [permit]
Syntax Description
Defaults
All default zones are permitted access.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example permits default zoning.
switch# configswitch(config)# zone default-zone permitRelated Commands
zone name
To create a zone, use the zone name command in configuration mode.
zone name zone-name
To negate the command or revert to the factory defaults, use the no form of this command.
no zone name zone-name
Entering the zone name command opens the config-zone submode which provides access to the following subcommand:
member [fcalias alias-name | pwwn pwwn-id]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Zones are assigned to zone sets, zone sets are then activated from one switch and propagate across the fabric to all switches. Zones allow security by permitting and denying access between nodes (hosts and storage). zone name commands are entered from the configuration mode.
Broadcast frames are sent to all Nx ports.
If any NL port attached to an FL port shares a broadcast zone with the source of the broadcast frame,
then the frames are broadcast to all devices in the loop.
Examples
The following example configures members for the specified zone (Zone2) based on the member type (pWWN or FC alias) and value specified.
switch# configswitch(config)# zone name Zone2switch(config-zone)# member pwwn 10:00:00:23:45:67:89:abswitch(config-zone)# member fcalias PayrollRelated Commands
zone rename
To rename a zone, use the zone rename command in EXEC mode.
zone rename current-name new-name
Syntax Description
current-name
Specifies the current fcalias name. Maximum length is 64 characters.
new-name
Specifies the new fcalias name. Maximum length is 64 characters.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Examples
The following example shows how to rename a zone.
switch# zone rename ZoneA ZoneBRelated Commands
zoneset
To group zones under one zone set, use the zoneset command in configuration mode.
zoneset [name zoneset-name |
activate name zoneset-name |
distribute full |
rename current-name new-name]To negate the command or revert to the factory defaults, use the no form of this command.
no zoneset [name zoneset-name |
activate name zoneset-name |
distribute full |
rename current-name new-name]Entering the zoneset name zoneset-name command opens the config-zoneset submode which provides access to the member subcommand:
member [fcalias alias-name | pwwn pwwn-id]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Configuration
Command History
This command was introduced in Cisco MDS 9000 FabricWare Release 2.1(2).
Usage Guidelines
Zones are activated by activating the parent zone set.
Examples
The following example creates a zone set named gottons, adds a zone, and activates the zone set.
switch# configswitch(config)# zoneset name gottonsswitch(config-zone)# member zone1switch(config-zone)# exitswitch(config)# zoneset activate name gottonsZoneset Activation initiated. check zone statusRelated Commands
