- 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.
Feedback