Feedback
Table Of Contents
copy running-config startup-config
Basic System Commands
This chapter describes the basic Cisco NX-OS system commands available on Cisco Nexus 5000 Series switches. These commands allow you to navigate and control the switch.
banner motd
To configure the message-of-the-day (MOTD) banner that displays when the user logs in to a Cisco Nexus 5000 Series switch, use the banner motd command. To revert to the default, use the no form of this command.
banner motd delimiter message delimiter
no banner motd
Syntax Description
Command Default
"Nexus 5000 Switch" is the default MOTD string.
Command Modes
Interface configuration mode
Command History
Usage Guidelines
To create a multiple-line MOTD banner, press Enter before typing the delimiting character to start a new line. You can enter up to 40 lines of text.
Examples
This example shows how to configure a single-line MOTD banner:
switch(config)# banner motd #Unauthorized access to this device is prohibited!#This example shows how to configure a multiple-line MOTD banner:
switch(config)# banner motd #Welcome Authorized Users > Unauthorized access prohibited!#This example shows how to revert to the default MOTD banner:
switch(config)# no banner motdRelated Commands
boot
To configure the boot variable for the Cisco Nexus 5000 Series kickstart or system software image, use the boot command. To clear the boot variable, use the no form of this command.
boot {kickstart | system} [bootflash:] [//server/] [directory] filename
no boot {kickstart | system}
Syntax Description
Note
There can be no spaces in the bootflash://server/directory/filename string. Individual elements of this string are separated by colons (:) and slashes (/).
Command Default
None
Command Modes
Interface configuration mode
Command History
Usage Guidelines
The Cisco NX-OS software uses the boot variable for loading images when booting up. You must copy the correct image to the switch before you reload.
Examples
This example shows how to configure the system boot variable:
switch(config)# boot system bootflash:n5000.binThis example shows how to configure the kickstart boot variable:
switch(config)# boot kickstart bootflash:n5000-kickstart.binThis example shows how to clear the system boot variable:
switch(config)# no boot systemThis example shows how to clear the kickstart boot variable:
switch(config)# no boot kickstartRelated Commands
cd
To change the current working directory in the device file system, use the cd command.
cd [filesystem:] [//server/] directory
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Use the pwd command to verify the current working directory.
Examples
This example shows how to change the current working directory on the current file system:
switch# cd my-scriptsThis example shows how to change the current working directory to another file system:
switch# cd volatile:Related Commands
clear cli history
To clear the command history, use the clear cli history command.
clear cli history
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Use the show cli history command to display the history of the commands that you entered at the command-line interface (CLI).
Examples
This example shows how to clear the command history:
switch# clear cli historyRelated Commands
clear cores
To clear the core files, use the clear cores command.
clear cores
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Use the show system cores command to display information about the core files.
Examples
This example shows how to clear the core file:
switch# clear coresRelated Commands
show system cores
Displays the core filename.
system cores
Configures the core filename.
clear debug-logfile
To clear the contents of the debug log file, use the clear debug-logfile command.
clear debug-logfile filename
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to clear the debug log file:
switch# clear debug-logfile syslogd_debugsRelated Commands
debug logfile
Configures a debug log file.
debug logging
Enables debug logging.
show debug logfile
Displays the contents of the debug log file.
clear install failure-reason
To clear the reason for software installation failures, use the clear install failure-reason command.
clear install failure-reason
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to clear the reason for software installation failures:
switch# clear install failure-reasonRelated Commands
clear license
To uninstall a license, use the clear license command.
clear license filename
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to clear a specific license:
switch# clear license fm.licRelated Commands
clear user
To log out a particular user, use the clear user command.
clear user username
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to log out a specific user:
switch# clear user adminRelated Commands
cli var name
To define a command-line interface (CLI) variable for a terminal session, use the cli var name command. To remove the CLI variable, use the no form of this command.
cli var name variable-name variable-text
no cli var name variable-name
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
You can reference a CLI variable using the following syntax:
$(variable-name)Instances where you can use variables include the following:
•
•
You cannot reference a variable in the definition of another variable.
The Cisco NX-OS software provides a predefined variable, TIMESTAMP, that you can use to insert the time of day. You cannot change or remove the TIMESTAMP CLI variable.
You cannot change the definition of a CLI variable. You must remove the variable and then create it again with the new definition.
Examples
This example shows how to define a CLI variable:
switch# cli var name testvar interface ethernet 1/3This example shows how to reference a CLI variable:
switch# show $(testvar)This example shows how to reference the TIMESTAMP variable:
switch# copy running-config > bootflash:run-config-$(TIMESTAMP).cnfgThis example shows how to remove a CLI variable:
switch# cli no var name testvarRelated Commands
clock set
To manually set the clock on a Cisco Nexus 5000 Series switch, use the clock set command.
clock set time day month year
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Use this command when you cannot synchronize the switch with an outside clock source, such as an NTP server.
Examples
This example shows how to manually configure the clock:
switch# clock set 12:00:00 04 July 2008Related Commands
clock summer-time
To configure the summer-time (daylight saving time) offset, use the clock summer-time command. To revert to the default, use the no form of this command.
clock summer-time zone-name start-week start-day start-month start-time end-week end-day end-month end-time offset-minutes
no clock summer-time
Syntax Description
Command Default
None
Command Modes
Interface configuration mode
Command History
Usage Guidelines
None.
Examples
This example shows how to configure the offset for summer-time or daylight saving time:
switch(config)# clock summer-time PDT 1 Sunday March 02:00 5 Sunday November 02:00 60This example shows how to revert to the default offset for summer-time:
switch(config)# no clock summer-timeRelated Commands
clock timezone
To configure the time zone offset from Coordinated Universal Time (UTC), use the clock timezone command. To revert to the default, use the no form of this command.
clock timezone zone-name offset-hours offset-minutes
no clock timezone
Syntax Description
Command Default
None
Command Modes
Interface configuration mode
Command History
Usage Guidelines
Use the command to offset the device clock from UTC.
Examples
This example shows how to configure the time zone offset from UTC:
switch(config)# clock timezone PST -8 0This example shows how to revert the time zone offset to the default:
switch# no clock timezoneRelated Commands
configure session
To create or modify a configuration session, use the configure session command.
configure session name
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to create a configuration session:
switch# configure session MySession switch(config-s)#Related Commands
show configuration session
Displays information about the configuration sessions.
configure terminal
To enter configuration mode, use the configure terminal command.
configure terminal
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Use this command to enter configuration mode. Commands in this mode are written to the running configuration file as soon as you enter them (using the Enter key/Carriage Return).
After you enter the configure terminal command, the system prompt changes from switch# to switch(config)#, indicating that the router is in configuration mode. To leave configuration mode and return to EXEC mode, type end or press Ctrl-Z.
To view the changes to the configuration that you have made, use the show running-config command.
Examples
This example shows how to enter configuration mode:
switch# configure terminal switch(config)#Related Commands
copy
To copy any file from a source to a destination, use the copy command.
copy source-url destination-url
Syntax Description
The format of the source and destination URLs varies according to the file or directory location. You can enter either a command-line interface (CLI) variable for a directory or a filename that follows the Cisco NX-OS file system syntax (filesystem:[/directory][/filename]).
The following tables list URL prefix keywords by the file system type. If you do not specify a URL prefix keyword, the router looks for a file in the current directory.
Table 1-1 lists URL prefix keywords for local writable storage file systems. Table 1-2 lists the URL prefix keywords for remote file systems. Table 1-3 lists the URL prefix keywords for nonwritable file systems.
Command Default
The default name for the destination file is the source filename.
Command Modes
EXEC mode
Command History
Usage Guidelines
The copy command allows you to copy a file (such as a system image or configuration file) from one location to another location. The source and destination for the file is specified using a Cisco NX-OS file system URL, which allows you to specify a local or remote file location. The file system being used (such as a local memory source or a remote server) determines the syntax used in the command.
You can enter on the command line all necessary source- and destination-URL information and the username to use, or you can enter the copy command and have the CLI prompt you for any missing information.
The entire copying process may take several minutes, depending on the network conditions and the size of the file, and differs from protocol to protocol and from network to network.
The colon character (:) is required after the file system URL prefix keywords (such as bootflash).
In the URL syntax for ftp:, scp:, sftp:, and tftp:, the server is either an IPv4 address or a host name.
This section contains usage guidelines for the following topics:
•
•
•
•
Copying Files from a Server to Bootflash Memory
Use the copy source-url bootflash: command (for example, copy tftp:source-url bootflash:) to copy an image from a server to the local bootflash memory.
Copying a Configuration File from a Server to the Running Configuration
Use the copy {ftp: | scp: | sftp: | tftp:}source-url running-config command to download a configuration file from a network server to the running configuration of the device. The configuration is added to the running configuration as if the commands were typed in the CLI. The resulting configuration file is a combination of the previous running configuration and the downloaded configuration file. The downloaded configuration file having precedence over the previous running configuration.
You can copy either a host configuration file or a network configuration file. Accept the default value of host to copy and load a host configuration file containing commands that apply to one network server in particular. Enter network to copy and load a network configuration file that contains commands that apply to all network servers on a network.
Copying a Configuration File from a Server to the Startup Configuration
Use the copy {ftp: | scp: | sftp: | tftp:}source-url startup-config command to copy a configuration file from a network server to the router startup configuration. These commands replace the startup configuration file with the copied configuration file.
Copying the Running or Startup Configuration on a Server
Use the copy running-config {ftp: | scp: | sftp: | tftp:}destination-url command to copy the current configuration file to a network server that uses FTP, scp, SFTP, or TFTP. Use the copy startup-config {ftp: | scp: | stfp: | tftp:}destination-url command to copy the startup configuration file to a network server.
You can use the copied configuration file copy as a backup.
Examples
This example shows how to copy a file within the same directory:
switch# copy file1 file2This example shows how to copy a file to another directory:
switch# copy file1 my-scripts/file2This example shows how to copy a file to another file system:
switch# copy file1 bootflash:This example shows how to copy a file to another supervisor module:
switch# copy file1 bootflash://sup-1/file1.bakThis example shows how to copy a file from a remote server:
switch# copy scp://10.10.1.1/image-file.bin bootflash:image-file.binRelated Commands
copy running-config startup-config
To save the running configuration to the startup configuration file so that all current configuration details are available after a reboot, use the copy running-config startup-config command. Once this command is entered, the running and the startup copies of the configuration are identical.
copy running-config startup-config
Syntax Description
This command has no additional arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
To view the changes to the configuration that you have made, use the show startup-config command.
Examples
The following example shows saving the running configuration to the startup configuration:
switch# copy running-config startup-configRelated Commands
show running-config
Displays the currently running configuration.
show startup-config
Displays the startup configuration file.
databits
To configure the number of data bits in a character for the terminal port, use the databits command. To revert to the default, use the no form of this command.
databits bits
no databits bits
Syntax Description
Command Default
8 bits
Command Modes
Terminal line configuration
Command History
Usage Guidelines
You can configure the console port only from a session on the console port.
Examples
This example shows how to configure the number of data bits for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# databits 7This example shows how to revert to the default number of data bits for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# no databits 7Related Commands
debug logfile
To direct the output of the debug commands to a specified file, use the debug logfile command. To revert to the default, use the no form of this command.
debug logfile filename [size bytes]
no debug logfile filename [size bytes]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
The Cisco NX-OS software creates the logfile in the log: file system root directory. Use the dir log: command to display the log files.
Examples
This example shows how to specify a debug log file:
switch# debug logfile debug_logThis example shows how to revert to the default debug log file:
switch# no debug logfile debug_logRelated Commands
dir
Displays the contents of a directory.
show debug logfile
Displays the debug logfile contents.
debug logging
To enable debug command output logging, use the debug logging command. To disable debug logging, use the no form of this command.
debug logging
no debug logging
Syntax Description
This command has no arguments or keywords.
Command Default
Disabled.
Command Modes
EXEC mode
Command History
Examples
This example shows how to enable the output logging for the debug command:
switch# debug loggingThis example shows how to disable the output logging for the debug command:
switch# no debug loggingRelated Commands
delete
To delete a file or directory, use the delete command.
delete [filesystem:] [//server/] [directory] filename
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Use the dir command to locate the file you that want to delete.
The delete command will delete a directory and its contents. Exercise caution when using this command to delete directories.
Examples
This example shows how to delete a file:
switch# delete bootflash:old_config.cfgThis example shows how to delete a directory:
switch# delete my_dir This is a directory. Do you want to continue (y/n)? [y] yRelated Commands
dir
Displays the contents of a directory.
save
Saves the configuration session to a file.
dir
To display the contents of a directory, use the dir command.
dir [filesystem:] [//server/] [directory]
Syntax Description
Note
Command Default
Displays the contents of the current working directory.
Command Modes
EXEC mode
Command History
Usage Guidelines
The dir command displays a listing of the files in the specified directory. For each file, it lists the size of the file in bytes, the last modified time of the file, and the filename of the file. This command then displays the usage statistics for the file system.
Use the pwd command to verify the current working directory.
Use the cd command to change the current working directory.
Examples
This example shows how to display the contents of the root directory in bootflash:
switch# dir bootflash:This example shows how to display the contents of the current working directory:
switch# dirRelated Commands
cd
Changes the current working directory.
delete
Deletes a file or directory.
pwd
Displays the name of the current working directory.
rmdir
Deletes a directory.
echo
To display a text string on the terminal, use the echo command.
echo [text]
Syntax Description
Command Default
Blank line.
Command Modes
EXEC mode
Command History
Usage Guidelines
You can use this command in a command script to display status information or prompts while the script is running.
Examples
This example shows how to display a blank line at the command prompt:
switch# echoThis example shows how to display a line of text at the command prompt:
switch# echo Script run at $(TIMESTAMP).Related Commands
end
To end the current configuration session and return to EXEC mode, use the end command in configuration mode.
end
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Configuration mode
Command History
Usage Guidelines
This command returns you to EXEC mode regardless of which configuration mode you are in. Use this command when you are done configuring the system and you want to return to EXEC mode to perform verification steps.
Examples
In the following example, the end command is used to exit from interface configuration mode and return to EXEC mode. A show command is used to verify the configuration.
switch# configure terminal switch(config)# interface ethernet 1/1 switch(config-if)# switchport host switch(config-if)# end switch# show interface ethernet 1/1Related Commands
exit (EXEC)
Terminates the active terminal session by logging off the router.
exit (global)
Exits from the current configuration mode.
exec-timeout
To configure the inactive session timeout on the console port or the virtual terminal, use the exec-timeout command. To revert to the default, use the no form of this command.
exec-timeout minutes
no exec-timeout
Syntax Description
minutes
Number of minutes. The range is from 0 to 525600. A setting of 0 minutes disables the timeout.
Command Default
Timeout is disabled.
Command Modes
Terminal line configuration
Command History
Usage Guidelines
You can configure the console port only from a session on the console port.
Examples
This example shows how to configure the inactive session timeout for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# exec-timeout 30This example shows how to revert to the default inactive session timeout for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# no exec-timeoutThis example shows how to configure the inactive session timeout for the virtual terminal:
switch# configure terminal switch(config)# line vty switch(config-line)# exec-timeout 30This example shows how to revert to the default inactive session timeout for the virtual terminal:
switch# configure terminal switch(config)# line vty switch(config-line)# no exec-timeoutRelated Commands
line console
Enters the console terminal configuration mode.
line vty
Enters the virtual terminal configuration mode.
show running-config
Displays the running configuration.
exit (EXEC)
To close an active terminal session by logging off the switch, use the exit command.
exit
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
In the following example, the exit (global) command is used to move from configuration mode to EXEC mode and the exit (EXEC) command is used to log off (exit the active session):
switch(config)# exit switch# exitRelated Commands
end
Ends your configuration session by exiting to EXEC mode.
exit (global)
Exits from the current configuration mode to the next highest configuration mode.
exit (global)
To exit any configuration mode to the next highest mode in the CLI mode hierarchy, use the exit command in any configuration mode.
exit
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
All configuration modes
Command History
Usage Guidelines
Use the exit command in configuration mode to return to EXEC mode. Use the exit command in interface, VLAN, or zone configuration mode to return to configuration mode. At the highest level, EXEC mode, the exit command will exit the EXEC mode and disconnect from the switch (see the description of the exit (EXEC) command for details).
Examples
The following example shows how to exit from the interface configuration mode and to return to the configuration mode:
switch(config-if)# exit switch(config)#Related Commands
end
Ends your configuration session by exiting to privileged EXEC mode.
exit (EXEC)
Terminates the active terminal session by logging off the router.
feature fcoe
To enable virtual and native Fibre Channel interfaces after installing the FC_FEATURES_PKG license, use the feature fcoe command. To disable Fibre Channel interfaces and return the FC_FEATURES_PKG license to the license manager software, use the no form of the command.
feature fcoe
no feature fcoe
Syntax Description
This command has no arguments or keywords.
Command Default
FCoE is disabled.
Command Modes
Configuration mode
Command History
Usage Guidelines
You must save the configuration, and then reboot the switch to enable or disable the FCoE feature.
Examples
This example shows how to enable FCoE on the switch:
switch(config)# feature fcoeRelated Commands
feature interface-vlan
To enable the creation of VLAN interfaces, use the feature interface-vlan command. To disable the VLAN interface feature, use the no form of this command.
feature interface-vlan
no feature interface-vlan
Syntax Description
This command has no arguments or keywords.
Command Default
VLAN interfaces are disabled.
Command Modes
Configuration mode
Command History
Usage Guidelines
You must use the feature interface-vlan or the svi enable command before you can create VLAN interfaces.
Examples
This example shows how to enable the interface VLAN feature on the switch:
switch(config)# feature interface-vlanRelated Commands
feature lacp
To enable Link Aggregation Control Protocol (LACP), which bundles a number of physical ports together to form a single logical channel, use the feature lacp command. To disable LACP on the switch, use the no form of this command.
feature lacp
no feature lacp
Syntax Description
This command has no arguments or keywords.
Command Default
LACP is disabled.
Command Modes
Configuration mode
Command History
Usage Guidelines
You must remove all the LACP configuration parameters from all EtherChannels on the switch before you can disable LACP.
Even after you enable LACP globally, you do not have to run LACP on all EtherChannels on the switch. You enable LACP on each channel mode using the channel-group mode command.
Examples
This example shows how to enable LACP EtherChannels on the switch:
switch(config)# feature lacpRelated Commands
feature lldp
The Link Layer Discovery Protocol (LLDP), which is a neighbor discovery protocol that is used for network devices to advertise information about themselves to other devices on the network, is enabled on the switch by default.
Command Default
Enabled
Command History
Usage Guidelines
You cannot enable or disable LLDP on a Cisco Nexus 5000 Series switch. LLDP is enabled on the switch by default. However, the feature lldp command shows as part of the running configuration on the switch.
The Cisco Discovery Protocol (CDP) is a device discovery protocol that runs over Layer 2 (the data link layer) on all Cisco-manufactured devices (routers, bridges, access servers, and switches). CDP allows network management applications to automatically discover and learn about other Cisco devices connected to the network.
To support non-Cisco devices and to allow for interoperability between other devices, the switch supports the Link Layer Discovery Protocol (LLDP). LLDP is a neighbor discovery protocol that is used for network devices to advertise information about themselves to other devices on the network. This protocol runs over the data-link layer, which allows two systems running different network layer protocols to learn about each other.
Related Commands
lldp
Configures the global LLDP options on the switch.
lldp (Interface)
Configures the LLDP feature on an interface.
show feature
Displays that LLDP is enabled on the switch.
feature private-vlan
To enable private VLANs, use the feature private-vlan command. To return to the default settings, use the no form of this command.
feature private-vlan
no feature private-vlan
Syntax Description
None
Command Default
Private VLANs are disabled.
Command Modes
Configuration mode
Command History
Usage Guidelines
The private VLAN commands are not available until you enable the private VLAN feature.
You cannot disable the private VLANs if there are operational ports on the switch that are in private VLAN mode.
Note
Examples
This example shows how to enable private VLAN functionality on the switch:
switch(config)# feature private-vlanRelated Commands
feature tacacs+
To enable TACACS+, use the feature tacacs+ command. To disable TACACS+, use the no form of this command.
feature tacacs+
no feature tacacs+
Syntax Description
This command has no arguments or keywords.
Command Default
Disabled.
Command Modes
Configuration mode
Command History
Usage Guidelines
You must use the feature tacacs+ command before you configure TACACS+.
Note
Examples
This example shows how to enable TACACS+:
switch(config)# feature tacacs+This example shows how to disable TACACS+:
switch(config)# no feature tacacs+Related Commands
feature udld
To enable the Cisco-proprietary Unidirectional Link Detection (UDLD) protocol), which allows ports that are connected through fiber optics or copper Ethernet cables to monitor the physical configuration of the cables and detect when a unidirectional link exists, use the feature udld command. To disable UDLD on the switch, use the no form of this command.
feature udld
no feature udld
Syntax Description
This command has no arguments or keywords.
Command Default
UDLD is disabled.
Command Modes
Configuration mode
Command History
Usage Guidelines
This example shows how to enable UDLD on the switch:
switch(config)# feature udldRelated Commands
find
To find filenames beginning with a character string, use the find command.
find filename-prefix
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
The find command searches all subdirectories under the current working directory. You can use the cd and pwd commands to navigate to the starting directory.
Examples
This example shows how to display filenames beginning with "n5000":
switch# find n5000Related Commands
cd
Changes the current working directory.
pwd
Displays the name of the current working directory.
format
To format the bootflash device, which erases its contents and restores it to its factory-shipped state, use the format command.
format bootflash:
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to format the bootflash device:
switch# format bootflash:Related Commands
cd
Changes the current working directory.
dir
Displays the directory contents.
pwd
Displays the name of the current working directory.
gunzip
To uncompress a compressed file, use the gunzip command.
gunzip [filesystem:] [//server/] [directory] filename
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
The compressed filename must have the .gz extension.
The Cisco NX-OS software uses Lempel-Ziv 1977 (LZ77) coding for compression.
Examples
This example shows how to uncompress a compressed file:
switch# gunzip run_cnfg.cfg.gzRelated Commands
gzip
To compress a file, use the gzip command.
gzip [filesystem:] [//server/] [directory] filename
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
After you run this command, the named file is replaced with a compressed file that has the .gz extension added to its filename.
The Cisco NX-OS software uses Lempel-Ziv 1977 (LZ77) coding for compression.
Examples
This example shows how to compress a file:
switch# gzip run_cnfg.cfgRelated Commands
hostname
To configure the hostname for the switch, use the hostname command. To revert to the default, use the no form of this command.
hostname name
no hostname
Syntax Description
name
Hostname for the switch. The name is alphanumeric, case sensitive, can contain special characters, and can have a maximum of 32 characters.
Command Default
"switch" is the default hostname.
Command Modes
EXEC mode
Command History
Usage Guidelines
The Cisco NX-OS software uses the hostname in command-line interface (CLI) prompts and in default configuration filenames.
The hostname command performs the same function as the switchname command.
Examples
This example shows how to configure the hostname for a Cisco Nexus 5000 Series switch:
switch# configure terminal switch(config)# hostname Engineering2 Engineering2(config)#This example shows how to revert to the default hostname:
Engineering2# configure terminal Engineering2(config)# no hostname switch(config)#Related Commands
show hostname
Displays the switch hostname.
show switchname
Displays the switch hostname.
Configures the switch hostname.
install all
To install the kickstart and system images on a Cisco Nexus 5000 Series switch, use the install all command.
install all [kickstart kickstart-url] [system system-url]
Syntax Description
The format of the kickstart and system URLs varies according to the file system, directory, and file location.
The following tables list URL prefix keywords by the file system type. If you do not specify a URL prefix keyword, the router looks for a file in the current directory.
Table 1-4 lists URL prefix keywords for local writable storage file systems. Table 1-5 lists the URL prefix keywords for remote file systems. For remote file systems, if it is not otherwise specified, the path is the default for the user on the remote server.
Command Default
If you do not enter any parameters, the boot variable values are used.
Command Modes
EXEC mode
Command History
Usage Guidelines
If you do not enter the information about the server or username when downloading and installing the image files from a remote server, you are prompted for the information.
This command sets the kickstart and system boot variables and copies the image files to the redundant supervisor module.
The install all command upgrades the switch software and also upgrades the Fabric Extender software of all attached chassis. The Fabric Extender remains online passing traffic while the software is copied. Once the software images have successfully been installed, the parent switch and the Fabric Extender chassis are rebooted automatically. This is done to maintain the software version compatibility between parent switch and the Fabric Extender.
You can use install all command to downgrade the Cisco NX-OS software on the switch. To determine if the downgrade software is compatible with the current configuration on the switch, use the show incompatibility system command and resolve any configuration incompatibilities.
Examples
This example shows how to install the Cisco NX-OS software from the bootflash: directory:
switch# install all kickstart bootflash:nx-os_kick.bin system bootflash:nx-os_sys.binThis example shows how to install the Cisco NX-OS software using the values configured in the kickstart and system boot variables:
switch# configure terminal switch(config)# boot kickstart bootflash:nx-os_kick.bin switch(config)# boot system bootflash:nx-os_sys.bin switch(config)# exit switch# copy running-config startup-config switch# install allThis example shows how to install the Cisco NX-OS software from an SCP server:
switch# install all kickstart scp://adminuser@10.10.1.1/nx-os_kick.bin system bootflash:scp://adminuser@10.10.1.1/nx-os_sys.binRelated Commands
install license
To install a license, use the install license command.
install license [filesystem:] [//server/] [directory] src-filename [target-filename]
Syntax Description
Note
Command Default
All licenses for the Cisco Nexus 5000 Series switches are factory installed. Manual installation is not required.
Command Modes
EXEC mode
Command History
Usage Guidelines
If a target filename is provided after the source location, the license file is installed with that name. Otherwise, the filename in the source URL is used. This command also verifies the license file before installing it.
Examples
This example shows how to install a file named license-file that resides in the bootflash: directory:
switch# install license bootflash:license-fileRelated Commands
line console
To specify the console port and enter console port configuration mode, use the line console command.
line console
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Interface configuration mode
Command History
Usage Guidelines
You can configure the console line only from a console port session.
Examples
This example shows how to enter console port configuration mode:
switch# configure terminal switch(config)# line console switch(config-console)#Related Commands
line vty
To specify the virtual terminal and enter line configuration mode, use the line vty command.
line vty
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
Interface configuration mode
Command History
Examples
This example shows how to enter console port configuration mode:
switch# configure terminal switch(config)# line vty switch(config-line)#Related Commands
modem in
To enable the modem connection on the console port, use the modem in command. To disable the modem connection, use the no form of this command.
modem in
no modem in
Syntax Description
This command has no arguments or keywords.
Command Default
Timeout is disabled.
Command Modes
Terminal line configuration
Command History
Usage Guidelines
You can configure the console port only from a session on the console port.
Examples
This example shows how to enable a modem connection on the console port:
switch# configure terminal switch(config)# line console switch(config-console)# modem inThis example shows how to disable a modem connection on the console port:
switch# configure terminal switch(config)# line console switch(config-console)# no modem inRelated Commands
line console
Enters console port configuration mode.
show line
Displays information about the console port configuration.
modem init-string
To download the initialization string to a modem connected to the console port, use the modem init-string command. To revert to the default, use the no form of this command.
modem init-string {default | user-input}
no modem init-string
Syntax Description
default
Downloads the default initialization string.
user-input
Downloads the user-input initialization string.
Command Default
The default initialization string is ATE0Q1&D2&C1S0=1\015.
Command Modes
Terminal line configuration
Command History
Usage Guidelines
You can configure the console port only from a session on the console port.
The default initialization string ATE0Q1&D2&C1S0=1\015 is defined as follows:
•
•
•
•
•
•
•
Use the modem set-string command to configure the user-input initialization string.
Examples
This example shows how to download the default initialization string to the modem connected to the console port:
switch# configure terminal switch(config)# line console switch(config-console)# modem init-string defaultThis example shows how to download the user-input initialization string to the modem connected to the console port:
switch# configure terminal switch(config)# line console switch(config-console)# modem init-string user-inputThis example shows how to remove the initialization string to the modem connected to the console port:
switch# configure terminal switch(config)# line console switch(config-console)# no modem init-stringRelated Commands
modem set-string user-input
To configure the user-input initialization string to download to a modem connected to the console port, use the modem set-string user-input command. To revert to the default, use the no form of this command.
modem set-string user-input string
no modem set-string
Syntax Description
string
User-input string. This string is alphanumeric and case sensitive, can contain special characters, and has a maximum of 100 characters.
Command Default
None
Command Modes
Terminal line configuration
Command History
Usage Guidelines
You can configure the console port only from a session on the console port.
Examples
This example shows how to configure the user-input initialization string for the modem connected to the console port:
switch# configure terminal switch(config)# line console switch(config-console)# modem init-string user-input ATE0Q1&D2&C1S0=3\015This example shows how to revert to the default user-input initialization string for the modem connected to the console port:
switch# configure terminal switch(config)# line console switch(config-console)# no modem set-stringRelated Commands
move
To move a file from one directory to another, use the move command.
move {[filesystem:] [//server/] [directory] source-filename} [filesystem:] [//server/] [directory] [destination-filename]
Syntax Description
Command Default
The default filename for the destination file is the same as the source file.
Command Modes
EXEC mode
Command History
Usage Guidelines
You can make a copy of a file by using the copy command.
Tip
Examples
This example shows how to move a file to another directory:
switch# move file1 my_files/file2This example shows how to move a file to another file system:
switch# move file1 volatile:This example shows how to move a file to another supervisor module:
switch# move file1 bootflash://sup-1/file1.bakRelated Commands
parity
To configure the parity for the console port, use the parity command. To revert to the default, use the no form of this command.
parity {even | none | odd}
no parity {even | none | odd}
Syntax Description
Command Default
The none keyword is the default.
Command Modes
Terminal line configuration
Command History
Usage Guidelines
You can configure the console port only from a session on the console port.
Examples
This example shows how to configure the parity for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# parity evenThis example shows how to revert to the default parity for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# no parity evenRelated Commands
ping
To determine the network connectivity to another network device, use the ping command.
ping {dest-address | hostname} [count {number | unlimited}] [df-bit] [interval seconds] [packet-size bytes] [source src-address] [timeout seconds] [vrf {vrf-name | default | management}]
Syntax Description
Command Default
For the default values, see the "Syntax Description" section for this command.
Command Modes
EXEC mode
Command History
Examples
This example shows how to determine connectivity to another network device:
switch# ping 172.28.231.246Related Commands
ping6
Determines connectivity to another device using IPv6 addressing.
traceroute
Displays the routes that packets take when traveling to an IP address.
ping6
To determine the network connectivity to another device using IPv6 addressing, use the ping6 command.
ping6 {dest-address | hostname} [count {number | unlimited}] [interface intf-id] [interval seconds] [packet-size bytes] [source address] [timeout seconds] [vrf {vrf-name | default | management}]
Syntax Description
Command Default
For the default values, see the "Syntax Description" section for this command.
Command Modes
EXEC mode
Command History
Examples
This example shows how to determine connectivity to another device using IPv6 addressing:
switch# ping6 2001:0DB8::200C:417A vrf managementRelated Commands
ping
Determines connectivity to another device using IPv4 addressing.
traceroute6
Displays the routes that packets take when traveling to an IPv6 address.
reload
To reload the switch and all attached Fabric Extender chassis or a specific Fabric Extender, use the reload command.
reload {all | fex chassis_ID}
Syntax Description
all
Reboot the entire Cisco Nexus 5000 Series switch and all attached Fabric Extender chassis.
fex chassis_ID
Reboot a specific Fabric Extender chassis. Chassis ID is 100 to 199.
Command Default
Reloads the Cisco Nexus 5000 Series switch.
Command Modes
EXEC mode
Command History
4.0(0)N1(1a)
This command was introduced.
4.0(1a)N2(1)
Support for the Cisco Nexus 2000 Series Fabric Extender was added.
Usage Guidelines
The reload command disrupts traffic on the switch and Fabric Extender.
Note
Examples
This example shows how to reload the Cisco Nexus 5000 Series switch:
switch# copy running-config startup-config switch# reload This command will reboot the system. (y/n)? [n] yThis example shows how to reload a Fabric Extender:
switch# reload fex 101 WARNING: This command will reboot FEX 101Do you want to continue? (y/n) [n] yRelated Commands
copy running-config startup-config
Copies the current running configuration to the startup configuration.
show version
Displays information about the software version.
rmdir
To remove a directory, use the rmdir command.
rmdir [filesystem: [//server/]] directory
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to remove a directory:
switch# rmdir my_filesRelated Commands
cd
Changes the current working directory.
delete
Deletes a file or directory.
dir
Displays the directory contents.
pwd
Displays the name of the current working directory.
run-script
To run a command script file at the command-line interface (CLI), use the run-script command.
run-script [filesystem:[//module/]][directory/]filename
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
You must create the command file on a remote device and download it to the Cisco Nexus 5000 Series switch using the copy command.
Examples
This example shows how to run a command script file:
switch# run-script script-fileRelated Commands
save
To save the current configuration session to a file, use the save command.
save location
Syntax Description
location
Location of the file. The location can be in bootflash or volatile. The file name can be any alphanumeric string up to 63 characters.
Command Default
None
Command Modes
Session configuration mode
Command History
Examples
This example shows how to save a configuration session to a file in bootflash:
switch# configure session MySession switch(config-s)# save bootflash:sessions/MySessionRelated Commands
configure session
Creates or modifies a configuration session.
delete
Deletes a file from a location.
send
To send a message to the active user sessions, use the send command.
send [session line] text
Syntax Description
session line
(Optional) Specifies a user session.
text
Text string. The text string can be up to 80 alphanumeric characters and is case sensitive.
Command Default
Sends a message to all active user sessions.
Command Modes
EXEC mode
Command History
Usage Guidelines
You can use the show users command to display information about the active user sessions.
Examples
This example shows how to send a message to all active user sessions on the switch:
switch# send The system will reload in 15 minutes! The system will reload in 15 minutes!This example shows how to send a message to a specific user session:
switch# send session pts/0 You must log off the switch.Related Commands
setup
To enter the basic device setup dialog, use the setup command.
setup [ficon]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
The setup script uses the factory-default values, not the values that you have configured. You can exit the dialog at any point by pressing Ctrl-C.
Examples
This example shows how to enter the basic device setup script:
switch# setupRelated Commands
session-limit
To configure the maximum number of the concurrent virtual terminal sessions on a device, use the session-limit command. To revert to the default, use the no form of this command.
session-limit sessions
no session-limit sessions
Syntax Description
Command Default
32 sessions.
Command Modes
Terminal line configuration
Command History
Examples
This example shows how to configure the maximum number of concurrent virtual terminal sessions:
switch# configure terminal switch(config)# line vty switch(config-line)# session-limit 48This example shows how to revert to the default maximum number of concurrent virtual terminal sessions:
switch# configure terminal switch(config)# line vty switch(config-line)# no session-limit 48Related Commands
line vty
Enters the virtual terminal configuration mode.
show running-config
Displays the running configuration.
show banner motd
To display the message-of-the-day (MOTD) banner, use the show banner motd command.
show banner motd
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the MOTD banner:
switch# show banner motd Unauthorized access is prohibited!Related Commands
show boot
To display the boot variable configuration, use the show boot command.
show boot [variables]
Syntax Description
Command Default
Displays all configured boot variables.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display all configured boot variables:
switch# show bootThis example shows how to display the list of boot variable names:
switch# show boot variablesRelated Commands
show cli alias
To display the command alias configuration, use the show cli alias command.
show cli alias [name alias-name]
Syntax Description
name alias-name
(Optional) Specifies the name of a command alias. The alias name is not case sensitive.
Command Default
Displays all configured command alias variables.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display all configured command aliases:
switch# show cli aliasThis example shows how to display a specific command alias:
switch# show cli alias name ethintRelated Commands
show cli history
To display the command history, use the show cli history command.
show cli history [lines] [unformatted]
Syntax Description
lines
(Optional) Displays the last number of lines from the end of the command history.
unformatted
(Optional) Displays the commands without line numbers or time stamps.
Command Default
Displays the entire formatted history.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display all of the command history:
switch# show cli historyThis example shows how to display the last 10 lines of the command history:
switch# show cli history 10This example shows how to display unformatted command history:
switch# show cli history unformattedRelated Commands
show cli variables
To display the configuration of the CLI variables, use the show cli variables command.
show cli variables
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the CLI variables:
switch# show cli variablesRelated Commands
show clock
To display the current date and time, use the show clock command.
show clock [detail]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the current clock setting:
switch# show clockThis example shows how to display the current clock setting and the summer-time (daylight saving time) configuration:
switch# show clock detailRelated Commands
clock set
Sets the clock time.
clock summer-time
Configures the summer-time (daylight saving time) offset.
show copyright
To display the Cisco NX-OS software copyright information, use the show copyright command.
show copyright
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the Cisco NX-OS copyright information:
switch# show copyrightshow debug logfile
To display the contents of the debug logfile, use the show debug logfile command.
show debug logfile filename
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
The log files are located in the log: file system.
Examples
This example shows how to display the contents of a debug log file:
switch# show debug logfile dmesgRelated Commands...
show environment
To display information about the hardware environment status, use the show environment command.
show environment [fan | power | temperature]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display information about the hardware environment:
switch# show environmentThis example shows how to display information about the power environment:
switch# show environment powershow file
To display the contents of a file on the local memory, use the show file command.
show file [filesystem:] [//server/] [directory] filename
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the contents of a file:
switch# show file ent-mod.licIf the file that you want to display is a directory, the command will return an error message:
switch# show file bootflash:///routing-sw /bin/showfile: /bootflash/routing-sw: Is a directoryRelated Commands
cd
Changes the current working directory.
dir
Displays the directory contents.
pwd
Displays the name of the current working directory.
show hardware internal
To display information about the physical device hardware, use the show hardware internal command.
show hardware internal
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display information about the physical device hardware:
switch# show hardware internalRelated Commands
show inventory
Displays hardware inventory information.
show module
Displays information about the modules.
show hostname
To display the hostname for the switch, use the show hostname command.
show hostname
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
The show switchname command also displays the switch hostname.
Examples
This example shows how to display the hostname for the switch:
switch# show hostnameRelated Commands
Configures the hostname for the switch.
show switchname
Displays the hostname.
Configures the hostname for the switch.
show incompatibility system
To display the configuration incompatibilities between the running system image and an earlier system image prior to downgrading the Cisco NX-OS software, use the show incompatibility system command.
show incompatibility system {filesystem: //server/ [directory] filename}
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the configuration incompatibilities:
switch# show incompatibility system bootflash://sup-local/old_image.binRelated Commands
install all
Installs the kickstart and system images.
reload
Reloads the device with new Cisco NX-OS software.
show version
Displays information about the software version.
show install all
To display information related to the operation of the install all command, use the show install all command.
show install all {failure-reason | impact [kickstart | system] | status}
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the installation failure reason:
switch# show install all failure-reasonThis example shows how to display the impact of installing new images:
switch# show install all impactThis example shows how to display the status of the software installation process:
switch# show install all statusRelated Commands
install all
Installs the software on the physical device.
show boot
Displays the boot variable configuration.
show inventory
To display the physical inventory information for the switch hardware, use the show inventory command.
show inventory [fex chassis_ID]
Syntax Description
Command Default
Displays all hardware inventory information.
Command Modes
EXEC mode
Command History
4.0(0)N1(1a)
This command was introduced.
4.0(1a)N2(1)
This command was modified to provide Fabric Extender support.
Examples
This example shows how to display the switch hardware inventory information:
switch# show inventoryThis example shows how to display the hardware inventory information for an attached Fabric Extender:
switch# show inventory fex 101Related Commands
show hardware internal
Displays information about the physical hardware.
show module
Displays information about the modules.
show license
To display license information, use the show license command.
show license [brief | file filename]
Syntax Description
brief
(Optional) Displays a list of license files installed on a device.
file filename
(Optional) Displays information for a specific license file.
Command Default
Displays information about the installed licenses.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display a specific license installed on the switch:
switch# show license file fc5020.licThis example shows how to display a list of license files installed on a device:
switch# show license briefThis example shows how to display all licenses installed on a device:
switch# show licenseRelated Commands
install license
Installs a license.
show license host-id
Displays the serial number of the chassis to use for licensing.
show license usage
Displays license usage information.
show license host-id
To display the serial number (host ID) of the switch chassis to use for licensing, use the show license host-id command.
show license host-id
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
The serial number is the entire string that appears after the colon (:) as shown in the example.
Examples
This example shows how to display the host ID, required to request node-locked licenses:
switch# show license host-id License hostid: VDH=FLC12300568Related Commands
install license
Installs a license.
show license
Displays license information.
show license usage
Displays license usage information.
show license usage
To display license usage information, use the show license usage command.
show license usage [PACKAGE]
Syntax Description
Command Default
Displays license usage for the switch.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display information about the current license usage:
switch# show license usage Feature Ins Lic Status Expiry Date Comments Count -------------------------------------------------------------------------------- FM_SERVER_PKG No - Unused - ENTERPRISE_PKG Yes - Unused Never - FC_FEATURES_PKG Yes - In use Never - --------------------------------------------------------------------------------Table 1-6 describes the columns used in the show license usage command output.
This example shows how to display a list of features in use for a specific license:
switch# show license usage FC_FEATURES_PKGRelated Commands
install license
Installs a license.
show license
Displays license information.
show license host-id
Displays the serial number of the chassis to use for licensing.
show line
To display terminal port configuration information, use the show line command.
show line [console]
Syntax Description
Command Default
Displays information about the terminal port configuration.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display information about the terminal port configuration information:
switch# show lineThis example shows how to display only the information about the console port configuration:
switch# show line consoleRelated Commands
show module
To display module information, use the show module command.
show module [module-number | fex [chassis_ID | all]]
Syntax Description
Command Default
Displays module information for all modules in the switch chassis.
Command Modes
EXEC mode
Command History
4.0(0)N1(1a)
This command was introduced.
4.0(1a)N2(1)
This command was modified to provide Fabric Extender support.
Examples
This example shows how to display information for all modules in the chassis:
switch# show moduleThis example shows how to display information for a specific module:
switch# show module 2This example shows how to display information about an attached Fabric Extender:
switch# show module fex 101This example shows how to display information about all attached Fabric Extender units:
switch# show module fex allRelated Commands
show hardware internal
Displays information about the physical hardware.
show inventory
Displays hardware inventory information.
show processes
To display the process information for the switch, use the show processes command.
show processes [vdc vdc-number]
Syntax Description
vdc vdc-number
(Optional) Displays process information for a specific virtual device context (VDC). There is only one VDC on a Cisco Nexus 5000 Series switch.
Command Default
Displays information for all processes running on the switch.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the process information for a device:
switch# show processesRelated Commands
show processes cpu
To display the CPU utilization information for processes on the device, use the show processes cpu command.
show processes cpu
Syntax Description
This command has no arguments or keywords.
Command Default
Displays information for all processes in the local device.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the CPU utilization information for the processes:
switch# show processes cpuRelated Commands
show processes log
To display the contents of the process log, use the show processes log command.
show processes log [details | pid process-id]
Syntax Description
Command Default
Displays summary information for all processes on the device.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display summary information from the process log:
switch# show processes logThis example shows how to display detailed information from the process log:
switch# show processes log detailsThis example shows how to display detailed information from the process log for a specific process:
switch# show processes log pid 3632Related Commands
show processes memory
To display the memory allocation information for processes, use the show processes memory command.
show processes memory [shared [detail]]
Syntax Description
shared
(Optional) Displays the shared memory allocation.
detail
(Optional) Displays the shared memory in bytes instead of the default kilobytes.
Command Default
Displays memory allocated to the processes.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display information about memory allocation for processes:
switch# show processes memoryThis example shows how to display information about shared memory allocation for processes:
switch# show processes memory sharedRelated Commands
show running-config
To display the running configuration, use the show running-config command.
show running-config [all]
Syntax Description
Command Default
Displays only the configured information.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the changes that you have made to the running configuration:
switch# show running-configThis example shows how to display the entire running configuration, including the default values:
switch# show running-config allRelated Commands
show running-config diff
To display the differences between the running configuration and the startup configuration, use the show running-config diff command.
show running-config diff
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Table 1-7 describes the notations used in the command output.
Examples
This example shows how to display the difference between the running configuration and the startup configuration:
switch# show running-config diffRelated Commands
show sprom
To display the contents of the serial PROM (SPROM) on the switch, use the show sprom command.
show sprom {all | backplane | fex {chassis_ID {all | backplane | powersupply ps-num} | all} | module module-number | powersupply ps-num | sup}
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
4.0(0)N1(1a)
This command was introduced.
4.0(1a)N2(1)
This command was modified to provide Fabric Extender support.
Usage Guidelines
The SPROM on the switch contains detailed information about the hardware, including serial, part, and revision numbers. If you need to report a problem with a system component, you can extract serial number information using the show sprom command.
Examples
This example shows how to display SPROM information for all components on the physical device:
switch# show sprom allThis example shows how to display SPROM information for the backplane:
switch# show sprom backplaneThis example shows how to display SPROM information for an attached Fabric Extender:
switch# show sprom fex 101Related Commands
show hardware internal
Displays information about the physical hardware.
show inventory
Displays hardware inventory information.
show startup-config
To display the startup configuration, use the show startup-config command.
show startup-config
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the startup configuration:
switch# show startup-configRelated Commands
show switchname
To display the hostname for the device, use the show switchname command.
show switchname
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
The show hostname command also displays the switch hostname.
Examples
This example shows how to display the hostname for the switch:
switch# show switchnameRelated Commands
Configures the hostname for the switch.
show hostname
Displays the hostname.
Configures the hostname for the switch.
show system cores
To display the core filename, use the show system cores command.
show system cores
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Use the system cores command to configure the system core filename.
Examples
This example shows how to display destination information for the system core files:
switch# show system coresRelated Commands
show system reset-reason
To display the reset history for the switch, use the show system reset-reason command.
show system reset-reason [fex chassis_ID]
Syntax Description
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
4.0(0)N1(1a)
This command was introduced.
4.0(1a)N2(1)
This command was modified to provide Fabric Extender support.
Examples
This example shows how to display the reset-reason history for the switch:
switch# show system reset-reasonThis example shows how to display the reset-reason history for an attached Fabric Extender:
switch# show system reset-reason fex 101show system uptime
To display the amount of time since the last system restart, use the show system uptime command.
show system uptime
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the amount of time since the last system restart:
switch# show system uptimeshow tech-support
To display information for Cisco technical support, use the show tech-support command.
show tech-support [brief | commands | feature]
Syntax Description
Command Default
Displays information for all features.
Command Modes
EXEC mode
Command History
Usage Guidelines
The output from the show tech-support command is very long. To better manage this output, you can redirect the output to a file.
Examples
This example shows how to display technical support information:
switch# show tech-supportThis example shows how to redirect the technical support information to a file:
switch# show tech-support > bootflash:TechSupport.txtThis example shows how to display the brief technical support information for the switch:
switch# show tech-support briefThis example shows how to display the technical support information for a specific feature:
switch# show tech-support aaaThis example shows how to display the commands used to generate the technical support information:
switch# show tech-support commandsshow terminal
To display information about the terminal configuration for a session, use the show terminal command.
show terminal
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to display information about the terminal configuration for a session:
switch# show terminalRelated Commands
show version
To display information about the software version, use the show version command.
show version [fex chassis_ID | image filename]
Syntax Description
fex chassis_ID
(Optional) Specifies the Fabric Extender chassis ID. Chassis ID is 100 to 199.
image filename
(Optional) Displays the version information for a system or kickstart image file.
Command Default
Displays software version information for the running kickstart and system images.
Command Modes
EXEC mode
Command History
4.0(0)N1(1a)
This command was introduced.
4.0(1a)N2(1)
This command was modified to provide Fabric Extender support.
Examples
This example shows how to display the version information for the kickstart and system image running on the device:
switch# show versionThis example shows how to display the version information for an image file:
switch# show version image bootflash:old_imageThis example shows how to display the version information for an attached Fabric Extender:
switch# show version fex 101sleep
To cause the command-line interface (CLI) to pause before displaying the prompt, use the sleep command.
sleep seconds
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
You can use this command in command scripts to delay the execution of the script.
Examples
This example shows how to cause the CLI to pause for 5 seconds before displaying the prompt:
switch# sleep 5Related Commands
speed
To configure the transmit and receive speed for the console port, use the speed command. To revert to the default, use the no form of this command.
speed speed
no speed speed
Syntax Description
speed
Speed in bits per second. Valid speeds are 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, or 115200.
Command Default
The default console port speed is 9600 bits per second.
Command Modes
Terminal line configuration
Command History
Usage Guidelines
You can configure the console port only from a session on the console port.
Examples
This example shows how to configure the speed for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# speed 57600This example shows how to revert to the default speed for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# no speed 57600Related Commands
line console
Enters the console terminal configuration mode.
show running-config
Displays the running configuration.
stopbits
To configure the stop bits for the console port, use the stopbits command. To revert to the default, use the no form of this command.
stopbits {1 | 2}
no stopbits {1 | 2}
Syntax Description
Command Default
1 stop bit.
Command Modes
Terminal line configuration
Command History
Usage Guidelines
You can configure the console port only from a session on the console port.
Examples
This example shows how to configure the number of stop bits for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# stopbits 2This example shows how to revert to the default number of stop bits for the console port:
switch# configure terminal switch(config)# line console switch(config-console)# no stopbits 2Related Commands
line console
Enters the console terminal configuration mode.
show running-config
Displays the running configuration.
system cores
To configure the destination for the system core, use the system cores command. To revert to the default, use the no form of this command.
system cores tftp:tftp_URL [vrf management]
no system cores
Syntax Description
Command Default
None
Command Modes
Interface configuration mode
Command History
Examples
This example shows how to configure a core file:
switch# configure terminal switch(config)# system cores tftp://serverA:69/core_fileThis example shows how to disable system core logging:
switch# configure terminal switch(config)# no system coresRelated Commands
system startup-config unlock
To unlock the startup configuration file, use the system startup-config unlock command.
system startup-config unlock process-id
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Usage Guidelines
Use the show system internal sysmgr startup-config locks command to display the locks on the startup configuration file.
Examples
This example shows how to unlock the startup-configuration file:
switch# system startup-config unlock 10switchname
To configure the hostname for the device, use the switchname command. To revert to the default, use the no form of this command.
switchname name
no switchname
Syntax Description
name
Hostname for the switch. The name is alphanumeric, case sensitive, can contain special characters, and can have a maximum of 32 characters.
Command Default
"switch" is the default hostname.
Command Modes
EXEC mode
Command History
Usage Guidelines
The Cisco NX-OS software uses the hostname in command-line interface (CLI) prompts and in default configuration filenames.
The switchname command performs the same function as the hostname command.
Examples
This example shows how to configure the hostname for a Cisco Nexus 5000 Series switch:
switch# configure terminal switch(config)# switchname Engineering2 Engineering2(config)#This example shows how to revert to the default hostname:
Engineering2# configure terminal Engineering2(config)# no switchname switch(config)#Related Commands
Configures the switch hostname.
show hostname
Displays the switch hostname.
show switchname
Displays the switch hostname.
tail
To display the last lines of a file, use the tail command.
tail [filesystem: [//server/]] [directory] filename [lines]
Syntax Description
Note
Command Default
Displays the last 10 lines.
Command Modes
EXEC mode
Command History
Examples
This example shows how to display the last 10 lines of a file:
switch# tail bootflash:startup.cfgThis example shows how to display the last 20 lines of a file:
switch# tail bootflash:startup.cfg 20Related Commands
cd
Changes the current working directory.
copy
Copies files.
dir
Displays the directory contents.
pwd
Displays the name of the current working directory.
terminal length
To set the number of lines of output to display on the terminal screen for the current session before pausing, use the terminal length command. To revert to the default, use the no form of this command.
terminal length lines
terminal no length
Syntax Description
lines
Number of lines to display. The range is from 0 to 511. Use 0 to not pause while displaying output.
Command Default
The initial default for the console is 0 (do not pause output). The initial default for virtual terminal sessions is defined by the client software. The default for the no form is 24 lines.
Command Modes
EXEC mode
Command History
Usage Guidelines
The session pauses after displaying the number of lines set in the terminal length. Press the space bar to display another screen of lines or press the Enter key to display another line. To return to the command prompt, press Ctrl-C.
The terminal length setting applies only to the current session.
Examples
This example shows how to set the number of lines of command output to display on the terminal before pausing:
switch# terminal length 28This example shows how to revert to the default number of lines:
switch# terminal no lengthRelated Commands
terminal session-timeout
To set the terminal inactivity timeout for the current session, use the terminal session-timeout command. To revert to the default, use the no form of this command.
terminal session-timeout minutes
terminal no session-timeout
Syntax Description
minutes
Number of minutes. The range is from 0 to 525600 minutes (8760 hours). Use 0 to disable the terminal inactivity timeout.
Command Default
Terminal session timeout is disabled (0 minutes).
Command Modes
EXEC mode
Command History
Usage Guidelines
The terminal session inactivity timeout setting applies only to the current session.
Examples
This example shows how to set the terminal inactivity timeout for the session to 10 minutes:
switch# terminal session-timeout 10This example shows how to revert to the default terminal inactivity timeout for the session:
switch# terminal no session-timeoutRelated Commands
terminal terminal-type
To set the terminal type for the current session, use the terminal terminal-type command. To revert to the default, use the no form of this command.
terminal terminal-type type
terminal no terminal-type
Syntax Description
type
Type of terminal. The type string is case sensitive, must be a valid type (for example, ansi, vt100, or xterm), and has a maximum of 80 characters.
Command Default
For a virtual terminal, the terminal type is set during negotiation with the client software. Otherwise, vt100 is the default.
Command Modes
EXEC mode
Command History
Usage Guidelines
The terminal type setting applies only to the current session.
Examples
This example shows how to set the terminal type:
switch# terminal type xtermThis example shows how to revert to the default terminal type:
switch# terminal no typeRelated Commands
terminal width
To set the number of character columns on the terminal screen for the current line for a session, use the terminal width command. To revert to the default, use the no form of this command.
terminal width columns
terminal no width
Syntax Description
Command Default
For a virtual terminal, the width is set during negotiation with the client software. Otherwise, 80 columns is the default.
Command Modes
EXEC mode
Command History
Usage Guidelines
The terminal width setting applies only to the current session.
Examples
This example shows how to set the number of columns to display on the terminal:
switch# terminal width 70This example shows how to revert to the default number of columns:
switch# terminal no widthRelated Commands
traceroute
To discover the routes that packets take when traveling to an IP address, use the traceroute command.
traceroute {dest-addr | hostname} [vrf {vrf-name | default | management}] [source src-addr]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to discover a route to a network device:
switch# traceroute 172.28.255.18 vrf managementRelated Commands
ping
Displays the network connectivity to another network device.
traceroute6
Discovers the route to a device using IPv6 addressing.
traceroute6
To discover the routes that packets take when traveling to an IPv6 address, use the traceroute6 command.
traceroute6 {dest-addr | hostname} [vrf {vrf-name | default | management}] [source src-addr]
Syntax Description
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to discover a route to a device:
switch# traceroute6 2001:0DB8::200C:417A vrf managementRelated Commands
ping6
Determines connectivity to another device using IPv6 addressing.
traceroute
Discovers the route to a device using IPv4 addressing.
update license
To update an existing license, use the update license command.
update license [filesystem: [//server/]] [directory] src-filename [target-filename]
Syntax Description
Note
Command Default
None
Command Modes
EXEC mode
Command History
Examples
This example shows how to update a license:
switch# update license bootflash:fm.lic fm-update.licRelated Commands
write erase
To erase configurations in persistent memory areas, use the write erase command.
write erase [boot | debug]
Syntax Description
boot
(Optional) Erases only the boot configuration.
debug
(Optional) Erases only the debug configuration.
Command Default
Erases all configuration in persistent memory.
Command Modes
EXEC mode
Command History
Usage Guidelines
You can use this command to erase the startup configuration in the persistent memory when information is corrupted or otherwise unusable. Erasing the startup configuration returns the switch to its initial state.
Examples
This example shows how to erase the startup configuration:
switch# write eraseThis example shows how to erase the debug configuration in the persistent memory:
switch# write erase debugRelated Commands
copy running-config startup-config
Copies the running configuration to the startup configuration.
show running-config
Displays the startup configuration.
