Brocade Communications Systems 1606 Mode d'emploi

53-1001340-01

28 July 2009

Fabric OS

Troubleshooting and Diagnostics Guide

Supporting Fabric OS v6.3.0

Brocade, the B-wing symbol, BigIron, DCX, Fabric OS, FastIron, IronPoint, IronShield, IronView, IronWare, JetCore, NetIron,

SecureIron, ServerIron, StorageX, and TurboIron are registered trademarks, and DCFM, Extraordinary Networks, and SAN Health

are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries. All other brands,

products, or service names are or may be trademarks or service marks of, and are used to identify, products or services of their

respective owners.

Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning

any equipment, equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to

this document at any time, without notice, and assumes no responsibility for its use. This informational document describes

features that may not be currently available. Contact a Brocade sales office for information on feature and product availability.

Export of technical data contained in this document may require an export license from the United States government.

The authors and Brocade Communications Systems, Inc. shall have no liability or responsibility to any person or entity with

respect to any loss, cost, liability, or damages arising from the information contained in this book or the computer programs that

accompany it.

The product described by this document may contain “open source” software covered by the GNU General Public License or other

open source license agreements. To find out which open source software is included in Brocade products, view the licensing

terms applicable to the open source software, and obtain a copy of the programming source code, please visit

http://www.brocade.com/support/oscd.

Brocade Communications Systems, Incorporated

Document History

Corporate and Latin American Headquarters

Brocade Communications Systems, Inc.

1745 Technology Drive

San Jose, CA 95110

Tel: 1-408-333-8000

Fax: 1-408-333-8101

E-mail: info@brocade.com

Asia-Pacific Headquarters

Brocade Communications Systems China HK, Ltd.

No. 1 Guanghua Road

Chao Yang District

Units 2718 and 2818

Beijing 100020, China

Tel: +8610 6588 8888

Fax: +8610 6588 9999

E-mail: [email protected]

European Headquarters

Brocade Communications Switzerland Sàrl

Centre Swissair

Tour B - 4ème étage

29, Route de l'Aéroport

Case Postale 105

CH-1215 Genève 15

Switzerland

Tel: +41 22 799 5640

Fax: +41 22 799 5641

E-mail: emea-i[email protected]

Asia-Pacific Headquarters

Brocade Communications Systems Co., Ltd. (Shenzhen WFOE)

Citic Plaza

No. 233 Tian He Road North

Unit 1308 – 13th Floor

Guangzhou, China

Tel: +8620 3891 2000

Fax: +8620 3891 2111

E-mail: [email protected]

Title Publication number Summary of changes Date

Fabric OS Troubleshooting and

Diagnostics Guide

53-0000853-01 First released edition. March 2008

Fabric OS Troubleshooting and

Diagnostics Guide

53-1001187-01 Added support for Virtual Fabrics,

fcPing, pathInfo, and additional

troubleshooting tips.

November 2008

Fabric OS Troubleshooting and

Diagnostics Guide

53-1001340-01 Added support for checking physical

connections, updated commands,

removed obsolete information, and

moved the FCIP and FICON chapters

into their respective books.

July 2009

Fabric OS Troubleshoot and Diagnostics Guide iii

53-1001340-01

Contents

About This Document

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Supported hardware and software . . . . . . . . . . . . . . . . . . . . . . . . . . . x

What’s new in this document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Document conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Text formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Command syntax conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Command examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Notes, cautions, and warnings . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Key terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Additional information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Brocade resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Other industry resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Getting technical help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

Chapter 1 Introduction to Troubleshooting

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Troubleshooting overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Network time protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Most common problem areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Questions for common symptoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Gathering information for your switch support provider. . . . . . . . . . . 5

Setting up your switch for FTP. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Capturing a supportSave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Capturing output from a console . . . . . . . . . . . . . . . . . . . . . . . . . 6

Capturing command output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Building a case for your switch support provider . . . . . . . . . . . . . . . . 6

Basic information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Detailed problem information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Gathering additional information . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 2 General Issues

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Licensing issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

iv Fabric OS Troubleshoot and Diagnostics Guide

53-1001340-01

Time issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Switch message logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Switch boot issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

FC-FC Routing connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Generate and route an ECHO . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Route and statistical information . . . . . . . . . . . . . . . . . . . . . . . . 15

Performance issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Chapter 3 Connectivity Issues

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Port initialization and FCP auto discovery process . . . . . . . . . . . . . .19

Link issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Connection problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Checking the physical connection . . . . . . . . . . . . . . . . . . . . . . . 21

Checking the logical connection . . . . . . . . . . . . . . . . . . . . . . . . . 22

Checking the Name Server (NS) . . . . . . . . . . . . . . . . . . . . . . . . . 22

Link failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Determining a successful speed negotiation. . . . . . . . . . . . . . . 24

Checking for a loop initialization failure . . . . . . . . . . . . . . . . . . . 25

Checking for a point-to-point initialization failure . . . . . . . . . . .25

Correcting a port that has come up in the wrong mode . . . . . .26

Marginal links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26

Troubleshooting a marginal link . . . . . . . . . . . . . . . . . . . . . . . . . 27

Device login issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Pinpointing problems with device logins . . . . . . . . . . . . . . . . . . 29

Media-related issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Testing a port’s external transmit and receive path . . . . . . . . .32

Testing a switch’s internal components . . . . . . . . . . . . . . . . . . .32

Testing components to and from the HBA . . . . . . . . . . . . . . . . .32

Segmented fabrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33

Reconciling fabric parameters individually . . . . . . . . . . . . . . . . 33

Downloading a correct configuration . . . . . . . . . . . . . . . . . . . . .34

Reconciling a domain ID conflict . . . . . . . . . . . . . . . . . . . . . . . . 34

Chapter 4 Configuration Issues

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Configupload and download issues. . . . . . . . . . . . . . . . . . . . . . . . . . 37

Gathering additional information . . . . . . . . . . . . . . . . . . . . . . . .39

Brocade configuration form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Chapter 5 FirmwareDownload Errors

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Fabric OS Troubleshoot and Diagnostics Guide v

53-1001340-01

Blade troubleshooting tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Firmware download issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Troubleshooting firmwareDownload . . . . . . . . . . . . . . . . . . . . . . . . .44

Gathering additional information . . . . . . . . . . . . . . . . . . . . . . . .45

USB error handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Considerations for downgrading firmware . . . . . . . . . . . . . . . . . . . . 45

Preinstallation messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Blade types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

Firmware versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48

Chapter 6 Security Issues

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Password issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Password recovery options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Device authentication issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Protocol and certificate management issues . . . . . . . . . . . . . . . . . . 51

Gathering additional information . . . . . . . . . . . . . . . . . . . . . . . . 51

SNMP issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Gathering additional information . . . . . . . . . . . . . . . . . . . . . . . .52

FIPS issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52

Chapter 7 Virtual Fabrics

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

General Virtual Fabric troubleshooting . . . . . . . . . . . . . . . . . . . . . . . 55

Fabric identification issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56

Logical Fabric issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56

Base switch issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Logical switch issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58

Switch configuration blade compatibility. . . . . . . . . . . . . . . . . . . . . . 59

Gathering additional information . . . . . . . . . . . . . . . . . . . . . . . .60

Chapter 8 ISL Trunking Issues

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Link issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Buffer credit issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Chapter 9 Zone Issues

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

vi Fabric OS Troubleshoot and Diagnostics Guide

53-1001340-01

Overview of corrective action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Verifying a fabric merge problem . . . . . . . . . . . . . . . . . . . . . . . .63

Verifying a TI zone problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Segmented fabrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64

Zone conflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Correcting a fabric merge problem quickly . . . . . . . . . . . . . . . . 66

Changing the default zone access . . . . . . . . . . . . . . . . . . . . . . .67

Editing zone configuration members . . . . . . . . . . . . . . . . . . . . .67

Reordering the zone member list . . . . . . . . . . . . . . . . . . . . . . . .67

Checking for Fibre Channel connectivity problems . . . . . . . . . . 68

Checking for zoning problems. . . . . . . . . . . . . . . . . . . . . . . . . . .69

Gathering additional information. . . . . . . . . . . . . . . . . . . . . . . . . . . .70

Chapter 10 iSCSI Issues

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Zoning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Chapter 11 Working With Diagnostic Features

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

About Fabric OS diagnostics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Diagnostic information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Power-on self test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Disabling POST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Enabling POST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Switch status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Viewing the overall status of the switch . . . . . . . . . . . . . . . . . . . 78

Displaying switch information . . . . . . . . . . . . . . . . . . . . . . . . . . .79

Displaying the uptime for a switch . . . . . . . . . . . . . . . . . . . . . . . 80

SpinFab and portTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Port information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Viewing the status of a port . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Displaying the port statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Displaying a summary of port errors for a switch . . . . . . . . . . .83

Equipment status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Checking the temperature, fan, and power supply . . . . . . . . . . 84

Checking the status of the fans . . . . . . . . . . . . . . . . . . . . . . . . .85

Checking the status of a power supply. . . . . . . . . . . . . . . . . . . . 85

Checking temperature status . . . . . . . . . . . . . . . . . . . . . . . . . . .86

System message log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Displaying the system message log, with no page breaks . . . . 87

Displaying the system message log one message at a time . . 87

Clearing the system message log . . . . . . . . . . . . . . . . . . . . . . . . 87

Fabric OS Troubleshoot and Diagnostics Guide vii

53-1001340-01

Port log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Viewing the port log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Syslogd configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Configuring the host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Configuring the switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89

Automatic trace dump transfers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Specifying a remote server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Enabling the automatic transfer of trace dumps. . . . . . . . . . . . 91

Setting up periodic checking of the remote server . . . . . . . . . . 91

Saving comprehensive diagnostic files to the server . . . . . . . . 91

Appendix A Switch Type

Appendix B Hexadecimal

Index

viii Fabric OS Troubleshoot and Diagnostics Guide

53-1001340-01

Fabric OS Troubleshoot and Diagnostics Guide ix

53-1001340-01

About This Document

In this chapter

•How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

•Supported hardware and software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

•What’s new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

•Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

•Additional information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

•Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

•Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv

How this document is organized

The document contains the following chapters:

•Chapter 1, “Introduction to Troubleshooting,” gives a brief overview of troubleshooting the

Fabric OS, and provides procedures for gathering basic information from your switch and fabric

to aid in troubleshooting.

•Chapter 2, “General Issues,” provides information on licensing, hardware, and syslog issues.

•Chapter 3, “Connectivity Issues,” provides information and procedures on troubleshooting

various link issues.

•Chapter 4, “Configuration Issues,” provides troubleshooting information and procedures for

configuration file issues.

•Chapter 5, “FirmwareDownload Errors,” provides procedures for troubleshooting firmware

download issues.

•Chapter 6, “Security Issues,” provides procedures for user account and security issues.

•Chapter 7, “Virtual Fabrics”, provides procedures to troubleshooting Virtual Fabrics.

•Chapter 8, “ISL Trunking Issues,” provides procedures for resolving trunking issues.

•Chapter 9, “Zone Issues,” provides preparations and procedures for performing firmware

downloads, as well troubleshooting information.

•Chapter 10, “iSCSI Issues,” provides information and procedures on iSCSI problems.

•Chapter 11, “Working With Diagnostic Features,” provides procedures for the use of the

diagnostics commands for the chassis, ports, and other chassis equipment. Provides

information on the system messages.

•The appendices provide special information to guide you in understanding switch output.

xFabric OS Troubleshoot and Diagnostics Guide

53-1001340-01

Supported hardware and software

In those instances in which procedures or parts of procedures documented here apply to some

switches but not to others, this guide identifies exactly which switches are supported and which are

not.

Although many different software and hardware configurations are tested and supported by

Brocade Communications Systems, Inc. for 6.3.0, documenting all possible configurations and

scenarios is beyond the scope of this document.

The following hardware platforms are supported by this release of Fabric OS:

•Brocade 300 switch

•Brocade 4100 switch

•Brocade 4900 switch

•Brocade 5000 switch

•Brocade 5100 switch

•Brocade 5300 switch

•Brocade 5410 embedded switch

•Brocade 5424 embedded switch

•Brocade 5460 embedded switch

•Brocade 5470 embedded switch

•Brocade 5480 embedded switch

•Brocade 7500 extension switch

•Brocade 7500E extension switch

•Brocade 7600 application appliance

•Brocade 7800 extension switch

•Brocade 8000 application appliance

•Brocade 48000 director

•Brocade DCX Backbone data center backbone

•Brocade DCX-4S Backbone data center backbone

What’s new in this document

•Information that was added:

-Checking the physical connection

-EMI issues

•Information that was changed:

-All commands have been updated.

Autres manuels pour 1606

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Brocade Communications Systems Stockage