Brocade Fibre Channel HBA: Administrator's Guide

53-1000881-01 13 June 2008
Brocade Fibre Channel HBA

Administrators Guide
Supporting HBA models 415, 425, 815, 825
Copyright 2008 Brocade Communications Systems, Inc. All Rights Reserved. Brocade, Fabric OS, File Lifecycle Manager, MyView, and StorageX are registered trademarks and the Brocade B-wing symbol, DCX, 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 the following URL: http://www.brocade.com/support/oscd.
Brocade Communications Systems, Incorporated

Corporate Headquarters Brocade Communications Systems, Inc. 1745 Technology Drive San Jose, CA 95110 Tel: 1-408-333-8000 Fax: 1-408-333-8101 info@brocade.com European and Latin American Headquarters Brocade Communications Switzerland Srl Centre Swissair Tour A - 2me tage 29, Route de l'Aroport Case Postale 105 CH-1215 Genve 15 Switzerland Tel: +41 22 799 56 40 Fax: +41 22 799 56 41 emea-info@brocade.com Asia-Pacific Headquarters Brocade Communications Singapore Pte. Ltd. 9 Raffles Place #59-02 Republic Plaza 1 Singapore 048619 Tel: +65-6538-4700 Fax: +65-6538-0302 apac-info@brocade.com
Document History
Title
Brocade Fibre Channel HBA Administrators Guide
Publication number
53-1000881-01
Summary of changes
New document
Date
June 2008
Contents
About This Document

In this section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv Text formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv Notes, cautions, and warnings . . . . . . . . . . . . . . . . . . . . . . . . . . xiv Key terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Notice to the reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Additional information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Brocade resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Other industry resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
Chapter 1
HCM Overview
In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 HCM software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Tree node pop-up menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Operating System (OS) support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Driver operating system support. . . . . . . . . . . . . . . . . . . . . . . . . . 4 Host Connectivity Manager (HCM) for local and remote management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 OS-specific features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Chapter 2
Getting Started with HCM Software

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Brocade Fibre Channel HBA Administrators Guide 53-1000881-01
iii
HCM software launch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Launching the application on Windows platforms. . . . . . . . . . . . 7 Launching the application on Linux platforms. . . . . . . . . . . . . . . 8 Launching the application on Solaris platforms . . . . . . . . . . . . . 8 Remember password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Skip login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Changing a password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Resetting a password or restoring a factory default password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Backing up data after an uninstall . . . . . . . . . . . . . . . . . . . . . . . 10 HCM main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 HCM product icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Setting up out-of-band discovery for an HBA . . . . . . . . . . . . . . . 13 Change the agent password on the host from a command line14 Logging off HCM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Chapter 3
Host Configuration
In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Host security authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Configuring security authentication using the GUI . . . . . . . . . . 16 Configuring security authentication using the BCU . . . . . . . . . . 19 Basic port configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Opening the Basic Port Configuration dialog box . . . . . . . . . . . 21 Port speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Port logging level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Frame data field size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 MPIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Path Time Out. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Persistent binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 HCM Logging levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Advanced port configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Opening the Advanced Port Configuration dialog box . . . . . . . . 31 Queue Depth configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Interrupt Control Coalesce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 NPIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Name configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Removing a name entry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Exporting the properties for a WWN . . . . . . . . . . . . . . . . . . . . . . 36 Importing the properties for a WWN. . . . . . . . . . . . . . . . . . . . . . 36 Adding a name and a WWN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Buffer credits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
iv
Chapter 4
Monitoring
In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Performance monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Polling frequency rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Resetting statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Port statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Virtual port statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Logical port statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 FCP IM statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Target statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Authentication statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Master Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Event severities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Filtering event log entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Application log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Chapter 5
Diagnostics
In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Related Diagnostic Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Diagnostics using the Brocade Command Line Utility (BCU) . . . . . . 58 diag commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 fcdiag commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Diagnostics using the GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Running a port-level test using the GUI . . . . . . . . . . . . . . . . . . . 59 Port-level test parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Running a protocol-level test using the GUI . . . . . . . . . . . . . . . . 60 Displaying test log details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Beaconing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Configuring beaconing using the BCU . . . . . . . . . . . . . . . . . . . . 63 Configuring beaconing using the GUI . . . . . . . . . . . . . . . . . . . . .64 SFP Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Displaying SFP information using the BCU. . . . . . . . . . . . . . . . . 64 Displaying SFP information using the GUI . . . . . . . . . . . . . . . . . 64 Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 supportSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 supportSave collection sources . . . . . . . . . . . . . . . . . . . . . . . . . 67
Chapter 6
HCM Dialog Boxes

In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 HBA properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Port properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Base port properties panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Remote port properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Logical port (LPort) properties panel . . . . . . . . . . . . . . . . . . . . . . . . . 75 Virtual port (VPort) properties panel . . . . . . . . . . . . . . . . . . . . . . . . . 76 Port SFP properties panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Port POM properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Port statistics dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Device properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Logical Unit Number (LUN) properties panel. . . . . . . . . . . . . . . . . . . 82 Fibre Channel security authentication dialog box. . . . . . . . . . . . . . . 83 Change HCM password dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Configure Names dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Define Name dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Persistent binding dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Port test diagnostics dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Protocol tests diagnostics dialog box. . . . . . . . . . . . . . . . . . . . . . . . . 89 Test Log Details dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 Master Log tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Master Log Filter dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Event Properties dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Appendix A
Brocade Command Line Utility (BCU)

In This Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Command Line Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Brocade Command Line Utility (BCU) Commands . . . . . . . . . . . . . . 96 adapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 auth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101 debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103 diag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105 fcdiag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 fabric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109 fcpim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110 IOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112 log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116 lport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 pbind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
vi
port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120 rport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123 supportSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126 vport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
Appendix B
FDMI FC-CTs
HBA Driver and FDMI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
Appendix C
Standards Compliance
Standards Compliance Publications . . . . . . . . . . . . . . . . . . . . . . . .131
Appendix D Index
Glossary
vii
viii
Figures
Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 Figure 11 Figure 12 Figure 13 Figure 14 Figure 15 Figure 16 Figure 17 Figure 18 Figure 19 Figure 20 Figure 21 Figure 22 Figure 23 Figure 24
HCM Login dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Change Password dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Host Connectivity Manager main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 HCM product icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Setup for HBA Discovery dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Fibre Channel Security Protocol Configuration dialog box. . . . . . . . . . . . . . . . . . 16 Fibre Channel Security Protocol Configuration dialog box. . . . . . . . . . . . . . . . . . 17 Basic Port Configuration dialog box - Windows, Linux, and VmWare . . . . . . . . . 21 Basic Port Configuration dialog box - Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Port disable/enable Configuration dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Persistent Binding dialog box - host level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Persistent Binding dialog box - HBA level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Persistent Binding dialog box - port level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Persistent binding from the Basic Port Configuration dialog box . . . . . . . . . . . . 29 Configure HCM Logging Levels dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Advanced Port Configuration dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Configure Names dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Master Log Filter dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 HCM Application Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Diagnostics - Port Tests dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Protocol-level tests dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Test Log Details for Echo Test dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Test Log Details for FC trace test dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 SFP Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
ix
Tables
Table 1 Table 2 Table 3 Table 4 Table 5 Table 6 Table 7 Table 8 Table 9 Table 10 Table 11 Table 12
Driver operating system support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 HCM operating system support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 OS-specific features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Basic port configuration options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Advanced port configuration options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Master Log fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 HCM Master Log icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Related diagnostic documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Port-level test parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 SFP management information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 supportSave categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 supportSave collection sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
xi
xii
About This Document
In this section
How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
xiii xvi xvii xvii xvii
How this document is organized

. This document is organized to help you find the information that you want as quickly and easily as possible. The document contains the following components:
Chapter 1, HCM Overview, provides a description of the Host Connectivity Manager (HCM)
application software, the graphical user interface (GUI), system requirements, and supported operating systems.
Chapter 2, Getting Started with HCM Software, explains how to launch the management
software, set security passwords, discover SAN components, and log out.
Chapter 3, Host Configuration, provides the procedures to configure operating parameters

(basic and advanced), security authentication, and persistent binding using the Brocade Command Line Utility (BCU) or the GUI.
Chapter 4, Monitoring, describe the HCM monitoring features. Chapter 5, Diagnostics, describes the non-destructive group of diagnostic commands that
can be run from the BCU or the GUI.
Chapter 6, HCM Dialog Boxes, lists the fields that are associated with the HCM GUI and
provides a definition for each field.
Appendix A, Brocade Command Line Utility (BCU), provides reference information for the Host
Connectivity Manager (HCM) commands that can be run from the Brocade Command Line Utility (BCU)
Appendix B, FDMI FC-CTs, provides reference information to support the Fabric Device
Management Interface (FDMI).
xiii
Appendix C, Extended Link Services (ELS) commands, lists the ELS commands supported by
the HBA stack.
Appendix D, Standards Compliance, provides reference information for standards

compliance. This section describes text formatting conventions and important notice formats used in this document.
Document conventions
Text formatting
The narrative-text formatting conventions that are used are as follows: bold text Identifies command names Identifies the names of user-manipulated GUI elements Identifies keywords and operands Identifies text to enter at the GUI or CLI Provides emphasis Identifies variables Identifies paths and Internet addresses Identifies document titles Identifies CLI output Identifies command syntax examples
italic text
code text
For readability, command names in the narrative portions of this guide are presented in mixed lettercase: for example, switchShow. In actual examples, command lettercase is often all lowercase. Otherwise, this manual specifically notes those cases in which a command is case sensitive.
Notes, cautions, and warnings

The following notices and statements are used in this manual. They are listed below in order of increasing severity of potential hazards. A note provides a tip, guidance or advice, emphasizes important information, or provides a reference to related information.
NOTE
ATTENTION
An Attention statement indicates potential damage to hardware or data.
xiv
CAUTION A Caution statement alerts you to situations that can be potentially hazardous to you.
DANGER A Danger statement indicates conditions or situations that can be potentially lethal or extremely hazardous to you. Safety labels are also attached directly to products to warn of these conditions or situations.
Key terms
For definitions specific to Brocade and Fibre Channel, see the Brocade Glossary. For definitions specific to this document, see Glossary on page 133. For definitions of SAN-specific terms, visit the Storage Networking Industry Association online dictionary at: http://www.snia.org/education/dictionary
Notice to the reader

This document may contain references to the trademarks of the following corporations. These trademarks are the properties of their respective companies and corporations. These references are made for informational purposes only. .
Corporation
Microsoft Corporation Sun Microsystems, Inc. Red Hat, Inc. SuSE VMware
Referenced Trademarks and Products

Windows Server, Windows XP, Windows Vista Sun, Solaris Red Hat, Red Hat Network, Maximum RPM, Linux Undercover SuSE Enterprise Server (SLES), Linux VMware, ESX Server
xv
Additional information
This section lists additional Brocade and industry-specific documentation that you might find helpful.
Brocade resources
To get up-to-the-minute information, join Brocade Connect. Its free! Go to http://www.brocade.com and click Brocade Connect to register at no cost for a user ID and password. For practical discussions about SAN design, implementation, and maintenance, you can obtain Building SANs with Brocade Fabric Switches through: http://www.amazon.com For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource Library location: http://www.brocade.com Release notes are available on the Brocade Connect Web site and are also bundled with the Fabric OS firmware.
Other industry resources

White papers, online demos, and data sheets are available through the Brocade Web site at
http://www.brocade.com/products/software.jhtml.
Best practice guides, white papers, data sheets, and other documentation is available through
the Brocade Partner Web site. For additional resource information, visit the Technical Committee T11 Web site. This Web site provides interface standards for high-performance and mass storage applications for Fibre Channel, storage management, and other applications: http://www.t11.org For information about the Fibre Channel industry, visit the Fibre Channel Industry Association Web site: http://www.fibrechannel.org
xvi
Getting technical help

Contact your HBA support supplier for hardware, firmware, and software support, including product repairs and part ordering. To expedite your call, have the following information available:
HBA model HBA operating system version Error numbers and messages received supportSave command output (see debug on page 103 for details) Detailed description of the problem, including the switch or fabric behavior immediately following the problem, and specific questions
Description of any troubleshooting steps already performed and the results Serial console and Telnet session logs syslog message logs
Related documentation
Part Number
53-1000884-01 53-1000885-01 53-1000598-03 53-1000853-01
Document Title
Brocade Fibre Channel HBA Installation and Reference Manual supporting HBA models 815, 825, 415, and 425 Brocade Fibre Channel HBA Troubleshooting Guide supporting HBA models 815, 825, 415, and 425 Fabric OS Administrators Guide supporting Fabric OS v6.1.0 Fabric OS Troubleshooting and Diagnostics Guide supporting Fabric OS v6.1.0
Document feedback
Quality is our first concern at Brocade and we have made every effort to ensure the accuracy and completeness of this document. However, if you find an error or an omission, or you think that a topic needs further development, we want to hear from you. Forward your feedback to: documentation@brocade.com Provide the title and version number of the document and as much detail as possible about your comment, including the topic heading and page number and your suggestions for improvement.
xvii
xviii
Chapter
HCM Overview
In this chapter
HCM software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tree node pop-up menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Operating System (OS) support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 2 3 4
HCM software
The Host Connectivity Manager (HCM) is a management software application for configuring, monitoring, and troubleshooting host bus adapters (HBAs) in a storage area network (SAN) environment that uses a supported Brocade HBA. The management software has two components:
The agent, which runs on the host. The management console, which is the graphical user interface client used to manage the
HBA. You can manage the software on the host or remotely from another host. The communication between the management console and the agent is managed using JSON-RPC over https. The information in this guide is intended for OEMs, field service personnel, and customers who are installing Brocade hardware and HCM software.
Features
The HBA management software has the following features:
Discovery, which, using the agent software running on the servers attached to the SAN,
enables you to contact the devices in your SAN.
Configuration management , which enables you to configure local and remote systems. With
HCM you can configure the following items:
Brocade 8 Gbps and 4 Gbps Fibre Channel adapters HBA ports Diagnostics, which enables you to test the adapters and the devices to which they are
connected:
Link status of each adapter and its attached devices Loopback test, which is external to the adapter, to evaluate the ports (transmit and receive
transceivers) and the error rate on the adapter
Read/write buffer test, which tests the link between the adapter and its devices FC protocol tests, including echo, ping, and trace route Monitoring, which provides statistics for the following SAN components: Authentication FCP Logical port Port Target Virtual port (vport) Security enables you to specify a CHAP secret and configure authentication parameters. Event notifications provide asynchronous notification of various conditions and problems
through a user-defined event filter.
Tree node pop-up menus

You can use the HCM GUI main menu or the Brocade Command Line Utility (BCU) to configure, monitor, and troubleshoot your SAN components. The instructions for using each feature are detailed in subsequent chapters of this document. For each SAN component, you can optionally right-click its icon and a pop-up menu displays.
SAN component
Host
Pop-up menu feature

Refresh All Stop Polling Configure Names Basic Port Configuration Persistent Binding Port Statistics FC SP Support Save Tree > Copy | Search | Collapse All | Expand All Refresh Define Name Basic Port Configuration Persistent Binding Port Statistics Diagnostics FC-SP Enable Adapter Tree > Copy | Search | Collapse All | Expand All Refresh Define Name Port Configuration > Basic | Advanced Persistent Binding Port Statistics Diagnostics FC-SP > Authentication | Authentication Statistics Enable Port Beacon > Port | Link Tree > Copy | Search | Collapse All | Expand All Refresh Logical Port Statistics Tree > Copy | Search | Collapse All | Expand All Refresh Logical Port Statistics Virtual Port Statistics Tree > Copy | Search | Collapse All | Expand All Refresh Define Name Statistics > Target Statistics | FCP IM Statistics Tree > Copy | Search | Collapse All | Expand All
HBA
Port
Base Port
VPort
Target Device
Operating System (OS) support

There are slight differences in the operating systems that are supported on the driver, on the Host Connectivity Manager (HCM), and the Brocade Command Line Utility (BCU), and the HCM agent.
Driver operating system support

Table 1 lists the operating systems supported on the driver.
NOTE
The Brocade Command Line Utility (BCU) is a standalone application that is installed as part of the driver package. The BCU is used primarily for managing HBAs installed on a local machine. The BCU is supported across all operating system versions listed in Table 1. Supported drivers vary with the operating system being used. For example, for Windows, the Storport miniport driver is supported (there is no support for the SCSI miniport driver) and for Solaris, only the Leadville-based driver is supported.
TABLE 1
Driver operating system support

x86
32b 32b 32b 32b
Operating System
Windows Server 2003 Windows Server 2008 Linux RedHAT Enterprise (RHEL) 4.0 Linux RedHAT Enterprise (RHEL) 5.0
x64
64b 64b 64b 64b 64b 64b 64b N/A
IA64
No support No support 64b 64b No support 64b N/A N/A
SPARC
N/A N/A No No No No 64b N/A
Linux SuSE Enterprise Server (SLES) 9.0 32b Linux SuSE Enterprise Server (SLES) 10.0 Solaris 10 VMware ESX 3.5 32b 32b 32b
Host Connectivity Manager (HCM) for local and remote management

HCM can be installed on the local machine for managing HBAs installed on the local server. HCM can also be installed on a remote machine to manage distributed HBAs. You can run HCM on all available operating systems listed in Table 1. In addition, HCM can be installed on the Windows Vista and Windows XP operating system. All the operating systems supported on HCM are shown in Table 2. In addition to installing HCM on a local or remote machine, you can launch the HCM application from the Brocade Enterprise Fabric Connectivity Manager (EFCM).
NOTE
1
TABLE 2
HCM operating system support
x86
32b 32b 32b 32b 32b 32b 32b 32b
Operating System
Windows Server 2003 Windows Server 2008 Windows Vista Enterprise Windows Vista Business Windows Vista Ultimate Windows XP Professional Linux RedHAT Enterprise (RHEL) 4.0 Linux RedHAT Enterprise (RHEL) 5.0
x64
32b 32b 32b 32b 32b 32b 32b 32b 32b 32b 32b N/A
IA64
No support No support No support No support No support No support No support No support No support No support N/A N/A
SPARC
N/A N/A N/A N/A N/A N/A No support No support No support No support 32b N/A
Linux SuSE Enterprise Server (SLES) 9.0 32b Linux SuSE Enterprise Server (SLES) 10.0 Solaris 10 VMware ESX 3.5 32b 32b N/A
OS-specific features
Some features are available only in specific operating system environments. These OS-specific features are identified in Table 3.
TABLE 3
Features
NPIV
OS-specific features
Linux
Yes Yes No Yes Yes
Windows
Yes Yes Yes Yes Yes
VMware
Yes Yes No Yes Yes
Solaris
No No No No No
Fibre Channel Security (FC-SP) Authentication Target persistent mode MPIO mode and Path Time Out FC Ping and FC Traceroute (Fibre Channel diagnostic tests)
Chapter
Getting Started with HCM Software
In this chapter
HCM software launch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Changing a password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Logging off HCM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
HCM software launch

The following procedures describe how to launch the HCM application in Windows, Linux, and Solaris.
Launching the application on Windows platforms

After installing the HCM software, locate Brocade HCM on the Windows platform by selecting Start > Programs > BROCADE_FCHBA. OR Click the desktop icon to launch the application. The following figure shows the screen that appears when HCM software is first launched.
FIGURE 1
HCM Login dialog box
The factory default user ID and password are Administrator and password. After you log in for the first time, you should change the older password to a new one using the HCM GUI.
2
Launching the application on Linux platforms
1. After installing the HCM software, locate Brocade HCM on the Linux platform by double-clicking on the BROCADE_FCHBA icon. 2. Select run to launch the application. OR Alternatively, you can start the application from the command prompt using the following commands:
suse116208:~ # cd /opt/brocade/fchba/client suse116208:<installed directory>/fchba/client # ./BROCADE_FCHBA
Launching the application on Solaris platforms

1. After installing the HCM software, you can launch the Brocade HCM application on the Solaris platform by double-clicking on the BROCADE_FCHBA icon. 2. Select run to launch the application. OR Alternatively, you can start the application from the command prompt using the following commands: sun-116190# cd <installed directory>/fchba/client/ sun-116190# ./BROCADE_FCHBA
NOTE
You can use the shortcut for launching the application on Solaris platforms, by clicking on the desktop icon, only on machines that have a desktop, such as gnome.
Remember password
The Login dialog has a check box to remember the password. If you check the Remember password check box, you do not need to enter the password the next time you launch the application.
Skip login
Enable skip login by checking the Skip Login Dialog check box.
If the Skip Login check box is checked, it automatically disables the Remember password option.
Disable Skip Login by setting hba-application.skip-login=false in the

/data/HBAApplication.properties file.
If you select the skip login check box, the login dialog box will not appear the next time the
application is started.
2
Changing a password
You can change the default password of the application to a different password using the Change HCM Password dialog. Note the following when you change a password:
You must validate the user before you change the password by supplying the old password. The
new password must be different than the old password.
The password can begin with an alphabetic, numeric, or special character. The default minimum and maximum length of the password is 8 and 64. You can configure the
password length in the HBAApplication.properties file: # min chars for the application password password_min=8 #max chars for the application password password_max=64
The password is encrypted and stored in the noitacitnehtua.properties file.

1. From the Host Connectivity Manager, click Configure > Change HCM Password. The Change Password dialog box displays.
FIGURE 2
Change Password dialog box
2. Type the current password for the account. The default user name and password are Administrator and password. 3. Type the new password of the account. The new password must have at least one character different from the old password. 4. Passwords can be from 8 to 40 characters in length. They must begin with an alphabetic or numeric character. 5. Retype the new password in the Confirm New password field. 6. Click OK.
NOTE
Both the user name and passwords are case-sensitive.
2
Resetting a password or restoring a factory default password
After a successful installation, copy the /data/noitacitnehtua.properties file to your personal folder so that, in case the password is lost, you can overwrite the noitacitnehtua.properties file in the data folder with the local copy. This restores the factory default user name (Administrator) and password (password).
Backing up data after an uninstall

If you uninstall the Brocade HCM software, you are prompted to back up the application configuration data that was created during installation. The following application configuration files are backed up in the data directory:
HBAApplication.properties SetupDiscovery.properties HbaAliasdb.properties log4j.xml noitacitnehtua.properties
To restore the backed-up configuration data when you re-install the HCM, you must manually overwrite the new data directory contents with the backed-up data. This restores your previous settings.
10
HCM main window

From the Host Connectivity Manager main window, you can manage all the adapters installed in this computer. Alternatively you can manage adapters installed in remote computers, if the computers are networked. Only one host can be managed at a time; multiple host management is not supported. Refer to the Brocade Fibre Channel HBA Installation and Reference Manual supporting HBA models 815, 825, 415, and 425 for instructions on how to install both the driver and GUI, the driver only, or the GUI only.
4. 1. 6.
2.
3.
5.
1. Menu bar 2. Device tree window 3. Master Log 4. Online help 5. System information 6. Context view
FIGURE 3
Host Connectivity Manager main window
11
HCM product icons

On the left side of the Host Connectivity Manager, there is a navigation tree for representing the managed host with HBAs and ports. Each tree node has an icon to represent the type of node. If the operational status is offline, link-down, or error, a small red diamond appears on the upper right corner of the icon.
FIGURE 4
HCM product icons
Discovery
Discovery enables you to contact the HBAs present in a specified host in your SAN. The setup discovery profile is saved in the SetupDiscovery.properties file to remember the history of each host and related attributes of discovered hosts. When you log in to HCM, the specified host is automatically contacted (discovered) and displayed on the navigation tree. When you configure and turn on discovery, the application discovers Brocade HBAs in that host, connected to the SAN. The HCM application enables you to discover Brocade adapters, ports, virtual ports, remote ports, and LUNs using out-of-band discovery only.
NOTE
12
2
Setting up out-of-band discovery for an HBA
When performing out-of-band discovery, you are managing the HBA remotely. The application connects to the agent running on the host server over the IP network and product information is copied back from the Brocade HBA to the server. If you do not configure the application to directly discover the devices, the connections and attached devices may not display correctly. 1. From the Host Connectivity Manager, click Discovery > Setup. The Setup for HBA Discovery dialog box displays.
FIGURE 5
Setup for HBA Discovery dialog box
2. From the Host Name list, select the host name from where you will discover the HBA. For the first time, the Host Name list will contain only the Local host. You must specify the Hostname or the IP address for discovering the remote servers. Only previously-discovered servers are available in the Host Name list. 3. Type the port number in the Port Number text box. The default is 34568. 4. Type in the user ID and password that will authenticate the SAN product with the agent. The default user ID and password are admin/password. It is recommended you change the agent password on the host for security reasons.
NOTE
Click the Remember Host check box if you do not want to type it in each time you set up discovery.
13
2
5. In the Polling Frequency (Seconds) text box, specify the value for how frequently the application has to poll for newly-discovered devices. All parameters related to the HBAs that are installed in that server are refreshed each time the poll occurs. 6. If the Keep Polling check box is checked, polling occurs after the specified polling interval. If the check box is not checked, polling will stop. 7. Click OK.
Change the agent password on the host from a command line

If you change the agent password in the Setup for HBA Discovery dialog box, you must change the agent password on the host side and then restart the agent service. The command to change the agent password: hcmagent -s admin The command to restart the agent: hcmagentservice restart
Change agent password on SuSE10 host (Example)

suse10-x86 -108:/opt/hbaagent # bin/hcmagent -s admin Changing password for admin. New password: brocade Password updated suse10-x86 -108:/opt/hbaagent # bin/hcmagentservice restart Stopping HCM Agent ... done Starting HCM Agent ... done suse10-x86 -108:/opt/hbaagent/bin #
Logging off HCM

End the HCM session using one of the following methods:
From the Host Connectivity Manager, click File > Exit. Click the X in the upper-right corner of the HCM window to close it.
14
Chapter
Host Configuration
In this chapter
Host security authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Basic port configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HCM Logging levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Advanced port configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NPIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Name configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Buffer credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15 20 30 31 34 34 38
Host security authentication

Authentication configuration can occur at three levels:
Host Adapter Port

Use the HCM GUI or the Brocade command line utility (BCU) to display the authentication settings and status. Diffie-Hellman (DH) key exchange is a public key cryptosystem where public values are exchanged to arrive at a symmetric key among the end entities. There are five well-known DH groups, however, only DH-CHAP group 0, called NULL DH, is supported in this release. Security authentication is not supported on Solaris platforms.
NOTE
15
3
Configuring security authentication using the GUI
The security authentication dialog can be launched from host, HBA, and port levels. From the host level: 1. Select the host from the device tree. 2. Select Configure > FC-SP from the main menu. OR Right-click the host and select FC-SP from the list. The Fibre Channel Security Protocol Configuration dialog at the host level displays.
FIGURE 6
Fibre Channel Security Protocol Configuration dialog box
From an HBA level: 1. Select the HBA from the device tree. 2. Select Configure > FC-SP from the main menu. OR Right-click the HBA and select FC-SP from the list.
16
3
The Fibre Channel Security Protocol Configuration dialog at the HBA level displays.
FIGURE 7
From a port:
Fibre Channel Security Protocol Configuration dialog box
1. Select a port from the device tree. 2. Select Configure > FC-SP > Authentication from the main menu. OR Right-click a port and select FC-SP > Authentication from the list. The Fibre Channel Security Protocol Configuration dialog at the port level displays.
17
3
3. Configure the following parameters on the Port Security Authentication tab: a. Select the Enable Authentication check box to enable or disable the authentication policy. If authentication is enabled, the port attempts to negotiate with the switch. If the switch does not participate in the authentication process, the port skips the authentication process. b. Type and retype the secret. The maximum length of the secret is 63 bytes. The default secret for each interface is its port world wide name (PWWN) without the colons; for example, 0102030405060708. Select the algorithm type from the list:
MD5
A hashing algorithm that verifies a messages integrity using Message Digest version 5. MD5 produces a 128-bit digest and is the required authentication mechanism for LDAP v3 servers.
SHA1
A secure hashing algorithm that computes a 160-bit message digest for a data file that is provided as input.
MD5SH1
Similar to the MD5 hashing algorithm, but used for DH-CHAP authentication
SHA1MD5
Similar to the SHA1 hashing algorithm, but used for DH-CHAP authentication c. Select DHNULL as the group value (this is the only group that is supported). 4. Click Apply to apply the changes. 5. Click OK to save the changes and close the dialog box.
18
3
Configuring security authentication using the BCU
Enter the following command to display or configure security authentication for the ports.
bcu> bcu> bcu> bcu> bcu> bcu> auth auth auth auth auth auth -show <port_id> -policy <port_id> {on|off} -algo <port_id> <md5|sha1|ms|sm> -secret <port_id> <secret_string> --stats <port_id> --statsclr <port_id>
where: - -show port_id - -policy Displays the authentication settings and the current status. Specify the ID of the port for which you want to display information. Set the authentication policy and enable or disable authentication. By default, the authentication policy is disabled. If authentication is enabled, the port attempts to negotiate with the switch. If the switch side does not participate in the authentication process, the port skips the authentication process. If the switch participates in the authentication and authentication fails, the port is placed in a link down state. Specify the ID of the port for which you want to set the authentication policy. Specify the state of the authentication policy: policy 2/1 on means authentication is turned on, policy 2/1 off means authentication is turned off. Set the authentication algorithm. Specify the ID of the port for which you want to set the authentication algorithm. Specify the hash algorithm:
port_id on|off
- -algo port_id
md5|sha1|ms|sm
MD5 defines MD5 as the only hash algorithm (the default). SH1 defines SHA-1 as the only hash algorithm. MS defines the hash algorithm priority list of MD5 followed by SHA-1 for
DH-CHAP authentication.
SM defines the hash algorithm priority list of SHA-1, followed by MD5 for
DH-CHAP authentication. - -secret port_id secret string Set the shared secret. Note: You cannot clear the secret. Specify the ID of the port for which you want to set the shared secret. Specify the secret string. The maximum length of the secret is 63 bytes. The default secret for each interface is its pwwn without the colons; for example, 0102030405060708.
19
3
- -stats port_id - -statsclr port_id Displays the authentication statistics. Specify the ID of the port for which you want to display information. Clears the authentication statistics. Specify the ID of the port for which you want to clear statistical information.
Refer to auth on page 101 for details about these commands.
Basic port configuration

For each port, you can configure the following parameters using the Basic Port Configuration window, the Brocade Command Line utility (BCU), or both. Table 4 lists the features and configuration options.
-
TABLE 4
Basic port configuration options

Configurable using the GUI
Yes Yes Yes Yes Yes Yes
Port configuration parameter

Port enable Configure speed Frame data field size MPIO mode Path Time Out * Persistent Binding Note: The persistent binding option is available on Windows platforms only. Log Level
Configurable using the BCU

Yes Yes Yes Yes Yes Yes
Yes
Yes
* Path Time Out is available only when MPIO is disabled.
20
3
Opening the Basic Port Configuration dialog box
There are slight changes in HCMs basic port configuration dialog, depending on the operating system. Refer to the appropriate figure for your operating system to determine the port configuration feature options (Figure 8, Basic Port Configuration dialog box - Windows, Linux, and VmWare or Figure 9, Basic Port Configuration dialog box - Solaris). 1. Select an HBA or port from the device tree. 2. From the Host Connectivity Manager, select Configure > Basic Port Configuration. The Basic Port Configuration dialog box displays.
-
FIGURE 8
Basic Port Configuration dialog box - Windows, Linux, and VmWare
FIGURE 9
Basic Port Configuration dialog box - Solaris
21
3
Port speed
Beyond the number of ports, it is important to also consider port speed, which is the maximum amount of data that can pass through the port at a given second. The unit of measurement is in gigabits per second (Gbps) and the speed options are 1 Gbps, 2 Gbps, 4 Gbps, and 8 Gbps. Auto-negotiate is the recommended setting, and it is the default.
Configuring the port speed using the GUI

1. Select Configure > Basic Port Configuration from the Host Connectivity Manager. The Basic Port Configuration dialog box displays. 2. Select a value from the Configured Speed list. Speed options are 1 Gbps, 2 Gbps, 4 Gbps, and 8 Gbps. The available speed options depend on the HBAs speed and the ports SFP. Auto-negotiate is the recommended setting and it is the default. 3. Click Apply to apply the changes. 4. Click OK to close the window. A port disable/enable configuration dialog displays, confirming the configured speed, which will take effect on port disable and enable.
FIGURE 10
Port disable/enable Configuration dialog box
5. Click Yes to continue, or No to cancel the operation.
22
3
Configuring the port speed using the BCU
Enter the following command to set the port speed.
bcu> port -speed <port_id> <1|2|4|8|auto>
where: - -speed Displays or sets the port speed. The port speed can be changed dynamically (when the port is enabled). If the port is disabled, the new port speed setting takes effect when the port is re-enabled. Note: Values 1, 2, 4, and 8 mean a single-port speed setting. The speed value is a bit mask that specifies speeds to be considered for auto-negotiation. port_id Specify the ID of the port for which you want to set the port speed. 1|2|4|8|auto Specify the port speed. Supported values are:
auto - auto-negotiates the speed. 1 - 15 - bit mask of speeds 1/2/4/8 Gbps.

Refer to port on page 120 for details about this command.
Port logging level

The number of messages logged by the host depends on the predetermined logging level. Although the HBA might generate many messages, only certain types of messages are logged based on the specified logging level.
Configuring the port logging level using the GUI

1. Select Configure > Basic Port Configuration from the Host Connectivity Manager. The Basic Port Configuration dialog box displays. 2. Select a value from the Port Logging Level list. Supported values are Log Critical, Log Error, Log Warning, and Log Info. 3. Click Apply to apply the changes. 4. Click OK to save the changes and close the window.
23
3
Configuring the logging level using the BCU
Enter the following command to set the logging level on the port.
bcu> log -level <port_id> [<Critical | Error | Warning | Info>] -m <fw|half|fcs|drv|aen|all>]
where: - -level port_id The number of messages logged by the host depends on the predetermined logging level. Specify the ID of the port for which you want to set the log level. Specify the severity level. fw | ha1 | fcs | drv | aen | all Specify the mode. Refer to log on page 116 for details about this command.
Critical | Error | Warning | Info
Frame data field size

Fibre Channel data is organized in frames that can be concatenated into sequences to create large block transfers. The frame size depends on the HBA and the target and can be in the range of 512 bytes to 2 KB. The maximum amount of frame data is governed by buffer credits that, if insufficient for the link distance and speed, can severely limit performance.
Specifying the maximum frame size using the GUI

1. Select Configure > Basic Port Configuration from the Host Connectivity Manager. The Basic Port Configuration dialog box displays. 2. Select the frame size from the Frame Data Field Size list. The default value is 2112. 3. Click Apply to apply the change. 4. Click OK to close the window.
24
3
Configuring the frame data field size using the BCU
The dfsize command sets the ports maximum receive data field size. If you do not specify a value, the current receive buffer size displays. The new receive data field size takes effect when the port is re-enabled. Enter the following command to set the frame data field size.
bcu> port -dfsize <port_id> <df_size>
NOTE
where: port_id df_size Specify the ID of the port for which you want to set the frame data field size. Specify the maximum supported receive data field size, in decimal value. If set to auto, the driver default value displays.
Refer to port on page 120 for details about this command.
MPIO
Multipathing solutions use redundant physical path components such as adapters, cables, and switches to create logical paths between the server and the storage device. In the event that one or more of these components fails, causing the path to fail, multipathing (MPIO) uses an alternate path for I/O so that applications can still access their data.
Specifying the MPIO using the GUI

1. Select Configure > Basic Port Configuration from the Host Connectivity Manager. The Basic Port Configuration dialog box displays. 2. Click the MPIO Mode Enable check box. 3. Click OK to close the window.
Specifying MPIO using the BCU

Enter the following command to set the MPIO mode to on or off. If the MPIO mode is off, you can specify an optional path time out value (TOV) in seconds (1 to 60). A timeout value of 10 is the default.
bcu> fcpim --mpiomode <port_id> {on|off [tov]}
where: port_id on|off tov Specify the ID of the port for which you want to enable or disable the FCP initiator mode. Specify whether MPIO mode is enabled (on) or disabled (off). You can optionally specify the time out value (TOV).
Refer to fcpim on page 110 for details about this command.
25
3
Path Time Out
You can enable or edit the Path Time Out field only when MPIO is disabled.
Specifying Path Time Out using the GUI

1. Select Configure > Basic Port Configuration from the Host Connectivity Manager. The Basic Port Configuration dialog box displays. 2. Type a value in to the Path Time Out text field. Its value range is 0 to 60. 3. Click OK to close the window.
Specifying Path Time Out using the BCU

Enter the following command to set the MPIO mode to on or off. If the MPIO mode is off, you can specify an optional path time out value (TOV) in seconds (1 to 60). A timeout value of 10 is the default.
bcu> fcpim --mpiomode <port_id> {on|off [tov]}
where: port_id on|off tov Specify the ID of the port for which you want to enable or disable the FCP initiator mode. Specify whether MPIO mode is enabled (on) or disabled (off). You can optionally specify the time out value (TOV).
Refer to fcpim on page 110 for details about this command.
26
3
Persistent binding
Persistent binding is a feature of Fibre Channel (FC) host bus adapters that enables you to permanently assign a system SCSI target ID to a specific FC device. This capability is useful in multi-server environments that share a device, because you can have multiple servers use the same SCSI target ID when referring to the shared FC device.
Configuring persistent binding using the GUI

The Persistent Binding dialog box can be launched at the host, HBA, or port level. Persistent Binding is available in the Windows environment only. From the host level: 1. Select a host and select Configure > Persistent Binding from the main menu. OR 2. Select and right-click a host in the device tree and select Persistent Binding from the list.
NOTE
NOTE
The SCSI Target ID is unique. See the SCSI protocol for the valid target ID range. The Persistent Binding dialog box (host level) displays, listing all the adapters in that host.
FIGURE 11
Persistent Binding dialog box - host level
27
3
From the HBA level: 1. Select an HBA and select Configure > Persistent Binding from the main menu. OR 2. Select and right-click an HBA in the device tree and select Persistent Binding from the list. The Persistent Binding dialog box (HBA level) displays.
FIGURE 12
Persistent Binding dialog box - HBA level
From the port level: 1. Select a port and select Configure > Persistent Binding from the main menu. OR 2. Select and right-click a port in the device tree and select Persistent Binding from the list. The Persistent Binding dialog box (port level) displays.
FIGURE 13
Persistent Binding dialog box - port level
28
3
Enabling and disabling persistent binding using the GUI
Persistent binding can be enabled or disabled from the HCM GUI using the following steps: 1. Launch the Basic Port Configuration dialog at the port level. 2. Check or uncheck the persistent binding check box in the Basic Port Configuration dialog.
FIGURE 14 NOTE
Persistent binding from the Basic Port Configuration dialog box
The Persistent Binding check box is not available for Solaris agents.
Enabling and disabling persistent binding using the CLI

Target persistent binding enables target port world wide name binding to a persistent target ID for the OS stack. Using the -list operand, you can query the list of mappings from the persistent binding module. Enter the following command to configure target persistent binding.
bcu> pbind -enable <port_id> bcu> pbind --disable <port_id> bcu> pbind --list <port_id> [<pwwn>]
where: - -enable port_id - -disable port_id - -list port_id pwwn Enables target persistent binding. Specify the ID of the port on which you want to enable persistent binding. Disables target persistent binding. Specify the ID of the port for which you want to disable persistent binding. Queries the list of mappings from the persistent binding module. Displays the ID of the port for which you want to display information. Displays the ports world wide name.
Refer to pbind on page 119 for details about this command.
29
HCM Logging levels

You can set the log level for the following modules:
Agent communication log, where all messages are exchanged between the HCM GUI
application and the HCM agent.
HCM debug log, where messages are logged locally.

If you do not set an HCM log level, TRACE, which is the most verbose and the default, is used.
Configuring the HCM logging level using the GUI

1. Select Configure >HCM Logging Levels from the Host Connectivity Manager. The Configure HCM Logging Levels dialog box displays.
FIGURE 15
Configure HCM Logging Levels dialog box
2. From both the Agent Communication Log and the Debug Log, select one of the following:
Trace, which is the most verbose. Debug Info Warning Error Fatal, which is the least verbose.
3. Click Apply to apply the change.
30
Advanced port configuration

For each port, you can configure the following parameters using the Advanced Port Configuration dialog box, the Brocade Command Line utility (BCU), or both. Table 5 lists the features and configuration options.
-
TABLE 5
Advanced port configuration options

Configurable using the GUI
Yes Yes Yes Yes
Port configuration parameter

Queue Depth Interrupt Control Coalesce Interrupt Control Latency Interrupt Control Delay
Configurable using the BCU

Yes Yes Yes Yes
Opening the Advanced Port Configuration dialog box

1. Select an HBA or port from the device tree. 2. From the Host Connectivity Manager, select Configure > Port Configuration > Advanced. The Advanced Port Configuration dialog box displays.
FIGURE 16
Advanced Port Configuration dialog box
31
3
Queue Depth configuration
The queue depth is the number of I/O operations that can be run in parallel on a device. When the queue is full, the drive refuses to accept any additional SCSI commands. The device continues to refuse new commands until at least one command has been completed, freeing up space in the queue.
Configuring the queue depth using the GUI

1. Select a port from the device tree.
From the Host Connectivity Manager, select Configure > Advanced Port Configuration.
The Advanced Port Configuration dialog box displays. OR
Right-click a port and select Port Configuration > Advanced.

2. Set the queue depth (a value that represents the number of parallel I/O operations). The valid queue depth range is 0-2000. 3. Click OK.
Configuring the queue depth using the BCU

Enter the following command to set the queue depth.
bcu> fcpim --qdepth <port_id> <q_depth_value>
where: - -qdepth port_id The number of I/O operations that can be run in parallel on a device. Specify the ID of the port for which you want to enable or disable the FCP initiator mode.
q_depth_value Specify the queue depth value.
Interrupt Control Coalesce

To avoid flooding the host system with too many interrupts, packets are collected and one single interrupt is generated for multiple packets. This is called interrupt coalescing. For receive operations, interrupts typically inform the host CPU that packets have arrived on the devices input queue. Without some form of interrupt moderation logic on the adapter, this might lead to an interrupt for each incoming packet. However, as the incoming packet rate increases, the device driver finishes processing one packet and checks to see if any more packets are on the receive queue before exiting the driver and clearing the interrupt. The driver then finds that there are more packets to handle and ends up handling multiple packets per interrupt as the packet rate increases, which means that the system gets more efficient as the load increases.
32
3
Configuring the Interrupt Control Coalesce using the GUI
1. Select a port from the device tree.
From the Host Connectivity Manager, select Configure > Advanced Port Configuration.
The Advanced Port Configuration dialog box displays. OR
Right-click a port and select Port Configuration > Advanced.

2. Set the latency and delay values:
Select On from the Interrupt Control Coalesce list. Specify the latency monitor time out value in microseconds, if coalesce is set to on.
Latency time out values supported are 0-225 microseconds. Setting the latency time out value to 0 disables the latency monitor time out interrupt.
Specify the delay time out value in microseconds, if coalesce is set to on. Delay time out
values supported are 0-1125 microseconds. Setting the delay time out value to 0 disables the latency monitor time out interrupt. 3. Click OK.
Configuring Interrupt Control Coalesce using the BCU

The intr command sets the ports interrupt attributes.
NOTE
Note: The operation fails if the input parameters are out of the supported range. Enter the following command to set Interrupt control coalesce, latency, and delay.
bcu> ioc --intr <ioc_id> <--coalesce|-c> {on | off} <Latency> <Delay>
where: port_id c coalesce Latency Specify the ID of the port for which you want to set the ports interrupt attributes. Displays the coalescing flag values. Supported values are on or off. Specify the latency monitor time out value in microseconds, if coalesce is set to on. Latency time out values supported are 0-225 microseconds. Setting the latency time out value to 0 disables the latency monitor time out interrupt. Specify the delay time out value in microseconds, if coalesce is set to on. Delay time out values supported are 0-1125 microseconds. Setting the delay time out value to 0 disables the delay timeout interrupt.
Delay
33
NPIV
N-Port ID Virtualization (NPIV) enables a single Fibre Channel protocol port to appear as multiple, distinct ports. NPIV provides separate port identification within the fabric for each operating system image (partition) behind the port, as if each operating system image had its own unique physical port. Each NPIV device has a unique virtual port ID (PID), port WWN, and node WWN. The virtual port has the same properties as an N_Port and is therefore capable of registering with all services of the fabric. In other words, multiple virtual devices emulated by NPIV appear no different than regular devices connected to a non-NPIV port. The maximum number of virtual PIDs for an N_Port on a switch is 255. NPIV is available at the physical port level only. No settings are available for vports from basic port configuration. NPIV is not supported on Solaris platforms.
NOTE
Name configuration
The Host Connectivity Manager allows you to use names as a method of providing familiar, simple names to world wide names for adapters, ports, and remote ports in the SAN. You can perform the following name tasks using either the Configure Names dialog or the Define Names dialog:
Associate a name that represents an adapter, port, or remote port. Among all adapters, two cannot have duplicate names. Among all the ports, two cannot have duplicate names. A port and adapter can have the same name. You cannot associate a name for a storage device. The remote ports name will not be available on the agent side; they are only available on
the GUI.
Add a WWN and an associated name for an adapter, port, or storage device that is not yet
discovered.
Remove or disassociate a name from a WWN.

In the GUI, across the adapters, ports, and remote ports, only unique names are allowed.
NOTE
34
3
Removing a name entry
1. Select Configure > Names from the Host Connectivity Manager. OR Right-click a device from the device tree and select Configure Names. The Configure Names dialog box displays.
FIGURE 17
Configure Names dialog box
2. Select one of the following from the Display list:
Current Host All WWNs Only Nodes Only Ports Only Remote Ports
A list of names for the devices you selected displays. 3. Select a device to highlight it and click the Remove button to remove the discovered device from the list. The Remove button clears the names and description of the discovered WWN and the entire row of the undiscovered WWN. 4. Click OK to close the window.
35
3
Exporting the properties for a WWN
1. Select Configure > Names from the Host Connectivity Manager. OR Right-click a device from the device tree and select Configure Names. The Configure Names dialog box displays. 2. Select one of the following from the Display list:
3. Click the Export button. The Save dialog box displays. 4. Name the properties file, and click Save. 5. Click OK to close the window.
Importing the properties for a WWN

1. Select Configure > Names from the Host Connectivity Manager. OR Right-click a device from the device tree and select Configure Names. The Configure Names dialog box displays. 2. Select one of the following from the Display list:
3. Click the Import button. The Open dialog box displays. 4. Navigate to the location of the *.properties file from which you will import properties for the selected device. 5. Name the properties file, and click Open. 6. Click OK to close the window.
36
3
Importing properties in EFCM format
1. In the Configure Names dialog box, select EFCM Format and then select Import. 2. Click OK. 3. Navigate to the location of the *.properties file from which you will import properties for the selected device. The format appears as follows.
# Names Export File V 1.0 : DO NOT DELETE / MOVE / MODIFY THIS LINE # For each row in the file the name should be followed by an '=' # Column Format: WWN=Name=Type =Description # EFCM Names file Format [ Delimiter '=' ] #################################################################### 200000051e536b20=s=Node= 200000051e536b43=bfa0=Node= 100000051e536b20=a=Port= 100000051e536b44=bfa0_port1=Port= 100000051e536b43=bfa0_port0=Port=
Importing properties in Fabric Manager (FM) format

1. In the Configure Names dialog box, select FM Format and then select Import. 2. Click OK. 3. Navigate to the location of the *.properties file from which you will import properties for the selected device. The format appears as follows:
# Names Export File V 1.0 : DO NOT DELETE / MOVE / MODIFY THIS LINE # For each row in the file the name should be followed by an ',' # Column Format: WWN,Name,Type ,Description # FM Names file Format [ Delimiter ',' ] #################################################################### 200000051e536b20,s,Node, 200000051e536b43,bfa0,Node, 100000051e536b20,a,Port, 100000051e536b44,bfa0_port1,Port, 100000051e536b43,bfa0_port0,Port,
37
3
Adding a name and a WWN
You can add up to 2000 names which are then stored in the HbaAliasdb.properties file. The entries persist during reboot. 1. Select Configure > Names from the Host Connectivity Manager. The Configure Names dialog box displays. 2. Type a name that represents an adapter, port, or storage device. 3. Type a valid WWN that corresponds to the name. 4. Click OK to close the window. The new component is added to the Name list.
Buffer credits
Buffer-to-buffer credit flow control is implemented to limit the amount of data a port sends, based on the number and size of the frames sent from that port. This scheme allows Fibre Channel to be self-throttling, thereby allowing it to establish a reliable connection without the need to accommodate dropped frames due to congestion. Buffer credit limits between each device and the fabric are communicated at the time of fabric login. One buffer credit allows a device to send one frame of data (typically 1 or 2 KiloBytes). The default BB Credit is 1. The baseline for the calculation is one credit per kilometer at 2 Gbps. This yields the following values for 10 km:
5 credits per port at 1 Gbps 10 credits per port at 2 Gbps 20 credits per port at 4 Gbps 40 credits per port at 8 Gbps
Refer to the Extended Fabrics concepts and planning section of the Fabric OS Administrators Guide for detailed information about buffer credits.
38
Chapter
Monitoring
In this chapter
Performance monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Master Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Application log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Performance monitoring
The Host Connectivity Manager (HCM) Port Statistics window enables you to monitor the performance of the HBA and the traffic between the HBA and the LUNs. You can use the information to isolate and troubleshoot areas that impact application performance. The following components display statistics:
Port statistics Virtual port (vport) statistics Logical port statistics FCP IM statistics Target statistics Security authentication statistics
Polling frequency rate

The faster the polling rate, the more quickly the HCM GUI receives indications from the host. However, faster polling rates consume more of your systems CPU and network resources and can therefore slow the system.
Controlling the polling frequency rate

To control port statistics polling, do one of the following from any of the Statistics dialog boxes. 1. Click the Start Polling box to manually poll the port statistics. 2. Type the polling rate in the Polling Frequency in Seconds text box. The range is between 5 and 3600. The default is five seconds. 3. Click the Stop Polling box to stop port statistics polling. 4. Check the Keep Running Data checkbox to see the trend.
39
4
Resetting statistics
1. Click the Reset button on any of the Statistics dialog box. A warning dialog displays.
2. Click Yes. All of the statistics are reset to 0.
Port statistics
Select Monitor > Statistics > Port Statistics from the Host Connectivity Manager. OR Right-click a port from the device tree and select Port Statistics from the list. The Port Statistics dialog box displays. The following statistical information for the selected port displays.
Date
The date and time of the most recent reset.
WWN
The world wide name of the port about which statistics are displayed.
TX Frames
The number of total Transmitted Fibre Channel frames across all protocols and classes.
RX Frames
The number of total Received Fibre Channel frames across all protocols and classes.
TX Words
The number of total Transmitted Fibre Channel words across all protocols and classes.
RX Words
The number of total Received Fibre Channel words across all protocols and classes.
LIP Count
The number of loop initialization (LIP) events.
NOS Count
The number of not operational (link has failed) events.
Error Frames
The number of frames that have been received in error.
Dropped Frames
40
4
The number of frames that were lost due to a lack of host buffers available.
Link Failure Count

The number of times a link error has occurred.
Loss Of Sync Count

The number of times loss of sync has occurred.
Loss Of Signal Count

The number of times loss of signal has occurred.
Primitive SeqProtocolErr
The number of primitive sequence protocol errors.
Undersized Frame
The number of undersized frame errors.
Bad EOF Frame

The number of end of frame (EOF) errors.
Oversized Frame
The number of oversized frame errors.
Invalid CRC Count

The number of frames received with invalid CRC.
Invalid Ordered Set

The number of invalid ordered sets.
Nonframe Coding Err

The number of nonframe coding errors.
41
4
Virtual port statistics
Select Monitor > Statistics > Virtual Port Statistics from the Host Connectivity Manager OR Right-click a virtual port from the device tree and select Virtual Port Statistics. The following statistical information for the selected virtual port displays.
Date
WWN
The world wide name of the virtual port.
FDISCs sent
The number of Fabric discoveries sent.
FDISC accepts
The number of times the system accepts Fabric discoveries.
FDISC retries
The number of times a Fabric discovery is attempted.
FDISC req timeouts

The time is required for a Fabric discovery.
FDISC rsp errors

The number of Fabric discovery response errors.
FDISC bad accepts

The number of times the system accepts Fabric discoveries.
FDISC rejects
The number of times the system rejects Fabric discoveries.
FDISC unknown
The number of unknown Fabric discovery occurrences.
FDISC alloc waits

The number of delayed Fabric discovery allocations.
LOGOs sent
The number of times logouts occur.
LOGO accepts
The number of times logouts are accepted.
LOGO rejects
The number of times logouts are rejected.
LOGO rsp err

The number of logout response errors.
42
4
LOGO unknown rsps
The number of unknown logout occurrences.
LOGO alloc waits

The number of delayed logout allocations.
No NPIV support
Indicates if there is no NPIV support.
Fabric offlines
The number of fabrics that are offline.
Fabric onlines
The number of fabrics that are online.
Fabric cleanups
The number of fabric cleanups.
43
4
Logical port statistics
Select Monitor > Statistics > Logical Port Statistics from the Host Connectivity Manager. OR Right-click a logical port from the device tree and select Logical Port Statistics. The following statistical information for the selected logical port (LPORT) displays.
Date
WWN
The world wide name of the logical port.
NS plogi sent
The number of Name Server port logins sent.
NS plogin accepts
The number of times Name Server port logins are accepted.
NS plogin rsp errors

The number of Name Server response errors.
NS plogin accept errors

The number of Name Server port login accept errors.
NS plogin rejects
The number of Name Server port login rejects.
NS plogin unknown rsp

The number of unknown Name Server port login response errors.
NS plogin alloc wait

The number of delayed Name Server port login allocations.
NS RSPN_ID_sent
The Name Server Register Symbolic Port Name identifier.
NS RSPN_ID rsp errors

The number of Name Server Register Symbolic Port Name identifier response errors.
NS RSPN_ID_rejects
The number of Name Server Register Symbolic Port Name identifier rejects.
NS RSPN_ID alloc wait

The number of Name Server Register Symbolic Port Name identifier allocations.
NS RSPN_ID sent
The number of times the Name Server Register Symbolic Port Name identifier was sent.
NS_RSPN_ID_accepts
The number of times the system accepted Name Server Register Symbolic Port Name identifier was accepted.
44
4
NS RFT_ID sent
The number of Name Server Register FC4 Type identifier requests sent.
NS RFT_ID accepts
The number of times the system accepted Name Server Register FC4 Type identifier requests.
NS RFT_ID rsp errors

The number of Name Server Register FC4 Type identifier response errors.
NS RFT_ID rejects
The number of times the system rejected Name Server Register FC4 Type identifier requests.
NS RFT_ID alloc wait

The number of delayed Name Server Register FC4 Type identifier allocations.
NS_GID_FT sent
The number of times a Name Server Get all Port ID request for a given FC4 type is sent.
NS_GID_FT accepts
The number of times a Name Server Get all Port ID request for a given FC4 type is accepted.
NS_GID_FT rsp errors

The number of response errors associated with a Name Server Get all Port ID request for a given FC4 type.
NS_GID FT rejects
The number of times a Name Server Get all Port ID request for a given FC4 type is rejected.
NS_GID FT unknown rsp

The number of unknown responses associated with a Name Server Get all Port ID request for a given FC4 type.
NS_GID FT alloc wait

The number of delayed Name Server Get all Port ID requests for a given FC4 type allocations.
NS timeouts
The number of Name Server timeouts.
NS retries
The number of Name Server retries.
Num RSCNs
The number of Fibre Channels Registered State Change Notifications.
Num port_ID RSCNs

The number of Fibre Channels Registered State Change Notifications.
45
4
FCP IM statistics
Select Monitor > Statistics > Remote port statistics > FCP IM Statistics from the Host Connectivity Manager. OR Right-click a remote port from the device tree and select FCP IM Statistics. The following Fibre Channel Protocol Input Method (FCP IM) statistical information apply to initiators and targets.
Date
WWN
The world wide name of the remote port.
Onlines
The number of online rports.
Offlines
The number of offline rports.
PRLI Sent
The number of PRLIs sent.
Fcxp Alloc Waits

The number of Fcxp allocation waits.
PRLI Rsp Errors

The number of PRLI response errors.
PRLI Rsp Accepts

The number of PRLI response accepts.
Num Times in Initiator Mode

The number of times the rport has been in initiator mode.
HAL Online Events

The number of HAL online events.
HAL Offline Events

The number of HAL offline events.
HAL Create Events

The number of HAL create events.
HAL Delete Events

The number of HAL delete events.
HAL Create Completions

The number of HAL create completions.
HAL Delete Completions

The number of HAL delete completions.
46
4
HAL SLER Events
The number of HAL SLER events.
HAL IOC Down Events

The number of HAL IOC down events.
HAL IO Cleanup Completions

The number of HAL IO cleanup completions.
HAL Task Management Commands

The number of HAL task management commands.
HAL TM FirmwareResponses
The number of HAL TM firmware responses.
HAL TM Successes
The number of HAL TM successes.
HAL TM Failures
The number of HAL TM failures.
HAL TM Related IO Cleanups

The number of HAL TM-related IO cleanups.
HAL TM Firmware Queue Resumed

The number of times HAL TM firmware queue is resumed.
HAL TM Affected By IOC Down Events

The number of times HAL TM is affected by IOC down events.
HAL TM Affected By ITN Offline

The number of times HAL TM is affected by ITN offline.
HAL TM Offline Cleanup Completions

The number of HAL TM offline cleanup completions.
HAL IO Requests
The number of HAL IO requests.
HAL IO Completions
The number of HAL IO completions.
47
4
Target statistics
Select Monitor > Statistics > Remote port statistics > Target Statistics from the Host Connectivity Manager. OR Right-click a remote port from the device tree and select Target Statistics. The following statistical information for the selected remote port displays.
Date
WWN
The world wide name of the selected remote port.
Offlines
The remote ports that are offline.
Onlines
The remote ports that are online.
RSCNs
The number of Fibre Channels Registered State Change Notification (RSCN) received.
PLOGI Sent
The number of times port logins (when two node ports in a SAN establish a connection between each other) occur.
PLOGI Accepts
The number of times the port logins are accepted.
PLOGI Timeouts
The number of times port logins time out.
PLOGI Failed
The number of times port logins fail.
PLOGI Rejects
The number of times port logins are rejected.
PLOGI Received
The number of times port logins are received.
PRLI Received
The number of times PRLIs are received.
ADISC Sent
The number of ADISC requests sent.
ADISC Accepts
The number of times ADISC requests are accepted.
ADISC Failed
The number of times ADISC requests fail.
48
4
ADISC Rejects
The number of times ADISC rejects.
ADISC Received
The number of ADISC requests that are received.
ADISC Rejected
The number of times ADISC requests are rejected.
LOGO Sent
The number of times logouts occur.
LOGO Accepts
The number of times logouts are accepted.
LOGO Failed
The number of times logouts fail.
LOGO Rejected
The number of times logouts are rejected.
LOGO Received
The number of times logouts are received.
HAL uninit Create Events

The number of HAL uninit create events.
HAL uninit Exception Events

The number of HAL uninit exception events.
HAL Created Online Events

The number of HAL created online events.
HAL Created Delete Events

The number of HAL created deleted events.
HAL Created IOC down

The number of times HAL created IO controllers were down.
HAL Created Exception Events

The number of HAL created exception events.
HAL fw Create f/w Responses

The number of HAL fw create responses.
HAL fw Create Delete Events

The number of HAL fw create delete events.
HAL fw Create Offline Events

The number of HAL fw Create offline events.
HAL fw Create IOC Down

The number of times HAL fw created IO controllers were down.
49
4
HAL fw Create Exception Events
The number of HAL fw create exception events.
HAL Online Offline Events

The number of HAL online and offline events.
HAL Online Delete Events

The number of HAL online delete events.
HAL Online IOC down Events

The number of HAL online IOC down events.
HAL Online Exception Events

The number of HAL online exception events.
HAL fw Delete f/w Responses

The number of HAL fw Delete f/w responses.
HAL fw Delete Delete Events

The number of HAL fw Delete Delete events.
HAL fw Delete IOC down Events

The number of HAL fw Delete IOC down events.
HAL fw Delete Exception Events

The number of HAL fw Delete Exception events.
HAL Offline Delete Events

The number of HAL Offline Delete Events.
HAL Offline Online Events

The number of HAL Offline Online events.
HAL Offline IOC down Events

The number of HAL offline IOC down events.
HAL Offline Exception Events

The number of HAL offline exception events.
HAL Delete f/w Responses

The number of HAL delete f/w responses.
HAL Delete IOC down Events

The number of HAL Delete IOC down events.
HAL Delete Exception Events

The number of HAL delete exception events.
HAL Delete Pend f/w Responses

The number of HAL delete pend f/w responses.
HAL Delete Pend IOC downs

The number of HAL delete pending IOC downs.
50
4
HAL Delete Pend Exceptions
The number of HAL delete pending exceptions.
HAL Off-Pending f/w Responses

The number of HAL off-pending f/w responses.
HAL Off-Pending Deletes

The number of HAL off-pending deletes.
HAL Off-Pending IOC downs

The number of HAL off-pending IOC downs.
HAL Off-Pending Exceptions

The number of HAL off-pending exceptions.
HAL IOC Down Offline Events

The number of HAL IOC down offline events.
HAL IOC Down Delete Events

The number of HAL IOC down delete events.
HAL IOC down Online Events

The number of HAL IOC down online events.
HAL IOC Down Exceptions Events

The number of HAL IOC down exception events.
51
4
Authentication statistics
The Authentication Statistics dialog box displays statistical information related to transmitted and received DHCHAP attempts for a selected port 1. Select a port from the device tree. 2. Select Configure > FC_SP > Authentication Statistics from the Host Connectivity Manager. The following statistical information for the selected FCP displays.
Date
The date the statistics were run.
Auth Failures
The number of times security authentication failed.
Auth Successes
The number of times security authentication succeeded.
Tx Auth Rjts
The number of rejected transmitted Fibre Channel authentication attempts.
Tx Negs
The number of transmitted Fibre Channel authentication negotiation attempts.
Tx Auth Dones
The number of completed transmitted Fibre Channel authentication attempts.
Tx DHCHAP Challenges
The number of transmitted DHCHAP challenge attempts.
Tx DHCHAP Replies
The number of transmitted DHCHAP replies.
Tx DHCHAP Successes
The number of times a transmitted Fibre Channel authentication attempt was successful.
Rx Auth Rjts
The number of rejected received Fibre Channel authentication attempts.
Rx Auth Negs
The number of received Fibre Channel authentication negotiation attempts.
Rx Auth Dones
The number of completed received Fibre Channel authentication attempts.
Rx DHCHAP Challenges
The number of received DHCHAP challenge attempts.
Rx DHCHAP Replies
The number of received DHCHAP replies.
RX DHCHAP Successes
The number of times a received DHCHAP challenge was successful.
52
Master Log
The Master Log Properties dialog box, described in Table 6, displays a list of all events that have occurred. Event monitoring enables early fault detection and isolation on a selected HBA. You can filter the events based on the user-defined criteria shown in Figure 18.
TABLE 6
Field
Filter button
Master Log fields

Description
Click to launch the Master Log Filter dialog box. Click to clear the master log filter option set. Displays a numbering sequence in ascending order. Displays the event severity (informational, minor, major, or critical) Displays the world wide name of the device on which the event occurred. Displays the category of event; for example, Rport or ITNIM. Displays the subcategory of the main category. Displays a brief description of the event. Displays the date and time when the event occurred.
Clear Filter button Sr No column Severity column WWN column Category column Subcategory column Description column Date/Time column
Event severities
Table 7 shows the icons that represent the four event types and describes each type.
TABLE 7
Icon
HCM Master Log icons

Description
Critical-level messages indicate that the software has detected serious problems that will eventually cause a partial or complete failure of a subsystem if not corrected immediately; for example, a power supply failure or rise in temperature must receive immediate attention. Major messages represent conditions that do not impact overall system functionality significantly. For example, timeouts on certain operations, failures of certain operations after retries, invalid parameters, or failure to perform a requested operation. Minor messages highlight a current operating condition that should be checked or it might lead to a failure in the future. For example, a power supply failure in a redundant system relays a warning that the system is no longer operating in redundant mode and that the failed power supply needs to be replaced or fixed. Information-level messages report the current non-error status of the system components; for example, the online and offline status of a fabric port.
53
4
Filtering event log entries
Event filtering enables you to block events based on user-defined criteria (severity or type of log). Events that have been filtered out do not appear in the Master Log 1. Click the Filter button in the Master Log section of the bottom pane. The Master Log Filter dialog box displays. 2. Filter the events using one of a combination of the criteria shown in Figure 18.
NOTE
The Category is the type of event; for example, an adapter, port, or audit.
FIGURE 18
Master Log Filter dialog box
3. Click Apply to save your changes, or click Cancel to exit the window. OR Click OK to save the changes and exit the window.
54
Application log
The application log displays all application-related informational and error messages, as well as the following attributes.
Date and time the message occurred Severity of the message Description of the message The agent IP address
FIGURE 19
HCM Application Log
55
56
Chapter
Diagnostics
In this chapter
Diagnostics using the Brocade Command Line Utility (BCU) . . . . . . . . . . . . Diagnostics using the GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Beaconing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SFP Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . supportSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
58 59 63 64 66 66
Related Diagnostic Documentation

The information in this chapter is specific to commands to support the Brocade Fibre Channel HBA. You can run diagnostics using the Brocade Command Line Utility (BCU) or the Host Connectivity Manager (HCM) GUI. For more information, refer to the documentation listed in Table 8.
TABLE 8
Part Number
Related diagnostic documentation

Document Title
Brocade Fibre Channel HBA Installation and Reference Manual supporting HBA models 815, 825, 415, and 425 Brocade Fibre Channel HBA Troubleshooting Guide supporting HBA models 815, 825, 415, and 425 Fabric OS Administrators Guide supporting Fabric OS v6.1.0 Fabric OS Troubleshooting and Diagnostics Guide supporting Fabric OS v6.1.0
53-1000884-01 53-1000885-01 53-1000598-03 53-1000853-01
57
Diagnostics using the Brocade Command Line Utility (BCU)

The purpose of diagnostic commands is to evaluate the integrity of the system hardware.
diag commands
Diag commands monitor and blink hardware components and can be performed while the system is running.
sfpshow
Displays small form factor pluggable (SFP) information.
tempshow
Displays adapter information.
beacon
Blinks the appropriate port LED for physical identification.
pciloopback
Checks the communication path between the host and the IO Controller (IOC).
loopback
Sends a health check message from the host to firmware through message queues that are memory-mapped over the PCI.
memtest
Tests memory blocks of the adapter.
beacon
Blinks the local port for the specified number of seconds. Refer to diag on page 105 for details about this command.
fcdiag commands
Fibre Channel diagnostics include the following tests on Fibre Channel components:
fcping
Determines the basic connectivity between two Fibre Channel network points and monitors and measures network latency
fctraceroute
Reports on a SAN path, including node hops and latency data
fcecho
Sends an FC Echo Extended Link Services (ELS) request to a remote port.
linkbeacon
Blinks the link.
scsitest
Tests the SCSI components. Refer to fcdiag on page 107 for details about this command.
58
Diagnostics using the GUI

You can run diagnostic tests using the GUI at the port level or the protocol level. When you invoke a test on an HBA, you can run diagnostics for one or both ports within the selected HBA.
NOTE
Running a port-level test using the GUI

1. Select an HBA or port from the device tree. 2. Right-click the component and select Diagnostics from the list. The Diagnostics dialog box is displayed.
FIGURE 20
Diagnostics - Port Tests dialog box
3. Click the check box that corresponds to the port test you are running. 4. Specify the parameters based on parameter information found in Table 9.
NOTE
Click the Stop on Error check box if you want the test to stop running if an error occurs. 5. Click Start to run the test.
59
5
Port-level test parameters
TABLE 9
Port-level test
Memory test
Port-level test parameters

Parameter
None
Test Options
You can enable or disable this test. Regardless of test cycle set value, the Memory Test will run only once. Integer from 0 - 4,294,967,295. The default value is 8192. Default value is A5A5A5A5. The number of times the test runs. The default value is 10.
NOTE: During the test IOC will be disabled.

PCI loopback test Frame Count Data Pattern Test Cycle Port loopback test Subtest ID
Internal Serdes External loopback
NOTE: For an External Loopback test, you must plug in the loopback connector.
Link Speed
8 Gb HBA: 2 Gbps 4 Gbps 8 Gbps 4 Gb HBA 1 Gbps 2 Gbps 4 Gbps Integer from 0 - 4,294,967,295. The default value is 8192. The number of times the test runs. The default value is 10. Default value is A5A5A5A5.
Frame Count Test Cycle Data Pattern (hexadecimal)
Running a protocol-level test using the GUI

There are three protocol-level tests:
Echo test, sends an FC Echo ELS to a remote port. FC ping test, requests the management server to test the connectivity with a given remote port
(without zoning restrictions). Not supported in Solaris operating systems.
FC trace route test, requests to enumerate the route between two given end points. Not
supported in Solaris operating systems.
60
5
Opening the Protocol Test dialog box 1. Select an HBA or port from the device tree. 2. Right-click the component and select Diagnostics from the list. The Diagnostics dialog box is displayed.
FIGURE 21
Protocol-level tests dialog box
3. Click the Protocol Tests tab. 4. Click the check box that corresponds to the protocol test you are running. 5. Select a port, target, and logical port from the lists, and click Add to add it to the test table. 6. Define the how many times the test runs by specifying the test cycle number. The default test cycle number is 1. 7. Click Start to run the test.
61
Displaying test log details

Opening the dialog box 1. Select Configure > Diagnostics from the Host Connectivity Manager. 2. Run any diagnostic test. 3. Select and double-click a row of the test results in the bottom pane. The Test Log Details dialog box displays. Fields and components
Field
Time Test Status Configuration
Description
The date and time the test was run. The name of the test. The status of the test, for example, executing or pending. The name of the test component and its corresponding value. For example: Adapter world wide name Data pattern Frame count Port world wide name The test result, for example, test started or test complete.
Result
See Figure 23 and Figure 22 for examples of test log detail.
FIGURE 22
Test Log Details for Echo Test dialog box
62
FIGURE 23
Test Log Details for FC trace test dialog box
Beaconing
Beaconing is a continuous signaling of error conditions on a LAN. Beaconing can occur either on the port or on one or both sides of the link (known as end-to-end beaconing). Link end-to-end beaconing provides a mechanism to start beaconing on both the HBA side and the switch side.
Configuring beaconing using the BCU

Enter the following command to blink the appropriate port LED for physical identification.
bcu> diag --beacon <port_id> <on|off>[<duration>]
where: duration Blinks the local port for the specified number of seconds. The default is 0, which means infinite blinking.
Refer to diag on page 105 for details about this command. Enter the following command to blink the appropriate link for physical identification.
bcu> fcdiag --linkbeacon <port_id> {on|off}
Refer to fcdiag on page 107 for details about this command.
63
5
Configuring beaconing using the GUI
1. Select Configure > Beacon from the Host Connectivity Manager. 2. Click the Beacon Port check box, the Beacon Link check box, or both, to enable the feature.
SFP Management
The Port SFP dialog box enables you to display the properties that are associated with a selected small form-factor pluggable (SFP) transceiver.
Displaying SFP information using the BCU

NOTE
Only Brocade-branded SFPs are supported with the 8 Gbps FC HBAs. The 8 Gbps SFP (which is bundled with the Brocade 815 or 825), it is referred to as SFP+. The 4 Gbps SFP (which is bundled with the Brocade 415 or 425) is simply referred to as SFP. Enter the following command to check the SFP information. If the firmware detects a non-Brocade SFP, the port is disabled.
bcu> diag --sfpshow <port_id>
Refer to diag on page 105 for details about this command.
Displaying SFP information using the GUI

1. Select a port in the device tree. 2. Click the SFP tab in the right pane. 3. The SFP Properties panel displays.
64
FIGURE 24
SFP Properties
Details about the port technology and extended link are described in Table 10.
TABLE 10
SFP category
SFP management information

SFP information displayed
Port technology
Extended information
SFP supported Connector type Transceiver Media Speed (in MBps) Extended ID Encoding Baud rate Length (9u, 50u, 62.5u, Cu) Vendor (name, OUI, part) Revision Wavelength Options BR Max BR Min Serial number Date code
65
Debugging
The debug commands, listed below, capture all the support information needed to diagnose suspected system issues.
supportSave
Collects debug information from the driver logs and stores the error messages in an output file.
portlog
Displays the log of FC frames and other main control messages that were sent out and received.
portlogclear
Clears the ports frame log.
portlogctl
Enables or disables the portlog. Refer to debug on page 103 for details about these commands.
supportSave
The supportSave command collects debug information needed from the driver. The captured debug information can be saved to the local filesystem and then sent to the supplier for further investigation. The information that is captured is detailed in Table 11.
TABLE 11
supportSave categories
Captured information
HCM GUI-related engineering logs Events Configuration files Operating-specific information Environment information Data.xml file Vital CPU, memory, network resources HCM Agent (logs, configuration) Driver logs (bfa_supportSave output) Install logs Core files
supportSave level
System (or Host)
The default location to where supportSave output is saved is under the IP address of the host from which it was collected, relative to the HCM installation directory. For example:
HCM Installation DIR\data\10.32.116.1\supportSave C:\Program Files\BROCADE\FCHBA\client\data\10.32.116.1\supportSave
66
5
supportSave collection sources
Table 12 lists the sources from which you can gather supportSave information.
TABLE 12
supportSave collection sources

supportSave information collected
Driver-related logs and config files Driver-related logs andconfig files Agent log/config files Agent log and config files HCM GUI log and config files
Source of supportSave information

BCU-based supportSave Browser-based supportSave HCM-based supportsave
supportSave collection using the GUI

There are two ways to trigger a support save collection using the GUI, explained in this section. 1. Select Tool > Support Save from the Host Connectivity Manager. OR Right-click a host from the device tree and select Support Save from the list.
NOTE
If the agent is up, it will use the advanced configuration. If there is no agent, it will use the basic configuration. After the supportSave operation completes, the following message is displayed: Support Save Completed and is located at
<HCM HOME Dir>/data/localhost/supportSave_Basic_<file_name>.zip
2. Click OK to close the dialog box.
supportSave collection on a port crash event

If the port crashes and triggers a port crash event, support save data is collected at a system-wide level. An application log message is generated with the following message:
Port Crash Support Save Completed
Port crash events have a CRITICAL severity and you can view the details in the Master Log and Application Log tables in HCM. For more information, refer to Master Log on page 53 and Application log on page 55.
supportSave collection using a command prompt

Enter the following command to run the supportSave command.
bfa_supportSave [destination_directory]
Refer to diag on page 105 for details about these commands.
67
5
supportSave collection using a browser
You can use an Internet browser (Internet Explorer 6 or higher or Firefox 2.0 or higher) to collect and transfer supportSave information for the driver and the HCM agent. Use a browser if you do not have root access, if you do not have access to file transfer methods such as FTP and SCP, or you do not have access to the Host Configuration Manager (HCM). 1. Open an Internet browser and type the following URL: https://localhost:34568/JSONRPCServiceApp/SupportSaveController.do where localhost is the IP address of the server from which you want to collect the supportSave information. 2. Type the agents credentials using the factory default settings, admin and password. The File Download dialog box displays, prompting you to save the supportSaveController.do file. 3. Click Save and navigate to the location where you want to save the supportSave file.
68
Chapter
HCM Dialog Boxes
In this chapter
HBA properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Port properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Base port properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remote port properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logical port (LPort) properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Virtual port (VPort) properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Port SFP properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Port POM properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Port statistics dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Device properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logical Unit Number (LUN) properties panel . . . . . . . . . . . . . . . . . . . . . . . . . Fibre Channel security authentication dialog box . . . . . . . . . . . . . . . . . . . . . Change HCM password dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure Names dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Define Name dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Persistent binding dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Port test diagnostics dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Protocol tests diagnostics dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Test Log Details dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Master Log tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Master Log Filter dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event Properties dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
70 71 73 74 75 76 77 79 80 81 82 83 84 85 86 87 88 89 91 92 93 94
69
HBA properties panel

The HBA properties panel enables you to display the properties that are associated with a selected HBA. Opening the properties panel 1. Select an HBA in the device tree. 2. Click the Properties tab in the right pane. Fields and components
Field
HBA Parameters Node WWN Name Operating Status Manufacturer Model Description Hardware Path Serial # Temperature Chip Revision Driver Parameters Driver Name Driver Version Firmware Parameters Firmware Version BIOS Version PCI Registers Vendor ID Device ID Subsystem ID Subsystem Vendor ID Current # of Lanes PCI Generation Initial Negotiated # of Lanes The identifier of the PCI Registers vendor The device ID of the PCI Register The ID of the PCI subsystem. The ID of the PCI subsystem vendor. The number of PCI lanes, in Gbps, each way between the PCI slot and the adapter. The number of times the PCI Register is generated. The set number of PCI lanes that were initially negotiated. The version level of the firmware. The version level of the BIOS. The name of the host adapter driver. The version level of the host adapter driver. The adapters world wide name. The name representing the adapter. Whether the HBA is enabled or disabled. The company that manufactured the HBA. The description of the HBA. The hardware path of the HBA. The serial number of the HBA. The temperature of the HBA, both in Celsius and Fahrenheit. The revision level of the chip.
Description
70
Port properties panel

The Port properties panel enables you to display the properties that are associated with a selected HBA port. Opening the properties panel 1. Select a port in the device tree. 2. Click the Properties tab in the right pane. Fields and components
Field
Port Parameters Port # Port WWN Node WWN Port Type Name FC Address Configured Port State Operating State Configured Speed Operating Speed Max Speed Supported Configured Topology Operating Topology BB Credit Frame Data Field Size Hardware Path # of LPorts Advanced Port Parameters Queue Depth Interrupt Control Coalesce Interrupt Control Latency Interrupt Control Delay Operating Parameters Beacon State Link Beacon State MPIO Mode State Indicates whether beaconing is on or off. Indicates whether link beaconing is on or off. Indicates whether multipathing mode is on or off. The number of I/O operations that can be run in parallel on a device. Indicates whether interrupt control is on or off. Sets the interrupt control latency value. Sets the interrupt control delay value. The port number: 0 or 1. The ports world wide name. The HBAs world wide name. The port type ( N_port). The name that is manually assigned to the port. The ports Fibre Channel address. Indicates whether the port is enabled or disabled. Indicates whether the link is online or offline. The configured speed of the port The speed at which the port is operating. The maximum port speed that is supported on the port. The topology setting. The topology setting at which the port is operating. The maximum number of receive buffers. The frame size, in bytes, of the port. Indicates whether MPIO is enabled or disabled. The number of logical ports.
Description
71
6
Field
Path Time Out Logging Level FC-SP Parameters Authentication Status Algorithm Group Error Status Indicates whether FC-SP authentication is on or off. The status of FC-SP authentication. The configured authentication algorithm. The DH Group (DH Null, group 0 is the only option). The health status of the Fibre Channel Security Protocol parameters.
Description
The value between 0 to 60 that specifies the time out session. Note you can only enable or edit the path time out when MPIO is disabled. The port logging level. Values include Log Critical, Log Error, Log Warning, and Log Info.
Using the property panel Refer to the following topics for specific procedures using this dialog box.
Configuring the port speed using the GUI on page 22 Specifying the maximum frame size using the GUI on page 24 Specifying the maximum frame size using the GUI on page 24 Specifying the MPIO using the GUI on page 25 Specifying Path Time Out using the GUI on page 26 Configuring the HCM logging level using the GUI on page 30 Configuring the queue depth using the GUI on page 32 Configuring the Interrupt Control Coalesce using the GUI on page 33
72
Base port properties panel

The Base Port properties panel enables you to display the properties that are associated with the base port. Opening the properties panel 1. From the device tree, select a base port. 2. In the right pane, click the Base Port Properties tab. Fields and components
Field
Port WWN Node WWN FC Address State Symbolic Name Roles Base Port Switch NWWN
Description
The world wide name of the base port. The world wide name of the device. The Fibre Channel address of the base port. Indicates whether the base port is online or offline. The symbolic name associated with the base port. The role of the base port; for example, FCP Initiator. The name of the base port. The world wide name of the switch.
73
Remote port properties panel

The Remote Port Properties panel enables you to display the properties that are associated with the remote port. Opening the properties panel 1. From the device tree, select a remote port. 2. Click the Remote Port Properties tab in the right pane. Fields and components
Field
Fibre Channel Properties Port WWN Node WWN Name FC Address Frame Data Field Size State Supported Classes Device Type Symbolic Name Remote Device Information Role Vendor Information Vendor Product ID Product Revision Binding Information Bind Type Target ID The persistent bind type. The identifier of the target device. The vendor of the device. The devices identifier. The revision level of the device. The role of the device (target or initiator) The world wide name of the devices port. The world wide name of the device. The name associated with the device. The Fibre Channel address of the device. The frame size, in bytes, of the device. Indicates whether the device is online or offline. The supported classes; for example, Class2. The type of the device; for example, Disk or Tape. The symbolic name of the remote port.
Description
74
Logical port (LPort) properties panel

The LPorts properties panel enables you to display the properties that are associated with a logical port. Opening the properties panel 1. From the device tree, select a logical port. 2. Click the LPORTs Properties tab in the right pane. Fields and components
Field
Port WWN Node WWN FC Address State Symbolic Name Roles Base Port Switch NWWN
Description
The ports world wide name. The adapters world wide name. The Fibre Channel address of the logical port. Displays whether the logical port is online or offline. The symbolic name associated with the logical port. The role of the logical port; for example, FCP Initiator. Indicates whether the logical port is used as the base port. The world wide name of the switch.
75
Virtual port (VPort) properties panel

The Virtual Port Parameters properties panel enables you to display the properties that are associated with a virtual port. Opening the properties panel Select a virtual port from the device tree. The virtual port parameters property panel is displayed. Fields and components
Field
Port WWN Node WWN FC Address State Roles Base Port Switch NWWN
Description
The ports world wide name. The adapters world wide name. The Fibre Channel address of the virtual port. Indicates whether the virtual port is online or offline. The role of the virtual port; for example, FCP Initiator. Indicates whether the virtual port is used as the base port. The world wide name of the switch.
76
Port SFP properties panel

The Port SFP properties panel enables you to display the properties that are associated with a selected small form-factor pluggable (SFP) transceiver. Only Brocade-branded SFPs are supported with the 8 Gbps FC HBAs. The 8 Gbps SFP (which is bundled with the Brocade 815 or 825), it is referred to as SFP+. The 4 Gbps SFP (which is bundled with the Brocade 415 or 425) is simply referred to as SFP. Opening the properties panel 1. Select a port in the device tree. 2. Click the SFP tab in the right pane. Fields and components
Field
Port Technology SFP Supported Connector Type Transceiver Media Speed Extended Information Extended ID Encoding Baud Rate Length 9u The identifier for the extended link. Displays how the extended link is encoded, for example, 8B10B. The transmission rate, roughly equivalent to the number of bits per second. The length of the single-mode fiber optic cable, used in situations where gigabit performance is not required (for distances greater than 100 meters). The length of the fiber optic cable (for distances greater than 10 meters). The length of the fiber optic cable (for distances greater than 10 meters). The length of the fiber optic cable (for distances greater than 1 meter, where optimum performance is required). The vendor of the extended link. The vendors organizational unique identifier (OUI). The part number of the extended link. The revision level of the extended link. The wavelength translation, which enables longer reach through lower attenuation. The name of the supported SFP. The type of port connector; for example, LC or SC. The type of transceiver; for example, XFP or GBIC. The type of media for the transceiver; for example, single mode. The port speed; for example, 1 Gbps, 2 Gbps, 4 Gbps, or 8 Gbps.
NOTE
Description
Length 50u Length 62.5u Length Cu Vendor Name Vendor OUI Vendor Part Revision Wavelength
77
6
Field
Options BR Max BR Min Serial # Date Code
Description
Displays details about the transceiver; for example, the type of port connector, type of transceiver, and enable/disable status. The upper bit rate limit at which the SFP transceiver meets its specifications. The lower bit rate limit at which the SFP transceiver meets its specifications. The serial number of the SFP. The date the SFP was manufactured.
78
Port POM properties panel

The Port POM properties panel enables you to monitor the SFP attributes. A notification is given for any parameters that are not within the configured power, temperature, voltage, and current specification policy. Only Brocade-branded SFPs are supported with the 8 Gbps FC HBAs. The 8 Gbps SFP (which is bundled with the Brocade 815 or 825), it is referred to as SFP+. The 4 Gbps SFP (which is bundled with the Brocade 415 or 425) is simply referred to as SFP. Opening the properties panel 1. Select a port in the device tree. 2. Click the POM tab in the right pane. Fields and components
Field
Temperature(C) Bias Current (mA) Tx Power (uvV) Rx Power (uvV) Voltage
NOTE
Description
The port temperature, measured in Celsius. The low-level DC current (the Bias Current), measured in mA. The transmitted power, measured in uVV. The received power, measured in uVV. The voltage; for example, 1.8V, 3.3V, or 5.0V.
79
Port statistics dialog box

The Port Statistics dialog box enables you to monitor the performance of the HBA and the traffic between the HBA and the LUNs. You can use the information to isolate and troubleshoot areas that impact application performance. Opening the dialog box Select Monitor > Statistics > Port Statistics from the Host Connectivity Manager. Fields and components
Field
Date WWN TX Frames RX Frames TX Words RX Words NOS Count Error Frames Dropped Frames Link Failure Count Loss Of Sync Count Loss Of Signal Count Primitive Seq Protocol Err Count Invalid TX Word Count Invalid CRC Count
Description
The current date and time at which the last reset was done. The world wide name of the port. The number of total Transmitted Fibre Channel frames across all protocols and classes. The number of total Received Fibre Channel frames across all protocols and classes. The number of total Transmitted Fibre Channel words across all protocols and classes. The number of total Received Fibre Channel words across all protocols and classes. The number of NOS events that have occurred on a switched Fabric. The number of frames that have been received in error. The number of frames that were lost due to a lack of host buffers available. The number of times a link error has occurred. The number of times loss of sync has occurred. The number of times loss of signal has occurred. The number of primitive sequence protocol errors. The number of invalid transmitted words. The number of frames received with invalid cyclic redundancy checks (CRCs).
Using the dialog box Refer to the following topics for specific procedures using this dialog box.
Port statistics Polling frequency rate Resetting statistics Performance monitoring
80
Device properties panel

The Device properties panel enables you to display the properties that are associated with a devices logical unit number (LUN). Opening the properties panel 1. Select a device in the device tree. 2. Click the LUNs tab in the right pane. Fields and components
Field
LUN # Capacity Block Size Vendor Product ID Product Revision Product Serial # Target WWN
Description
The logical unit number associated with the device; for example, 0-9. The capacity of the device. The block size of the device. The vendor of the device. The devices product identifier. The revision number of the device. The serial number of the device. The world wide name of the device
81
Logical Unit Number (LUN) properties panel

The LUN properties panel enables you to display the properties of a selected LUN. Opening the properties panel Select a LUN from the device tree. The LUN parameters display in the right pane. Fields and components
Field
FCP LUN Capacity Block Size Vendor Product ID Product Revision Product Serial # Target WWN
Description
The logical unit number of Fibre Channel Protocol (FCP) device. The capacity of the logical unit. The block size of the logical unit, in bytes (for example, 512 Bytes). The vendor of the device to which the logical unit is assigned. The product identifier of the device to which the logical unit is assigned. The revision level of the device to which the logical unit is assigned. The serial number of the device to which the logical unit is assigned. The world wide name of the target device.
82
Fibre Channel security authentication dialog box

The Fibre Channel Security Protocol (FC SP) dialog box enables you to define security authentication on selected ports. Opening the dialog box 1. Select an HBA in the device tree. 2. Select Configure > FC_SP > Authentication Statistics from the Host Connectivity Manager dialog box. The Fibre Channel Security Protocol dialog box displays. Fields and components
Field
Port # Port WWN Port Name Authentication Status CHAP Secret Retype Secret Algorithm Group
Description
The port number (0 or 1) for which you are configuring security authentication. The world wide name of the port for which you are configuring security authentication. The name of the port (for example, Port 0 or Port 1) for which you are configuring security authentication. Check to enable port security authentication. Indicates whether authentication is used. Type the CHAP secret. Retype the CHAP secret to confirm. The configured algorithm. Options include md5, sha1, md5sha1, shamd5. Indicates the DH group value. DHNULL (group 0) is the only option.
Using the dialog box Refer to the following topic for specific procedures using this dialog box.
Configuring security authentication using the GUI on page 16
83
Change HCM password dialog box

The Change Password dialog box enables you to change an existing password for the application. Opening the dialog box Select Configure > Change HCM Password from the Host Connectivity Manager dialog box, The Change HCM password dialog box displays. Fields and components
Field
User Name Old password New password Confirm New password
Description
Type your user name. Type your existing password. Type a new password. Confirm your new password by retyping it.
Changing a password on page 9
84
Configure Names dialog box

The Configure Names dialog box enables you to perform the following tasks:
Search by name or world wide name. Add a world wide name and an associated name for an adapter, port, or storage device that is
not yet discovered.
Remove a device from the Name display list. Import from or export properties to a file.
Opening the dialog box Select Configure > Names from the Host Connectivity Manager. The Configure Names dialog box displays. Fields and components
Field
Display Name
Description
Select a discovered host from the drop down list. Current Host is the default. The name for all configured devices.
NOTE: You can also search for a name by typing the name into the text box and clicking OK.
WWN The world wide name for all configured devices.
NOTE: You can also search for a name by typing the world wide name into the text box and clicking OK.
Type Description Remove Import Export Add button EFCM / FM format The type of device; for example, Node or Port. Displays a description of the device. Select a device to highlight it, then click the Remove button to remove the discovered device from the list. Click to import properties from a properties file for a selected device. Click to save properties to a properties file for a selected device. For undiscovered devices, type in the name of the ports name or the WWN and click the Add button to add it to the Display list. Enables you to import properties in EFCM or FM format.
Removing a name entry on page 35 Importing the properties for a WWN on page 36 Exporting the properties for a WWN on page 36 Adding a name and a WWN on page 38
85
Define Name dialog box

The Define Name dialog box enables you to assign a name to an existing world wide name. Opening the dialog box 1. Right-click on an HBA, port, or remote port in the device tree. 2. Type a name that represents an adapter, port, or storage device.
NOTE
The WWN and the Type are not editable. 3. Click OK to apply the change and close the window. The new component is added to the Name list. Fields and components
Field
Name
Description
The name for all configured devices.
NOTE: You can also search for a name by typing the name into the text box and clicking OK.
WWN The world wide name for all configured devices.
NOTE: You can also search for a name by typing the world wide name into the text box and clicking OK.
Type The type of device; for example, Node or Port.
86
Persistent binding dialog box

The Persistent Binding dialog box enables target port world wide name binding to a persistent target ID for the OS stack. Opening the dialog box 1. Select Configure > Basic Port Configuration from the Host Connectivity Manaager. 2. Click the Enable Persistent Binding check box. Persistent Binding is enabled. 3. Select Configure > Persistent Binding. The Persistent Binding dialog box displays. Fields and components
Field
Serial Number Port # Port WWN Name Target Name Remote Port WWN SCSI Target ID
Description
The serial number of the HBA. The port number of the HBA. The ports world wide name. The port name; for example, Port 0 or Port 1. The SCSI target name. The world wide name of the remote port. The SCSI target identifier.
Buffer credits on page 38
87
Port test diagnostics dialog box

The Port Tests diagnostics dialog box enables you to run tests on the port and to configure parameters such as link speed and frame count. Opening the dialog box 1. Select Configure > Diagnostics from the Host Connectivity Manager. 2. Click Port Tests. The Port Tests dialog box displays. Fields and components
Field
Ports Memory Test PCI Loopback Test Data Pattern Test Cycle Loopback Test Subtest ID Link Speed Frame Count Stop on Error Time Test Status Start button Stop button
Description
Select a port from the drop down list. Check to run a Memory test on the port. Check to run a PCI Loopback test on the port. Type a data pattern. The default value is A5A5A5A5. Specify the number of times the test runs. The default value is 100. Check to run a Loopback test on the port. Select a subtest from the dropdown list. The default is Internal. Select a link speed from the drop down list. Type a frame count. The default value is 8192. Check to flag the system to stop running the test if an error occurs. The test log displays the time the port test was run. The test log displays the type of test that was run. The test log displays the status of the test that was run. Click to run the selected test. Click to stop all pending tests.
Configuring beaconing using the GUI on page 64 Displaying SFP information using the GUI on page 64 supportSave collection using the GUI on page 67
88
Protocol tests diagnostics dialog box

The Protocol Tests diagnostics dialog box enables you to run test on Fibre Channel components. Opening the dialog box 1. Select Configure > Diagnostics from the Host Connectivity Manager. 2. Click Protocol Tests. The Protocol Tests dialog box displays. Fields and components
Field
Echo Test FC Ping Test FC Trace Route Add Remove Remove All Test Cycle Test Log Stop on Error Start button Stop button
Description
Check to run an Echo Test on the selected port. Check to run an FC Ping Test on the selected port. Check to run an FC Trace Route on the selected port. Click to add a selected port, logical port, or target to the test list. Click to remove a selected port, logical port, or target from the test list. Click to remove all ports, logical ports, and targets from the test list. Specify the number of times the test runs. The default value is 100. The test log table displays the time the test was run, type of test run, status of the test, configuration, and the results. Check to flag the system to stop running the test if an error occurs. Click to run the selected test. Click to stop all pending tests.
89
6
Configuring beaconing using the GUI on page 64 Displaying SFP information using the GUI on page 64 supportSave collection using the GUI on page 67
90
Test Log Details dialog box

The Test Log Details dialog box enables you to view details about a selected port or protocol test. Opening the dialog box 1. Select Configure > Diagnostics from the Host Connectivity Manager. 2. Run any diagnostic test. 3. Select and double-click a row of the test results in the bottom pane. The Test Log Details dialog box displays. Fields and components
Field
Time Test Status Configuration
Description
The date and time the test was run. The name of the test. The status of the test, for example, executing or pending. The name of the test component and its corresponding value. For example: Adapter world wide name Data pattern Frame count Port world wide name The test result, for example, test started or test complete.
Result
91
Master Log tab

The Master Log enables you to display a list of all events that have occurred. Opening the Master Log 1. Click the Master Log tab, located on the bottom pane of the Host Connectivity Manager. A master summary of events on all discovered devices is displayed. Fields and components
Field
Filter button Clear Filter button Refresh button Sr No column Severity column WWN column Category column
Description
Click to launch the Master Log Filter dialog box. Click to clear the Master Log Filter parameters. Click to refresh the Master Log. Displays a numbering sequence in ascending order. The event severity (informational, minor, major, or critical). The world wide name of the device on which the event occurred. The event categories are as follows: ADAPTER - Events pertaining to the adapter PORT - Events pertaining to a physical port LPORT - Events pertaining to a specific logical port (one logical port always exists per physical port) RPORT - Events pertaining to a specific remote port (could be an initiator or target) ITNIM - Events pertaining to an initiator-target nexus RSVD - Reserved AUDIT - Audit events
Subcategory column Description column Date/Time column
The subcategory of the main event; for example, offline, online, disabled, or enabled. Displays a brief description of the event. The date and time when the event occurred.
Master Log on page 53 Event severities on page 53 Filtering event log entries on page 54
92
Master Log Filter dialog box

The Master Log Filter dialog box enables you to filter the events you receive by time, severity, category, or world wide name. Opening the dialog box 1. Select the Master Log tab, located at the bottom pane of the Host Connectivity Manager, 2. Click the Filter button. The Master Log Filter dialog box is displayed. Fields and components
Field
Event Time Event Severity Category WWN
Description
Type in a From and To value to represent the time during which events will be logged. Select one or all of the following values: Major, Minor, Critical, Info. Select an event category, for example, Rport or ITNIM, from the list. Select a world wide name from the list.
93
Event Properties dialog box

The Event Properties dialog box displays the properties associated with a selected event from the Master Log. Opening the dialog box 1. Click the Master Log tab, located on the bottom pane of the Host Connectivity Manager. A master summary of events on all discovered devices is displayed. 2. Double click an event. The Event Properties dialog box displays. Fields and components
Field
Date/Time Time Severity WWN Event ID Category Description Root Cause
Description
The date when the event occurred. The time when the event occurred. The event severity (informational, minor, major, or critical). The world wide name of the device on which the event occurred. An identifier that corresponds to the event. The category of event; for example, Rport or ITNIM. A brief description of the event. The root cause of the event.
94
Appendix
Brocade Command Line Utility (BCU)
In This Appendix
adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 auth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 diag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 fabric. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 fcdiag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 fcpim. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 IOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 lport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 pbind. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 rport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 vport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Command Line Help

This appendix provides reference documentation for the Brocade Command Line Utility (BCU) supporting the Brocade Fibre Channel components. BCU runs in two modes:
Direct mode, where you type the command at the command prompt. For example:
port - -speed <port_id> <1|2|4|8|auto>
Shell mode, accessed using the bcu shell. To access the shell mode, type bcu shell. To exit out of shell mode, type exit.
All the commands in this appendix are shown in the shell mode. For example: bcu> port --speed <port_id> <1|2|4|8|auto>
95
Brocade Command Line Utility (BCU) Commands

The following table alphabetically lists the commands that are available for configuring the devices in a SAN environment that use a Brocade HBA.
Command
Adapter commands bcu> adapter - -list - -name - -query - -enable - -disable Authentication commands bcu> auth - -show - -policy - --algo - -secret - -stats - -statsclr Debug commands bcu> debug - -portlog - -portlogclear - -portlogctl Fabric commands bcu> fabric - - stats - - statsclr FC diagnostic commands Note: fcping and fctraceroute are not supported on Solaris platforms. bcu> fcdiag - -fcping - -fctraceroute - -fcecho - -linkbeacon - -scsitest FCP initiator mode commands Note: fcpim - -mpiomode is not supported on Solaris platforms. bcu> fcpim - -mpiomode - -stats - -statsclr - -query <port_id> {on | off [tov]} <port_id> <rpwwn> [-l <lpwwn>] <port_id> <rpwwn> [-l <lpwwn>] <port_id> <rpwwn> [-l <lpwwn>] <port_id> <rpwwn> [-l lpwwn] <port_id> <rpwwn> [-l lpwwn] <port_id> <rpwwn> [-l lpwwn] <port_id> {on | off} <port_id> <rpwwn> [-l lpwwn] <port_id> <port_id> <port_id> <port_id> <port_id> <enable | disable> <port_id> <port_id> <on | off> <port_id> <md5 | sha1 | ms | sm> <port_id> secret string <port_id> <port_id> <ad_id> <adapter_name> <ad_id> <ad_id> <ad_id>
Operands
Synopsis
96
A
- -qdepth Help commands bcu> - -help Lists all available sub-commands <port_id> <q_depth_value>
Command
bcu> <sub_command> - -help IO Controller (IOC) commands bcu> ioc
Operands
Synopsis
Lists all details about the specific sub_command.
- -stats - -query - -statsclr - -enable - -disable - -intr
<ioc_id> <ioc_id> <ioc_id> <ioc_id> <ioc_id> <ioc_id> <- -coalesce | c> {on | off} <Latency> <Delay>
Log commands bcu> log - -level <port_id> [<critical | error | warning | info>] [-m <fw | ha1 | fcs | drv | aen | all>]
Logical port (lport) commands bcu> lport - -list - -query - -stats - -statsclr Diagnostic commands bcu> diag - -sfpshow - -tempshow - -beacon - -pciloopback - -loopback - -memtest Port commands (physical port) bcu> port - -list - -name - -enable - -disable - -stats - -statsclr - -query - -speed <port_id> [port_name] <port_id> <port_id> <port_id> <port_id> <port_id> <port_id> <1|2|4|8|auto> <port_id> <ad_id> <port_id> {on | off} [<duration>] <port_id> [-p <pattern>] [-c <frame_count>] <port_id> [-t <loopback_type>] [-s <speed>] [-c <frame_count>] [-p <pattern>] <ad_id> <port_id> <port_id> [-l lpwwn] <port_id> [-l lpwwn] <port_id> [-l lpwwn]
97
A
- -dfsize <port_id> [dfsize]
Command
Operands
Synopsis
Remote port (rport) commands bcu> rport - -list - -query - -stats - -statsclr - -osname Target persistent binding Note: Target persistent binding is available in Windows operating systems only. It is not supported in other operating systems. bcu> pbind - -enable - -disable - -list Virtual port (vport) commands Note: vport commands are not supported on Solaris platforms. bcu> vport - -create - -delete - -query - -stats - -statsclr <port_id> vpwwn [-n <nwwn>] [-s <sname>] <port_id> vpwwn <port_id> vpwwn <port_id> vpwwn <port_id> vpwwn <port_id> <port_id> <port_id> [<pwwn>] <port_id> [-l lpwwn] <port_id> rpwwn [-l lpwwn] <port_id> rpwwn [-l lpwwn] <port_id> rpwwn [-l lpwwn] <port_id> [-l lpwwn]
98
adapter
Displays and sets adapter configuration. Synopsis
bcu> bcu> bcu> bcu> bcu> adapter adapter adapter adapter adapter --enable <ad_id> --disable <ad_id> -list -name <ad_id> <adapter-name> -query <ad_id>
Description Operands
Use this command to display and set adapter parameters. When invoked without operands, this command displays the usage. The following operands are supported: - -enable ad_id - -disable ad_id - -list - -name Enables the adapter. Specify the ID of the adapter you want to enable. Disables the adapter. Specify the ID of the adapter you want to disable. Lists all adapters in the system. For each adapter in the system, a brief summary line is displayed. Specify or set the name of the adapter. Note: Use an empty string ( ) to clear a previous adapter name. Adapter names are stored persistently. ad_id Specify the ID of the adapter for which you want to query. Specify the serial number of the adapter for which you want to display information. adapter-name Specify the adapter name. The name can include up to 15 characters, must begin with a letter, can consist of letters, digits, hyphens, and underscore characters, but must not contain spaces. This operand is optional; if the user does not specify an adapter name, the current adapter name displays. Queries or displays adapter information. Specify the ID of the adapter for which you want to query.
- -query ad_id
99
A
Example
# bcu> adapter --query 1 Example:# bcu> adapter --query 1 Adapter Information: model info: Brocade-825 (PROTOTYPE) num ports: 2 max speed: 8 Gbps chip revision: Rev-B hw path: 0000:0d:00 Serial Num: ALX0301D061 name: PCI Information: vendor id: 1657 device id: 0013 ssid: 0014 ssvid: 1657 PCIe Gen: PCIe lanes: Port Information: Port 0: pwwn: nwwn: hwpath: name: Port 1: pwwn: nwwn: hwpath: name: Flash Information: status: fw version: bios version: Gen1 8 (Initial number of lanes = 8)
10:00:00:05:1e:53:0e:4a 20:00:00:05:1e:53:0e:4a 0000:0d:00.0
10:00:00:05:1e:53:0e:4b 20:00:00:05:1e:53:0e:4b 0000:0d:00.1
good FCHBA1.0.0
See Also
port, IOC
100
auth
Displays the status and statistics for authentication settings. Note: port_id could be any of the following:

Synopsis
<adapter_id> <port_id> <port-pwwn> <port-name> <port-hwpath>

auth auth auth auth auth auth -show <port_id> -policy <port_id> {on|off} -algo <port_id> <md5|sha1|ms|sm> -secret <port_id> secret string --stats <port_id> --statsclr <port_id>
bcu> bcu> bcu> bcu> bcu> bcu>
Displays the authentication settings and the current authentication status. The following operands are supported: - -show port_id - -policy Prints the attributes. Specify the ID of the port for which you want to display information. Turns authentication on or off. By default, the authentication policy is disabled. If authentication is enabled, the port attempts to negotiate with the switch. If the switch side does not participate in the authentication process, the port skips the authentication process. If the switch participates in the authentication and authentication fails, the port is placed in a link down state. Specify the ID of the port for which you want to set the authentication policy. Specify the state of the authentication policy: policy 2/1 on means authentication is turned on, policy 2/1 off means authentication is turned off. Set the authentication algorithm. Specify the ID of the port for which you want to set the authentication algorithm. Specify the hash algorithm:
port_id on|off
- -algo port_id
md5|sha1|ms|sm
md5 defines MD5 as the only hash algorithm (the default). sh1 defines SHA-1 as the only hash algorithm. ms defines the hash algorithm priority list of MD5 followed by SHA-1 for
- -secret DH-CHAP authentication. sm defines the hash algorithm priority list of SHA-1, followed by MD5 for DH-CHAP authentication.
Set the shared secret.
101
A
Note: You cannot clear the secret. port_id secret string Specify the ID of the port for which you want to set the shared secret. Specify the secret string. The maximum length of the secret is 63 bytes. The default secret for each interface is its pwwn without the colons; for example, 0102030405060708. Displays the authentication statistics. Specify the ID of the port for which you want to display information. Clears the authentication statistics. Specify the ID of the port for which you want to clear statistical information.
- -stats port_id - -statsclr port_id Example
bcu> auth -show 1/0 port 1/0 Port Status Linkdown Auth uninit Hash Type SHA1 Group Type DH-NULL
bcu> auth -show 2/1 port 2/1 Auth On Hash Type SHA1, MD5 Group Type DH-NULL
bcu> auth -algo 2/1 sha1 Authentication algorithm set bcu> auth -algo 2/1 ms Authentication algorithm set bcu> auth --secret 5/0 mypasswd Authentication Secret set bcu> auth --stats 4/1
See Also
None.
102
debug
Gathers all the support information. Synopsis
bcu> debug -portlog <port_id> bcu> debug -portlogclear <port_id> bcu> debug -portlogctl <port_id> <enable | disable>
Captures all the support information needed to diagnose suspected system issues. The following operands are supported: - -portlog Displays the log of FC frames and other main control messages that were sent out and received. If the portlog is disabled, the following message displays as the first line: Refer to bcu debug portlogctl command for more information: WARNING: port log is disabled. port_id - -portlogclear port_id - -portlogctl port_id enable disable Specifies the ID of the port for which you want to display the FC frame logs and other control messages. Clears the ports frame log. Specifies the ID of the port for which you want to clear the ports frame log. Enable or disable the portlog. Specifies the ID of the port for which you want to enable or disable the portlog. Enables the portlogclear command. Disables the portlogclear command.
Example
bcu> debug --portlog 1/0 Total records present = 256 --------------------------------------------------------------------------Time Module Event Len Log info --------------------------------------------------------------------------5f54f984 FCXP Rx 4 231f141d,001f1400,214cffff,01000000 5f54f986 FCXP Rx 4 231f141d,001f1400,214cffff,02000000 5f54fabc FCXP Rx 4 231f141d,001f21ef,214effff,02000000 5f54fd8a FCXP Rx 4 231f141d,00fffffe,2150099f,02000000 5f551ab9 FCXP Rx 16 031f1400,00fffffc,215209a0,01000000 5f551abf FCXP Tx 56 02fffffc,001f1400,0000ffff,01000000 5f551f4c FCXP Rx 16 031f1400,00fffffc,215409a3,01000000 5f551f4f FCXP Tx 56 02fffffc,001f1400,0000ffff,01000000 5f5523f4 FCXP Rx 16 031f1400,00fffffc,215609a6,01000000 5f5523f8 FCXP Tx 56 02fffffc,001f1400,0000ffff,01000000 5f552879 FCXP Rx 16 031f1400,00fffffc,215809a7,01000000 5f55287b FCXP Tx 56 02fffffc,001f1400,0000ffff,01000000 5f552dc1 FCXP Rx 16 031f1400,00fffffc,205609ad,01000000 5f630e44 UF Rx 40 221f1400,00fffffd,09aeffff,61040008 5f630e59 FCXP Tx 36 23fffffd,001f1400,09aeffff,02000000 5f630e6b FCXP Tx 148 221f141d,001f1400,0000ffff,03000000 5f630f3d FCXP Rx 4 23fffffd,001f1400,09aeffff,01000000 5f637343 FCXP Rx 0 221f141c,001f1400,0000ffff 5f819ba8 FCXP Tx 148 221f141c,001f1400,0000ffff,03000000 5ff0652d FCXP Rx 0 221f141d,001f1400,0000ffff
103
A
600b1c96 600fb7c0 6029b887 609ca9a9 60badd22 60bbfc3d 6148ee29 614e1847 614e188c 614e18e3 614e18fc 614e1902 614e1905 614e1922 614e1923 614e1a54 614e1d70 614e3bc2 614e3bc8 614e404e 614e4051 614e44d3 614e44d6 614e496d 614e496f 614e4df2 615c1a9b 615c1ab0 615c1abf ...... FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP UF FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP FCXP UF FCXP FCXP Tx Rx Tx Rx Tx Rx Rx Tx Rx Tx Tx Tx Tx Rx Rx Rx Rx Rx Tx Rx Tx Rx Tx Rx Tx Rx Rx Tx Tx 148 0 148 0 148 0 0 48 48 48 48 36 56 4 4 4 4 16 56 16 56 16 56 16 56 16 40 36 148 221f141d,001f1400,0000ffff,03000000 221f141c,001f1400,0000ffff 221f141c,001f1400,0000ffff,03000000 221f141d,001f1400,0000ffff 221f141d,001f1400,0000ffff,03000000 221f141c,001f1400,0000ffff 221f141d,001f1400,0000ffff 221f1400,001f141e,0000ffff,05000000 221f1400,001f141e,2058ffff,05000000 221f21ef,001f141e,0000ffff,05000000 22fffffe,001f141e,0000ffff,05000000 231f141e,001f1400,2058ffff,02000000 02fffffc,001f1400,0000ffff,01000000 231f141e,001f1400,2058ffff,01000000 231f141e,001f1400,2058ffff,02000000 231f141e,001f21ef,205effff,02000000 231f141e,00fffffe,206e09b2,02000000 031f1400,00fffffc,206c09ba,01000000 02fffffc,001f1400,0000ffff,01000000 031f1400,00fffffc,207209bc,01000000 02fffffc,001f1400,0000ffff,01000000 031f1400,00fffffc,207009bf,01000000 02fffffc,001f1400,0000ffff,01000000 031f1400,00fffffc,207609c0,01000000 02fffffc,001f1400,0000ffff,01000000 031f1400,00fffffc,20cc09c3,01000000 221f1400,00fffffd,09c6ffff,61040008 23fffffd,001f1400,09c6ffff,02000000 221f141e,001f1400,0000ffff,03000000
bcu> debug --portlogclear 1/0 port log is successfully cleared bcu> debug --portlogctl 1/0 enable portlog enabled bcu> debug --portlogctl 1/0 disable portlog disabled
See Also
None.
104
diag
Lists the non-destructive group of diagnostic commands. Synopsis
bcu> diag --sfpshow <port_id> bcu> diag --tempshow <ad_id> bcu> diag --pciloopback <port_id> [-p <pattern>] [-c <frame_count>] bcu> diag --loopback <port_id> [-t <loopback-type>] [-s <speed>] [-c <frame_count>] [-p <pattern>] bcu> diag --memtest <ad_id> bcu> diag --beacon <port_id> <on | off> [<duration>]
Displays the group of diagnostic commands that are non-destructive and indicates when the adapter is running at a normal operation state. The following operands are supported: - -sfpshow Monitors the attributes of the SFP. Note: A notification occurs for any parameter that is not within the configured power, temperature, voltage, and current policy. Specify the ID of the port on which you want to monitor the SFP attributes. Blinks the appropriate port LED for physical identification. Specify the ID of the port for which you want to beacon. Specify if beaconing is to be turned on or off. Specify the length of time between blinks. 0, meaning infinite beaconing, is the default. Runs the port loopback test. Specify the ID of the port on which you want to run a loopback test. Specify the length of time between blinks. Specify the loopback speed: 8 | 4 | 2 | 1. Specify the frame count. Specify the pattern (must be one hex word). Tests the adapters memory blocks. Specify the ID of the port on which you want to run a memory test. Sends a health check message from the host to firmware through message queues memory mapped over the PCI. Specify the ID of the port for which you want to send a health check message. Displays the data pattern.
port_id - -beacon port_id on | off duration - -loopback port_id duration -s speed -c frame count -p pattern - -memtest ad_id - -pciloopback port_id p pattern -c frame count
-t loopback-type Specify the loopback type: int | serdes | ext.
105
A
- -tempshow ad_id Example Reads the adapters temperature sensor registers. Specify the ID of the adapter for which you want to display temperature sensor registers.
bcu> diag --sfpshow 1/0 Identifier: 3 SFP Connector: 7 LC Transceiver: 540c404000000000 200,400,800_MB/s M5,M6,SN,S, Encoding: 1 8B10B Baud Rate: 85 (units 100 megabaud) Length 9u: 0 (units km) Length 9u: 0 (units 100 meters) Length 50u: 5 (units 10 meters) Length 62.5u: 2 (units 10 meters) Length Cu: 0 (units 1 meter) Vendor Name: BROCADE Vendor OUI: 00:05:1e Vendor PN: 57-1000012-01 Vendor Rev: A Wavelength: 5203 (units nm) Options: 003a Rx_LOS TX_FAULT TX_DISABLE RATE_SELECT BR Max: 0 BR Min: 0 Serial No: UAF10738000010P Date Code: 070916 Temperature: 34.691406 Centigrade Current: 6.628000 mAmps Voltage: 3.414000 V RX Power: 0.340000 mW Tx Power: 0.464000 mW bcu> diag --tempshow 1 temperature: 38.520200 C
See Also
fcdiag
106
fcdiag
Runs diagnostic tests on Fibre Channel components. Note: port_id could be any of the following:
NOTE
bcu fcdiag - -fcping and bcu fcdiag - -fctraceroute are not available on Solaris platforms. Synopsis
bcu> bcu> bcu> bcu> bcu> fcdiag fcdiag fcdiag fcdiag fcdiag -fcping <port_id> <rpwwn> [-l lpwwn] --fctraceroute <port_id> <rpwwn> [-l lpwwn] --fcecho <port_id> <rpwwn> [-l lpwwn] --linkbeacon <port_id> {on | off} --scsitest <port_id> <rpwwn> [-l lpwwn]
Operands
The following operands are supported. - -fcping port_id rpwwn lpwwn - -fctraceroute port_id rpwwn lpwwn - -fcecho port_id rpwwn lpwwn - -linkbeacon port_id Specify the ID of the port for which you want to run the fcecho command. Specify the remote port world wide name. Specify the logical port world wide name. This is an optional argument. Blinks (toggles) the link beacon. Specify the ID of the port for which you want to run a linkbeacon test. Enable link beaconing by turning it on or off. If it is turned on, you can specify duration. Determines the basic connectivity between two Fibre Channel network points and monitors and measures network latency. Specify the ID of the port you want to ping. Specify the remote port world wide name you want to ping. Specify the logical port world wide name. This is an optional argument. Reports on a SAN path, including node hops and latency data. Specify the ID of the port on which you want to run the fctraceroute command. Specify the remote port world wide name. Specify the logical port world wide name. This is an optional argument.
mode {on|off} | t duration
107
A
- -scsitest port_id rpwwn lpwwn See Also diag Tests the SCSI components. Specify the ID of the port for which you want to run a linkbeacon test. Specify the remote port world wide name. Specify the logical port world wide name. This is an optional argument.
108
fabric
Prints and resets fabric statistics. Synopsis Operands
bcu> fabric -stats <port_id> bcu> fabric --statsclr <port_id>
The following operands are supported: - -stats port_id - -statsclr port_id Prints the fabric statistics. Specify the ID of the fabric port for which you will print the statistics. Resets the fabric statistics. Specify the ID of the fabric port for which you will reset the statistics.
Example
bcu> fabric --stats 1/0 Fabric Stats: FLOGI sent: 114 FLOGI rsp errors: 0 FLOGI accept errors: 0 FLOGI accepts: 58 FLOGI rejects: 0 FLOGI unknown rsp: 0 FLOGI alloc wait: 0 FLOGI received: 0 FLOGI rejected: 0 fabric offlines: 57 fabric onlines: 58
See Also
None.
109
fcpim
Enables or disables FCP initiator mode. bcu fcpim - -mpiomode is not available on the Solaris operating system. Synopsis
bcu> bcu> bcu> bcu> bcu> fcpim fcpim fcpim fcpim fcpim -query <port_id> <rpwwn [-l <lpwwn>] --stats <port_id> <rpwwn [-l <lpwwn>] --statsclear <port_id> <rpwwn [-l <lpwwn>] --mpiomode <port_id> {on|off [tov]} --qdepth <port_id> <q_depth_value>
NOTE
Enables or disables fast failover of the Fibre Channel Port (FCP) initiator mode I/O and displays or clears statistics. The following operands are supported: - -query port_id rpwwn lpwwn - -stats port_id rpwwn lpwwn - -statsclr port_id rpwwn lpwwn - -mpiomode port_id on|off tov - -qdepth port_id Specify the ID of the port for which you want to enable or disable the FCP initiator mode. Specify the ID of the port for which you want to enable or disable the FCP initiator mode. Specify whether MPIO mode is enabled or disabled. Specify the ID of the port for which you want to enable or disable the FCP initiator mode. Specify the remote port world wide name. Specify the logical port world wide name. This is an optional argument. Displays statistics related to the Fibre Channel port. Specify the ID of the port for which you want to display information. Specify the remote port world wide name. Specify the logical port world wide name. This is an optional argument. Displays statistics related to the Fibre Channel port. Specify the ID of the port for which you want to display information. Specify the remote port world wide name. Specify the logical port world wide name. This is an optional argument.
q_depth_value Specify the queue depth value.
110
A
Example
# bcu> fcpim --stats 1/0 50:00:1f:e1:50:0d:da:a9 rport onlines: 4 rport offlines: 3 PRLI sent: 4 PRLI Accepts: 4 PRLI error responses: 0 PRLI responses parse err: 0 fcxp alloc waits: 0 Second level err recovery: 0 Num times in initiator mode: 0 HAL fcpim statistics online events: offline events: create events: delete events: create completions: delete completions: SLER events: IOC down events: IO cleanup completions: task management commands: TM firmware responses: TM successes: TM failures: TM related IO cleanups: TM firmware queue resumed: TM affected by IOC down events: TM affected by ITN offline: TM offline cleanup completions: IO requests: IO completions:
4 3 1 0 4 2 0 1 3 0 0 0 0 0 0 0 0 0 456026 456026
See Also
IOC vport
111
IOC
IO Controller (IOC) refers to the combination of port and the firmware controlling it. Synopsis
bcu> bcu> bcu> bcu> bcu> bcu> ioc ioc ioc ioc ioc ioc -stats <ioc_id> -statsclr <ioc_id> -enable <ioc_id> -disable <ioc_id> --query <ioc_id> --intr <ioc_id> <--coalesce|-c> {on | off} <Latency> <Delay>
Description
Displays the IOC statistics and enables you to clear the statistics and enable or disable the IOC.
CAUTION:
Disabling the IOC is a destructive operation.
Operands
The following operands are supported: - -stats ioc_id - -statsclr ioc_id - -enable ioc_id - -disable ioc_id - -query ioc_id - -intr Displays the port level statistics. Specify the ID of the port for which you want to display information. Clears the port level statistics. Specify the ID of the port for which you want to clear statistical information. Enables the IO Controller (IOC). If the IOC is already enabled, the command is ignored. Specify the port of the IO Controller (IOC) you want to enable. Disables the port of the IO Controller (IOC). If the IOC is already disabled, the command is ignored. Specify the ID of the port you want to disable. Queries IOC information. Specify the ID of the port for which you want to display information. Sets the ports interrupt attributes. Note: The operation fails if the input parameters are out of the supported range. ioc_id coalesce|c Latency Specify the ID of the port for which you want to set the ports interrupt attributes. Displays the coalescing flag values. Supported values are on or off. Set latency monitor time out values in microseconds, if coalesce is set to on. Latency time out values supported are 0-225 microseconds. Setting the latency time out value to 0 disables the latency monitor time out interrupt. Set delay time out values in microseconds, if coalesce is set to on. Delay time out values supported are 0-1125 microseconds. Setting the delay time out value to 0 disables the latency monitor time out interrupt.
Delay
112
A
Example
# bcu> ioc --stats 1/0 IOC driver statistics: mailbox interrupts: start events: stop events: enable events: disable events: heartbeat failures: firmware boots: stats timeouts: IOC firmware statistics: heartbeat count: config requests: enable requests: disable requests: stats requests: clear stats reqs: unknown requests: intr coalesce reqs: Firmware IO statistics: IO aborts: implicit IO aborts: IO timeouts: ABTS failures: EDTOV timer events: RECTOV timer events: seq level rec failures: unexpected frames: unexp fr - good rsp: unexp fr - bad rsp: sequence count errors: IO underruns: IO underrun errors: IO overruns: IO overrun errors: data out of range: IO protocol errors: target IO aborts: Firmware port FPG statistics: FPG interrupts: FPG level 0 intrs: FPG 0 cause intrs: FPG intr other: FPG intr other ignored: FPG signal lost: FPG signal regained: FPG sync lost: FPG sync timeout: FPG sync regained: FPG div2 overflow: FPG div2 underflow: FPG efifo overflow: FPG efifo underflow: FPG IDLE primitives: FPG LRR primitives: FPG LR primitives: FPG OLS primitives: FPG NOS primitives: FPG LIP primitives: FPG ARBF0 primitives:
5 0 0 2 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 24 0 24 0 24 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
113
A
FPG MRK primitives: 0 FPG unknown primitives: 0 Firmware port PHYSM statistics: module inserts: 0 module extracts: 0 module invalid events: 0 module validation ignored: 0 laser faults: 0 signal loss count: 0 sync loss count: 0 Firmware port SNSM statistics: HWSM success: 0 HWSM failures: 0 HWSM timeouts: 0 SWSM success: 2 SWSM timeouts: 0 Firmware port LKSM statistics: HWSM success: 0 HWSM failures: 0 HWSM timeouts: 0 SWSM success: 0 SWSM failures: 0 SWSM timeouts: 0 busy buffer failures: 0 bufwait state entries: 0 link failures: 0 prim seq protocol errs: 0 LR tx started: 0 LRR tx started: 0 OLS tx started: 0 NOS tx started: 0
bcu> ioc --statsclr 1/0 Successfully reset the ioc level stats bcu> ioc --enable 1/0 port id 1/0 enabled bcu> ioc --enable 1/0 Error: IOC is already enabled bcu> ioc --disable 1/0 port id 1/0 disabled bcu> ioc --disable 1/0 Error: IOC is already disabled bcu> ioc --intr 1/0 --coalesce off Interrupt coalescing has been turned off bcu> ioc --intr 1/0 --coalesce on Interrupt coalescing has been turned on bcu> ioc --intr 1/0 --coalesce on -latency xxx -delay xxx Interrupt coalescing has been turned on bcu> ioc --intr 1/0 --coalesce on -latency xxx -delay xxx Interrupt coalescing parameter set failed. Latency/delay value out of range.
114
A
See Also adapter lport
115
log
Sets the log level for each module. If no log level is specified, the current level is used. Synopsis
bcu> log -level <port_id> [<Critical|Error|Warning|Info>] [-m <fw|ha1|fcs|drv|aen|all>]
Description
The number of messages logged by the host depends on the predetermined logging level. Although the HBA might generate many messages, only certain types of messages are logged based on the specified logging level. The following operand is supported: - -level port_id The number of messages logged by the host depends on the predetermined logging level. Specify the ID of the port for which you want to set the log level. Specify the severity level. fw | ha1 | fcs | drv | aen | all Specify the mode.
Operands
Critical | Error | Warning | Info
See Also
None.
116
lport
Lists the logical port (lport) commands. A logical port is a port that is logged into a fabric. Synopsis
bcu> bcu> bcu> bcu> lport lport lport lport -list <port_id> -query <port_id> [-l lpwwn] -stats <port_id> [-l lpwwn] --statsclr <port_id> [-l lpwwn]
Lists all the logical ports (lports) under a given port_id. The following operands are supported: - -list port_id - -query port_id lpwwn - -stats port_id lpwwn - -statsclr port_id lpwwn Specify the ID of the port for which you want to clear statistical information. Specify the logical ports port world wide name for which you want to clear statistical information. If the lpwwn is not specified, the base port is used. Lists all the lport commands. Specify the ID of the port for which you want to display information. Lists the attributes of the logical port. Specify the ID of the port for which you want to display information. Specify the logical ports port world wide name for which you want to display information. If the lpwwn is not specified, the base port is used. Displays the logical ports statistics. Specify the ID of the port for which you want to display statistical information. Specify the logical ports port world wide name for which you want to display statistical information. If the lpwwn is not specified, the base port is used.
Example
bcu> lport --list 1/0 Port ID: 1/0 Port Name: Port PWWN: 10:00:00:05:1e:53:0e:4a Port NWWN: 20:00:00:05:1e:53:0e:4a HW Path: 0000:0d:00.0 Num LPORTs: 1
PT
BP
FC Addr
062100
LPORT PWWN
10:00:00:05:1e:53:0e:4a
LPORT NWWN
20:00:00:05:1e:53:0e:4a
FC4 Roles
IM
# bcu> lport --query 1/0 Port FC Addr: 062100 Port Type: Base Port (State: Linkup) Port PWWN: 10:00:00:05:1e:53:0e:4a Port NWWN: 20:00:00:05:1e:53:0e:4a Symbolic name: Brocade-825 | 1.0.0 | hba-rh5x-2950-iu23 | Red Hat Enterprise Linux Server release 5 (Tikanga) | Role: FCP Initiator Switch NWWN: 10:00:00:05:1e:41:22:40
117
# bcu> lport --stats 1/0 NS PLOGI sent: 2 NS PLOGI accepts: 2 NS PLOGI rsp errors: 0 NS PLOGI accept errors: 0 NS PLOGI rejects: 0 NS PLOGI unknown rsp: 0 NS PLOGI alloc wait: 0 NS NS NS NS NS NS NS NS NS NS NS NS NS NS NS NS RSPN_ID RSPN_ID RSPN_ID RSPN_ID RSPN_ID RFT_ID RFT_ID RFT_ID RFT_ID RFT_ID GID_FT GID_FT GID_FT GID_FT GID_FT GID_FT sent: accepts: rsp errors: rejects: alloc wait: sent: accepts: rsp errors: rejects: alloc wait: sent: accepts: rsp errors: rejects: unknown rsp: alloc wait: 2 2 0 0 0 2 2 0 0 0 2 2 0 0 0 0 0 0
NS timeouts: NS retries:
RSCN received : 0 port_id RSCN received : 0 # bcu> lport --statsclr 1/0 Successfully reset the lport level stats
See Also
None.
118
pbind
Lists, enables, and disables target persistent binding. Synopsis
bcu> pbind -enable <port_id> bcu> pbind --disable <port_id> bcu> pbind --list <port_id> <pwwn>
Enables target port world wide name binding to a persistent target ID for the OS stack. The following operands are supported: - -enable port_id - -disable port_id - -list port_id pwwn Enables target persistent binding. Specify the ID of the port on which you want to enable persistent binding. Disables target persistent binding. Specify the ID of the port for which you want to disable persistent binding. Queries the list of mappings from the persistent binding module. Displays the ID of the port for which you want to display information. Displays the world wide name of the port for which you want to display information.
See Also
None.
119
port
Lists the port commands (the physical ports on the HBA). Note: port_id could be any of the following:

Synopsis

port port port port port port port port port -list -name <port_id> <port_name> -enable <port_id> -disable <port_id> <-f> -stats <port_id> --statsclr <port_id> --query <port_id> -speed <port_id> <1|2|4|8|auto> --dfsize <port_id> [df_size]
bcu> bcu> bcu> bcu> bcu> bcu> bcu> bcu> bcu>
Operands
The following operands are supported: - -list - -name port_id port_name Lists all the physical ports along with their basic attributes. Query or set the port name. You can clear the port name using an empty string ( ). Specify the ID of the port for which you want to display information. Specify a new name for the port. The name can include up to 15 characters, must begin with an alphabetic letter, can consist of letters, digits, hyphens, and underscore characters, and no spaces. Naming a port is optional; if you do not specify a port name, the current port name displays. Enables the physical port if it is disabled. Specify the ID of the port you want to enable. Disables the physical port, if currently enabled. This is a destructive operation and affects normal operation of the port. The port is taken offline, all remote FCP sessions are logged out, and all outstanding I/Os are terminated. You are prompted before disabling occurs. Note: For scripting, use the -f option to force the operation. port_id - -stats port_id - -statsclr port_id - -query port_id Specify the ID of the port you want to disable. Displays the physical port-level statistics. Specify the ID of the port for which you want to display statistical information. Clears port-level statistics. Specify the ID of the port for which you want to clear statistical information. Queries and displays port-related information for a port. Specify the ID of the port for which you want to display information.
- -enable port_id - -disable
120
A
- -speed Queries or sets the port speed. The port speed can be changed dynamically (when the port is enabled). If the port is disabled, the new port speed setting takes effect when the port is re-enabled. Note: Values 1, 2, 4, and 8 mean a single-port speed setting. The speed value is a bit mask that specify speeds to be considered for auto-negotiation. 1Gbps speed is not valid for an 8 Gbps HBA; 8Gbps speed is not valid for a 4 Gbps HBA. port_id speed Specify the ID of the port for which you want to set the port speed. Specify the port speed. Supported values are:
auto - auto-negotiates the speed. 1 - 15 - bit mask of speeds 1/2/4/8 Gbps.

- -dfsize Queries or sets the ports maximum receive data field size. If you do not specify a value, the current receive buffer size displays. Note: The new receive data field size takes effect when the port is re-enabled. port_id df_size Specify the ID of the port for which you want to set the data field size. Indicates the maximum supported receive data field size, in decimal value. If set to auto, the driver default value displays. dfsize values include 512, 1024, 2048, and 2112.
Example
bcu> port --list
Port #
1/0 1/1 2/0 2/1 3/0
FC Addr
010000 -- 010100 ---
PWWN
10:00:00:04:1e:53:04:f0 10:00:00:05:1e:53:04:f1 10:00:00:05:1e:0a:41:98 10:00:00:05:1e:0a:41:99 10:00:00:05:1e:53:0b:ad
Sfp
sw -sw -sw
State
Linkup Linkdown Linkup Linkdown Linkdown
Spd
4G --8G -----
Type
N -N ---
bcu> port --name 1/0 emc_fab3_ad5_p0 Port 1/0s name set to emc_fab3_ad5_p0 bcu> port --name 1/0 Port 1/0s name is emc_fab3_ad5_p0 bcu> port --enable 2/1 port enabled bcu> port --enable 2/1 port is already enabled bcu> port --disable 2/1 port disabled bcu> port --disable 2/1 port is already disabled
121
A
bcu> port --stats 1/0 tx_frames: tx_words: rx_frames: rx_words: lip_count: nos_count: link_failures: loss_of_syncs: loss_of_signals: primseq_errs: invalid ordered set: nonframe coding err: invalid_crcs frames: undersized frames: oversized frames: bad EOF frames: error_frames: dropped_frames: 101606 4833130 96183 1211891 0 0 0 0 0 0 0 2 0 0 0 0 0 0
bcu> port --statsclr 1/0 Successfully reset the port level stats bcu> port --speed 1/0 auto Setting will be enforced after port --disable and --enable bcu> port --speed 1/0 Current port speed is: 8G Configured port speed is: Auto bcu> port --dfsize 1/1 2112 Setting will be enforced after port --disable and --enable bcu> port --dfsize 1/1 auto Setting will be enforced after port --disable and --enable
See Also
adapter IOC
122
rport
Lists the commands that apply to a remote port in a fabric. A remote port is a port that is physically separated from the adapter. Synopsis
bcu> bcu> bcu> bcu> rport rport rport rport -list <port_id> [-l <lpwwn>] -query <port_id> <rpwwn> [-l lpwwn] -stats <port_id> <rpwwn> [-l lpwwn] --statsclr <port_id> <rpwwn> [-l lpwwn]
Operands
The following operands are supported: - -list port_id lpwwn - -osname port_id lpwwn - -query port_id rpwwn lpwwn Lists all remote parts accessible for a given logical port. Specify the ID of the port for which you want to display rport information. Specify the logical port world wide name. This is an optional argument. Note: If the -l lpwwn argument is not specified, the base port is used. Displays the operating system. Specify the ID of the port to the operating system. Displays the logical port world wide name. This is an optional argument. Displays detailed attributes of a remote port. Specify the ID of the port for which you want to query attributes of a remote port. Specify the remote port world wide name for which you want to query attributes. Specify the logical port world wide name for which you want to query attributes of a remote port. This is an optional argument. Note: If the -l lpwwn argument is not specified, the base port is used. - -stats port_id rpwwn lpwwn - -statsclr port_id rpwwn lpwwn Displays remote port statistics. Specify the ID of the port for which you want to display information. Displays the remote ports port world wide name. Displays the logical port world wide name. This is an optional argument. Note: If the -l lpwwn argument is not specified, the base port is used. Clears the remote port statistics. Specify the ID of the port for which you want to clear remote port statistics. Specify the remote ports port world wide name for which you want to clear remote port statistics Displays the logical port world wide name. This is an optional argument. Note: If the -l lpwwn argument is not specified, the base port is used.
123
A
Examples
bcu> rport --list 1/0 Num RPORTs = 17 ------------------------------------------------------------------------------FC Addr Remote Port PWWN Remote Port NWWN State F df_sz ------------------------------------------------------------------------------1f21ef 2f:ff:00:06:2b:0d:31:e5 2f:ff:00:06:2b:0d:31:e5 online T 2048 1f1401 28:18:00:0c:29:00:02:5a 28:18:00:0c:29:00:02:59 online I 2112 1f1402 28:18:00:0c:29:00:02:5f 28:18:00:0c:29:00:02:5e online I 2112 1f1403 28:18:00:0c:29:00:02:64 28:18:00:0c:29:00:02:63 online I 2112 1f1404 28:18:00:0c:29:00:02:69 28:18:00:0c:29:00:02:68 online I 2112 1f1405 28:18:00:0c:29:00:02:6e 28:18:00:0c:29:00:02:6d online I 2112 1f1406 28:18:00:0c:29:00:02:73 28:18:00:0c:29:00:02:72 online I 2112 1f1407 28:18:00:0c:29:00:02:78 28:18:00:0c:29:00:02:77 online I 2112 1f1408 28:18:00:0c:29:00:02:7d 28:18:00:0c:29:00:02:7c online I 2112 1f1409 28:18:00:0c:29:00:02:82 28:18:00:0c:29:00:02:81 online I 2112 1f140a 28:18:00:0c:29:00:02:87 28:18:00:0c:29:00:02:86 online I 2112 1f140b 28:18:00:0c:29:00:02:8c 28:18:00:0c:29:00:02:8b online I 2112 1f140c 28:18:00:0c:29:00:02:91 28:18:00:0c:29:00:02:90 online I 2112 1f140d 28:18:00:0c:29:00:02:96 28:18:00:0c:29:00:02:95 online I 2112 1f140e 28:18:00:0c:29:00:02:9b 28:18:00:0c:29:00:02:9a online I 2112 1f140f 28:18:00:0c:29:00:02:a0 28:18:00:0c:29:00:02:9f online I 2112 1f1410 28:18:00:0c:29:00:02:a5 28:18:00:0c:29:00:02:a4 online I 2112 # bcu> rport --query 1/0 RPORT FC Address: RPORT port wwn: RPORT node wwn: Status: Class of Service: Function: Data Field size: Cont.Incr.seq_cnt(CISC): symbolic name: Vendor: Product ID: Product Rev: bcu> rport --stats 1/0 offlines: 0 onlines: 1 RSCN : 0 PLOGI sent: 1 PLOGI accepts : 1 PLOGI timeouts: 0 PLOGI failed: 0 PLOGI rejects : 0 PLOGI received: 0 PRLI received: 0 ADISC sent: 0 ADISC received: 0 ADISC rejects : 0 ADISC accepts : 0 ADISC failed: 0 ADISC rejected: 0 LOGO sent: 0 LOGO accepts: 0 LOGO failed: 0 LOGO rejected: 0 LOGO received: 0 2f:ff:00:06:2b:0d:31:e5 1f21ef 2f:ff:00:06:2b:0d:31:e5 2f:ff:00:06:2b:0d:31:e5 online Class-3 Target 2048 Not Supported LSI7204XP-LC A.1 03-01078-02F FW:01.03.05 Port 1 SANBlaze VLUN FC RAMDisk 0005 2f:ff:00:06:2b:0d:31:e5
124
A
HAL rport statistics: uninit: create events: uninit: exception events: created: online events: created: delete events: created: IOC down: created: exception events: fw create: f/w responses: fw create: delete events: fw create: offline events: fw create: IOC down: fw create: exception events: online: offline events: online: delete events: online: IOC down events: online: exception events: fw delete: fw responses: fw delete: delete events: fw delete: IOC down events: fw delete: exception events: offline: delete events: offline: online events: offline: IOC down events: offline: exception events: delete: fw responses: delete: IOC down events: delete: exception events: delete pend: fw responses: delete pend: IOC downs: delete pend: exceptions: off-pending: fw responses: off-pending: deletes: off-pending: IOC downs: off-pending: exceptions: IOC down: offline events: IOC down: delete events: IOC down: online events: IOC down: exceptions:
1 0 1 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
bcu> rport -- statsclr 1/0 2f:ff:00:06:2b:0d:31:e5 Successfully reset the rport level stats
See Also
None.
125
supportSave
Gathers all the support information. Synopsis
bfa_supportsave [destination_directory]
NOTE
The bfa_supportshow command outputs much of the same information as the bfa_supportsave command, but to the command line screen rather than the output file. Description Operands Captures all the support information needed to diagnose suspected system issues. The following operands are supported: - -destination_directory Saves the collected supportsave information into an output file. Example
# bfa_supportsave ====================== Fetching Driver trace for port 1/0 ====================== Done. ====================== Fetching Driver trace for port 1/1 ====================== Done. ===================== Fetching Firmware trace for port 1/0 ===================== Done. ===================== Fetching Firmware trace for port 1/1 ===================== Done. ========================= Fetching supportshow details ========================= Done. ============================== Creating a tar ball ============================= Done. ======= Output file ./bfa_ss_out_2008-06-03_04_53_10/bfa_supportsave.tgz =======
126
vport
Lists the commands that apply to a virtual port. Note: vport commands are not supported on Solaris platforms. Synopsis
bcu> bcu> bcu> bcu> bcu> vport vport vport vport vport -create <port_id> vpwwn [-n <nwwn>] [-s <sname>] --delete <port_id> vpwwn --query <port_id> vpwwn --stats <port_id> vpwwn --statsclr <port_id> vpwwn
vport commands enable you to create and delete vports and display statistics about them. The following operands are supported: - -create Adds a new vport in the base fabric. Primary identification for a vport is the port wwn. A node wwn can optionally be assigned to a vport. One or more FC-4 protocols must be enabled for a vport. Specify the ID of the port for which you want to add a new vport. Adds the virtual port by its world wide name. If no port wwn is specified, the information provided is for the base vport. Adds the virtual port by the nodes world wide name for the vport. This is an optional argument. If not specified, the physical port nodes world wide name is used. Adds the symbolic name for the virtual port. This is an optional argument. Deletes the specified vport. This deletes all associated objects, such as any associated login sessions and active I/O requests. Specify the ID of the port for which you want to delete a vport. Deletes the virtual port by its world wide name. If no port wwn is specified, the information provided is for the base vport. Queries information about the vport. This provides the vports status and information associated with FC-4s. If no port WWN is specified, the information provided is for the base vport. Specify the ID of the port for which you want to query vport information. Queries the virtual port by its world wide name. If no port wwn is specified, the information provided is for the base vport. Displays the statistics that are associated with the vport. If you do not specify the ports world wide name, the statistics listed are for the base vport. Specify the ID of the port for which you want to display statistical information. Displays the statistics for the virtual port by its world wide name. If no part wwn is specified, the information provided is for the base vport.
port_id vpwwn n nwwn
s sname - -delete port_id vpwwn - -query
port_id vpwwn - -stats port_id vpwwn
127
A
- -statsclr port_id vpwwn Example Clears the statistics that are associated with the vport. If you do not specify the ports world wide name, the statistics listed are for the base vport. Specify the ID of the port for which you want to clear statistical information. Clears the statistics for the virtual port by its world wide name. If no part wwn is specified, the information provided is for the base vport.
# bcu> vport --stats 1/0 28:18:00:0c:29:00:02:69 FDISCs sent: 7 FDISC accepts: 7 FDISC retries: 0 FDISC req timeouts: 0 FDISC rsp errors: 0 FDISC bad accepts: 0 FDISC rejects: 0 FDISC unknown rsps: 0 FDISC alloc waits: 0 LOGOs sent: LOGO accepts: LOGO rejects: LOGO rsp errors: LOGO unknown rsps: LOGO alloc waits: No NPIV support: Fabric offlines: Fabric onlines: Fabric cleanups: 0 0 0 0 0 0 0 6 6 0
See Also
fcpim IOC
128
Appendix
FDMI FC-CTs
HBA Driver and FDMI

The HBA driver participates in the FC-GS5-compliant Fabric Device Management Interface (FDMI) when connected to a fabric. The HBA is expected to register and deregister its information in the fabric; based on this information, the fabrics HBA management server will service the HBA information query requests.
Code (hex)
0200 0210 0211
Mnemonic
RHBA RPRT RPA
Description
Register HBA Register Port Register Port Attributes
Attributes in request CT_IU

HBA Identifier, Registered Port List, HBA Attribute Block HBA Identifier, Port_Name, Port Attribute Block Port_Name, Port Attribute Block
129
130
Appendix
Standards Compliance
Standards Compliance Publications

Ref #
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
Publication Number
INCITS 352 NCITS TR-25:1999 ANSI X3.230:1994 ANSI X3.297:1997 ANSI X3.303:1998 ANSI/INCITS 373:2003 INCITS TR-30-2002 ANSI X3.272:1996 NCITS 332: 1999 ANSI INCITS 350-2003 ANSI INCITS 366-2003 NCITS TR-19:1998 NCITS TR-20:1998 RFC-4338 (this obsoletes RFC-2625) PCI-SIG Document PCI-SIG Document PCI-SIG Document PCI-SIG Document
Description
Fibre Channel Physical Interfaces (FC-PI) Fibre Channel Methodologies for Jitter Specification (FC-MJS) Fibre Channel Physical and Signaling Interfaces (FC-PH) Fibre Channel Physical and Signaling Interface - 2 (FC-PH-2) Fibre Channel Physical and Signaling Interface - 3 (FC-PH-3) Fibre Channel Framing and Signaling Interface (FC-FS) Fibre Channel - Methodologies for Interconnects (FC-MI) Fibre Channel Arbitrated Loop (FC-AL) Fibre Channel Arbitrated Loop (FC-AL-2) Fibre Channel Protocol for SCSI, Second Version (FCP-2) SCSI Architecture Model - 2 Private loop SCSI direct attach (FC-PLDA). Technical Report Fabric Loop Attachment (FC-FLA) Technical report. Internet Protocol and ARP over Fibre Channel, June 1999 (IP over FC profile) PCI Local Bus Specification Rev 2.3, March 29, 2002 PCI Local Bus Hot-Plug Specification, Rev 1.0, october 6, 1997. Adapter Card Requirements section only. PCI-X Addendum to the PCI Local Bus Specification. Rev 1.0a. July 24, 2000 PCI-Express Card Electromechanical Specification, Rev 1.0a. April 15, 2003 PCI-Express Base Specification, Rev 1.0a, April 15, 2003
Revision
Rev 13 Rev 10 Rev 4.3 Rev 7.4 Rev 9.4 Rev 1.9 Rev 1.92 Rev 4.5 Rev 7.0 Rev 8.0 Rev 24 Rev 2.1 Rev 2.7 January 206 N/A N/A N/A Rev 1.1 Dated 3/28/2005 Rev 1.1 Dated 3/28/2005 ECN to Rev 1.0a dated 8/12/2003
19
PCI-SIG Document
20
PCI-SIG Document
PCI-Express - Root Complex Discovery Topology, August 12, 2003
131
C
21 22 PCI-SIG Document PCI-SIG Document PCI-Express Reset Limit Adjustment, July 14, 2003 Errata for PCI-Express Base Specification, Rev 1.0a, October 7, 2003 ECN dated 7/14/2003 Rev1.0a dated 10/7/2003
132
Appendix
Glossary
D
BCU Brocade Command Line Utility (BCU) Beaconing A continuous signaling of error conditions on a LAN. Beaconing can occur either on the port or on one or both sides of the link (known as end-to-end beaconing). Buffer Credit A system and method for providing flow control for a computer network. Buffer-to-buffer credit flow control is implemented to limit the amount of data a port sends, based on the number and size of the frames sent from that port. DH Group Diffie-Hellman (DH) key exchange is a public key cryptosystem where public values are exchanged to arrive at a symmetric key among the end entities. There are five well-known DH groups, however, only DH-CHAP group 0, called NULL DH, is supported in this release. F_Port Fabric Port. A port on a switch to which an N_Port connects. HBA Host Bus Adapter HCM Host Connectivity Manager ITL Initiator-Target-LUN. An Initiator Port (HBA controller) talks to one Target Port addressing one LUN. JSON Java Script Object Notation. A lightweight computer data interchange format. It is a text-based format for representing data structures and arrays. JSON-RPC A remote procedure call protocol encoded in JSON. Logging level The number of messages logged by the host computer depends on a predetermined logging level. Although many messages might be generated by the HBA, only certain types of messages are typically logged.
133
D
Restrictions on message logging might be imposed by the operating system of the host computer. LUN Logical unit number. An address for an individual disk drive or virtual partition (volume) within a storage device. LUN mapping A process that makes a LUN available to some hosts and unavailable to other hosts. N_Port Node Port. A Fibre Channel host or storage port in a fabric or point-to-point connection. NPIV N_Port ID Virtualization (NPIV) enables a single Fibre Channel protocol port to appear as multiple, distinct ports, providing separate port identification within the fabric for each operating system image behind the port (as if each operating system image had its own unique physical port). Persistent binding A Fibre Channel (FC) host bus adapter (HBA) feature that enables you to permanently assign a system SCSI target ID to a specific FC device, even though the devices ID on the FC loop may be different each time the FC loop initializes. R_Port Remote port in a fabric. A remote port is a port that is physically separated from the adapter. WWNN World Wide Node Name. The unique name for any particular node in the fabric; for example, an HBA. WWPN World Wide Port Name. The unique name for any particular port in the fabric. A WWNN can have multiple associated WWPNs.
134
Index
A
adapter command, 99 advanced port configuration options, 31 application log, 55 auth command, 101 Authentication Configuration dialog box, 83 authentication, security, 19
configuring NPIV, 34 configuring persistent binding using the CLI, 27 configuring port speed, 22 configuring security authentication using the GUI, 16 configuring world wide names, 34
D
debug command, 66, 103 Define Name dialog box, 86 Device properties panel, 81 diag command, 105 diagnostics related documentation, 57 running port-level test, 59, 60 types of tests, 2 dialog box Authentication Configuration, 83 Configure Names, 85 Define Master Log Filter, 93 Define Name, 86 Event Properties, 94 Persistent Binding, 87 Protocol Tests diagnostics, 89 Security Authentication, 83 Test Log Details, 91 discovery description of, 2 setting up, 12 setting up out-of-band, 13 documentation related for diagnostics, 57
B
backing up data prior to uninstall, 10 base port properties panel, 73 beaconing configuring using the BCU, 63 configuring using the GUI, 64 buffer credits, 38
C
command adapter, 99 auth, 101 debug, 66, 103 diag, 58, 105 fabric, 109 fcdiag, 58, 107 fcpim, 110 IOC, 112 log, 30, 116 lport, 117 pbind, 119 port, 120 portlog, 66 portlogclear, 66 portlogct, 66 rport, 123 supportSave, 66, 126 vport, 127 Configure Names dialog box, 85
E
event categories, 92 event log entries filtering, 54 event logs, how to filter, 54 Event Properties dialog box, 94
135
event severities, 53 events, master log, 53
log application, 55 master log, 53 test, 62 log command, 30, 116 log off, 14 logging level configuring using the BCU, 24 login, how to skip, 8 lport command, 117 LUN properties panel, 82
F
fabric command, 109 Fabric Device Management Interface (FDMI) specifications, 129 fcdiag command, 107 fcpim command, 110 frame data field size specifying using the BCU, 25 specifying using the GUI, 24
M
management software components, 1 Master Log Filter dialog box, 93 Master Log properties, 53 Master Log Properties tab, 92 monitoring types of statistics, 2 MPIO specifying using the BCU, 25 specifying using the GUI, 25
H
HBA Properties panel, 70 HCM authentication, 9 change password dialog box, 84 features, 2 main window, 11 master log icons, 53 product icons, 12 software overview, 1 HCM logging level configuring using the GUI, 30 host management, remote, 1 host security authentication, 15
N
name configuration, 34 nickname association tasks, 34 NPIV configuration, 34
I
interrupt control coalesce, 32 configuring using the BCU, 33 configuring using the GUI, 33 IOC command, 112
O
operating system support standard, 4 operating systems, support for, 4 operating system-specific features, 5
L
launching HCM on Linux, 8 on Solaris, 8 on Windows, 7 Linux launching HCM, 8
136
P
panel Device properties, 81 HBA Properties, 70 LUN properties, 82 Port POM, 79 Port SFP, 77 Port Statistics, 80 remote port properties, 74, 75 Virtual port parameters, 76 password how to change, 9 how to reset, 10 path time out specifying using the BCU, 26 specifying using the GUI, 26 pbind command, 119 persistent binding configuring using the BCU, 29 configuring using the GUI, 27, 29 Persistent Binding dialog box, 87 persistent binding, configuring, 27 polling frequency rate controlling, 39 port command, 120 port configuration advanced, 31 opening the advanced dialog box, 31 opening the basic dialog box, 21 port speed, 22 port configuration options basic, 20 port logging level configuring using the GUI, 23 Port POM panel, 79 port properties panel, 71 Port SFP panel, 77 port speed configuring using the BCU, 23 configuring using the GUI, 22 Port Statistics panel, 80 Port Test diagnostics dialog box dialog box Port Test diagnostics, 88 port-level diagnostic tests, running from GUI, 60 portlog command, 66 portlogclear command, 66 portlogct command, 66
properties importing in EFCM format, 37 importing in FM format, 37 Protocol Tests diagnostics dialog box, 89
Q
queue depth configuring using the BCU, 32 configuring using the GUI, 32
R
remote host management, 1 Remote port properties panel, 74, 75 resetting a password, 10 rport command, 123
S
SAN components, types listed in device tree, 3 security authentication configuring using the BCU, 19 configuring using the GUI, 16 Security Authentication dialog box, 83 SFP displaying using the BCU, 64 displaying using the GUI, 64 management information, 65 SFP management, 64 skip login, 8 Solaris launching HCM, 8 statistics authentication, 52 FCP IP, 46 logical port, 44 resetting, 40 target, 48
137
supportSave categories of information, 66 collecting on a port crash event, 67 collecting using a browser, 68 collecting using the BCU, 67 collecting using the GUI, 67 collection sources, 67 configuring using the CLI, 67 configuring using the GUI, 67 supportSave command, 66, 126
T
test log details, 62 Test Log Details dialog box, 91 tree node pop-up menus, 3
U
uninstalling how to backup data prior to, 10
V
Virtual port parameters panel, 76 vport command, 127
W
Windows launching HCM application, 7 world wide names configuring, 34 WWN adding a name, 38 exporting, 36 importing, 36 removing, 35
138

Brocade Fibre Channel HBA: Administrator's Guide

Caricato da

Informazioni sul documento

Descrizione originale:

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Brocade Fibre Channel HBA: Administrator's Guide

Caricato da

Copyright:

Formati disponibili

53-1000881-01 13 June 2008

Brocade Fibre Channel HBA

Brocade Communications Systems, Incorporated

About This Document

Getting Started with HCM Software

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

HCM Dialog Boxes

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Command Line Utility (BCU)

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

About This Document

How this document is organized

Chapter 3, Host Configuration, provides the procedures to configure operating parameters

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Appendix D, Standards Compliance, provides reference information for standards

Notes, cautions, and warnings

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Notice to the reader

Referenced Trademarks and Products

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Other industry resources

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Getting technical help

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Tree node pop-up menus

Pop-up menu feature

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Operating System (OS) support

Driver operating system support

Driver operating system support

Host Connectivity Manager (HCM) for local and remote management

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Getting Started with HCM Software

HCM software launch

Launching the application on Windows platforms

HCM Login dialog box

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Launching the application on Solaris platforms

Disable Skip Login by setting hba-application.skip-login=false in the

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

The password is encrypted and stored in the noitacitnehtua.properties file.

Change Password dialog box

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

Backing up data after an uninstall

HBAApplication.properties SetupDiscovery.properties HbaAliasdb.properties log4j.xml noitacitnehtua.properties

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

HCM main window

Host Connectivity Manager main window

Brocade Fibre Channel HBA Administrators Guide 53-1000881-01

HCM product icons