Cisco MDS 9000 Series User manual

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
USA
http://www.cisco.com
Tel: [phone]
800 553-NETS (6387)
Fax: [phone]
Text Part Number: OL-29291-02

©2008-2014 Cisco Systems, Inc. All rights reserved.

CONTENTS
Preface Preface xiii
Audience xiii
Document Conventions xiii
Related Documentation xv
Obtaining Documentation and Submitting a Service Request xvi
CHAPTER 1 New and Changed Information 1
New and Changed Information 1
CHAPTER 2 Overview 5
Software Compatibility 5
Modular Software Design 5
Serviceability 5
Switched Port Analyzer 6
Call Home 6
Online Diagnostics 6
Embedded Event Manager 6
Manageability 6
Simple Network Management Protocol 6
Role-Based Access Control 6
Cisco NX-OS Software Configuration 7
Tools for Software Configuration 7
CLI 7
NTP 7
Licensing 9
Quality of Service 9
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
OL-29291-02 iii

CHAPTER 3 Using the Cisco NX-OS Setup Utility 11
Information About the Cisco NX-OS Setup Utility 11
Prerequisites for the Setup Utility 13
Initial Setup Routine 13
Configuring Out-of-Band Management 13
Configuring In-Band Management 19
Where to Go Next 25
CHAPTER 4 Using PowerOn Auto Provisioning 27
Using Power On Auto Provisioning 27
About Power On Auto Provisioning 27
POAP Configuration Script 28
Guidelines and Limitations for POAP Configuration 28
Network Infrastructure Requirements for POAP 29
Setting Up the Network Environment to use POAP 30
Using USB 30
Using a DHCP Server 31
The POAP Process 32
The Power-Up Phase 33
The USB Discovery Phase 34
The DHCP Discovery Phase 34
Script Execution Phase 35
Post-Installation Reload Phase 36
Configuring a Switch Using POAP 36
Verifying the Device Configuration 36
CHAPTER 5 Understanding the Command-Line Interface 37
Information About the CLI Prompt 38
Command Modes 38
EXEC Command Mode 38
Global Configuration Command Mode 38
Interface Configuration Command Mode 39
Subinterface Configuration Command Mode 40
Saving and Restoring a Command Mode 40
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
iv OL-29291-02
Contents

Command Mode Summary 41
Special Characters 41
Keystroke Shortcuts 42
Abbreviating Commands 44
Completing a Partial Command Name 45
Identifying Your Location in the Command Hierarchy 45
Using the no Form of a Command 46
Configuring CLI Variables 47
About CLI Variables 47
Configuring CLI Session-Only Variables 47
Configuring Persistent CLI Variables 48
Command Aliases 49
About Command Aliases 49
Defining Command Aliases 50
Configuring Command Aliases for a User Session 51
Command Scripts 51
Running a Command Script 51
Echoing Information to the Terminal 52
Delaying Command Action 53
Context-Sensitive Help 53
Understanding Regular Expressions 55
Special Characters 55
Multiple-Character Patterns 55
Anchoring 56
Searching and Filtering show Command Output 56
Filtering and Searching Keywords 57
diff Utility 58
grep and egrep Utilities 59
less Utility 59
sed Utility 60
sort Utility 60
Redirecting show Command Output Using sscp 61
Searching and Filtering from the --More-- Prompt 61
Using the Command History 62
Recalling a Command 62
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
OL-29291-02 v
Contents

Configuring the CLI Edit Mode 63
Controlling CLI History Recall 63
Displaying the Command History 63
Enabling or Disabling the CLI Confirmation Prompts 64
Setting CLI Display Colors 64
Sending Commands to Modules 65
BIOS Loader Prompt 66
Examples Using the CLI 66
Defining Command Aliases 66
Using CLI Session Variables 66
Using the System-Defined Timestamp Variable 67
Running a Command Script 67
Using the sscp Utility to Redirect show Command Output 68
CHAPTER 6 Configuring Terminal Settings and Sessions 69
Information About Terminal Settings and Sessions 69
Terminal Session Settings 69
Console Port 70
COM1 Port 70
Virtual Terminals 71
Modem Support 71
Configuring the Console Port 71
Configuring the COM1 Port 73
Configuring Virtual Terminals 75
Configuring the Inactive Session Timeout 75
Configuring the Session Limit 76
Configuring Modem Connections 77
Enabling a Modem Connection 77
Downloading the Default Initialization String 79
Configuring and Downloading a User-Specified Initialization String 80
Initializing a Modem for a Powered-Up Cisco NX-OS Device 81
Clearing Terminal Sessions 82
Displaying Terminal and Session Information 82
Default Settings for Terminal Display and Session Parameters 83
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
vi OL-29291-02
Contents

CHAPTER 7 Basic Device Management 85
Information About Basic Device Management 85
Device Hostname 85
Interface 86
Default Gateway 86
Message-of-the-Day Banner 87
Device Clock 87
Time Zone and Summer Time (Daylight Saving Time) 87
User Sessions 87
Telnet Server Connection 87
Changing the Device Hostname 87
Configuring the Management Interface 88
Configuirng the Default Gateway 90
Configuring the MOTD Banner 90
Configuring the Time Zone 91
Configuring Summer Time (Daylight Saving Time) 92
Manually Setting the Device Clock 94
Managing Users 94
Displaying Information about the User Sessions 94
Sending a Message to Users 95
Enabling or Disabling a Telnet Server Connection 95
Verifying the Device Configuration 96
Default Settings for Basic Device Parameters 97
CHAPTER 8 Using the Device File Systems, Directories, and Files 99
Information About Device File Systems, Directories, Files, and External Storage Devices 99
File Systems 99
Directories 100
Files 100
Working with External Storage Devices 101
Formatting an External Flash Device 101
Mounting or Unmounting a USB Drive 101
External Storage Device Support Matrix 101
Working with Directories 103
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
OL-29291-02 vii
Contents

Identifying the Current Directory 103
Changing the Current Directory 103
Creating a Directory 103
Displaying Directory Contents 103
Deleting a Directory 104
Accessing the Directories on a Standby Supervisor Module 104
Working with Files 104
Moving a File 104
Copying a File 105
Deleting a File 105
Displaying a File's Contents 106
Displaying a File's Checksums 106
Compressing and Uncompressing a File 106
Displaying the Last Lines in a File 107
Redirecting show Command Output to a File 107
Finding Files 107
Working with Archive Files 108
Creating an Archive File 108
Appending Files to an Archive File 108
Extracting Files from an Archive File 109
Displaying the Filenames in an Archive File 109
Examples of Using a File System 110
Accessing Directories on a Standby Supervisor Module 110
Performing ISSU or ISSD Using a USB Drive 110
CHAPTER 9 Working with Configuration Files 111
Information About Configuration Files 111
Types of Configuration Files 111
Managing Configuration Files 112
Saving the Running Configuration to the Startup Configuration 112
Copying a Configuration File to a Remote Server 112
Downloading the Running Configuration From a Remote Server 113
Downloading the Startup Configuration From a Remote Server 114
Copying Configuration Files to an External Flash Memory Device 116
Copying the Running Configuration from an External Flash Memory Device 116
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
viii OL-29291-02
Contents

Copying the Startup Configuration from an External Flash Memory Device 117
Copying Configuration Files to an Internal File System 118
Rolling Back to a Previous Configuration 119
Removing the Configuration for a Missing Module 120
Erasing a Configuration 121
Verifying the Device Configuration 122
Examples of Working with Configuration Files 123
Copying Configuration Files 123
Backing Up Configuration Files 123
Rolling Back to a Previous Configuration 123
CHAPTER 10 Configuring CDP 125
Information About CDP 125
CDP Overview 125
High Availability for CDP 126
Configuring CDP 126
Enabling or Disabling CDP Globally 126
Enabling or Disabling CDP on an Interface 127
Configuring Optional CDP Parameters 128
Verifying the CDP Configuration 128
Clearing CDP Counters and Tables 129
CDP Example Configuration 129
Default Settings for CDP 129
CHAPTER 11 Configuring NTP 131
Information About NTP 131
NTP 131
NTP Configuration Distribution Using CFS 133
High Availability for NTP 133
Prerequisites for NTP 133
Guidelines and Limitations for NTP 133
Configuring NTP 133
Enabling or Disabling the NTP Protocol 134
Configuring an NTP Server and Peer 134
Displaying and Clearing NTP Statistics 135
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
OL-29291-02 ix
Contents

Distributing the NTP Configuration Using CFS 136
Enabling NTP Configuration Distribution 136
Committing NTP Configuration Changes 137
Discarding NTP Configuration Changes 138
Releasing Fabric Session Lock on the NTP Configuration 139
Verifying NTP Configuration 139
NTP Example Configuration 139
Default Settings for NTP 140
CHAPTER 12 Managing System Hardware 141
Displaying Switch Hardware Inventory 141
Displaying the Switch Serial Number 143
Displaying Power Usage Information 144
Power Supply Modes 145
Configuration Guidelines for Power Supplies 145
Configuring the Power Supply Mode 148
About Crossbar Management 149
Operational Considerations when Removing Crossbars 150
Gracefully Shutting Down a Crossbar 151
Provideing Backward Compatibility for Generation 1 Modules in Cisco MDS 9513
Directors 151
About Module Temperature Monitoring 152
Displaying Module Temperatures 153
About Fan Modules 153
About Clock Modules 155
Displaying Environment Information 156
Default Settings 157
CHAPTER 13 Managing Modules 159
About Modules 159
Supervisor Modules 160
Switching Modules 162
Services Modules 162
Maintaining Supervisor Modules 162
Replacing Supervisor Modules 162
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
xOL-29291-02
Contents

Standby Supervisor Module Boot Variable Version 163
Standby Supervisor Module Bootflash Memory 163
Standby Supervisor Module Boot Alert 163
Verifying the Status of a Module 163
Checking the State of a Module 164
Connecting to a Module 165
Reloading Modules 166
Reloading a Switch 166
Power Cycling Modules 166
Reloading Switching Modules 167
Saving the Module Configuration 168
Purging Module Configurations 169
Powering Off Switching Modules 169
Identifying Module LEDs 170
EPLD Images 176
Upgrading EPLD Images 176
Displaying EPLD Image Versions 180
SSI Boot Images 181
Installing the SSI Boot Image 181
Upgrading or Downgrading the SSI Boot Image 183
SSI Boot Image Upgrade Considerations for the SSM 183
Verifying the SSI Boot Image 184
Using the install ssi Command 188
Managing SSMs and Supervisor Modules 190
Configuring SSM and MSM Global Upgrade Delay 190
Guidelines for Replacing SSMs and Supervisor Modules 191
Recovering an SSM After Replacing Corrupted CompactFlash Memory 191
Guidelines for Upgrading and Downgrading Cisco MDS NX-OS Releases 192
Default Settings 194
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
OL-29291-02 xi
Contents

Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
xii OL-29291-02
Contents

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
•Obtaining Documentation and Submitting a Service Request, page xvi
Audience
This guide is for experienced network administrators who are responsible for configuring and maintaining
the Cisco MDS 9000 Family of multilayer directors and fabric switches.
Document Conventions
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. As a result of this, you may find a
deviation in the style used to describe these tasks, with the newly included sections of the document
following the new format.
Note
Command descriptions use the following conventions:
DescriptionConvention
Bold text indicates the commands and keywords that you enter literally
as shown.
bold
Italic text indicates arguments for which the user supplies the values.
Italic
Square brackets enclose an optional element (keyword or argument).[x]
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
OL-29291-02 xiii

DescriptionConvention
Square brackets enclosing keywords or arguments separated by a vertical
bar indicate an optional choice.
[x | y]
Braces enclosing keywords or arguments separated by a vertical bar
indicate a required choice.
{x | y}
Nested set of square brackets or braces indicate optional or required
choices within optional or required elements. Braces and a vertical bar
within square brackets indicate a required choice within an optional
element.
[x {y | z}]
Indicates a variable for which you supply values, in context where italics
cannot be used.
variable
A nonquoted set of characters. Do not use quotation marks around the
string or the string will include the quotation marks.
string
Examples use the following conventions:
DescriptionConvention
Terminal sessions and information the switch displays are in screen font.screen font
Information you must enter is in boldface screen font.boldface screen font
Arguments for which you supply values are in italic screen font.
italic screen font
Nonprinting characters, such as passwords, are in angle brackets.< >
Default responses to system prompts are in square brackets.[ ]
An exclamation point (!) or a pound sign (#) at the beginning of a line
of code indicates a comment line.
!, #
This document uses the following conventions:
Means reader take note. Notes contain helpful suggestions or references to material not covered in the
manual.
Note
Means reader be careful. In this situation, you might do something that could result in equipment damage
or loss of data.
Caution
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
xiv OL-29291-02
Preface
Document Conventions

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
Release Notes
•Cisco MDS 9000 Series Release Notes for Cisco MDS NX-OS Releases
•Cisco MDS 9000 Series Release Notes for MDS SAN-OS Releases
•Cisco MDS 9000 Series Release Notes for Storage Services Interface Images
•Cisco MDS 9000 Series Release Notes for Cisco MDS 9000 EPLD Images
•Cisco Data Center Network Manager Release Notes
Regulatory Compliance and Safety Information
Regulatory Compliance and Safety Information for the Cisco MDS 9000 Series
Compatibility Information
•Cisco Data Center Interoperability Support Matrix
•Cisco MDS 9000 NX-OS Hardware and Software Compatibility Information and Feature Lists
•Cisco MDS NX-OS Release Compatibility Matrix for Storage Service Interface Images
•Cisco MDS 9000 Series Switch-to-Switch Interoperability Configuration Guide
•Cisco MDS NX-OS Release Compatibility Matrix for IBM SAN Volume Controller Software for Cisco
MDS 9000
Hardware Installation
•Cisco MDS 9700 Director Hardware Installation Guide
•Cisco MDS 9500 Series Hardware Installation Guide
•Cisco MDS 9250i Multiservice Switch Hardware Installation Guide
•Cisco MDS 9200 Series Hardware Installation Guide
Software Installation and Upgrade
•Cisco MDS 9000 Series Storage Services Interface Image Install and Upgrade Guide
•Cisco MDS 9000 Series Storage Services Module Software Installation and Upgrade Guide
•Cisco MDS 9000 NX-OS Release 4.1(x) and SAN-OS 3(x) Software Upgrade and Downgrade Guide
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
OL-29291-02 xv
Preface
Related Documentation

Cisco NX-OS
•Cisco MDS 9000 Series NX-OS Fundamentals Configuration Guide
•Cisco MDS 9000 Series NX-OS Licensing Guide
•Cisco MDS 9000 Series NX-OS System Management Configuration Guide
•Cisco MDS 9000 Series NX-OS Interfaces Configuration Guide
•Cisco MDS 9000 Series NX-OS Fabric Configuration Guide
•Cisco MDS 9000 Series NX-OS Quality of Service Configuration Guide
•Cisco MDS 9000 Series NX-OS Security Configuration Guide
•Cisco MDS 9000 Series NX-OS IP Services Configuration Guide
•Cisco MDS 9000 Series NX-OS Intelligent Storage Services Configuration Guide
•Cisco MDS 9000 Series NX-OS High Availability and Redundancy Configuration Guide
•Cisco MDS 9000 Series NX-OS Inter-VSAN Routing Configuration Guide
Command-Line Interface
Cisco MDS 9000 Series Command Reference
Intelligent Storage Networking Services Configuration Guides
•Cisco MDS 9000 I/O Acceleration Configuration Guide
•Cisco MDS 9000 Series SANTap Deployment Guide
•Cisco MDS 9000 Series Data Mobility Manager Configuration Guide
•Cisco MDS 9000 Series Storage Media Encryption Configuration Guide
•Cisco MDS 9000 Series Secure Erase Configuration Guide
•Cisco MDS 9000 Series Cookbook for Cisco MDS SAN-OS
Troubleshooting and Reference
•Cisco NX-OS System Messages Reference
•Cisco MDS 9000 Series NX-OS Troubleshooting Guide
•Cisco MDS 9000 Series NX-OS MIB Quick Reference
•Cisco MDS 9000 Series NX-OS SMI-S Programming Reference
•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.
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
xvi OL-29291-02
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
OL-29291-02 xvii
Preface
Obtaining Documentation and Submitting a Service Request

Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
xviii OL-29291-02
Preface
Obtaining Documentation and Submitting a Service Request

CHAPTER 1
New and Changed Information
This chapter provides release-specific information for each new and changed feature in the Cisco MDS 9000
Family NX-OS Fundamentals Configuration Guide. The latest version of this document is available at the
following Cisco website:
http://www.cisco.com/en/US/products/ps5989/products_installation_and_configuration_guides_list.html
•New and Changed Information, page 1
New and Changed Information
As of Cisco MDS NX-OS Release 4.2(1), software configuration information is available in new feature-specific
configuration guides for the following information:
•System management
•Interfaces
•Fabric
•Quality of service
•Security
•IP services
•High availability and redundancy
The information in these new guides previously existed in the Cisco MDS 9000 Family CLI Configuration
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.
To find additional information about Cisco NX-OS Release 6.2, see Cisco MDS 9000 Family NX-OS Release
Notes.
This table summarizes the new and changed features for the Cisco MDS 9000 Family NX-OS Fundamentals
Configuration Guide, and tells you where they are documented.
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
OL-29291-02 1

Table 1: New and Changed Features for Release 6.2
Where DocumentedChanged in ReleaseDescriptionFeature
Using PowerOn Auto
Provisioning, on page
27
6.2(9)PowerOn Auto
Provisioning (POAP)
automates the process of
upgrading software
images and installing
configuration files on the
Cisco MDS 9148, 9148S,
and 9396S Multilayer
Fabric Switches.
POAP
Understanding the
Command-Line
Interface, on page 37
4.2(1)Allows comparison of
command outputs.
diff utility
Understanding the
Command-Line
Interface, on page 37
4.2(1)Can be used in show
command searching and
filtering.
Allows command aliases
for users sessions.
Command aliases
Understanding the
Command-Line
Interface, on page 37
4.2(1)Allows redirection of
command outupt to SSH
sessions on remote
servers.
Streaming secure copy
(sscp)
Understanding the
Command-Line
Interface, on page 37
4.2(1)Allows sending
commands directly to a
module from the
supervisor module
session.
I/O module commands
Understanding the
Command-Line
Interface, on page 37
4.2(1)Provides changes to the
show cli history
command.
Command history
Understanding the
Command-Line
Interface, on page 37
4.2(1)Allows saving and
restoring of command
modes.
Command modes
Understanding the
Command-Line
Interface, on page 37
4.2(1)Allows enabling and
disabling for command
confirmation prompts.
Confirmation prompts
Understanding the
Command-Line
Interface, on page 37
4.2(1)Allowed changes to the
colors used for CLI
elements in the terminal
display.
Terminal colors
Cisco MDS 9000 Family NX-OS Fundamentals Configuration Guide
2OL-29291-02
New and Changed Information
New and Changed Information