Page 1 Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x First Published: January 29, 2013 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883 Text Part Number: OL-30890-01...
Page 2 Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks . Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company.
Page 3: Table Of Contents
Ethernet Switching FCoE and Fibre Channel Switching Virtual Port Channels Serviceability Switched Port Analyzer Ethanalyzer Call Home Online Diagnostics Switch Management Simple Network Management Protocol Role-Based Access Control Configuration Methods Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 4 Configuring the Management Interface Displaying Management Interface Configuration Shutting Down the Management Interface Using PowerOn Auto Provisioning C H A P T E R 4 Information About PowerOn Auto Provisioning Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 5 Saving and Restoring a Command Mode Exiting a Configuration Command Mode Command Mode Summary Special Characters Keystroke Shortcuts Abbreviating Commands Completing a Partial Command Name Identifying Your Location in the Command Hierarchy Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 6 Controlling CLI History Recall Configuring the CLI Edit Mode Displaying the Command History Enabling or Disabling the CLI Confirmation Prompts Setting CLI Display Colors Sending Commands to Modules BIOS Loader Prompt Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 7 Additional References for Terminal Settings and Sessions Related Documents for Terminal Settings and Sessions Basic Device Management C H A P T E R 7 Finding Feature Information Information About Basic Device Management Device Hostname Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 8 Licensing Requirements for File Systems, Directories, and Files Working with Directories Identifying the Current Directory Changing the Current Directory Creating a Directory Displaying Directory Contents Deleting a Directory Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x viii OL-30890-01...
Page 9 Related Documents for File Systems Working with Configuration Files C H A P T E R 9 Information About Configuration Files Types of Configuration Files Licensing Requirements for Configuration Files Managing Configuration Files Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 10 Examples of Working with Configuration Files Copying Configuration Files Backing Up Configuration Files Rolling Back to a Previous Configuration Additional References for Configuration Files Related Documents for Configuration Files Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 11: Preface
Documentation Feedback, page xiv • Obtaining Documentation and Submitting a Service Request, page xv Audience This publication is for network administrators who configure and maintain Cisco Nexus devices and Cisco Nexus 2000 Series Fabric Extenders. Document Conventions Note As part of our constant endeavor to remodel our documents to meet our customers' requirements, we have modified the manner in which we document configuration tasks.
Page 12 Means reader take note. Notes contain helpful suggestions or references to material not covered in the Note manual. Means reader be careful. In this situation, you might do something that could result in equipment damage Caution or loss of data. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 13: Related Documentation For Cisco Nexus 5500 Series Nx-Os Software
Preface Related Documentation for Cisco Nexus 5500 Series NX-OS Software Related Documentation for Cisco Nexus 5500 Series NX-OS Software The entire Cisco NX-OS 5500 Series documentation set is available at the following URL: http://www.cisco.com/c/en/us/support/switches/nexus-5000-series-switches/ tsd-products-support-series-home.html Release Notes The release notes are available at the following URL: http://www.cisco.com/en/US/products/ps9670/prod_release_notes_list.html...
Page 14: Documentation Feedback
The Cisco Nexus 5500 Series NX-OS MIB Reference is available at http://www.cisco.com/en/US/docs/switches/ datacenter/nexus5500/sw/mib/reference/NX5500_MIBRef.html. Error and System Messages The Cisco Nexus 5500 Series NX-OS System Message Guide is available at http://www.cisco.com/en/US/docs/ switches/datacenter/nexus5500/sw/system_messages/reference/sl_nxos_book.html. Troubleshooting Guide The Cisco Nexus 5500 Series NX-OS Troubleshooting Guide is available at http://www.cisco.com/en/US/...
Page 15: Obtaining Documentation And Submitting A Service Request
What's New in Cisco Product Documentation, at: http:// www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html. To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the What's New in Cisco Product Documentation RSS feed. RSS feeds are a free service.
Page 16 Preface Obtaining Documentation and Submitting a Service Request Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 17: New And Changed Information For This Release
Added the support for 7.3(0)N1(1) Basic Device the EXEC banner Management feature. 63 character hostname Added support for 63 7.3(0)N1(1) Basic Device and switchname characters for hostname Management and switchname. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 18 New and Changed Information for this Release New and Changed Information for this Release Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 19: Overview
Native Fibre Channel implements a lossless service at the transport layer using a buffer-to-buffer credit system. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 20: Data Center I/O Consolidation
Overview Data Center I/O Consolidation For FCoE traffic, the Ethernet link must provide a lossless service. Ethernet links on Cisco Nexus devices provide two mechanisms to ensure lossless transport for FCoE traffic: link-level flow control and priority flow control. IEEE 802.3x link-level flow control allows a congested receiver to signal the far end to pause the data transmission for a short period of time.
Page 21: Virtual Interfaces
• Traffic suppression (unicast, multicast, and broadcast) FCoE and Fibre Channel Switching Cisco Nexus devices support data center I/O consolidation by providing FCoE interfaces (to the servers) and native Fibre Channel interfaces (to the SAN). FCoE and Fibre Channel switching includes the following features: •...
Page 22: Qos
A virtual port channel (vPC) allows links that are physically connected to two different Cisco Nexus devices or Cisco Nexus 2000 Series Fabric Extenders to appear as a single port channel. A vPC can provide multipathing, which allows you to create redundancy by enabling multiple parallel paths between nodes and load balancing traffic where alternative paths exist.
Page 23: Call Home
Online Diagnostics Cisco generic online diagnostics (GOLD) is a suite of diagnostic facilities to verify that hardware and internal data paths are operating as designed. Boot-time diagnostics, continuous monitoring, and on-demand and scheduled tests are part of the Cisco GOLD feature set.
Page 24: Configuring With Cisco Data Center Network Manager
For more information, see the Cisco DCNM Configuration Guides. Configuring with Cisco MDS Fabric Manager You can configure Cisco Nexus Series switches using the Fabric Manager client, which runs on a local PC and uses the Fabric Manager server. For more information, see the Cisco Nexus Fabric Manager Software guide for your device.
Page 25 In this example, the blade server rack incorporates blade switches that support 10-Gigabit Ethernet uplinks to the Cisco Nexus device. The blade switches do not support FCoE, so there is no FCoE traffic and no Fibre Channel ports on the Cisco Nexus device.
Page 26: Fabric Extender Deployment Topology
The Fabric Extender units are attached to their parent Cisco Nexus devices with 10-Gigabit fabric interfaces. Each Fabric Extender acts as a Remote I/O Module on the parent Cisco Nexus device. All device configurations are managed on the Cisco Nexus device and configuration information is downloaded using inband communication to the Fabric Extender.
Page 27: Data Center I/O Consolidation Topology
The following figure shows a typical I/O consolidation scenario for the Cisco Nexus device. Figure 4: I/O Consolidation Topology The Cisco Nexus device connects to the server ports using FCoE. Ports on the server require converged network adapters. For redundancy, each server connects to both switches. Dual-port CNA adapters can be used for this purpose.
Page 28 802.1s Multiple Spanning Tree Protocol 802.1w Rapid Spanning Tree Protocol 802.3ad Link aggregation with LACP 802.3ae 10-Gigabit Ethernet 802.1Q VLAN Tagging 802.1p Class of Service Tagging for Ethernet frames Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 29: Using The Cisco Nx-Os Setup Utility
BIOS images. Starting the Switch A Cisco Nexus switch starts its boot process as soon as its power cord is connected to an A/C source. The switch does not have a power switch. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x...
Page 30: Boot Sequence
Instead, the BIOS image retains control and prints a message to the console at 9600 baud every 30 seconds that indicates a failure. The following figure shows the normal and recovery boot sequence. Figure 5: Boot Sequence Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 31: Console Settings
You must have the network-admin role before you can upgrade the software image on the switch. You must log in to the switch on its console port connection. To upgrade the software on the switch, follow these steps: Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 32 Upgrading the Switch Software SUMMARY STEPS 1. Log in to Cisco.com to access the Software Download Center. To log in to Cisco.com, go to the URL http://www.cisco.com/ and click Log In at the top of the page. Enter your Cisco username and password.
Page 33 • Updates the boot variables to reference the specified images and saves the configuration to the startup configuration file. Step 10 After the switch completes the installation, log in and verify that the switch is running the required software version. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 34 7/14/2009 4:00:00 [07/14/2009 05:20:12] Hardware cisco Nexus5500 Chassis ("40x10GE/Supervisor") Intel(R) Celeron(R) M CPU with 2074240 kB of memory. Processor Board ID JAB1232002F Device name: switch bootflash: 1003520 kB Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 35: Downgrading From A Higher Release
Locate the image files you will use for the downgrade by entering the dir bootflash: command. If the image files are not stored on the bootflash memory, download the files from Cisco.com: a) Log in to Cisco.com to access the Software Download Center. To log in to Cisco.com, go to the URL http:// www.cisco.com/...
Page 36: Initial Configuration
These tasks must be completed before you can configure the switch. SUMMARY STEPS 1. Verify the following physical connections for the new Cisco Nexus device: 2. Verify that the default console port parameters are identical to those of the computer terminal (or terminal...
Page 37: Initial Setup
• 1 stop bit Initial Setup The first time that you access a switch in your Cisco Nexus series, it runs a setup program that prompts you for the IP address and other configuration information necessary for the switch to communicate over the Ethernet interface.
Page 38: Default Login
Enter. If a default answer is not available (for example, switch name), the switch uses what was previously configured and skips to the next question. To configure the switch for first time, follow these steps: Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 39 Using the Cisco NX-OS Setup Utility Initial Configuration SUMMARY STEPS 1. Ensure that the switch is on. Switches in the Cisco Nexus series boot automatically. 2. Enter the new password for the administrator. 3. Enter yes to enter the setup mode.
Page 40 Enter a name for the switch. Note Starting with Cisco NX-OS Release 7.3(0)N1(1), the character limit of a switch name is increased from 32 to 63 alphanumeric characters. Also, 63 characters is the maximum length limit for setting hostname using SNMP.
Page 41 Enter on (on is the default) to configure the switch port trunk mode. Example: Configure default physical FC switchport trunk mode (on/off/auto) [on]: on Step 16 Enter permit (deny is the default) to deny a default zone policy configuration. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 42: Changing The Initial Configuration
So setup always assumes system defaults and not the current system configuration values. Press Enter at anytime to skip a dialog. Use ctrl-c at anytime Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 43: Management Interface Configuration
CLI through the console port. About the mgmt0 Interface The mgmt0 interface on a Cisco Nexus device provides out-of-band management, which enables you to manage the switch by its IPv4 or IPv6 address. The mgmt0 interface is a 10/100/1000 Ethernet port.
Page 44: Displaying Management Interface Configuration
5202 multicast frames, 0 compressed 0 input errors, 0 frame, 0 overrun, 0 fifo 570 packets output, 85555 bytes 0 underrun, 0 output errors, 0 collisions 0 fifo, 0 carrier errors Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 45: Shutting Down The Management Interface
Shutting down this interface will drop all telnet sessions. Do you wish to continue (y/n)? y The following example shuts down the interface using the force option: switch# configure terminal switch(config)# interface mgmt 0 switch(config-if)# shutdown force Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 46 Using the Cisco NX-OS Setup Utility Management Interface Configuration Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 47: Using Poweron Auto Provisioning
Cisco Nexus switches that are being deployed in the network for the first time. When a Cisco Nexus Series switch with the POAP feature boots and does not find the startup configuration, the switch enters POAP mode and checks for a USB device containing the configuration script file. If it finds one, it checks that device to see if it also contains the software image files and the switch configuration file.
Page 48: Network Requirements For Poap
The software image is installed on the switch and is used at the next reboot. • Schedules the downloaded configuration to be applied at the next switch reboot. • Stores the configuration as the startup-configuration. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 49: Poap Process
Tool Command Language (Tcl). You can customize one of these scripts to meet the requirements of your network environment. For information about customizing this script using Python, see the Cisco NX-OS Python API Reference Guide for your platform. POAP Process...
Page 50 Using PowerOn Auto Provisioning POAP Process Within these phases, other process and decision points occur. The following illustration shows a flow diagram of the POAP process. Figure 7: POAP Process Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 51: Power-Up Phase
The switch sends out DHCP discover messages on all of the active interfaces (including the mgmt interface) soliciting DHCP offers from the DHCP server or servers. The DHCP client on the Cisco Nexus switch uses the switch serial number or its MAC address in the client-identifier option to identify itself to the DHCP server.
Page 52 DHCP server assigns an IP address to the switch. If there is a failure in any of the subsequent steps in the POAP process, the IP address is released back to the DHCP server. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 53: Script Execution Phase
TFTP server or the HTTP server. The switch runs the configuration script, which downloads and installs the software image and downloads a switch-specific configuration file. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 54: Post-Installation Reload Phase
= poap_mac statement. When the switch runs the configuration script, the switch downloads the file that is named conf_mac-address.cfg, where the mac-addressis the MAC Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 55: Location-Based Configuration File Selection
• If you use POAP to bootstrap a Cisco Nexus device that is a part of a vPC pair using static port-channels on the VPC links, the Cisco Nexus device activates all of its links upon POAP startup. The dually connected device at the end of the VPC links might start sending some or all of its traffic to the port-channel member links connected to the Cisco Nexus device, and the traffic would be lost.
Page 56: Setting Up The Network Environment To Use Poap
Module Pre-Provisioning feature, see the Cisco Nexus System Management Configuration guide for your device. • During POAP, the Cisco Nexus devices boot up in Layer 2 mode by default. Therefore, uplink connectivity through the front panel ports must be in Layer 2 mode.
Page 57: Verifying The Device Configuration
Displays the running configuration. show startup-config Displays the startup configuration. For detailed information about the fields in the output from these commands, see the Cisco Nexus command reference for your device. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x...
Page 58 Using PowerOn Auto Provisioning Verifying the Device Configuration Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 59: Understanding The Command-Line Interface
Enabling or Disabling the CLI Confirmation Prompts, page 71 • Setting CLI Display Colors, page 71 • Sending Commands to Modules, page 72 • BIOS Loader Prompt, page 73 • Examples Using the CLI , page 73 Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 60: Finding Feature Information
As long as you provide the correct password, the device logs you in. Command Modes This section describes command modes in the Cisco NX-OS CLI. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 61: Exec Command Mode
EXEC Command Mode EXEC Command Mode When you first log in, the Cisco NX-OS software places you in EXEC mode. The commands available in EXEC mode include the show commands that display the device status and configuration information, the clear commands, and other commands that perform actions that you do not save in the device configuration.
Page 62: Subinterface Configuration Command Mode
IEEE 802.1Q encapsulation to associate a subinterface with a VLAN. For more information about configuring subinterfaces, see the Cisco Nexus interfaces guide for your device. For details about the subinterface commands, see the command reference guide for your device.
Page 63: Saving And Restoring A Command Mode
Purpose Saving and Restoring a Command Mode The Cisco NX-OS software allows you to save the current command mode, configure a feature, and then restore the previous command mode. The push command saves the command mode and the pop command restores the command mode.
Page 64: Command Mode Summary
To exit to global switch(config-subif)# configuration mode, specify a configuration mode, use subinterface with an the exit command. interface command. To exit to EXEC mode, use the end command or press Ctrl-Z. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 65: Special Characters
Understanding the Command-Line Interface Special Characters Special Characters This table lists the characters that have special meaning in Cisco NX-OS text strings and should be used only in regular expressions or other special contexts. Table 4: Special Characters Character Description...
Page 66 When used at the end of a command line in which a valid command has been typed, the resulting configuration is first added to the running configuration file. Up arrow key Displays the previous command in the command history. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 67 Example: switch# cd bootflash:<Tab> bootflash: bootflash://sup-1/ bootflash:/// bootflash://sup-2/ bootflash://module-5/ bootflash://sup-active/ bootflash://module-6/ bootflash://sup-local/ Example: switch# cd bootflash://mo<Tab> bootflash://module-5/ bootflash://module-6/cv switch# cd bootflash://module- Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 68: Abbreviating Commands
For example, entering co<Tab> lists all commands available in EXEC mode beginning with co: switch# co<Tab> configure copy switch# co Note that the characters you entered appear at the prompt again to allow you to complete the command entry. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 69: Identifying Your Location In The Command Hierarchy
Almost every configuration command has a no form that can be used to disable a feature, revert to a default value, or remove a configuration. The Cisco NX-OS command reference publications describe the function of the no form of the command whenever a no form is available.
Page 70: Configuring Cli Variables
• Cannot have nested references through another variable • Can persist across switch reloads or exist only for the current session Cisco NX-OS supports one predefined variable: TIMESTAMP. This variable refers to the current time when the command executes in the format YYYY-MM-DD-HH.MM.SS.
Page 71: Configuring Cli Session-Only Variables
You can configure CLI variables that persist across CLI sessions and device reloads. SUMMARY STEPS 1. configure terminal 2. cli var name variable-name variable-text 3. exit 4. (Optional) show cli variables 5. (Optional) copy running-config startup-config Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 72: Command Aliases
• Command aliases persist across reboots if you save them to the startup configuration. • Command alias translation always takes precedence over any keyword in any configuration mode or submode. • Command alias configuration takes effect for other user sessions immediately. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 73: Defining Command Aliases
Understanding the Command-Line Interface Defining Command Aliases • The Cisco NX-OS software provides one default alias, alias, which is the equivalent to the show cli alias command that displays all user-defined aliases. • You cannot delete or change the default command alias alias.
Page 74: Configuring Command Aliases For A User Session
Configuring Command Aliases for a User Session You can create a command alias for the current user session that is not available to any other user on the Cisco NX-OS device. You can also save the command alias for future use by the current user account.
Page 75: Echoing Information To The Terminal
You cannot create the script files at the CLI prompt. You can create the script file on a remote device and Note copy it to the bootflash:, slot0:, or volatile: directory on the Cisco NX-OS device. SUMMARY STEPS 1. run-script [bootflash: | slot0: | volatile:]filename...
Page 76: Delaying Command Action
30 Context-Sensitive Help The Cisco NX-OS software provides context-sensitive help in the CLI. You can use a question mark (?) at any point in a command to list the valid input options. CLI uses the caret (^) symbol to isolate input errors. The ^ symbol appears at the point in the command string where you have entered an incorrect command, keyword, or argument.
Page 77 <2000-2030> Enter the year (no abbreviation) switch# clock set 13:32:00 18 April Enters the correct syntax for the clock set command. switch# clock set 13:32:00 18 April 2008<CR> switch# Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 78: Understanding Regular Expressions
Understanding the Command-Line Interface Understanding Regular Expressions Understanding Regular Expressions The Cisco NX-OS software supports regular expressions for searching and filtering in CLI output, such as the show commands. Regular expressions are case sensitive and allow for complex matching requirements. Special Characters You can also use other keyboard characters (such as ! or ~) as single-character patterns, but certain keyboard characters have special meanings when used in regular expressions.
Page 79: Anchoring
Searching and Filtering show Command Output Often, the output from show commands can be lengthy and cumbersome. The Cisco NX-OS software provides the means to search and filter the output so that you can easily locate information. The searching and filtering options follow a pipe character (|) at the end of the show command.
Page 80: Filtering And Searching Keywords
Include lines that match Filtering and Searching Keywords The Cisco NX-OS CLI provides a set of keywords that you can use with the show commands to search and filter the command output. This table lists the keywords for filtering and searching the CLI output.
Page 81: Diff Utility
You can compare the output from a show command with the output from the previous invocation of that command. diff-clean [all-session] [all-users] This table describes the keywords for the diff utility. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 82: Grep And Egrep Utilities
Removes diff temporary files from all sessions (past and present sessions) of all users. The Cisco NX-OS software creates temporary files for the most current output for a show command for all current and previous users sessions. You can remove these temporary files using the diff-clean command.
Page 83: Less Utility
The default sort includes all characters. Folds lowercase characters into uppercase characters. Sorts by comparing a general numeric value. Sorts only using printable characters. The default sort includes nonprintable characters. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 84: Searching And Filtering From The --More-- Prompt
The initial default is 11 lines. If you use the optional lines argument, that value becomes the new default number of lines to display for this command. q or Q or Ctrl-C Exits the --More-- prompt. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 85: Using The Command History
Repeats the previous command. Using the Command History The Cisco NX-OS software CLI allows you to access the command history for the current user session. You can recall and reissue commands, with or without modification. You can also clear the command history.
Page 86: Controlling Cli History Recall
You can control the commands that you recall from the CLI history using the Ctrl-P and Ctrl-N keystroke shortcuts. Cisco NX-OS software recalls all commands from the current command mode and higher command modes. For example, if you are working in global configuration mode, the command recall keystroke shortcuts recall both EXEC mode and global configuration mode commands.
Page 87: Enabling Or Disabling The Cli Confirmation Prompts
Enabling or Disabling the CLI Confirmation Prompts Enabling or Disabling the CLI Confirmation Prompts For many features, the Cisco NX-OS software displays prompts on the CLI that ask for confirmation before continuing. You can enable or disable these prompts. The default is enabled.
Page 88: Sending Commands To Modules
0 days 1 hours 45 minute(s) 34 second(s) --- 12,16 ---- Hardware bootflash: 0 blocks (block size 512b) uptime is 0 days 1 hours 45 minute(s) 42 second(s) Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 89: Bios Loader Prompt
If a valid kickstart image is not found, the following BIOS loader prompt displays: loader> For information on how to load the Cisco NX-OS software from the prompt, see the Cisco Nexus <loader>...
Page 90: Using The System-Defined Timestamp Variable
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 Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 91: Additional References For The Cli
This section includes additional information related to the CLI. Related Documents for the CLI Related Topic Document Title Cisco NX-OS Licensing Cisco NX-OS Licensing Guide Command reference Cisco Nexus 5000 Series NX-OS Command Reference Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 92 Understanding the Command-Line Interface Related Documents for the CLI Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 93: Chapter 6 Configuring Terminal Settings And Sessions
Information About Terminal Settings and Sessions This section includes information about terminal settings and sessions. Terminal Session Settings The Cisco NX-OS software features allow you to manage the following characteristics of terminals: Terminal type Name used by Telnet when communicating with remote hosts...
Page 94: Console Port
Enables the flow-control hardware. Parity Specifies the odd or even parity for error detection. Speed Specifies the transmission speed for the connection. Stop bits Specifies the stop bits for an asynchronous line. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 95: Virtual Terminals
Configure your terminal emulator with 9600 baud, 8 data bits, 1 stop bit, and no parity. Virtual Terminals You can use virtual terminal lines to connect to your Cisco NX-OS device. Secure Shell (SSH) and Telnet create virtual terminal sessions. You can configure an inactive session timeout and a maximum sessions limit for virtual terminals.
Page 96 {300 | 1200 | 2400 | 4800 | 9600 | 38400 | 57600 | Configures the transmit and receive speed. The default 115200} is 115200. Example: switch(config-console)# speed 115200 Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 97: Configuring The Com1 Port
You can set the following characteristics for the COM1 port: • Data bits • Flow control on the hardware • Parity • Speed • Stop bits Before You Begin Log in to the console port or COM1 port. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 98 {300 | 1200 | 2400 | 4800 | 9600 | 38400 | 57600 | Configures the transmit and receive speed. The default 115200} is 9600. Example: switch(config-com1)# speed 115200 Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 99: Configuring Virtual Terminals
Configuring Virtual Terminals This section describes how to configure virtual terminals on Cisco NX-OS devices. Configuring the Inactive Session Timeout You can configure a timeout for inactive virtual terminal sessions on a Cisco NX-OS device. SUMMARY STEPS 1. configure terminal 2.
Page 100: Configuring The Session Limit
Copies the running configuration to the startup configuration. Example: switch(config)# copy running-config startup-config Configuring the Session Limit You can limit the number of virtual terminal sessions on your Cisco NX-OS device. SUMMARY STEPS 1. configure terminal 2. line vty 3. session-limit sessions 4. exit 5.
Page 101: Configuring Modem Connections
Step 3 session-limit sessions Configures the maximum number of virtual sessions for the Cisco NX-OS device. The range is from 1 to 60. The default is 32. Example: switch(config-line)# session-limit 10 Step 4 Exits line configuration mode.
Page 102 Displays the console and COM1 settings. Example: switch(config)# show line Step 6 (Optional) copy running-config startup-config Copies the running configuration to the startup configuration. Example: switch(config)# copy running-config startup-config Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 103: Downloading The Default Initialization String
Configuring Terminal Settings and Sessions Downloading the Default Initialization String Downloading the Default Initialization String The Cisco NX-OS software provides a default initialization string that you can download for connecting with the modem. The default initialization string is ATE0Q1&D2&C1S0=1\015. Before You Begin Log in to the console port.
Page 104: Configuring And Downloading A User-Specified Initialization String
Enters global configuration mode. Example: switch# configure terminal switch(config)# Step 2 Enter one of the following commands: Option Description line com1 Enters COM1 configuration mode. line console Enters console configuration mode. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 105: Initializing A Modem For A Powered-Up Cisco Nx-Os Device
If you connect a modem to a powered-up physical device, you must initialize the modem before you can use Before You Begin After waiting until the Cisco NX-OS device has completed the boot sequence and the system image is running, connect the modem to either the COM1 port or the console port on the device.
Page 106: Clearing Terminal Sessions
Example: switch# clear line pts/0 Displaying Terminal and Session Information To display terminal and session information, perform one of the following tasks: Command Purpose show terminal Displays terminal settings. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 107: Default Settings For File System Parameters
The all keyword displays the default values for the user accounts. For detailed information about the fields in the output from these commands, see the Cisco Nexus command reference guide for your device. Default Settings for File System Parameters This table lists the default settings for the file system parameters.
Page 108 Configuring Terminal Settings and Sessions Related Documents for Terminal Settings and Sessions Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 109: Basic Device Management
To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the “New and Changed Information” chapter or the Feature History table below. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 110: Information About Basic Device Management
EXEC Banner Starting with the Cisco NX-OS Release 7.3(0)N1(1), the EXEC banner is displayed after a user logs in to a switch. This banner can be used to post reminders to your network administrators.
Page 111: User Sessions
User Sessions You can display the active user session on your device. You can also send messages to the user sessions. For more information about managing user sessions and accounts, see the Cisco Nexus security configuration guide for your device.
Page 112: Configuring The Motd Banner
4. (Optional) show banner motd 5. (Optional) copy running-config startup-config DETAILED STEPS Command or Action Purpose Step 1 configure terminal Enters global configuration mode. Example: switch# configure terminal switch(config)# Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 113: Configuring The Exec Banner
• Maximum of 40 lines SUMMARY STEPS 1. configure terminal 2. banner exec delimiting-character message delimiting-character 3. (Optional) no banner exec 4. exit 5. (Optional) show banner exec 6. (Optional) copy running-config startup-config Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 114: Configuring The Time Zone
Unauthorized access to this device is prohibited! Configuring the Time Zone You can configure the time zone to offset the device clock time from UTC. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 115: Configuring Summer Time (Daylight Saving Time)
Configuring Summer Time (Daylight Saving Time) You can configure when summer time, or daylight saving time, is in effect for the device and the offset in minutes. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 116 Displays the configured MOTD banner. Example: switch(config)# show clock detail Step 5 copy running-config startup-config (Optional) Copies the running configuration to the startup configuration. Example: switch# copy running-config startup-config Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 117: Manually Setting The Device Clock
Related Topics Configuring the Time Zone, on page 98 Setting the Clock Manager You can configure the clock manager to synchronize all the clocks of the components in the Cisco Nexus chassis. SUMMARY STEPS 1. clock protocol protocol vdc vdc-num 2.
Page 118: Managing Users
You can display information about users logged into the device and send messages to those users. Displaying Information about the User Sessions You can display information about the user session on the device. SUMMARY STEPS 1. show users Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 119: Sending A Message To Users
To verify the configuration after bootstrapping the device using POAP, use one of the following commands: Command Purpose show running-config Displays the running configuration. show startup-config Displays the startup configuration. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 120: Default Settings For Basic Device Parameters
Basic Device Management Default Settings for Basic Device Parameters For detailed information about the fields in the output from these commands, see the Cisco Nexus command reference for your device. Default Settings for Basic Device Parameters This table lists the default settings for basic device parameters.
Page 121: Using The Device File Systems, Directories, And Files
Additional References for File Systems, page 122 Information about the External Storage Devices, Device File Systems, Directories, and Files This section describes file systems, directories, and files on the Cisco NX-OS device. File Systems The syntax for specifying a local file system is filesystem:[//modules/].
Page 122: Directories
You can download files, such as system image files, from remote servers using FTP, Secure Copy (SCP), Secure Shell FTP (SFTP), and TFTP. You can also copy files from an external server to the device, because the device can act as an SCP server. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 123: Licensing Requirements For File Systems, Directories, And Files
Cisco NX-OS licensing scheme, see the Cisco NX-OS Licensing Guide. Working with Directories This section describes how to work with directories on the Cisco NX-OS device. Identifying the Current Directory You can display the directory name of your current directory.
Page 124: Creating A Directory
[filesystem:[//module/]]directory Creates a new directory. The filesystem argument is case sensitive. The directory argument is alphanumeric, case sensitive, and has a maximum of 64 characters. Example: switch# mkdir test Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 125: Displaying Directory Contents
Example: switch# dir bootflash:test If the directory is not empty, you must delete all the files before you can delete the directory. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 126: Accessing Directories On The Standby Supervisor Module
Working with Files This section describes how to work with files on the Cisco NX-OS device. Moving Files You can move a file from one directory to another directory.
Page 127: Copying Files
3. copy [filesystem:[//module/][directory/] | directory/]source-filename | {filesystem:[//module/][directory/]] | directory/}[target-filename] DETAILED STEPS Command or Action Purpose Step 1 (Optional) Displays the name of your current default directory. Example: switch# pwd Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 128: Deleting Files
If you specify a directory, the delete command deletes Caution Example: the entire directory and all its contents. switch# delete test old_tests/test1 Displaying File Contents You can display the contents of a file. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 129: Displaying File Checksums
Example: switch# show file bootflash:trunks2.cfg cksum Compressing and Uncompressing Files You can compress and uncompress files on your Cisco NX-OS device using Lempel-Ziv 1977 (LZ77) coding. SUMMARY STEPS 1. (Optional) dir [filesystem:[//module/]directory]] 2. gzip [filesystem:[//module/][directory/] | directory/]filename 3. gunzip [filesystem:[//module/][directory/] | directory/]filename .gz Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x...
Page 130: Displaying The Last Lines In A File
Redirecting show Command Output to a File You can redirect show command output to a file on bootflash:, slot0:, volatile:, or on a remote server. SUMMARY STEPS 1. show-command > [filesystem:[//module/][directory] | [directory /]]filename Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 131: Finding Files
Working with Archive Files The Cisco NX-OS software supports archive files. You can create an archive file, append files to an existing archive file, extract files from an archive file, and list the files in an archive file.
Page 132: Creating An Archive Files
By default, the files are not deleted. The verbose keyword specifies that the Cisco NX-OS software should list the files as they are added to the archive. By default, the files are listed as they are added.
Page 133: Appending Files To An Archive File
Appending Files to an Archive File Appending Files to an Archive File You can append files to an existing archive file on your Cisco NX-OS device. Before You Begin You have created an archive file on your Cisco NX-OS device.
Page 134: Displaying The Filenames In An Archive File
Examples of Using the File System This section includes example of using the file system on the Cisco NX-OS device. Accessing Directories on Standby Supervisor Modules This example shows how to list the files on the standby supervisor module:...
Page 135: Moving Files
Before You Begin Ensure that the directory is empty before you try to delete it. SUMMARY STEPS 1. (Optional) pwd 2. (Optional) dir [filesystem :[//module/][directory]] 3. rmdir [filesystem :[//module/]]directory Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 136: Displaying File Contents
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 Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 137: Compressing And Uncompressing Files
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 Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 138: Default Settings For File System Parameters
This section includes additional information related to the file systems. Related Documents for File Systems Related Topic Document Title Licensing Cisco NX-OS Licensing Guide Command reference Cisco Nexus 7000 Series NX-OS Fundamentals Command Reference Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 139: Working With Configuration Files
Additional References for Configuration Files, page 137 Information About Configuration Files Configuration files contain the Cisco NX-OS software commands used to configure the features on a Cisco NX-OS device. Commands are parsed (translated and executed) by the Cisco NX-OS software when the system is booted (from the startup-config file) or when you enter commands at the CLI in a configuration mode.
Page 140: Licensing Requirements For Configuration Files
SUMMARY STEPS 1. (Optional) show running-config 2. copy running-config startup-config DETAILED STEPS Command or Action Purpose Step 1 show running-config (Optional) Displays the running configuration. Example: switch# show running-config Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 141: Copying A Configuration File To A Remote Server
Enter vrf (If no input, current vrf 'default' is considered): management Enter hostname for the ftp server: 172.1.1.10 Enter username: xxx Password: ***** Transfer of file Completed Successfully ***** Note: Boot variable kickstart is set to bootflash:/n5000-uk9-kickstart.5.0.2.N2.1.bin Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 142: Downloading The Running Configuration From A Remote Server
Ensure that the permissions on the file are set correctly. Permissions on the file should be set to world-read. Ensure that your Cisco NX-OS device has a route to the remote server. The Cisco NX-OS device and the remote server must be in the same subnetwork if you do not have a router or a default gateway to route traffic between subnets.
Page 143: Downloading The Startup Configuration From A Remote Server
Ensure that the permissions on the file are set correctly. Permissions on the file should be set to world-read. Ensure that your Cisco NX-OS device has a route to the remote server. The Cisco NX-OS device and the remote server must be in the same subnetwork if you do not have a router or a default gateway to route traffic between subnets.
Page 144: Copying Configuration Files To An External Flash Memory Device
Copying Files, on page 119 Copying Configuration Files to an External Flash Memory Device You can copy configuration files to an external flash memory device as a backup for later use. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 145: Copying The Running Configuration From An External Flash Memory Device
Copying Files, on page 119 Copying the Running Configuration from an External Flash Memory Device You can configure your Cisco NX-OS device by copying configuration files created on another Cisco NX-OS device and saved to an external flash memory device.
Page 146: Copying The Startup Configuration From An External Flash Memory Device
Copying Files, on page 119 Copying the Startup Configuration from an External Flash Memory Device You can recover the startup configuration on your Cisco NX-OS device by downloading a new startup configuration file saved on an external flash memory device.
Page 147: Copying Configuration Files To An Internal File System
DETAILED STEPS Command or Action Purpose Step 1 copy running-config [filesystem:][directory/] | Copies the running-configuration file to internal memory. [directory/]filename The filesystem, directory, and filename arguments are case sensitive. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 148: Rolling Back To A Previous Configuration
3. copy configuration_file running-configuration 4. copy running-config startup-config DETAILED STEPS Command or Action Purpose Step 1 write erase Clears the current configuration of the switch. Example: switch# write erase Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 149: Removing The Configuration For A Missing Module
You can only remove the configuration for an empty slot in the chassis. Before You Begin Remove the I/O module from the chassis. SUMMARY STEPS 1. (Optional) show hardware 2. purge module slot running-config 3. (Optional) copy running-config startup-config Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 150: Erasing A Configuration
◦ Subnet mask To remove the boot variable definitions and the IPv4 configuration on the mgmt0 interface, use the write erase boot command. SUMMARY STEPS 1. write erase [boot | debug] Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 151: Clearing Inactive Configurations
& for other than default vdc: • acl— Clears inactive ACL configurations. /bootflash/vdc_x/qos_inactive_if_config.cfg (where x is vdc number) • acl qos—Clears inactive ACL configurations and inactive QoS configurations. Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 152: Verifying The Device Configuration
Displays the startup configuration. For detailed information about the fields in the output from these commands, see the Cisco Nexus command reference for your device. Examples of Working with Configuration Files This section includes examples of working with configuration files.
Page 153: Rolling Back To A Previous Configuration
By default, the reload command reloads the device from a binary version of the startup configuration. Note Beginning with Cisco NX-OS 6.2(2), you can use the reload ascii command to copy an ASCII version of the configuration to the start up configuration when reloading the device.
Page 154 Working with Configuration Files Related Documents for Configuration Files Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01...
Page 155 (table) Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01 IN-1...
Page 156 91, 104, 122 accessing standby supervisor modules clocks changing current directories file systems 91, 122 default settings 91, 122 MOTD banners description Telnet servers licensing requirements specifying Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x IN-2 OL-30890-01...
Page 157 See command modes modules 72, 133 hostname removing configuration after removal 94, 95 configuring sending commands from the supervisor mdoule session description Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01 IN-3...
Page 158 124, 126, 129, 131, 132, 133, 136, 137 example roll back copying from external memory devices rolling back to previous configurations copying to internal file systems downloading from remote servers Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x IN-4 OL-30890-01...
Page 159 77, 90 clearing defined displaying information virtual device contexts settings virtual terminals 79, 83, 84 terminal settings configuring licensing configuring session limits time zones 94, 98 settings configuring Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x OL-30890-01 IN-5...
Page 160 Index Cisco Nexus 5500 Series NX-OS Fundamentals Configuration Guide, Release 7.x IN-6 OL-30890-01...

Cisco Nexus 5500 Series Configuration Manual

Preface

New and Changed Information for this Release

Overview

Using the Cisco NX-OS Setup Utility

Using Poweron Auto Provisioning

Understanding the Command-Line Interface

Chapter 6 Configuring Terminal Settings and Sessions

Basic Device Management

Using the Device File Systems, Directories, and Files

Working with Configuration Files

Quick Links

Related Manuals for Cisco Nexus 5500 Series

Summary of Contents for Cisco Nexus 5500 Series

Table of Contents