Page 1
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide First Published: 2013-04-09 Last Modified: 2013-04-09 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-29291-02...
Serviceability Switched Port Analyzer Call Home Online Diagnostics Embedded Event Manager Manageability Simple Network Management Protocol Role-Based Access Control Cisco NX-OS Software Configuration Tools for Software Configuration Licensing Quality of Service Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 4
C H A P T E R 5 Information About the CLI Prompt Command Modes EXEC Command Mode Global Configuration Command Mode Interface Configuration Command Mode Subinterface Configuration Command Mode Saving and Restoring a Command Mode Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 5
Utility grep and egrep Utilities less Utility sed Utility sort Utility Redirecting show Command Output Using sscp Searching and Filtering from the --More-- Prompt Using the Command History Recalling a Command Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 6
Enabling a Modem Connection Downloading the Default Initialization String Configuring and Downloading a User-Specified Initialization String Initializing a Modem for a Powered-Up Cisco NX-OS Device Clearing Terminal Sessions Displaying Terminal and Session Information Default Settings for Terminal Display and Session Parameters...
Page 7
Information About Device File Systems, Directories, Files, and External Storage Devices File Systems Directories Files Working with External Storage Devices Formatting an External Flash Device Mounting or Unmounting a USB Drive External Storage Device Support Matrix Working with Directories Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 8
Downloading the Running Configuration From a Remote Server Downloading the Startup Configuration From a Remote Server Copying Configuration Files to an External Flash Memory Device Copying the Running Configuration from an External Flash Memory Device Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide viii OL-29291-02...
Page 9
High Availability for NTP Prerequisites for NTP Guidelines and Limitations for NTP Configuring NTP Enabling or Disabling the NTP Protocol Configuring an NTP Server and Peer Displaying and Clearing NTP Statistics Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 10
Configuring the Power Supply Mode About Crossbar Management Operational Considerations when Removing Crossbars Gracefully Shutting Down a Crossbar Provideing Backward Compatibility for Generation 1 Modules in Cisco MDS 9513 Directors About Module Temperature Monitoring Displaying Module Temperatures About Fan Modules...
Page 11
Configuring SSM and MSM Global Upgrade Delay Guidelines for Replacing SSMs and Supervisor Modules Recovering an SSM After Replacing Corrupted CompactFlash Memory Guidelines for Upgrading and Downgrading Cisco MDS NX-OS Releases Default Settings Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide...
Preface This preface describes the audience, organization, and conventions of the Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide. It also provides information on how to obtain related documentation. • Audience, page xiii • Document Conventions, page xiii • Related Documentation, page xv •...
Page 14
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 MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Preface Related Documentation Related Documentation The documentation set for the Cisco MDS 9000 Series includes the following documents. To find a document online, use the Cisco MDS NX-OS Documentation Locator at: http://www.cisco.com/en/US/docs/storage/san_switches/mds9000/roadmaps/doclocater.htm Cisco DCNM documentation is available at the following URL: http://www.cisco.com/en/US/products/ps9369/tsd_products_support_series_home.html...
• Cisco DCNM for SAN Database Schema Reference Obtaining Documentation and Submitting a Service Request For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What's New in Cisco Product Documentation.
Page 17
Preface Obtaining Documentation and Submitting a Service Request 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. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide...
Page 18
Preface Obtaining Documentation and Submitting a Service Request Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide xviii OL-29291-02...
Guide and in the Cisco MDS 9000 Family Fabric Manager Configuration Guide. Those configuration guides remain available on Cisco.com and should be used for all software releases prior to MDS NX-OS Release 4.2(1). Each guide addresses the features introduced in or available in a particular release. Select and view the configuration guide that pertains to the software installed in your switch.
Page 20
Command-Line confirmation prompts. Interface, on page 37 Terminal colors Allowed changes to the 4.2(1) Understanding the colors used for CLI Command-Line elements in the terminal Interface, on page 37 display. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Quality of Service , page 9 Software Compatibility The Cisco NX-OS software interoperates with Cisco products that run any variant of the Cisco IOS software. The Cisco NX-OS software also interoperates with any networking operating system that conforms to the IEEE and RFC compliance standards.
GOLD, see the . Embedded Event Manager Cisco Embedded Event Manager (EEM) is a device and system management feature that helps you to customize behavior based on network events as they happen. For information about configuring EEM, see the .
Cisco NX-OS Software Configuration Cisco NX-OS Software Configuration This section describes the tools you can use to configure Cisco NX-OS software, and provides an overview of the software configuration process with links to the appropriate chapters. Tools for Software Configuration You can use one of two configuration management tools to configure your SANs: •...
Tools for Software Configuration By configuring an IP address as a peer, the Cisco NX-OS device will obtain and provide time as required. The peer is capable of providing time on its own and is capable of having a server configured. If both of these instances point to different time servers, your NTP service is more reliable.
◦ NTP peer 10.10.10.1 Licensing The Cisco NX-OS software licensing feature allows you to access premium features on the device after you install the appropriate license for that feature. Any feature not included in a license package is bundled with the Cisco NX-OS software and is provided to you at no extra charge.
Information About the Cisco NX-OS Setup Utility The Cisco NX-OS setup utility is an interactive command-line interface (CLI) mode that guides you through a basic (also called a startup) configuration of the system. The setup utility allows you to configure only enough connectivity for system management.
SNMP access. If you enable IPv4 routing, the device uses the IPv4 route and the default network IPv4 address. If IPv4 routing is disabled, the device uses the default gateway IPv4 address. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Initial Setup Routine The first time that you access a switch in the Cisco MDS 9000 Family, it runs a setup program that prompts you for the IP address and other configuration information necessary for the switch to communicate over the supervisor module Ethernet interface.
Confirm the password for user_name: user-password c) Assign the user role network-admin (network-operator is the default). Enter the user role [network-operator]: network-admin Step 6 Configure the read-only or read-write SNMP community string. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Enter no (no is the default) at the in-band management configuration prompt. Continue with in-band (VSAN1) management configuration? (yes/no) [no]: no b) Enter yes (yes is the default) to enable IPv4 routing capabilities. Enable ip routing capabilities? (yes/no) [y]: yes Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Configure the default domain name? (yes/no) [n]: yes Enter the default domain name. Default domain name: domain_name Step 11 Enter yes (yes is the default) to enable the SSH service. Enabled SSH service? (yes/no) [n]: yes Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Enter yes (yes is the default) to configure the switchport mode F. Configure default switchport mode F (yes/no) [n]: y Step 21 Enter on (off is the default) to configure the PortChannel auto-create state. Configure default port-channel auto-create state (on/off) [off]: on Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Fibre Channel fabric. Note You can configure both in-band and out-of-band configuration together by entering Yes in both Step 10c and Step 10d in the following procedure. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Using the Cisco NX-OS Setup Utility Configuring In-Band Management SUMMARY STEPS 1. Power on the switch. Switches in the Cisco MDS 9000 Family boot automatically. 2. Enter the new password for the administrator. 3. Enter yes to enter the setup mode.
Enter no (yes is the default) at the configuration prompt to configure out-of-band management. Continue with Out-of-band (mgmt0) management configuration? [yes/no]: no Step 9 Enter yes (yes is the default) to configure the default gateway. Configure the default-gateway: (yes/no) [y]: yes Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Enter no (no is the default) to disable the Telnet service. Enable the telnet service? (yes/no) [y]: no Step 12 Enter yes (yes is the default) to enable the SSH service. Enabled SSH service? (yes/no) [n]: yes Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Enable full zoneset distribution (yes/no) [n]: no Disables the switch-wide default for the full zone set distribution feature. You see the new configuration. Review and edit the configuration that you have just entered. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
If you do not save the configuration at this point, none of your changes are updated the next time the switch Caution is rebooted. Type yes to save the new configuration. This ensures that the kickstart and system images are also automatically configured. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Using the Cisco NX-OS Setup Utility Where to Go Next Where to Go Next To become more familiar with the CLI, continue to . Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 44
Using the Cisco NX-OS Setup Utility Where to Go Next Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
About Power On Auto Provisioning When a Cisco MDS Series switch with 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) in USB port 1.
The POAP configuration guidelines and limitations are as follows: • Only FAT32 USB is supported. (The file system on the USB should be FAT32). For both Cisco MDS 9700 and 9500 series switches, POAP is supported only on USB 1 Port.
• The POAP feature does not require a license, and is enabled by default. • Note POAP is not supported through Cisco Data Center Network Management (DCNM). Network Infrastructure Requirements for POAP When there is no USB device with the required installation files, or the configuration files are not present in the USB, POAP requires the following network infrastructure: •...
◦ The configuration file with the name conf_<serialnum>.cfg must be present in the USB. To obtain the serial number of the switch, run the show sprom backplane 1 command: switch# show sprom backplane 1 DISPLAY backplane sprom contents: Common block: Block Signature : 0xabab Block Version Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Note Ensure that the POAP script identifies the switch. • Only FAT32 USB is supported. (The file system on the USB should be FAT32). For both Cisco Note MDS 9700 and 9500 series switches, POAP is supported only on USB 1 Port.
You can download all the sample files for the POAP process from the following Note link: https://software.cisco.com/download/ release.html?mdfid=283453013&softwareid=282088132&release=6.2(11)&relind=AVAILABLE&rellifecycle=&reltype=latest Ensure that you select the correct version of the Cisco MDS NX-OS release before downloading the sample Note files. The POAP Process The POAP process involves the following phases:...
POAP. No user intervention is required for POAP to continue. The prompt that asks if you want to abort POAP Note remains available until the POAP process is complete. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
35.) The DHCP client on the Cisco MDS switch uses the switch serial number in the client-identifier option to identify itself to the DHCP server. The DHCP server can use this identifier to send information, such as the IP address and script filename, back to the DHCP client.
At that point, the configuration is applied to the switch. Note If script execution fails, the DHCP discovery process restarts. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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. For detailed information about these commands, see the Cisco MDS 9000 Family Command Reference. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
This section describes command modes in the Cisco NX-OS CLI. 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.
You must enable many features on a per-interface basis. Interface configuration commands modify the operation of the interfaces on the device, such as Ethernet interfaces or management interfaces (mgmt 0). For more information about configuring interfaces, see the Cisco Nexus interfaces guide for your device. SUMMARY STEPS 1.
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.
Ctrl-Z. 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 3: Special Characters Character...
Exits to the previous command mode without removing the command string. Ctrl-K Deletes all characters from the cursor to the end of the command line. Ctrl-L Redisplays the current command line. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Displays the next command in the command history. Right arrow key Moves your cursor through the command string, either forward or backward, allowing you to edit the current Left arrow key command. Displays a list of available commands. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
You might be in the wrong command mode or using incorrect syntax. This table lists examples of command abbreviations. Table 5: Examples of Command Abbreviations Command Abbreviation configure terminal conf t Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Identifying Your Location in the Command Hierarchy Some features have a configuration submode hierarchy nested more than one level. In these cases, you can display information about your present working context (PWC). SUMMARY STEPS 1. where detail Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
• 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.
Configures the CLI persistent variable. The variable name is a case-sensitive, alphanumeric string and must begin with an alphabetic character. The maximum length is 31 Example: characters. switch(config)# cli var name testinterface ethernet 2/1 Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
• Command alias configuration takes effect for other user sessions immediately. • 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.
Step 4 alias (Optional) Displays the command alias configuration. Example: switch# alias Step 5 copy running-config startup-config (Optional) Copies the running configuration to the startup configuration. Example: switch# copy running-config startup-config Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
Returns to the beginning of the text line. Inserts a horizontal tab character. Inserts a vertical tab character. Displays a backslash character. \nnn Displays the corresponding ASCII octal character. SUMMARY STEPS 1. echo [backslash-interpret] [text] Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
13:32:00 18 April ? <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 MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
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.
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.
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.
You can use the less utility to display the contents of the show command output one screen at a time. You can enter less commands at the : prompt. To display all less commands you can use, enter h at the : prompt. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
-t delimiter Sorts using a specified delimiter. The default delimiter is the space character. Removes duplicate lines from the sort results. The sort output displays the duplicate lines. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
The initial default is 1 line. If you use the optional lines argument, that value becomes the new default number of lines to display for this command. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
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.
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.
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>...
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...
Specifies the transmission speed for the connection. Stop bits Specifies the stop bits for an asynchronous line. Configure your terminal emulator with 9600 baud, 8 data bits, 1 stop bit, and no parity. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Virtual Terminals 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.
Configures the timeout for an inactive session. The range is from 0 to 525600 minutes (8760 hours). A value of 0 minutes disables the session timeout. The default is 30 Example: minutes. switch(config-console)# exec-timeout 30 Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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 MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
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.
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.
(Optional) 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 MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
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 MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
Example: switch# modem connect line com1 Related Topics Enabling a Modem Connection, on page 77 Clearing Terminal Sessions You can clear terminal sessions on the Cisco NX-OS device. SUMMARY STEPS 1. (Optional) show users 2. clear line name DETAILED STEPS...
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 Terminal Display and Session Parameters This table lists the default settings for terminal displays and session parameters.
C H A P T E R Basic Device Management This chapter describes how to configure, manage, and verify the basic setting on your Cisco NX-OS device. • Information About Basic Device Management, page 85 • Changing the Device Hostname, page 87 •...
Interface Note If the management 10/100 Ethernet port (mgmt0) interface of the Cisco MDS 9700 Series switches has a preconfigured /0 IPv6 address that cannot be removed, use the write erase boot command to clear the complete configuration of the device and reload it. Perform this process before commissioning the device into production as this process is disruptive to user traffic if it is applied to the active supervisor of a system.
Telnet Server Connection The Telnet server is disabled by default on all switches in the Cisco MDS 9000 Family. You can enable the Telnet server if you do not require a secure SSH connection. However, if you require a secure SSH connection, you need to disable the default Telnet connection and then enable the SSH connection.
You only need to configure the mgmt0 interface on the active supervisor module. When a supervisor Note module switchover occurs, the new active supervisor module uses the same configuration for the mgmt0 interface. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
You can configure the MOTD to display before the login prompt on the terminal when a user logs in. The MOTD banner has the following characteristics: • Maximum of 80 characters per line Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Copies the running configuration to the startup configuration. Example: switch# copy running-config startup-config Configuring the Time Zone You can configure the time zone to offset the device clock time from UTC. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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 MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
80 alphanumeric characters and is case sensitive. Example: switch# send Reloading the device is 10 minutes! Enabling or Disabling a Telnet Server Connection You can enable or disable the Telnet server connection. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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 MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Default Settings for Basic Device Parameters This table lists the default settings for basic device parameters. Table 15: Default Basic Device Parameters Parameters Default MOTD banner text User Access Verification Clock time zone Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
This section describes the file systems, directories, files, and support provided to the external storage devices on devices. File Systems This topic provides information about the file system components supported on a Cisco MDS device. (The syntax for specifying a local file system is filesystem:[//modules/]. ) The default filesystem parameter is bootflash:.
You can download files, such as system image files, from remote servers using FTP, Secure Copy Protocol (SCP), Secure File Transfer Protocol (SFTP), and TFTP. You can also copy files from an external server to your device because your device can act as an SCP server. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Mounting or Unmounting a USB Drive Mount or unmount a USB drive automatically by plugging or unplugging the drive from a Cisco MDS device. You can also use the mount or unmount command in either the user EXEC mode or the privileged EXEC mode to mount or unmount the device, respectively.
Switch Cisco MDS 8Gb No hardware — No hardware port No hardware No hardware Fabric Switch for port port port HP BladeSystem c-Class USB 2.0 or higher devices supported. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
To create a new directory, run the following command: mkdir [filesystem:[//module/]]directory Example: switch# mkdir test Displaying Directory Contents To display the contents of a directory, run the following command: dir [directory | filesystem:[//module/][directory]] Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Deleting a Directory You can remove directories from the file systems on a Cisco MDS device. Note • Ensure that the directory is empty before you delete it. If the directory is not empty, you must delete all the files before you delete the directory.
• The copy command supports FTP, SCP, SFTP, TFTP, and HTTP protocols. Deleting a File If you specify a directory, the delete command deletes the entire directory and all of its contents. Caution Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
[filesystem:[//module/][directory/] | directory/]filename Example: switch# gzip show_tech After a file is compressed, it has a .gz suffix. Note • To uncompress a file, run the following command: gunzip [filesystem:[//module/][directory/] | directory/]filename .gz Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
To find all the files beginning with the filename prefix in the default directory and in its subdirectories, run the following command: find filename-prefix Example: switch# find bgp_script Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
The verbose keyword specifies that the software should list the files as they are added to the archive. By default, the files are listed as they are added. Appending Files to an Archive File You can append files to an existing archive file on a device. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Displaying the Filenames in an Archive File The archive filename is not case sensitive. Note To display the file names in an archive file, run the following command: tar list {bootflash: | volatile:}archive-filename Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
This example shows how to perform an In-Service Software Upgrade (ISSU) or In-Service Software Downgrade (ISSD) using a system image or kickstart image from a USB drive: switch# install all system usb1:m9300-s1ek9-mzg.6.2.13.FM.0.65.bin.S0 kickstart usb1:m9300-s1ek9-kickstart-mzg.6.2.13.FM.0.65.bin.S0 Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Examples of Working with Configuration Files, page 123 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.
You can copy a configuration file stored in the internal memory to a remote server as a backup or to use for configuring other Cisco NX-OS devices. SUMMARY STEPS 1. copy running-config scheme://server/[url /]filename 2. copy startup-config scheme://server/[url /]filename Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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.
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.
Related Topics 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. Before You Begin Insert the external flash memory device into the active supervisor module.
Related Topics 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. Before You Begin Insert the external flash memory device into the active supervisor module.
Note switch# reload binary version of the startup configuration. 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. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide...
Displays the installed hardware for the device. Example: switch# show hardware Step 2 purge module slot running-config Removes the configuration for a missing module from the running configuration. Example: switch# purge module 3 running-config Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
To remove the boot variables, running configuration, and the IP configuration on the management interface follow step-3 to step-5. SUMMARY STEPS 1. write erase boot 2. reload 3. write erase 4. write erase boot 5. reload Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
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 MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
By default, the reload command reloads the device from a binary version of the startup configuration. 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.
The Cisco Discovery Protocol (CDP) is an advertisement protocol used by Cisco devices to advertise itself to other Cisco devices in the same network. CDP runs on the data link layer and is independent of Layer 3 protocols. Cisco devices that receive the CDP packets cache the information to make it accessible through the CLI and SNMP.
High Availability for CDP High Availability for CDP The Cisco NX-OS software supports stateless restarts for CDP. After a reboot or a supervisor module switchover, the Cisco NX-OS software applies the running configuration. For more information on high availability, see the .
Table 17: CDP Default Settings Parameters Default Enabled globally and on all interfaces CDP version Version 2 CDP device ID Serial number CDP timer 60 seconds CDP hold timer 180 seconds Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
By configuring an IP address as a peer, the Cisco NX-OS device will obtain and provide time as required. The peer is capable of providing time on its own and is capable of having a server configured. If both of these instances point to different time servers, your NTP service is more reliable.
NTP Configuration Distribution Using CFS NTP Configuration Distribution Using CFS You can enable NTP fabric distribution for all Cisco MDS switches in the fabric. When you perform NTP configurations, and distribution is enabled, the entire server and peer configuration is distributed to all the switches in the fabric.
{peer | io | local | memory} Displays the NTP statistics. You can display the following NTP statistics: Example: • peer—NTP statistics for per peer. switch# show ntp statistics peers • io—NTP statistics for I/O devices. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Acquires a fabric lock and stores all future configuration changes in the pending database. Use the no form of the command Example: to disable NTP configuration distribution. The default is disabled. swtich(config)# ntp distribute Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
When you commit the NTP configuration changes, the Cisco NX-OS software applies the pending changes to the running configuration on the local Cisco MDS switch and to all the Cisco MDS switches in the fabric that can receive NTP configuration distributions. When you commit the NTP configuration changes without implementing the CFS session feature, the NTP configurations are distributed to all the switches in the fabric that have NTP distribution enabled.
Example: swtich(config)# ntp abort Step 3 show ntp session status (Optional) Displays the NTP configuration distribution session status information. Example: swtich(config)# show ntp session status Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Displays the NTP distribution status. show ntp timestamp status Displays if the timestamp check is enabled. NTP Example Configuration This example configures an NTP server: configure terminal ntp server 192.0.2.10 Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Cisco Storage Area Networking Operating System (NX-OS) Software TAC support: http://www.cisco.com/tac Copyright (c) 2003-2004 by Cisco Systems, Inc. All rights reserved. The copyright for certain works contained herein are owned by Cisco Systems, Inc. and/or other third parties and are used and distributed under license. Software BIOS: version 1.0.8...
Displaying the Switch Serial Number You can display the serial number of your Cisco MDS 9000 Family switch by looking at the serial number label on the back of the chassis (next to the power supply), or by using the show sprom backplane 1 command.
In response to this command, power supply capacity and consumption information is displayed for each module. In a Cisco MDS 9500 Series switch, power usage is reserved for both supervisors regardless of whether Note one or both supervisor modules are present.
Cisco MDS 9000 Series Multilayer Switches support different number and capabilities of power supplies. The following describe the power modes that are available on the Cisco MDS 9000 Series Multilayer Switches. Not all the power modes are available on all the Cisco MDS 9000 Series Multilayer Switches.
Page 164
Scenario 3: If 3000 W is added as power supply 2, then the current capacity increases to 5000 W. Reason: 5000 W is twice the minimum (2500 W). This table describes how these scenarios differ. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 165
You decide to change the switch to redundant mode. Then the current capacity decreases to 2500 W and the configuration is rejected. Reason: 2500 W is less than the system usage (3000 W). This table describes these scenarios. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Configuring the Power Supply Mode You can configure power supply modes. SUMMARY STEPS 1. configure terminal 2. power redundancy-mode {combined | insrc-redundant | ps-redundant |redundant} 3. (Optional) show environment power 4. (Optional) copy running-config startup-config Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
• 4/44-port 8-Gbps Host-Optimized Fibre Channel module • Cisco MDS 9513 Fabric-2 Crossbar Switching module Note The new software features in Cisco MDS NX-OS Release 4.1(1b) and later are not supported in the Generation 1 hardware. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide...
• 14/2-port Multiprotocol Services (MPS-14/2) module Operational Considerations when Removing Crossbars You can mix and match Generation 1 and Generation 2 hardware on the Cisco MDS 9500 Series Directors running Cisco MDS NX-OS software without compromising the integrity and availability of your SANs based on Cisco MDS 9500 Series Directors.
Provideing Backward Compatibility for Generation 1 Modules in Cisco MDS 9513 Directors To provide backward compatibility for a Generation 1 module in a Cisco MDS 9513 chassis, the active and backup Supervisor-2 modules are associated to a specific crossbar module. The Supervisor-2 module in slot 7 is associated with crossbar module 1, and Supervisor-2 module in slot 8 is associated with crossbar module 2.
9513 that has only Generation 2 modules installed. About Module Temperature Monitoring Built-in automatic sensors are provided in all switches in the Cisco MDS 9000 Family to monitor your switch at all times. Each module (switching and supervisor) has four sensors: 1 (outlet sensor), 2 (intake sensor), 3 (onboard sensor), and 4 (onboard sensor).
• One or more fans fail within a fan module—Even with multiple fan failures, switches in the Cisco MDS 9000 Family can continue functioning. When a fan fails within a module, the functioning fans in the module increase their speed to compensate for the failed fan(s).
Page 172
If one or more fans fail within a fan module, the Fan Status LED turns red. A fan failure could lead to Note temperature alarms if not corrected immediately. The fan status is continuously monitored by the Cisco MDS NX-OS software. In case of a fan failure, the following action is taken: • System messages are displayed.
Figure 9: Cisco MDS 9513 Front Fan Module Numbering The rear fan module (DS-13SLT-FAN-R) on the Cisco MDS 9513 Director has only two fans. If a fan in the rear fan module fails, the State field in the show environment fan command output only displays "failure"...
Power Supply redundancy mode: redundant Total Power Capacity 919.38 Power reserved for Supervisor(s)[-] 220.08 Power reserved for Fan Module(s)[-] 0.00 Power currently used by Modules[-] 0.00 ------- Total Power Available 699.30 Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
• Cisco MDS 9513 Directors—Two supervisor modules, one in slot 7 (sup-1) and one in slot 8 (sup-2). When the switch powers up and both supervisor modules come up together, the active module is the one that comes up first.
Page 179
Managing Modules Supervisor Modules • Cisco MDS 9200 Series switches—One supervisor module that includes an integrated 16-port switching module. Module Terms Fixed or Relative Usage module-7 and module-8 Fixed usage for the Cisco MDS module-7 always refers to the 9513 Director...
This section includes general information about replacing and using supervisor modules effectively. Replacing Supervisor Modules To avoid packet loss when removing a supervisor module from a Cisco MDS 9500 Series Director, take the supervisor modules out of service before removing the supervisor module.
When updating software images on the standby supervisor module, verify that there is enough space available for the image using the dir bootflash://sup-standby/ command. It is a good practice to remove older versions of Cisco MDS NX-OS images and kickstart images. Standby Supervisor Module Boot Alert...
Status column each time. The switching module goes through a testing and an initializing stage before displaying an ok status. This table describes the module states listed in the show module command output. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
• To display the standby supervisor module information. You cannot configure the standby supervisor module using this command. • To display the switching module portion of the Cisco MDS 9200 Series supervisor module which resides in slot 1. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide...
Reloading a Switch To reload the switch, issue the reload command without any options. When you issue this command, you reboot the switch (see the Cisco MDS 9000 NX-OS Release 4.1(x) and SAN-OS 3(x) Software Upgrade and Downgrade Guide. Power Cycling Modules You can power cycle any module in a chassis.
In this example, the identified module resides in slot switch# reload module 9 force-dnld 1 00:00:46 switch %LC-2-MSG:SLOT9 LOG_LC-2-IMG_DNLD_COMPLETE: COMPLETED downloading of linecard image. Download successful... Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
3 The factory default configuration is applied. module referred to in Step 1. 4 The configuration saved in nonvolatile storage 4 You enter the reload command to reload the referred to in Step 1 is applied. switch. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Enter the purge module slot running-config command to delete the configuration in a specific module. Once you enter this command, the Cisco NX-OS software clears the running configuration for the specified slot. This command does not work on supervisor modules or on any slot that currently has a module. This command only works on an empty slot (where the specified module once resided).
Managing Modules Identifying Module LEDs Identifying Module LEDs This table describes the LEDs for the Cisco MDS 9200 Series integrated supervisor modules. Table 26: LEDs for the Cisco MDS 9200 Series Supervisor Modules Status Description Status Green All diagnostics pass. The module is operational (normal initialization sequence).
Page 189
Link is disabled by software. Flashing yellow A fault condition exists. No link. This table describes the LEDs for the Cisco MDS 9200 Series interface module. Table 27: LEDs on the Cisco MDS 9200 Series Interface Module Status Description Status Green All diagnostics pass.
Page 190
Traffic is flowing through port. No link or no traffic. This table describes the LEDs for the 16-port and 32-port switching modules, and the 4-port, 12-port, 24-port, and 48-port Generation 2 switching modules. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 191
Managing Modules Identifying Module LEDs Table 28: LEDs for the Cisco MDS 9000 Family Fibre Channel Switching Modules Status Description Status Green All diagnostics pass. The module is operational (normal initialization sequence). The module is booting or running diagnostics (normal initialization sequence).
Page 192
The LEDs on the supervisor module indicate the status of the supervisor module, power supplies, and the fan module. This table provides more information about these LEDs. Table 29: LEDs for the Cisco MDS 9500 Series Supervisor Modules Status Description...
Page 193
Link is up. No link. MGMT 10/100 Ethernet Activity Green Traffic is flowing through port. No link or no traffic. Compact Flash Green The external CompactFlash card is being accessed. No activity. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
(EPLDs) that provide hardware functionalities in all modules. EPLD image upgrades are periodically provided to include enhanced hardware functionality or to resolve known issues. Refer to the Cisco MDS NX-OS Release Notes to verify if the EPLD has changed for the Cisco NX-OS image version being used.
Page 195
2 Verify that you have enough free space available on the active and standby supervisor memory devices that you plan to use, either bootflash: or slot0:. The download site on Cisco.com shows the size of the EPLD image file in bytes.
Page 196
* Supervisor/Fabric-1 DS-X9530-SF1-K9 ha-standby The show module command output shows that the standby supervisor is in slot 6. Use the attach command to access the supervisor module. switch# attach module 6 Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 197
Curr Ver New Ver ------------------------------------------------------- XBUS IO 0x07 0x07 UD Flow Control 0x05 0x05 PCI ASIC I/F 0x05 0x05 PCI Bridge 0x05 0x07 WARNING: Upgrade process could take upto 15 minutes. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
2 epld bootflash:m9000-epld-2.1.2.img \ <------------------------------------------------------------progress twirl Module 2 EPLD upgrade is successful When you upgrade the EPLD module on Cisco MDS 9100 Series switches, you receive the following message: Note Data traffic on the switch will stop now!!
Fibre Channel switching mode by default. Note If you downgrade to a Cisco MDS SAN-OS release that does not support the SSM, you must power down the module. The boot variables for the SSM are lost. Installing the SSI Boot Image You can install the SSI boot image on the following modules: •...
Page 200
Step 4 Enter the install ssi command to install the SSI boot image on the SSM. As of Cisco SAN-OS Release 3.0(2), if the SSI boot image is located on bootflash: the install ssi command Note copies the SSI boot image to the modflash: on the SSM.
Update the SSI boot image using one of the following methods: • If your switch is running Cisco MDS SAN-OS Release 2.0(1a) through Release 2.1(1a), configure the SSI boot variable to upgrade or downgrade the SSI boot image on the module.
1. Log into the switch through the console port, an SSH session, or a Telnet session. 2. Enter the show version command to ensure that your switch is running Cisco MDS SAN-OS Release 2.1(1a) or later system and kickstart images.
Page 203
2 Verify that you have enough free space available on the active and standby supervisor memory devices which you plan to use, either bootflash: or slot0:. The download site on Cisco.com shows the size of the boot image file in bytes.
Page 205
4 Copy the EPLD image file from the FTP server to the bootflash: or slot0: device in the active supervisor module. The following example shows how to copy to bootflash: switch# copy ftp://10.1.7.2/m9000-epld-4.1.1b.img bootflash:m9000-epld-4.1.1b.img Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Issue a show module command to verify the status of the module. 3. Verify the Cisco MDS NX-OS release running on the switch and the location and name of the SSI boot image on the switch.
Page 207
Upgrading or Downgrading the SSI Boot Image Note the slot number for later reference. Step 3 Verify the Cisco MDS NX-OS release running on the switch and the location and name of the SSI boot image on the switch. Step 4 Install the SSI image on the SSM.
Recovering an SSM After Replacing Corrupted CompactFlash Memory As of Cisco MDS NX-OS Release 4.1(1a) and SAN-OS Release 2.1(2), you can use the CompactFlash memory (modflash:) on the SSM to store the SSI image. If the modflash: on the SSM is replaced, the SSM might not initialize.
2 Guidelines for Upgrading and Downgrading Cisco MDS NX-OS Releases Consider the following guidelines when upgrading and downgrading the Cisco MDS NX-OS software on a switch containing an SSM: Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide...
Page 211
Manager GUI to upgrade SSMs once it has been installed. • If you downgrade to a Cisco MDS NX-OS release that does not support the SSM, you must power down the module. The boot variables for the module are lost.
• No value for location. System clock No value for system clock time. In-band (VSAN 1) interface IP address, subnet mask, and broadcast address assigned to the VSAN are set to 0.0.0.0. Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02...
Page 213
Table 32: Default Supervisor Module Settings Parameter Default Initial state when installed • Power-down state on switches with Cisco MDS SAN-OS Release 2.1(1a) and earlier installed. • Fibre Channel switching mode on switches with Cisco MDS SAN-OS Release 2.1(2) and NX-OS Release 4.1(1b), or later installed and SSMs...
Page 216
EDLD images POAP process 32, 33, 34, 35, 36 downgrading DHCP phase post-installation reload phase description power up phase egrep utility script execution phase filtering show command output using POAP Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide IN-2 OL-29291-02...
Page 217
LEDs grep utility descriptions keywords less utility less utility filtering show command output sed utility searching show command output show command output licensing support loader> prompt description Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide OL-29291-02 IN-3...
Page 218
See also POAP clearing a session privileged EXEC mode clearing statistics 135, 139 summary configuration distribution prompts, See confirmation prompts configuring a server, example configuring peer default settings Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide IN-4 OL-29291-02...