The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter provides examples for configuring certain fundamental Cisco NX-OS features.
This example shows how to define command aliases:
cli alias name ethint interface ethernet cli alias name shintbr show interface brief cli alias name shintupbr shintbr | include up | include ethernet
This example shows how to use a command alias:
switch# configure terminal switch(config)# ethint 2/3 switch(config-if)#
This example shows how to reference a user-defined CLI session variable:
switch# show interface $(testinterface) Ethernet2/1 is down (Administratively down) Hardware is 10/100/1000 Ethernet, address is 0000.0000.0000 (bia 0019.076c.4dac) MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec, reliability 255/255, txload 1/255, rxload 1/255 Encapsulation ARPA auto-duplex, auto-speed Beacon is turned off Auto-Negotiation is turned on Input flow-control is off, output flow-control is off Auto-mdix is turned on Switchport monitor is off Last clearing of "show interface" counters never 5 minute input rate 0 bytes/sec, 0 packets/sec 5 minute output rate 0 bytes/sec, 0 packets/sec L3 in Switched: ucast: 0 pkts, 0 bytes - mcast: 0 pkts, 0 bytes L3 out Switched: ucast: 0 pkts, 0 bytes - mcast: 0 pkts, 0 bytes Rx 0 input packets 0 unicast packets 0 multicast packets 0 broadcast packets 0 jumbo packets 0 storm suppression packets 0 bytes Tx 0 output packets 0 multicast packets 0 broadcast packets 0 jumbo packets 0 bytes 0 input error 0 short frame 0 watchdog 0 no buffer 0 runt 0 CRC 0 ecc 0 overrun 0 underrun 0 ignored 0 bad etype drop 0 bad proto drop 0 if down drop 0 input with dribble 0 input discard 0 output error 0 collision 0 deferred 0 late collision 0 lost carrier 0 no carrier 0 babble 0 Rx pause 0 Tx pause 0 reset
This example uses $(TIMESTAMP) when redirecting show command output to a file:
switch# show running-config > rcfg.$(TIMESTAMP) Preparing to copy....done switch# dir 12667 May 01 12:27:59 2008 rcfg.2008-05-01-12.27.59 Usage for bootflash://sup-local 8192 bytes used 20963328 bytes free 20971520 bytes total
This example displays the CLI commands specified in the script file:
switch# show file testfile configure terminal interface ethernet 2/1 no shutdown end show interface ethernet 2/1
This example displays the run-script command execution output:
switch# run-script testfile `configure terminal` `interface ethernet 2/1` `no shutdown` `end` `show interface ethernet 2/1 ` Ethernet2/1 is down (Link not connected) Hardware is 10/100/1000 Ethernet, address is 0019.076c.4dac (bia 0019.076c.4dac) MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec, reliability 255/255, txload 1/255, rxload 1/255 Encapsulation ARPA Port mode is trunk auto-duplex, auto-speed Beacon is turned off Auto-Negotiation is turned on Input flow-control is off, output flow-control is off Auto-mdix is turned on Switchport monitor is off Last clearing of "show interface" counters 1d26.2uh 5 minute input rate 0 bytes/sec, 0 packets/sec 5 minute output rate 0 bytes/sec, 0 packets/sec Rx 0 input packets 0 unicast packets 0 multicast packets 0 broadcast packets 0 jumbo packets 0 storm suppression packets 0 bytes Tx 0 output packets 0 multicast packets 0 broadcast packets 0 jumbo packets 0 bytes 0 input error 0 short frame 0 watchdog 0 no buffer 0 runt 0 CRC 0 ecc 0 overrun 0 underrun 0 ignored 0 bad etype drop 0 bad proto drop 0 if down drop 0 input with dribble 0 input discard 0 output error 0 collision 0 deferred 0 late collision 0 lost carrier 0 no carrier 0 babble 0 Rx pause 0 Tx pause 0 reset
This example shows how to list the files on the standby supervisor module:
switch# dir bootflash://sup-remote 12198912 Aug 27 16:29:18 2003 m9500-sf1ek9-kickstart-mzg.1.3.0.39a.bin 1864931 Apr 29 12:41:59 2003 dplug2 12288 Apr 18 20:23:11 2003 lost+found/ 12097024 Nov 21 16:34:18 2003 m9500-sf1ek9-kickstart-mz.1.3.1.1.bin 41574014 Nov 21 16:34:47 2003 m9500-sf1ek9-mz.1.3.1.1.bin Usage for bootflash://sup-remote 67747169 bytes used 116812447 bytes free 184559616 bytes total
This example shows how to delete a file on the standby supervisor module:
switch# delete bootflash://sup-remote/aOldConfig.txt
This example shows how to move a file on an external flash device:
switch# move slot0:samplefile slot0:mystorage/samplefile
This example shows how to move a file in the default file system:
switch# move samplefile mystorage/samplefile
This example shows how to copy the file called samplefile from the root directory of the slot0: file system to the mystorage directory:
switch# copy slot0:samplefile slot0:mystorage/samplefile
This example shows how to copy a file from the current directory level:
switch# copy samplefile mystorage/samplefile
This example shows how to copy a file from the active supervisor module bootflash to the standby supervisor module bootflash:
switch# copy bootflash:system_image bootflash://sup-2/system_image
This example shows how to overwrite the contents of an existing configuration in NVRAM:
switch# copy nvram:snapshot-config nvram:startup-config Warning: this command is going to overwrite your current startup-config: Do you wish to continue? {y/n} [y] y
You can also use the copy command to upload and download files from the slot0: or bootflash: file system to or from a FTP, TFTP, SFTP, or SCP server.
This example displays the contents of a file on an external flash device:
switch# show file slot0:test configure terminal interface ethernet 1/1 no shutdown end show interface ethernet 1/1
This example displays the contents of a file residing in the current directory:
switch# show file myfile
This example shows how to display the checksum of a file:
switch# show file bootflash:trunks2.cfg cksum 583547619
This example shows how to display the MD5 checksum of a file:
switch# show file bootflash:trunks2.cfg md5sum 3b94707198aabefcf46459de10c9281c
This example shows how to compress a file:
switch# dir 1525859 Jul 04 00:51:03 2003 Samplefile ... switch# gzip volatile:Samplefile switch# dir 266069 Jul 04 00:51:03 2003 Samplefile.gz ...
This example shows how to uncompress a compressed file:
switch# dir 266069 Jul 04 00:51:03 2003 Samplefile.gz ... switch# gunzip samplefile switch# dir 1525859 Jul 04 00:51:03 2003 Samplefile ...
This example shows how to direct the output to a file on the bootflash: file system:
switch# show interface > bootflash:switch1-intf.cfg
This example shows how to direct the output to a file on external flash memory:
switch# show interface > slot0:switch-intf.cfg
This example shows how to direct the output to a file on a TFTP server:
switch# show interface > tftp://10.10.1.1/home/configs/switch-intf.cfg Preparing to copy...done
This example directs the output of the show tech-support command to a file:
switch# show tech-support > Samplefile Building Configuration ... switch# dir 1525859 Jul 04 00:51:03 2003 Samplefile Usage for volatile:// 1527808 bytes used 19443712 bytes free 20971520 bytes total
This example shows how to find a file in the current default directory:
switch# find smm_shm.cfg /usr/bin/find: ./lost+found: Permission denied ./smm_shm.cfg ./newer-fs/isan/etc/routing-sw/smm_shm.cfg ./newer-fs/isan/etc/smm_shm.cfg
This example shows how to overwrite the contents of an existing configuration in NVRAM:
switch# copy nvram:snapshot-config nvram:startup-config Warning: this command is going to overwrite your current startup-config. Do you wish to continue? {y/n} [y] y
This example shows how to copy a running configuration to the bootflash: file system:
switch# copy system:running-config bootflash:my-config
This example shows how to create a snapshot of the startup configuration in a predefined location on the device (binary file):
switch# copy startup-config nvram:snapshot-config
This example shows how to back up the startup configuration to the bootflash: file system (ASCII file):
switch# copy startup-config bootflash:my-config
This example shows how to back up the startup configuration to the TFTP server (ASCII file):
switch# copy startup-config tftp://172.16.10.100/my-config
This example shows how to back up the running configuration to the bootflash: file system (ASCII file):
switch# copy running-config bootflash:my-config
To roll back your configuration to a snapshot copy of a previously saved configuration, you need to perform the following steps:
Clear the current running image with the write erase command.
Restart the device with the reload command.
Copy the previously saved configuration file to the running configuration with the copy configuration_file running-configuration command.
Copy the running configuration to the start-up configuration with the copy running-config startup-config command.