- Defining Command Aliases
- Using CLI Session Variables
- Using the System-Defined Timestamp Variable
- Running a Command Script
- Accessing Directories on Standby Supervisor Modules
- Moving Files
- Copying Files
- Displaying File Contents
- Displaying File Checksums
- Compressing and Uncompressing Files
- Redirecting show Command Output
- Finding Files
- Copying Configuration Files
- Backing Up Configuration Files
- Rolling Back to a Previous Configuration
Fundamentals Configuration Examples
This chapter provides examples for configuring certain fundamental Cisco NX-OS features.
- Defining Command Aliases
- Using CLI Session Variables
- Using the System-Defined Timestamp Variable
- Running a Command Script
- Accessing Directories on Standby Supervisor Modules
- Moving Files
- Copying Files
- Displaying File Contents
- Displaying File Checksums
- Compressing and Uncompressing Files
- Redirecting show Command Output
- Finding Files
- Copying Configuration Files
- Backing Up Configuration Files
- Rolling Back to a Previous Configuration
Defining Command Aliases
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)#
Using CLI Session Variables
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
Using the System-Defined Timestamp Variable
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
Running a Command Script
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
Accessing Directories on Standby Supervisor Modules
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
Moving Files
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
Copying Files
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.
Displaying File Contents
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
Displaying File Checksums
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
Compressing and Uncompressing Files
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 ...
Redirecting show Command Output
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
Finding Files
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
Copying Configuration Files
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
Backing Up Configuration Files
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
Rolling Back to a Previous Configuration
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.