FeedbackTable Of Contents
I Commands
The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the "Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.
in-order-guarantee
To enable in-order delivery in the Cisco MDS 9000 Family of switches, use the in-order-guarantee command in configuration mode. To disable in-order delivery, use the no form of the command.
in-order-guarantee
no in-order-guarantee
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
In-order delivery of data frames guarantees frame delivery to a destination in the same order that they were sent by the originator.
Examples
The following example shows how to enable in-order delivery.
switch## config tswitch(config)##switch(config)# in-order-guaranteeswitch(config)#switch(config)# no in-order-guaranteeswitch(config)#install all
To upgrade all modules in any Cisco MDS 9000 family switch, use the install all command. This upgrade can happen nondisruptively or disruptively depending on the current configuration of your switch.
install all system URL kickstart URL
Syntax Description
install all
Upgrades the system.
system
Upgrades the system image.
kickstart
Upgrades the kickstart image.
URL
The location URL of the source file to be installed.
The following table lists the aliases for URL.
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(3).
Usage Guidelines
The install all command upgrades all modules in any Cisco MDS 9000 Family switch.
To copy a remote file, specify the entire remote path exactly as it is.
See the Cisco MDS 9000 Family Configuration Guide for detailed procedures.
Examples
The following example displays the result of the install all command if the system and kickstart files are specified locally.
switch# install all system bootflash:system_image kickstart bootflash:kickstart_imageImage verification is in progress, please wait.This command is going to install system image system_imageand kickstart image kickstart_image on this systemThe command will:- Install the Loader, if required- Install the BIOS, if required- Update boot variables- Save configuration- Reload the standby supervisor- Perform a HA Switchover- Perform a hitless upgrade of module 1, 2, 3, 4, 7, 8, 9Do you want to continue y/n ? [n] : yImage synchronization is in progress, please wait.Installing Loader, please wait.Installing Loader on module 5 ... successfulInstalling Loader on module 6 ... successfulInstalling BIOS, please wait.Installing BIOS on module 1 ... not required (same version)Installing BIOS on module 2 ... not required (same version)Installing BIOS on module 3 ... not required (same version)Installing BIOS on module 4 ... not required (same version)Installing BIOS on module 5 ... not required (same version)Installing BIOS on module 6 ... not required (same version)Installing BIOS on module 7 ... not required (same version)Installing BIOS on module 8 ... not required (same version)Installing BIOS on module 9 ... not required (same version)Updating boot variables .. successfulSaving configuration, please wait.Reload of the standby supervisor is in progress, please waitSuccess, the standby supervisor is online and ready to takeoverThe following example displays the result of the install all command if the system and kickstart files are specified remotely.
switch# install all system scp://user@171.71.00.000:/home/user/golden-sanity/system_image kickstart scp://user@171.71.00.000:/home/user/golden-sanity/kickstart_imageCopyingscp://user@171.71.00.000/home/user/golden-sanity/system_image tobootflash:/system_image..Copyingscp://user@171.71.00.000/home/user/golden-sanity/kickstart_image tobootflash:/kickstart_imageaharihar@171.71.00.000's password:system_image-3u 100% |*****************************| 19941 KB00:24Image verification is in progress, please wait.This command is going to install system image system_imageand kickstart image kickstart_image on this systemThe command will:- Install the Loader, if required- Install the BIOS, if required- Update boot variables- Save configuration- Reload the standby supervisor- Perform a HA Switchover- Perform a hitless upgrade of module 1, 2, 3, 4, 7, 8, 9Do you want to continue y/n ? [n] : yImage synchronization is in progress, please wait.Installing Loader, please wait.Installing Loader on module 5 ... successfulInstalling Loader on module 6 ... successfulInstalling BIOS, please wait.Installing BIOS on module 1 ... not required (same version)Installing BIOS on module 2 ... not required (same version)Installing BIOS on module 3 ... not required (same version)Installing BIOS on module 4 ... not required (same version)Installing BIOS on module 5 ... not required (same version)Installing BIOS on module 6 ... not required (same version)Installing BIOS on module 7 ... not required (same version)Installing BIOS on module 8 ... not required (same version)Installing BIOS on module 9 ... not required (same version)Updating boot variables .. successfulSaving configuration, please wait.Reload of the standby supervisor is in progress, please waitSuccess, the standby supervisor is online and ready to takeoverThis example displays the file output on the console of the standby supervisor module:
Installation procedure in progress, please wait.The login will be disabled until the installation is completed.Switchover to this supervisor is successfulInstall of module 1 is in progress, please wait.Install of module 2 is in progress, please wait.Install of module 3 is in progress, please wait.Install of module 4 is in progress, please wait.Install of module 7 is in progress, please wait.Install of module 8 is in progress, please wait.Install of module 9 is in progress, please wait.The installation procedure has completed successfully.MDS Switchswitch login:Related Commands
install module bios
To program the supervisor or switching module BIOS, use the install module bios system command.
install module module-number bios {system [bootflash: | slot0: | volatile: | system-image]}
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(3).
Usage Guidelines
If the BIOS is upgraded, you need to reboot to make the new BIOS effective. You can schedule the reboot at a convenient time so traffic will not be impacted.
The console baud rate automatically reverts to the default rate (9600) after any BIOS upgrade.
The URL is always the system image URL in the supervisor module, and points to the bootflash: or slot0: directories.
Examples
The following example shows how to perform a non disruptive upgrade for the system.
switch# install module 1 biosStarted bios programming .... please wait###BIOS upgrade succeeded for module 1In this example, the switching module in slot 1 was updated.
install module image
To program the supervisor or switching module image, use the install module image command.
install module module-number image kickstart [bootflash: | slot0: | volatile: | system-image]
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(3).
Usage Guidelines
The install module command only upgrades the system image on any module (other than the standby supervisor module). If error occur for any switching module, the module is reset and the new image is downloaded for that module.
If you are issuing this command on the supervisor module, follow these requirements:
•
Update the environment variables before issuing this command.
•
•
Examples
The following example shows how to perform a non disruptive upgrade for the system.
switch# install module 5 image system bootflash:system.imgBeginning the install check...bootflash:/system.img and kickstart image...is compatible.bootflash:/system.img image...can be upgraded non-disruptively from current.Preliminary install check done.Beginning the install process.Parsing of versioning database successful.Preparing file system plan now...Done.Preparing upgrade group plan now...Done.Executing pre-uninstall scripts...Done.Updating the File System for installation...Done.Executing post-install scripts...Done.System Manager will restart the services according to upgrade plan..Done.Installation completed successfully.Related Commands
show version compatibility
Shows the system software that is currently running on the switch
install module loader
To upgrade the bootloader on either the active or standby supervisor module, use the install module loader command. This command is only for supervisor modules, not switching modules.
install module module-number loader kickstart [bootflash: | slot0: | volatile: | kickstart-image]
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(3).
Usage Guidelines
Before issuing the install module loader command, be sure to read the release notes to verify compatibility issues between the boot loader and the kickstart or system images.
If you install a loader version that is the same as the currently-installed version, the loader will not be upgraded. When both the current version and the installed version are the same, use the init system command to force a loader upgrade.
Examples
The following example shows how to perform a non disruptive upgrade for the system.
switch# install module 6 loader bootflash:kickstart_imageThis example displays the command being issued on the standby supervisor module in slot 6.
Related Commands
interface
To configure an interface on the Cisco MDS 9000 Family of switches, use the interface command in configuration mode. To disable an interface, use the no form of the command.
interface fc | mgmt | port-channel | sup-fc | vsan
no interface fc | mgmt | port-channel | sup-fc | vsan
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format:
interface fc1/1 - 5 , fc2/5 - 7
The spaces are required before and after the dash ( - ) and before and after the comma ( , ).
Examples
The following example displays the options for the interface command.
switch## config tswitch(config)# interface ?cpp Virtualization IPFC interfacefc Fiber Channel interfacefc-tunnel Fc-tunnel interfacefcip Fcip interfacegigabitethernet Ethernet interfaceiscsi ISCSI interfacemgmt Management interfaceport-channel Port Channel interfacesup-fc Inband Interfacevsan IPFC VSAN interfaceRelated Commands
interface fc
To configure a Fibre Channel interface on the Cisco MDS 9000 Family of switches, use the interface fc command. To disable a Fibre Channel interface, use the no form of the command.
interface fc slot_number [channel-group number force] exit | fcdomain rcf-reject vsan vsan-id [fspf cost link_cost vsan vsan-id | dead-interval seconds vsan vsan-id | hello-interval seconds vsan vsan-id | passive vsan vsan-id | retransmit-interval seconds vsan vsan-id] no | shutdown | switchport
no interface fc slot_number [channel-group number force] exit | fcdomain rcf-reject vsan vsan-id [fspf cost link_cost vsan vsan-id | dead-interval seconds vsan vsan-id | hello-interval seconds vsan vsan-id | passive vsan vsan-id | retransmit-interval seconds vsan vsan-id] no | shutdown | switchport
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format:
interface space fc1/1space-space5space,spacefc2/5space-space7
Examples
The following example configures ports 1 to 4 in Fibre Channel interface 9.
switch# config tEnter configuration commands, one per line. End with CNTL/Z.switch(config)# int fc9/1 - 4Related Commands
interface fc switchport
To configure an interface on the Cisco MDS 9000 Family of switches, use the interface command in configuration mode.
interface fc slot-number {switchport beacon | description text | encap eisl | [fcrxbbcredit credit mode E | Fx] fcrxbbcredit default | switchport [fcrxbufsize size | mode auto (E | F | FL | Fx | SD | TL) | speed (1000 | 2000 | auto) | trunk allowed vsan vsan-id] | add [vsan number | all] | mode [auto | off | on]}
no interface fc slot-number {switchport beacon | description text | encap eisl | [fcrxbbcredit credit mode E | Fx] fcrxbbcredit default | switchport [fcrxbufsize size | mode auto (E | F | FL | Fx | SD | TL) | speed (1000 | 2000 | auto) | trunk allowed vsan vsan-id] | add [vsan number | all] | mode [auto | off | on]}
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format:
interface space fc1/1space-space5space,spacefc2/5space-space7
Examples
The following example changes to Configuration mode, configures a Fibre Channel interface, and configures switchport mode E for the specified BB credit.
switch## config tswitch(config)# interface fc1/1switch(config-if)# switchport fcrxbbcredit 2 mode ERelated Commands
interface mgmt
To configure a management interface on the Cisco MDS 9000 Family of switches, use the interface mgmt command in configuration mode.
interface mgmt number | exit [ip | no ip] no | shutdown | switchport description text [vrrp | no vrrp vrrp_id]
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode. Issue interface mgmt commands from the config-interface (config-if) mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example configures the management interface, displays the options available for the configured interface, and exits to configuration mode.
switch## config tswitch(config)##switch(config)# interface mgmt 0switch(config-if)# ?Interface configuration commands:exit Exit from this submodeip [no] ip addressno Negate a command or set its defaultsshutdown Enable/disable an interfaceswitchport Configure switchport parametersvrrp [no] vrrp vr_id: Configure vrrp on this interfaceswitch(config-if)# exitswitch(config)#Related Commands
interface port-channel
To configure a port channel interface on the Cisco MDS 9000 Family of switches, use the interface port-channel command.
interface port-channel number [fcdomain rcf-reject vsan vsan-id] | fspf [cost link_cost | dead-interval seconds | hello-interval seconds | passive | retransmit-interval seconds] | shutdown | switchport
no interface port-channel number [fcdomain rcf-reject vsan vsan-id] | fspf [cost link_cost | dead-interval seconds | hello-interval seconds | passive | retransmit-interval seconds] | shutdown | switchport
Syntax Description
Defaults
Disabled
Command Modes
Configuration mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example enters configuration mode and configures a PortChannel interface.
switch## config tswitch(config)##switch(config)# interface port-channel 32switch(config-if)#Related Commands
interface sup-fc
To configure Fibre Channel interface on the supervisor module on the Cisco MDS 9000 Family of switches, use the interface sup-fc command.
interface sup-fc number exit | no
Syntax Description
interface
Selects an interface to configure.
sup-fc
Inband Interface
number
Inband interface number.
exit
Exit from submode
no
Negate a command or set its defaults
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example configures the Fibre Channel interface on the supervisor module.
switch(config)# interface sup-fc 0switch(config-if)#Related Commands
interface vsan
To configure a VSAN interface on the Cisco MDS 9000 Family of switches, use the interface vsan command.
interface vsan vsan-id exit [ip | no ip] no | shutdown | [vrrp | no vrrp vr_id]
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example configures a VSAN interface.
switch(config)# interface vsan 1switch(config-if)#Related Commands
ip default-gateway
To configure the IP address of the default gateway, use the ip default-gateway command. To disable the IP address of the default gateway, use the no form of the command.
ip default-gateway destination-ip-address
no ip default-gateway destination-ip-address
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following examples configures the IP default gateway to 1.1.1.4.
switch## config tswitch(config)##switch(config)# ip default-gateway 1.1.1.4switch(config)#Related Commands
ip default-network
To configure the IP address of the default network, use the ip default-network command in configuration mode. To disable the IP address of the default network, use the no form of the command.
ip default-network ip-address
no ip default-network ip-address
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following examples configures the IP address of the default network to 1.1.1.4.
switch## config tswitch(config)##switch(config)# ip default-network 1.1.1.4switch(config)#ip domain-list
To configure the IP domain list, use the ip domain-list command in configuration mode. To disable the IP domain list, use the no form of the command.
ip domain-list domain-name
no ip domain-list domain-name
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example configures the IP domain list.
switch## config tswitch(config)##switch(config)# ip domain domain nameswitch(config)#ip domain-lookup
To enable the DNS server lookup feature, use the ip domain-lookup command in configuration mode. Use the no form of this command to disable this feature.
ip domain-lookup
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
Instead of IP addresses, you can configure the switch using meaningful names. The configured name automatically looks up the corresponding IP address.
Examples
The following example configures a DNS server domain name.
switch## config tswitch(config)##switch(config)# ip domain-lookupswitch(config)#ip domain-name
To configure a domain name, use the ip domain-name command in configuration mode.
ip domain-name domain name
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example configures a domain name.
switch## config tswitch(config)##switch(config)# ip domain-name domain nameswitch(config)#ip name-server
To configure a name server, use the ip name-server command in configuration mode.
ip name-server ip-address
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
You can configure a maximum of six servers. By default, no server is configured.
Examples
The following example configure a name server with an IP address of 1.1.1.4.
switch## config tswitch(config)# ip name-server 1.1.1.4The following example specifies the first address (15.1.0.1) as the primary server and the second address (15.2.0.0) as the secondary sever.
switch(config)# ip name-server 15.1.0.1 15.2.0.0The following example deletes the configured server(s) and reverts to factory default.
switch(config)# no ip name-serverip route
To configure a static route, use the ip route command in configuration mode.
ip route ip-address subnet-mask [nexthop_ip-address] [ interface (mgmt 0 | vsan number) ] [distance distance-number]
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following examples shows how to configure a static route.
switch## config tswitch(config)##switch(config)# IP route 10.0.0.0 255.0.0.0 20.20.20.10 distance 10 interface vsan 1switch(config)#Related Commands
ip routing
To enable the IP forwarding feature, use the ip routing command in configuration mode.
ip routing
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example enables the IP forwarding feature.
switch## config tswitch(config)##switch(config)# ip routingswitch(config)#