Cisco Nexus 5000 Series User manual

Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide,
Release 5.2(1)N1(1)
First Published: July 02, 2012
Last Modified: July 02, 2012
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-27583-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright ©1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
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: http://
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. (1110R)
©2012 Cisco Systems, Inc. All rights reserved.

CONTENTS
Preface Preface xix
Audience xix
Document Conventions xix
Documentation Feedback xxi
Obtaining Documentation and Submitting a Service Request xxi
CHAPTER 1 New and Changed Information for this Release 1
CHAPTER 2 Overview 3
SAN Switching Overview 3
CHAPTER 3 Configuring Fibre Channel Interfaces 7
Configuring Fibre Channel Interfaces 7
Information About Fibre Channel Interfaces 7
Licensing Requirements for Fibre Channel 7
QOS Requirements for Fibre Channel 7
Physical Fibre Channel Interfaces 8
Virtual Fibre Channel Interfaces 8
VF Port 8
VE Ports 9
VNP Ports 9
Interface Modes 10
E Port 10
F Port 10
NP Port 11
TE Port 11
TF Port 11
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 iii

TNP Port 11
SD Port 12
Auto Mode 12
Interface States 12
Administrative States 12
Operational States 12
Reason Codes 13
Buffer-to-Buffer Credits 15
Configuring Fibre Channel Interfaces 16
Configuring a Fibre Channel Interface 16
Configuring a Range of Fibre Channel Interfaces 16
Setting the Interface Administrative State 17
Configuring Interface Modes 17
Configuring the Interface Description 18
Configuring Unified Ports 19
Configuring Port Speeds 20
Autosensing 21
Configuring SD Port Frame Encapsulation 21
Configuring Receive Data Field Size 21
Understanding Bit Error Thresholds 22
Configuring Global Attributes for Fibre Channel Interfaces 23
Configuring Switch Port Attribute Default Values 23
Information About N Port Identifier Virtualization 24
Enabling N Port Identifier Virtualization 24
Example Port Channel Configurations 25
Verifying Fibre Channel Interfaces 26
Verifying SFP Transmitter Types 26
Verifying Interface Information 26
Verifying BB_Credit Information 28
Default Fibre Channel Interface Settings 28
CHAPTER 4 Configuring Fibre Channel Domain Parameters 31
Information About Domain Parameters 31
Fibre Channel Domains 31
Domain Restarts 32
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
iv OL-27583-01
Contents

Restarting a Domain 33
Domain Manager Fast Restart 33
Enabling Domain Manager Fast Restart 34
Switch Priority 34
Configuring Switch Priority 34
About fcdomain Initiation 35
Disabling or Reenabling fcdomains 35
Configuring Fabric Names 36
Incoming RCFs 37
Rejecting Incoming RCFs 37
Autoreconfiguring Merged Fabrics 37
Enabling Autoreconfiguration 38
Domain IDs 38
Domain IDs 39
Configuring Static or Preferred Domain IDs 40
Allowed Domain ID Lists 41
Configuring Allowed Domain ID Lists 41
CFS Distribution of Allowed Domain ID Lists 42
Enabling Distribution 42
Locking the Fabric 43
Committing Changes 43
Discarding Changes 44
Clearing a Fabric Lock 45
Displaying CFS Distribution Status 45
Displaying Pending Changes 45
Displaying Session Status 45
Contiguous Domain ID Assignments 46
Enabling Contiguous Domain ID Assignments 46
FC IDs 47
Persistent FC IDs 47
Enabling the Persistent FC ID Feature 47
Persistent FC ID Configuration Guidelines 48
Configuring Persistent FC IDs 48
Unique Area FC IDs for HBAs 49
Configuring Unique Area FC IDs for an HBA 50
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 v
Contents

Persistent FC ID Selective Purging 51
Purging Persistent FC IDs 51
Verifying the fcdomain Configuration 52
Default Settings for Fibre Channel Domains 53
CHAPTER 5 Configuring N Port Virtualization 55
Configuring N Port Virtualization 55
Information About NPV 55
NPV Overview 55
NPV Mode 56
Server Interfaces 56
NP Uplinks 57
FLOGI Operation 57
NPV Traffic Management 58
Automatic Uplink Selection 58
Traffic Maps 58
Disruptive Load Balancing 59
NPV Traffic Management Guidelines 59
NPV Guidelines and Limitations 59
Configuring NPV 60
Enabling NPV 60
Configuring NPV Interfaces 61
Configuring an NP Interface 61
Configuring a Server Interface 62
Configuring NPV Traffic Management 62
Configuring NPV Traffic Maps 62
Enabling Disruptive Load Balancing 63
Verifying NPV 63
Verifying NPV Examples 64
Verifying NPV Traffic Management 65
CHAPTER 6 Configuring FCoE NPV 67
Information About FCoE NPV 67
FCoE NPV Model 69
Mapping Requirements 70
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
vi OL-27583-01
Contents

Port Requirements 71
NPV Features 71
vPC Topologies 72
Supported and Unsupported Topologies 73
Guidelines and Limitations 77
FCoE NPV Configuration Limits 77
Default Settings 78
Enabling FCoE and Enabling NPV 78
Enabling FCoE NPV 79
Configuring NPV Ports for FCoE NPV 80
Verifying FCoE NPV Configuration 80
Configuration Examples for FCoE NPV 81
CHAPTER 7 Configuring VSAN Trunking 85
Configuring VSAN Trunking 85
Information About VSAN Trunking 85
VSAN Trunking Mismatches 86
VSAN Trunking Protocol 86
Configuring VSAN Trunking 87
Guidelines and Limitations 87
Enabling or Disabling the VSAN Trunking Protocol 87
Trunk Mode 87
Configuring Trunk Mode 88
Trunk-Allowed VSAN Lists 90
Configuring an Allowed-Active List of VSANs 91
Displaying VSAN Trunking Information 92
Default Settings for VSAN Trunks 93
CHAPTER 8 Configuring SAN Port Channels 95
Configuring SAN Port Channels 95
Information About SAN Port Channels 95
Understanding Port Channels and VSAN Trunking 96
Understanding Load Balancing 97
Configuring SAN Port Channels 99
SAN Port Channel Configuration Guidelines 101
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 vii
Contents

F and TF Port Channel Guidelines 101
Creating a SAN Port Channel 102
About Port Channel Modes 102
Configuring Active Mode SAN Port Channel 103
About SAN Port Channel Deletion 104
Deleting SAN Port Channels 104
Interfaces in a SAN Port Channel 105
About Interface Addition to a SAN Port Channel 105
Compatibility Check 105
Suspended and Isolated States 106
Adding an Interface to a SAN Port Channel 106
Forcing an Interface Addition 107
About Interface Deletion from a SAN Port Channel 108
Deleting an Interface from a SAN Port Channel 108
SAN Port Channel Protocol 108
About Channel Group Creation 109
Autocreation Guidelines 110
Enabling and Configuring Autocreation 111
About Manually Configured Channel Groups 112
Converting to Manually Configured Channel Groups 112
Example Port Channel Configurations 112
Verifying SAN Port Channel Configuration 113
Default Settings for SAN Port Channels 114
CHAPTER 9 Configuring and Managing VSANs 115
Configuring and Managing VSANs 115
Information About VSANs 115
VSAN Topologies 115
VSAN Advantages 118
VSANs Versus Zones 118
Guidelines and Limitations for VSANs 119
About VSAN Creation 120
Creating VSANs Statically 120
Port VSAN Membership 122
Assigning Static Port VSAN Membership 122
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
viii OL-27583-01
Contents

Displaying VSAN Static Membership 123
Default VSANs 123
Isolated VSANs 124
Displaying Isolated VSAN Membership 124
Operational State of a VSAN 124
Static VSAN Deletion 124
Deleting Static VSANs 125
About Load Balancing 126
Configuring Load Balancing 126
Interop Mode 128
Displaying the Static VSAN Configuration 128
Default Settings for VSANs 128
CHAPTER 10 Configuring and Managing Zones 131
Information About Zones 131
Information About Zoning 131
Zoning Features 131
Zoning Example 133
Zone Implementation 134
Active and Full Zone Sets 134
Configuring a Zone 137
Configuration Examples 137
Zone Sets 139
Activating a Zone Set 139
Default Zone 140
Configuring the Default Zone Access Permission 141
FC Alias Creation 141
Creating FC Aliases 142
Creating FC Aliases Example 142
Creating Zone Sets and Adding Member Zones 143
Zone Enforcement 144
Zone Set Distribution 145
Enabling Full Zone Set Distribution 145
Enabling a One-Time Distribution 146
Recovering from Link Isolation 146
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 ix
Contents

Importing and Exporting Zone Sets 147
Zone Set Duplication 147
Copying Zone Sets 148
Renaming Zones, Zone Sets, and Aliases 148
Cloning Zones, Zone Sets, FC Aliases, and Zone Attribute Groups 149
Clearing the Zone Server Database 150
Verifying the Zone Configuration 151
Information About Smart Zoning 151
Smart Zoning Member Configuration 152
Enabling Smart Zoning on a VSAN 152
Setting Default Value for Smart Zoning 152
Configuring Device Types for Zone Members 153
Converting Zones Automatically to Smart Zoning 154
Removing Smart Zoning Configuration 154
Disabling Smart Zoning at Zone Level 155
Enhanced Zoning 156
Enhanced Zoning 156
Changing from Basic Zoning to Enhanced Zoning 157
Changing from Enhanced Zoning to Basic Zoning 158
Enabling Enhanced Zoning 158
Modifying the Zone Database 159
Releasing Zone Database Locks 160
Merging the Database 160
Configuring Zone Merge Control Policies 161
Default Zone Policies 162
Configuring System Default Zoning Settings 162
Verifying Enhanced Zone Information 163
Compacting the Zone Database 163
Analyzing the Zone and Zone Set 164
Default Settings for Zones 164
CHAPTER 11 Distributing Device Alias Services 167
Distributing Device Alias Services 167
Information About Device Aliases 167
Device Alias Features 167
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
xOL-27583-01
Contents

Device Alias Requirements 168
Zone Aliases Versus Device Aliases 168
Device Alias Databases 169
Creating Device Aliases 169
Device Alias Modes 170
Device Alias Mode Guidelines and Limitations for Device Alias Services 171
Configuring Device Alias Modes 171
Device Alias Distribution 172
Locking the Fabric 172
Committing Changes 172
Discarding Changes 173
Overriding the Fabric Lock 174
Disabling and Enabling Device Alias Distribution 174
Legacy Zone Alias Configuration 176
Importing a Zone Alias 176
Device Alias Database Merge Guidelines 176
Verifying the Device Alias Configuration 177
Default Settings for Device Alias Services 177
CHAPTER 12 Configuring Fibre Channel Routing Services and Protocols 179
Information About Fibre Channel Routing Services and Protocols 179
Information About FSPF 180
FSPF Examples 180
Fault Tolerant Fabric Example 180
Redundant Link Example 181
FSPF Global Configuration 181
SPF Computational Hold Times 182
Link State Records 182
Configuring FSPF on a VSAN 182
Resetting FSPF to the Default Configuration 183
Enabling or Disabling FSPF 184
Clearing FSPF Counters for the VSAN 184
FSPF Interface Configuration 185
FSPF Link Cost 185
Configuring FSPF Link Cost 185
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 xi
Contents

Hello Time Intervals 186
Configuring Hello Time Intervals 186
Dead Time Intervals 187
Configuring Dead Time Intervals 187
Retransmitting Intervals 187
Configuring Retransmitting Intervals 188
About Disabling FSPF for Specific Interfaces 188
Disabling FSPF for Specific Interfaces 188
Clearing FSPF Counters for an Interface 189
FSPF Routes 190
Fibre Channel Routes 190
Configuring Fibre Channel Routes 190
In-Order Delivery 191
Reordering Network Frames 192
Reordering SAN Port Channel Frames 192
About Enabling In-Order Delivery 193
Enabling In-Order Delivery 193
Enabling In-Order Delivery for a VSAN 194
Displaying the In-Order Delivery Status 195
Configuring the Drop Latency Time 195
Displaying Latency Information 196
Flow Statistics Configuration 196
Flow Statistics 196
Counting Aggregated Flow Statistics 196
Counting Individual Flow Statistics 197
Clearing FIB Statistics 198
Displaying Flow Statistics 198
Default Settings for FSFP 198
CHAPTER 13 Managing FLOGI, Name Server, FDMI, and RSCN Databases 201
Managing FLOGI, Name Server, FDMI, and RSCN Databases 201
Fabric Login 201
Name Server Proxy 202
About Registering Name Server Proxies 202
Registering Name Server Proxies 202
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
xii OL-27583-01
Contents

Rejecting Duplicate pWWNs 203
Rejecting Duplicate pWWNs 203
Name Server Database Entries 204
Displaying Name Server Database Entries 204
FDMI 204
Displaying FDMI 205
RSCN 205
About RSCN Information 205
Configuring the Port-Address Format 206
Displaying RSCN Information 206
Multi-pid Option 207
Configuring the multi-pid Option 207
Suppressing Domain Format SW-RSCNs 208
Clearing RSCN Statistics 208
Configuring the RSCN Timer 208
Verifying the RSCN Timer Configuration 210
RSCN Timer Configuration Distribution 210
Enabling RSCN Timer Configuration Distribution 210
Locking the Fabric 211
Committing RSCN Timer Configuration Changes 211
Discarding the RSCN Timer Configuration Changes 212
Clearing a Locked Session 212
Displaying RSCN Configuration Distribution Information 213
Default Settings for RSCN 213
CHAPTER 14 Discovering SCSI Targets 215
Discovering SCSI Targets 215
Information About SCSI LUN Discovery 215
About Starting SCSI LUN Discovery 215
Starting SCSI LUN Discovery 216
About Initiating Customized Discovery 216
Initiating Customized Discovery 216
Displaying SCSI LUN Information 217
CHAPTER 15 Advanced Fibre Channel Features 219
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 xiii
Contents

Advanced Fibre Channel Features and Concepts 219
Fibre Channel Timeout Values 219
Timer Configuration Across All VSANs 219
Timer Configuration Per-VSAN 220
fctimer Distribution 221
Enabling or Disabling fctimer Distribution 221
Committing fctimer Changes 222
Discarding fctimer Changes 223
Overriding the Fabric Lock 223
Fabric Database Merge Guidelines 223
Verifying Configured fctimer Values 224
World Wide Names 224
Verifying the WWN Configuration 225
Link Initialization WWN Usage 225
Configuring a Secondary MAC Address 225
FC ID Allocation for HBAs 226
Default Company ID List 226
Verifying the Company ID Configuration 227
Switch Interoperability 228
About Interop Mode 228
Configuring Interop Mode 1 231
Verifying Interoperating Status 232
Default Settings for Advanced Fibre Channel Features 237
CHAPTER 16 Configuring FC-SP and DHCHAP 239
Information About FC-SP and DHCHAP 239
Fabric Authentication 239
Configuring DHCHAP Authentication 240
DHCHAP Compatibility with Fibre Channel Features 241
About Enabling DHCHAP 241
Enabling DHCHAP 241
DHCHAP Authentication Modes 242
Configuring the DHCHAP Mode 243
DHCHAP Hash Algorithm 244
Configuring the DHCHAP Hash Algorithm 244
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
xiv OL-27583-01
Contents

DHCHAP Group Settings 245
Configuring the DHCHAP Group Settings 245
DHCHAP Password 245
Configuring DHCHAP Passwords for the Local Switch 246
Password Configuration for Remote Devices 246
Configuring DHCHAP Passwords for Remote Devices 246
DHCHAP Timeout Value 247
Configuring the DHCHAP Timeout Value 247
Configuring DHCHAP AAA Authentication 248
Displaying Protocol Security Information 248
Configuration Examples for Fabric Security 249
Default Settings for Fabric Security 250
CHAPTER 17 Configuring Port Security 253
Configuring Port Security 253
Information About Port Security 253
Port Security Enforcement 254
Auto-Learning 254
Port Security Activation 254
Configuring Port Security 255
Configuring Port Security with Auto-Learning and CFS Distribution 255
Configuring Port Security with Auto-Learning without CFS 256
Configuring Port Security with Manual Database Configuration 256
Enabling Port Security 257
Port Security Activation 257
Activating Port Security 257
Database Activation Rejection 258
Forcing Port Security Activation 258
Database Reactivation 259
Auto-Learning 260
About Enabling Auto-Learning 260
Enabling Auto-Learning 260
Disabling Auto-Learning 261
Auto-Learning Device Authorization 262
Authorization Scenario 262
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 xv
Contents

Port Security Manual Configuration 264
WWN Identification Guidelines 264
Adding Authorized Port Pairs 265
Port Security Configuration Distribution 266
Enabling Port Security Distribution 266
Locking the Fabric 267
Committing the Changes 267
Discarding the Changes 267
Activation and Auto-Learning Configuration Distribution 268
Merging the Port Security Database 270
Database Interaction 270
Database Scenarios 272
Copying the Port Security Database 273
Deleting the Port Security Database 273
Clearing the Port Security Database 273
Displaying Port Security Configuration 274
Default Settings for Port Security 274
CHAPTER 18 Configuring Fabric Binding 275
Configuring Fabric Binding 275
Information About Fabric Binding 275
Licensing Requirements for Fabric Binding 275
Port Security Versus Fabric Binding 275
Fabric Binding Enforcement 276
Configuring Fabric Binding 277
Configuring Fabric Binding 277
Enabling Fabric Binding 277
Switch WWN Lists 278
Configuring Switch WWN List 278
Fabric Binding Activation and Deactivation 279
Activating Fabric Binding 279
Forcing Fabric Binding Activation 280
Copying Fabric Binding Configurations 280
Clearing the Fabric Binding Statistics 281
Deleting the Fabric Binding Database 281
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
xvi OL-27583-01
Contents

Verifying the Fabric Binding Configuration 281
Default Settings for Fabric Binding 282
CHAPTER 19 Configuring Fabric Configuration Servers 283
Configuring Fabric Configuration Servers 283
Information About FCS 283
FCS Characteristics 284
FCS Name Specification 285
Displaying FCS Information 285
Default FCS Settings 285
CHAPTER 20 Configuring Port Tracking 287
Configuring Port Tracking 287
Information About Port Tracking 287
Default Settings for Port Tracking 288
Configuring Port Tracking 289
Enabling Port Tracking 289
Configuring Linked Ports 290
Operationally Binding a Tracked Port 290
Tracking Multiple Ports 291
Tracking Multiple Ports 291
Monitoring Ports in a VSAN 292
Monitoring Ports in a VSAN 292
Forcefully Shutting down 293
Forcefully Shutting Down a Tracked Port 293
Displaying Port Tracking Information 294
CHAPTER 21 Fibre Channel Slow Drain Device Detection and Congestion Avoidance- An Overview 295
How to Configure a Stuck Frame Timeout Value 296
Configuring a Stuck Frame Timeout Value 296
How to Configure a No-Credit Timeut Value 296
Configuring a No-Credit Timeout Value 296
Displaying Credit Loss Counters 297
Displaying Credit Loss Events 298
Displaying Timeout Drops 298
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 xvii
Contents

Displaying the Average Credit Not Available Status 298
How to Configure a Port Monitor 299
Port Monitoring 299
Enabling Port Monitor 299
Configuring a Port Monitor Policy 300
Activating a Port Monitor Policy 301
Displaying Port Monitor Policies 301
Cisco Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
xviii OL-27583-01
Contents

Preface
The preface contains the following sections:
•Audience, page xix
•Document Conventions, page xix
•Documentation Feedback, page xxi
•Obtaining Documentation and Submitting a Service Request, page xxi
Audience
This publication is for network administrators who configure and maintain Cisco Nexus devices and Cisco
Nexus 2000 Series Fabric Extenders.
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 Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
OL-27583-01 xix

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 Nexus 5000 Series NX-OS SAN Switching Configuration Guide, Release 5.2(1)N1(1)
xx OL-27583-01
Preface
Document Conventions