HCMAdmin

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
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
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
Document History
Title
Publication number
Summary of changes
Date
Brocade Fibre Channel HBA

Administrators Guide
53-1000881-01
New document
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

53-1000881-01
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

53-1000881-01
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

53-1000881-01
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
Glossary
Index

53-1000881-01
vii
viii

53-1000881-01
Figures
Figure 1
HCM Login dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Figure 2
Change Password dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Figure 3
Host Connectivity Manager main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Figure 4
HCM product icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Figure 5
Setup for HBA Discovery dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Figure 6
Fibre Channel Security Protocol Configuration dialog box. . . . . . . . . . . . . . . . . . 16
Figure 7
Fibre Channel Security Protocol Configuration dialog box. . . . . . . . . . . . . . . . . . 17
Figure 8
Basic Port Configuration dialog box - Windows, Linux, and VmWare . . . . . . . . . 21
Figure 9
Basic Port Configuration dialog box - Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Figure 10
Port disable/enable Configuration dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Figure 11
Persistent Binding dialog box - host level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Figure 12
Persistent Binding dialog box - HBA level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Figure 13
Persistent Binding dialog box - port level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Figure 14
Persistent binding from the Basic Port Configuration dialog box . . . . . . . . . . . . 29
Figure 15
Configure HCM Logging Levels dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Figure 16
Advanced Port Configuration dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Figure 17
Configure Names dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Figure 18
Master Log Filter dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Figure 19
HCM Application Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Figure 20
Diagnostics - Port Tests dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Figure 21
Protocol-level tests dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Figure 22
Test Log Details for Echo Test dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Figure 23
Test Log Details for FC trace test dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Figure 24
SFP Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

53-1000881-01
ix

53-1000881-01
Tables
Table 1
Driver operating system support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Table 2
HCM operating system support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Table 3
OS-specific features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Table 4
Basic port configuration options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Table 5
Advanced port configuration options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Table 6
Master Log fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Table 7
HCM Master Log icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Table 8
Related diagnostic documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Table 9
Port-level test parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Table 10
SFP management information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Table 11
supportSave categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Table 12
supportSave collection sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

53-1000881-01
xi
xii

53-1000881-01
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).

53-1000881-01
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
italic text
Provides emphasis
Identifies variables
Identifies paths and Internet addresses
Identifies document titles
code text
Identifies CLI output

Identifies command syntax examples
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.
NOTE
A note provides a tip, guidance or advice, emphasizes important information, or provides a reference
to related information.
ATTENTION
An Attention statement indicates potential damage to hardware or data.
xiv

53-1000881-01
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
Referenced Trademarks and Products
Microsoft Corporation
Windows Server, Windows XP, Windows Vista
Sun Microsystems, Inc.
Sun, Solaris
Red Hat, Inc.
Red Hat, Red Hat Network, Maximum RPM, Linux Undercover
SuSE
SuSE Enterprise Server (SLES), Linux
VMware
VMware, ESX Server

53-1000881-01
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

53-1000881-01
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
Document Title
53-1000884-01
Brocade Fibre Channel HBA Installation and Reference Manual supporting HBA models
815, 825, 415, and 425
53-1000885-01
Brocade Fibre Channel HBA Troubleshooting Guide supporting HBA models 815, 825,
415, and 425
53-1000598-03
Fabric OS Administrators Guide supporting Fabric OS v6.1.0
53-1000853-01
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.

53-1000881-01
xvii
xviii

53-1000881-01
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.

53-1000881-01
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.

53-1000881-01
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
Pop-up menu feature
Host
Refresh All
Stop Polling
Configure Names
Basic Port Configuration
Persistent Binding
Port Statistics
FC SP
Support Save
Tree > Copy | Search | Collapse All | Expand All
HBA
Refresh
Define Name
Basic Port Configuration
Persistent Binding
Port Statistics
Diagnostics
FC-SP
Enable Adapter
Port
Refresh
Define Name
Port Configuration > Basic | Advanced
Persistent Binding
Port Statistics
Diagnostics
FC-SP > Authentication | Authentication Statistics
Enable Port
Beacon > Port | Link
Base Port
Refresh
Logical Port Statistics
VPort
Refresh
Logical Port Statistics
Virtual Port Statistics
Target Device
Refresh
Define Name
Statistics > Target Statistics | FCP IM Statistics

53-1000881-01
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
Operating System
x86
x64
IA64
SPARC
Windows Server 2003
32b
64b
No support
N/A
Windows Server 2008
32b
64b
No support
N/A
Linux RedHAT Enterprise (RHEL) 4.0
32b
64b
64b
No
32b
64b
64b
No
Linux SuSE Enterprise Server (SLES) 9.0 32b
64b
No support
No
Linux SuSE Enterprise Server (SLES)

10.0
32b
64b
64b
No
Solaris 10
32b
64b
N/A
64b
VMware ESX 3.5
32b
N/A
N/A
N/A
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.
NOTE
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).

53-1000881-01
1
TABLE 2
HCM operating system support
Operating System
x86
x64
IA64
SPARC
Windows Server 2003
32b
32b
No support
N/A
Windows Server 2008
32b
32b
No support
N/A
Windows Vista Enterprise
32b
32b
No support
N/A
Windows Vista Business
32b
32b
No support
N/A
Windows Vista Ultimate
32b
32b
No support
N/A
Windows XP Professional
32b
32b
No support
N/A
32b
32b
No support
No support
32b
32b
No support
No support
Linux SuSE Enterprise Server (SLES) 9.0 32b
32b
No support
No support
Linux SuSE Enterprise Server (SLES)

10.0
32b
32b
No support
No support
Solaris 10
32b
32b
N/A
32b
VMware ESX 3.5
N/A
N/A
N/A
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
OS-specific features
Features
Linux
Windows
VMware
Solaris
NPIV
Yes
Yes
Yes
No
Fibre Channel Security (FC-SP)

Authentication
Yes
Yes
Yes
No
Target persistent mode
No
Yes
No
No
MPIO mode and Path Time Out
Yes
Yes
Yes
No
FC Ping and FC Traceroute (Fibre

Channel diagnostic tests)
Yes
Yes
Yes
No

53-1000881-01

53-1000881-01
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.

53-1000881-01
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.

53-1000881-01
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.

53-1000881-01
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

53-1000881-01
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

53-1000881-01
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.
NOTE
The HCM application enables you to discover Brocade adapters, ports, virtual ports, remote ports,
and LUNs using out-of-band discovery only.
12

53-1000881-01
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.

53-1000881-01
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

53-1000881-01
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.
NOTE
Security authentication is not supported on Solaris platforms.

53-1000881-01
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

53-1000881-01
3
The Fibre Channel Security Protocol Configuration dialog at the HBA level displays.
FIGURE 7
Fibre Channel Security Protocol Configuration dialog box
From a port:
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.

53-1000881-01
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

53-1000881-01
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.
port_id
Specify the ID of the port for which you want to set the authentication policy.
on|off
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.
- -algo
port_id
Set the authentication algorithm.

Specify the ID of the port for which you want to set the authentication
algorithm.
md5|sha1|ms|sm
Specify the hash algorithm:
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
- -secret
Set the shared secret.

Note: You cannot clear the secret.
port_id
Specify the ID of the port for which you want to set the shared secret.
secret string
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.

53-1000881-01
19
3
- -stats
Displays the authentication statistics.
port_id
- -statsclr
Clears the authentication statistics.
port_id
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
Port configuration parameter
Configurable using the GUI
Configurable using the BCU
Port enable
Yes
Yes
Configure speed
Yes
Yes
Frame data field size
Yes
Yes
MPIO mode
Yes
Yes
Path Time Out *
Yes
Yes
Persistent Binding
Note: The persistent binding option is
available on Windows platforms only.
Yes
Yes
Log Level
Yes
Yes
* Path Time Out is available only when MPIO is disabled.
20

53-1000881-01
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

53-1000881-01
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.
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.
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

53-1000881-01
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

2. Select a value from the Port Logging Level list.
Supported values are Log Critical, Log Error, Log Warning, and Log Info.
4. Click OK to save the changes and close the window.

53-1000881-01
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.
Critical | Error | Warning | Info

Specify the severity level.
fw | ha1 | fcs | drv | aen | all
Specify the mode.
Refer to log on page 116 for details about this command.
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

2. Select the frame size from the Frame Data Field Size list.
The default value is 2112.
3. Click Apply to apply the change.
24

53-1000881-01
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.
NOTE
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>
where:
port_id
Specify the ID of the port for which you want to set the frame data field size.
df_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

2. Click the MPIO Mode Enable check box.
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
Specify the ID of the port for which you want to enable or disable the FCP
initiator mode.
on|off tov
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.

53-1000881-01
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

2. Type a value in to the Path Time Out text field. Its value range is 0 to 60.
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
initiator mode.
on|off tov
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

53-1000881-01
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.
NOTE
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
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

53-1000881-01
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
28
Persistent Binding dialog box - port level

53-1000881-01
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
Persistent binding from the Basic Port Configuration dialog box
NOTE
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
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.
port_id
Displays the ID of the port for which you want to display information.
pwwn
Displays the ports world wide name.
Refer to pbind on page 119 for details about this command.

53-1000881-01
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

53-1000881-01
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
Port configuration parameter
Configurable using the GUI
Configurable using the BCU
Queue Depth
Yes
Yes
Interrupt Control Coalesce
Yes
Yes
Interrupt Control Latency
Yes
Yes
Interrupt Control Delay
Yes
Yes
Opening the Advanced Port Configuration dialog box

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

53-1000881-01
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

From the Host Connectivity Manager, select Configure > Advanced Port Configuration.
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.

initiator mode.
q_depth_value Specify the queue depth value.

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

53-1000881-01
3
Configuring the Interrupt Control Coalesce using the GUI
From the Host Connectivity Manager, select Configure > Advanced Port Configuration.
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
Specify the ID of the port for which you want to set the ports interrupt
attributes.
c coalesce
Displays the coalescing flag values. Supported values are on or off.
Latency
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.
Delay
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.

53-1000881-01
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.
NOTE
NPIV is not supported on Solaris platforms.
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.

NOTE
In the GUI, across the adapters, ports, and remote ports, only unique names are allowed.
34

53-1000881-01
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.

53-1000881-01
35
3
Exporting the properties for a WWN
OR
Current Host
All WWNs
Only Nodes
Only Ports
Only Remote Ports
3. Click the Export button.

The Save dialog box displays.
4. Name the properties file, and click Save.
Importing the properties for a WWN

OR
Current Host
All WWNs
Only Nodes
Only Ports
Only Remote Ports
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.
36

53-1000881-01
3
Importing properties in EFCM format
1. In the Configure Names dialog box, select EFCM Format and then select Import.
2. Click OK.
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.
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,

53-1000881-01
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.
2. Type a name that represents an adapter, port, or storage device.
3. Type a valid WWN that corresponds to the name.
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

Refer to the Extended Fabrics concepts and planning section of the Fabric OS Administrators
Guide for detailed information about buffer credits.
38

53-1000881-01
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.

53-1000881-01
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

53-1000881-01
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.

53-1000881-01
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

53-1000881-01
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.

53-1000881-01
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

53-1000881-01
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.

53-1000881-01
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

53-1000881-01
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.

53-1000881-01
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

53-1000881-01
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.

53-1000881-01
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

53-1000881-01
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.

53-1000881-01
51
4
Authentication statistics
The Authentication Statistics dialog box displays statistical information related to transmitted and
received DHCHAP attempts for a selected port
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

53-1000881-01
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
Master Log fields
Field
Description
Filter button
Click to launch the Master Log Filter dialog box.
Clear Filter button
Click to clear the master log filter option set.
Sr No column
Displays a numbering sequence in ascending order.
Severity column
Displays the event severity (informational, minor, major, or critical)
WWN column
Displays the world wide name of the device on which the event
occurred.
Category column
Displays the category of event; for example, Rport or ITNIM.
Subcategory column
Displays the subcategory of the main category.
Description column
Displays a brief description of the event.
Date/Time column
Displays the date and time when the event occurred.
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-1000881-01
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

53-1000881-01
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

53-1000881-01
55
56

53-1000881-01
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
Related diagnostic documentation
Part Number
Document Title
53-1000884-01
Brocade Fibre Channel HBA Installation and Reference Manual supporting HBA models
815, 825, 415, and 425
53-1000885-01
Brocade Fibre Channel HBA Troubleshooting Guide supporting HBA models 815, 825,
415, and 425
53-1000598-03
Fabric OS Administrators Guide supporting Fabric OS v6.1.0
53-1000853-01
Fabric OS Troubleshooting and Diagnostics Guide supporting Fabric OS v6.1.0

53-1000881-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

53-1000881-01
Diagnostics using the GUI

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

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.

53-1000881-01
59
5
Port-level test parameters
TABLE 9
Port-level test parameters
Port-level test
Parameter
Test Options
Memory test
None
You can enable or disable this test.

Regardless of test cycle set value, the
Memory Test will run only once.
Frame Count
Integer from 0 - 4,294,967,295. The

default value is 8192.
Data Pattern
Default value is A5A5A5A5.
Test Cycle
The number of times the test runs. The

Subtest ID
Link Speed
8 Gb HBA:
2 Gbps
4 Gbps
8 Gbps
4 Gb HBA
1 Gbps
2 Gbps
4 Gbps
Frame Count
Integer from 0 - 4,294,967,295. The

Test Cycle
The number of times the test runs. The

Data Pattern (hexadecimal)
Default value is A5A5A5A5.
NOTE: During the test IOC will

be disabled.
PCI loopback test
Port loopback test
NOTE: For an External

Loopback test, you must plug
in the loopback connector.
Internal
Serdes
External loopback
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

53-1000881-01
5
Opening the Protocol Test dialog box
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.

53-1000881-01
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
Description
Time
The date and time the test was run.
Test
The name of the test.
Status
The status of the test, for example, executing or pending.
Configuration
The name of the test component and its corresponding value. For
example:
Adapter world wide name
Data pattern
Frame count
Port world wide name
Result
The test result, for example, test started or test complete.
See Figure 23 and Figure 22 for examples of test log detail.
FIGURE 22
62
Test Log Details for Echo Test dialog box

53-1000881-01
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.

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.

53-1000881-01
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>
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

53-1000881-01
FIGURE 24
SFP Properties
Details about the port technology and extended link are described in Table 10.
TABLE 10
SFP management information
SFP category
SFP information displayed
Port technology
Extended information

53-1000881-01
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
supportSave level
Captured information
System (or Host)
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
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

53-1000881-01
5
supportSave collection sources
Table 12 lists the sources from which you can gather supportSave information.
TABLE 12
supportSave collection sources
Source of supportSave information
supportSave information collected
BCU-based supportSave
Driver-related logs and config files
Browser-based supportSave
Driver-related logs andconfig files

Agent log/config files
HCM-based supportsave
Agent log and config files

HCM GUI log and config files
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.

53-1000881-01
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

53-1000881-01
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

53-1000881-01
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.
Field
Description
HBA Parameters
Node WWN
The adapters world wide name.
Name
The name representing the adapter.
Operating Status
Whether the HBA is enabled or disabled.
Manufacturer
The company that manufactured the HBA.
Model Description
The description of the HBA.
Hardware Path
The hardware path of the HBA.
Serial #
The serial number of the HBA.
Temperature
The temperature of the HBA, both in Celsius and Fahrenheit.
Chip Revision
The revision level of the chip.
Driver Parameters
Driver Name
The name of the host adapter driver.
Driver Version
The version level of the host adapter driver.
Firmware Parameters
Firmware Version
The version level of the firmware.
BIOS Version
The version level of the BIOS.
PCI Registers
70
Vendor ID
The identifier of the PCI Registers vendor
Device ID
The device ID of the PCI Register
Subsystem ID
The ID of the PCI subsystem.
Subsystem Vendor ID
The ID of the PCI subsystem vendor.
Current # of Lanes
The number of PCI lanes, in Gbps, each way between the PCI slot
and the adapter.
PCI Generation
The number of times the PCI Register is generated.
Initial Negotiated # of Lanes
The set number of PCI lanes that were initially negotiated.

53-1000881-01
Port properties panel

The Port properties panel enables you to display the properties that are associated with a selected
HBA port.
2. Click the Properties tab in the right pane.
Field
Description
Port Parameters
Port #
The port number: 0 or 1.
Port WWN
The ports world wide name.
Node WWN
The HBAs world wide name.
Port Type
The port type ( N_port).
Name
The name that is manually assigned to the port.
FC Address
The ports Fibre Channel address.
Configured Port State
Indicates whether the port is enabled or disabled.
Operating State
Indicates whether the link is online or offline.
Configured Speed
The configured speed of the port
Operating Speed
The speed at which the port is operating.
Max Speed Supported
The maximum port speed that is supported on the port.
Configured Topology
The topology setting.
Operating Topology
The topology setting at which the port is operating.
BB Credit
The maximum number of receive buffers.
Frame Data Field Size
The frame size, in bytes, of the port.
Hardware Path
Indicates whether MPIO is enabled or disabled.
# of LPorts
The number of logical ports.
Advanced Port Parameters

Queue Depth
The number of I/O operations that can be run in parallel on a device.
Indicates whether interrupt control is on or off.
Interrupt Control Latency
Sets the interrupt control latency value.
Interrupt Control Delay
Sets the interrupt control delay value.
Operating Parameters
Beacon State
Indicates whether beaconing is on or off.
Link Beacon State
Indicates whether link beaconing is on or off.
MPIO Mode State
Indicates whether multipathing mode is on or off.

53-1000881-01
71
6
Field
Description
Path Time Out
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.
Logging Level
The port logging level. Values include Log Critical, Log Error, Log
Warning, and Log Info.
FC-SP Parameters
Authentication
Indicates whether FC-SP authentication is on or off.
Status
The status of FC-SP authentication.
Algorithm
The configured authentication algorithm.
Group
The DH Group (DH Null, group 0 is the only option).
Error Status
The health status of the Fibre Channel Security Protocol parameters.
Using the property panel

Refer to the following topics for specific procedures using this dialog box.
72
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

53-1000881-01
Base port properties panel

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

53-1000881-01
73
Remote port properties panel

The Remote Port Properties panel enables you to display the properties that are associated with
the remote port.
1. From the device tree, select a remote port.
2. Click the Remote Port Properties tab in the right pane.
Field
Description
Fibre Channel Properties

Port WWN
The world wide name of the devices port.
Node WWN
The world wide name of the device.
Name
The name associated with the device.
FC Address
The Fibre Channel address of the device.
Frame Data Field Size
The frame size, in bytes, of the device.
State
Indicates whether the device is online or offline.
Supported Classes
The supported classes; for example, Class2.
Device Type
The type of the device; for example, Disk or Tape.
Symbolic Name
The symbolic name of the remote port.
Remote Device Information

Role
The role of the device (target or initiator)
Vendor Information
Vendor
The vendor of the device.
Product ID
The devices identifier.
Product Revision
The revision level of the device.
Binding Information
74
Bind Type
The persistent bind type.
Target ID
The identifier of the target device.

53-1000881-01
Logical port (LPort) properties panel

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

53-1000881-01
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.
Select a virtual port from the device tree.
The virtual port parameters property panel is displayed.
76
Field
Description
Port WWN
Node WWN
FC Address
The Fibre Channel address of the virtual port.
State
Indicates whether the virtual port is online or offline.
Roles
The role of the virtual port; for example, FCP Initiator.
Base Port
Indicates whether the virtual port is used as the base port.
Switch NWWN

53-1000881-01
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.
NOTE
2. Click the SFP tab in the right pane.
Field
Description
Port Technology
SFP Supported
The name of the supported SFP.
Connector Type
The type of port connector; for example, LC or SC.
Transceiver
The type of transceiver; for example, XFP or GBIC.
Media
The type of media for the transceiver; for example, single mode.
Speed
The port speed; for example, 1 Gbps, 2 Gbps, 4 Gbps, or 8 Gbps.
Extended Information
Extended ID
The identifier for the extended link.
Encoding
Displays how the extended link is encoded, for example, 8B10B.
Baud Rate
The transmission rate, roughly equivalent to the number of bits per

second.
Length 9u
The length of the single-mode fiber optic cable, used in situations

where gigabit performance is not required (for distances greater
than 100 meters).
Length 50u
The length of the fiber optic cable (for distances greater than 10
meters).
Length 62.5u
meters).
Length Cu
meter, where optimum performance is required).
Vendor Name
The vendor of the extended link.
Vendor OUI
The vendors organizational unique identifier (OUI).
Vendor Part
The part number of the extended link.
Revision
The revision level of the extended link.
Wavelength
The wavelength translation, which enables longer reach through

lower attenuation.

53-1000881-01
77
78
Field
Description
Options
Displays details about the transceiver; for example, the type of port
connector, type of transceiver, and enable/disable status.
BR Max
The upper bit rate limit at which the SFP transceiver meets its
specifications.
BR Min
The lower bit rate limit at which the SFP transceiver meets its
specifications.
Serial #
The serial number of the SFP.
Date Code
The date the SFP was manufactured.

53-1000881-01
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.
NOTE
2. Click the POM tab in the right pane.
Field
Description
Temperature(C)
The port temperature, measured in Celsius.
Bias Current (mA)
The low-level DC current (the Bias Current), measured in mA.
Tx Power (uvV)
The transmitted power, measured in uVV.
Rx Power (uvV)
The received power, measured in uVV.
Voltage
The voltage; for example, 1.8V, 3.3V, or 5.0V.

53-1000881-01
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.
Select Monitor > Statistics > Port Statistics from the Host Connectivity Manager.
Field
Description
Date
The current date and time at which the last reset was done.
WWN
The world wide name of the port.
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

TX Words
The number of total Transmitted Fibre Channel words across all

RX Words
The number of total Received Fibre Channel words across all

NOS Count
The number of NOS events that have occurred on a switched Fabric.
Error Frames
The number of frames that have been received in error.
Dropped Frames
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 Seq Protocol Err Count
The number of primitive sequence protocol errors.
Invalid TX Word Count
The number of invalid transmitted words.
Invalid CRC Count
The number of frames received with invalid cyclic redundancy

checks (CRCs).
Using the dialog box

80
Port statistics
Polling frequency rate
Resetting statistics
Performance monitoring

53-1000881-01
Device properties panel

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

53-1000881-01
81
Logical Unit Number (LUN) properties panel

The LUN properties panel enables you to display the properties of a selected LUN.
Select a LUN from the device tree.
The LUN parameters display in the right pane.
82
Field
Description
FCP LUN
The logical unit number of Fibre Channel Protocol (FCP) device.
Capacity
The capacity of the logical unit.
Block Size
The block size of the logical unit, in bytes (for example, 512 Bytes).
Vendor
The vendor of the device to which the logical unit is assigned.
Product ID
The product identifier of the device to which the logical unit is

assigned.
Product Revision
The revision level of the device to which the logical unit is assigned.
Product Serial #
The serial number of the device to which the logical unit is assigned.
Target WWN
The world wide name of the target device.

53-1000881-01
Fibre Channel security authentication dialog box

The Fibre Channel Security Protocol (FC SP) dialog box enables you to define security
authentication on selected ports.
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.
Field
Description
Port #
The port number (0 or 1) for which you are configuring security

authentication.
Port WWN
The world wide name of the port for which you are configuring
security authentication.
Port Name
The name of the port (for example, Port 0 or Port 1) for which you are
configuring security authentication.
Authentication
Check to enable port security authentication.
Status
Indicates whether authentication is used.
CHAP Secret
Type the CHAP secret.
Retype Secret
Retype the CHAP secret to confirm.
Algorithm
The configured algorithm. Options include md5, sha1, md5sha1,

shamd5.
Group
Indicates the DH group value. DHNULL (group 0) is the only option.

Refer to the following topic for specific procedures using this dialog box.
Configuring security authentication using the GUI on page 16

53-1000881-01
83
Change HCM password dialog box

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

Changing a password on page 9
84

53-1000881-01
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.
Select Configure > Names from the Host Connectivity Manager.
Field
Description
Display
Select a discovered host from the drop down list. Current Host is the
default.
Name
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.
Description
Displays a description of the device.
Remove
Select a device to highlight it, then click the Remove button to

remove the discovered device from the list.
Import
Click to import properties from a properties file for a selected device.
Export
Click to save properties to a properties file for a selected device.
Add button
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.
EFCM / FM format
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

53-1000881-01
85
Define Name dialog box

The Define Name dialog box enables you to assign a name to an existing world wide name.
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.
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
86
The type of device; for example, Node or Port.

53-1000881-01
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.
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.
Field
Description
Serial Number
The serial number of the HBA.
Port #
The port number of the HBA.
Port WWN
Name
The port name; for example, Port 0 or Port 1.
Target Name
The SCSI target name.
Remote Port WWN
The world wide name of the remote port.
SCSI Target ID
The SCSI target identifier.

Buffer credits on page 38

53-1000881-01
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.
2. Click Port Tests.
The Port Tests dialog box displays.
Field
Description
Ports
Select a port from the drop down list.
Memory Test
Check to run a Memory test on the port.
PCI Loopback Test
Check to run a PCI Loopback test on the port.
Data Pattern
Type a data pattern. The default value is A5A5A5A5.
Test Cycle
Specify the number of times the test runs. The default value is 100.
Loopback Test
Check to run a Loopback test on the port.
Subtest ID
Select a subtest from the dropdown list. The default is Internal.
Link Speed
Select a link speed from the drop down list.
Frame Count
Type a frame count. The default value is 8192.
Stop on Error
Check to flag the system to stop running the test if an error occurs.
Time
The test log displays the time the port test was run.
Test
The test log displays the type of test that was run.
Status
The test log displays the status of the test that was run.
Start button
Click to run the selected test.
Stop button
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

53-1000881-01
Protocol tests diagnostics dialog box

The Protocol Tests diagnostics dialog box enables you to run test on Fibre Channel components.
2. Click Protocol Tests.
The Protocol Tests dialog box displays.
Field
Description
Echo Test
Check to run an Echo Test on the selected port.
FC Ping Test
Check to run an FC Ping Test on the selected port.
FC Trace Route
Check to run an FC Trace Route on the selected port.
Add
Click to add a selected port, logical port, or target to the test list.
Remove
Click to remove a selected port, logical port, or target from the test
list.
Remove All
Click to remove all ports, logical ports, and targets from the test list.
Test Cycle
Specify the number of times the test runs. The default value is 100.
Test Log
The test log table displays the time the test was run, type of test run,
status of the test, configuration, and the results.
Stop on Error
Check to flag the system to stop running the test if an error occurs.
Start button
Click to run the selected test.
Stop button
Click to stop all pending tests.

53-1000881-01
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

53-1000881-01
Test Log Details dialog box

The Test Log Details dialog box enables you to view details about a selected port or protocol test.
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.
Field
Description
Time
The date and time the test was run.
Test
The name of the test.
Status
The status of the test, for example, executing or pending.
Configuration
The name of the test component and its corresponding value. For
example:
Adapter world wide name
Data pattern
Frame count
Port world wide name
Result
The test result, for example, test started or test complete.

53-1000881-01
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.
Field
Description
Filter button
Click to launch the Master Log Filter dialog box.
Clear Filter button
Click to clear the Master Log Filter parameters.
Refresh button
Click to refresh the Master Log.
Sr No column
Displays a numbering sequence in ascending order.
Severity column
The event severity (informational, minor, major, or critical).
WWN column
The world wide name of the device on which the event occurred.
Category column
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
The subcategory of the main event; for example, offline, online,

disabled, or enabled.
Description column
Displays a brief description of the event.
Date/Time column
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

53-1000881-01
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.
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.
Field
Description
Event Time
Type in a From and To value to represent the time during which

events will be logged.
Event Severity
Select one or all of the following values: Major, Minor, Critical, Info.
Category
Select an event category, for example, Rport or ITNIM, from the list.
WWN
Select a world wide name from the list.



53-1000881-01
93
Event Properties dialog box

The Event Properties dialog box displays the properties associated with a selected event from 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.
2. Double click an event.
The Event Properties dialog box displays.
Field
Description
Date/Time
The date when the event occurred.
Time
The time when the event occurred.
Severity
The event severity (informational, minor, major, or critical).
WWN
The world wide name of the device on which the event occurred.
Event ID
An identifier that corresponds to the event.
Category
The category of event; for example, Rport or ITNIM.
Description
A brief description of the event.
Root Cause
The root cause of the event.


94

53-1000881-01
Appendix
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>

53-1000881-01
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
Operands
Synopsis
Adapter commands
bcu> adapter
- -list
- -name
<ad_id> <adapter_name>
- -query
<ad_id>
- -enable
<ad_id>
- -disable
<ad_id>
- -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>
- -portlog
<port_id>
- -portlogclear
<port_id>
- -portlogctl
<port_id> <enable | disable>
- - stats
<port_id>
- - statsclr
<port_id>
Authentication commands
bcu> auth
Debug commands
bcu> debug
Fabric commands
bcu> fabric
FC diagnostic commands
Note: fcping and fctraceroute are not supported on Solaris platforms.
bcu> fcdiag
- -fcping
<port_id> <rpwwn> [-l lpwwn]
- -fctraceroute
- -fcecho
- -linkbeacon
<port_id> {on | off}
- -scsitest
FCP initiator mode commands

Note: fcpim - -mpiomode is not supported on Solaris platforms.
bcu> fcpim
96
- -mpiomode
<port_id> {on | off [tov]}
- -stats
<port_id> <rpwwn> [-l <lpwwn>]
- -statsclr
- -query

53-1000881-01
A
- -qdepth
<port_id> <q_depth_value>
Help commands
bcu> - -help
Command
Lists all available sub-commands
Operands
bcu> <sub_command> - -help
Synopsis
Lists all details about the specific sub_command.
IO Controller (IOC) commands

bcu> ioc
- -stats
<ioc_id>
- -query
<ioc_id>
- -statsclr
<ioc_id>
- -enable
<ioc_id>
- -disable
<ioc_id>
- -intr
<ioc_id> <- -coalesce | c> {on | off} <Latency> <Delay>
- -level
<port_id> [<critical | error | warning | info>] [-m <fw | ha1 |

fcs | drv | aen | all>]
Log commands
bcu> log
Logical port (lport) commands

bcu> lport
- -list
<port_id>
- -query
<port_id> [-l lpwwn]
- -stats
- -statsclr
- -sfpshow
<port_id>
- -tempshow
<ad_id>
- -beacon
<port_id> {on | off} [<duration>]
- -pciloopback
<port_id> [-p <pattern>] [-c <frame_count>]
- -loopback
<port_id> [-t <loopback_type>] [-s <speed>]

[-c <frame_count>] [-p <pattern>]
- -memtest
<ad_id>
Diagnostic commands
bcu> diag
Port commands (physical port)

bcu> port

53-1000881-01
- -list
- -name
<port_id> [port_name]
- -enable
<port_id>
- -disable
<port_id>
- -stats
<port_id>
- -statsclr
<port_id>
- -query
<port_id>
- -speed
<port_id> <1|2|4|8|auto>
97
Command
- -dfsize
<port_id> [dfsize]
Operands
Synopsis
Remote port (rport) commands

bcu> rport
- -list
- -query
<port_id> rpwwn [-l lpwwn]
- -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
<port_id>
- -disable
<port_id>
- -list
<port_id> [<pwwn>]
Virtual port (vport) commands

Note: vport commands are not supported on Solaris platforms.
bcu> vport
98
- -create
<port_id> vpwwn [-n <nwwn>] [-s <sname>]
- -delete
<port_id> vpwwn
- -query
<port_id> vpwwn
- -stats
<port_id> vpwwn
- -statsclr
<port_id> vpwwn

53-1000881-01
adapter
Displays and sets adapter configuration.
Synopsis
Description
Operands
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>
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
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.
- -list
Lists all adapters in the system. For each adapter in the system, a brief
summary line is displayed.
- -name
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
- -query
ad_id

53-1000881-01
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.
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:
See Also
100
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
port, IOC

53-1000881-01
auth
Displays the status and statistics for authentication settings.
Note: port_id could be any of the following:
Synopsis
Description
Operands
<adapter_id>
<port_id>
<port-pwwn>
<port-name>
<port-hwpath>
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>
Displays the authentication settings and the current authentication status.

The following operands are supported:
- -show
port_id
- -policy
Prints the attributes.

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.
port_id
Specify the ID of the port for which you want to set the authentication policy.
on|off
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.
- -algo
port_id
Set the authentication algorithm.

Specify the ID of the port for which you want to set the authentication
algorithm.
md5|sha1|ms|sm
Specify the hash algorithm:
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

53-1000881-01
sm defines the hash algorithm priority list of SHA-1, followed by MD5 for
Set the shared secret.
101
A
Note: You cannot clear the secret.
port_id
Specify the ID of the port for which you want to set the shared secret.
secret string
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.
- -stats
Displays the authentication statistics.
port_id
- -statsclr
Clears the authentication statistics.
port_id
Example
bcu> auth -show 1/0

port
Port Status
Auth
Hash Type
1/0
Linkdown
uninit
SHA1
Group Type
DH-NULL
bcu> auth -show 2/1

port
Auth
Hash Type
2/1
On
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
102
None.

53-1000881-01
debug
Gathers all the support information.
Synopsis
Description
Operands
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.
- -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
Example
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.
port_id
Specifies the ID of the port for which you want to enable or disable the
portlog.
enable
Enables the portlogclear command.
disable
Disables the portlogclear command.
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

53-1000881-01
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
104
None.

53-1000881-01
diag
Lists the non-destructive group of diagnostic commands.
Synopsis
Description
Operands
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.
- -sfpshow
port_id
- -beacon
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.
port_id
Specify the ID of the port for which you want to beacon.
on | off
Specify if beaconing is to be turned on or off.
duration
Specify the length of time between blinks. 0, meaning infinite beaconing, is

the default.
- -loopback
port_id
Runs the port loopback test.

Specify the ID of the port on which you want to run a loopback test.
-t loopback-type Specify the loopback type: int | serdes | ext.

duration
Specify the length of time between blinks.
-s speed
Specify the loopback speed: 8 | 4 | 2 | 1.
-c frame count
Specify the frame count.
-p pattern
Specify the pattern (must be one hex word).
- -memtest
ad_id
- -pciloopback
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.
port_id
Specify the ID of the port for which you want to send a health check message.
p pattern
Displays the data pattern.
-c frame count

53-1000881-01
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
106
fcdiag

53-1000881-01
fcdiag
Runs diagnostic tests on Fibre Channel components.
<adapter_id>
<port_id>
<port-pwwn>
<port-name>
<port-hwpath>
NOTE
bcu fcdiag - -fcping and bcu fcdiag - -fctraceroute are not available on Solaris platforms.
Synopsis
Operands
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]
The following operands are supported.

- -fcping
Determines the basic connectivity between two Fibre Channel network points
and monitors and measures network latency.
port_id
Specify the ID of the port you want to ping.
rpwwn
Specify the remote port world wide name you want to ping.
lpwwn
Specify the logical port world wide name. This is an optional argument.
- -fctraceroute
Reports on a SAN path, including node hops and latency data.
port_id
Specify the ID of the port on which you want to run the fctraceroute
command.
rpwwn
Specify the remote port world wide name.
lpwwn
- -fcecho
port_id
Specify the ID of the port for which you want to run the fcecho command.
rpwwn
lpwwn
- -linkbeacon
port_id
Blinks (toggles) the link beacon.

Specify the ID of the port for which you want to run a linkbeacon test.
mode {on|off} | t duration

Enable link beaconing by turning it on or off. If it is turned on, you can specify
duration.

53-1000881-01
107
A
- -scsitest
See Also
108
Tests the SCSI components.
port_id
Specify the ID of the port for which you want to run a linkbeacon test.
rpwwn
lpwwn
diag

53-1000881-01
fabric
Prints and resets fabric statistics.
Synopsis
bcu> fabric -stats <port_id>

bcu> fabric --statsclr <port_id>
Operands

- -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.

53-1000881-01
109
fcpim
Enables or disables FCP initiator mode.
NOTE
bcu fcpim - -mpiomode is not available on the Solaris operating system.

Synopsis
Description
Operands
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>
Enables or disables fast failover of the Fibre Channel Port (FCP) initiator mode I/O and displays or
clears statistics.
- -query
port_id
initiator mode.
rpwwn
lpwwn
- -stats
Displays statistics related to the Fibre Channel port.
port_id
rpwwn
lpwwn
- -statsclr
Displays statistics related to the Fibre Channel port.
port_id
rpwwn
lpwwn
- -mpiomode
port_id
initiator mode.
on|off tov
Specify whether MPIO mode is enabled or disabled.
- -qdepth
port_id
initiator mode.
q_depth_value Specify the queue depth value.
110

53-1000881-01
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:
See Also
4
3
1
0
4
2
0
1
3
0
0
0
0
0
0
0
0
0
456026
456026
IOC
vport

53-1000881-01
111
IOC
IO Controller (IOC) refers to the combination of port and the firmware controlling it.
Synopsis
Description
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>
Displays the IOC statistics and enables you to clear the statistics and enable or disable the IOC.
CAUTION:
Operands
Disabling the IOC is a destructive operation.

- -stats
ioc_id
- -statsclr
ioc_id
- -enable
ioc_id
- -disable
ioc_id
- -query
ioc_id
- -intr
Displays the port level statistics.

Clears the port level statistics.
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.
Sets the ports interrupt attributes.
Note: The operation fails if the input parameters are out of the supported
range.
112
ioc_id
Specify the ID of the port for which you want to set the ports interrupt
attributes.
coalesce|c
Displays the coalescing flag values. Supported values are on or off.
Latency
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.
Delay
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.

53-1000881-01
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:

53-1000881-01
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

53-1000881-01
A
See Also
adapter
lport

53-1000881-01
115
log
Sets the log level for each module. If no log level is specified, the current level is used.
Synopsis
Description
Operands
bcu> log -level <port_id> [<Critical|Error|Warning|Info>]

[-m <fw|ha1|fcs|drv|aen|all>]
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.
Critical | Error | Warning | Info

Specify the severity level.
fw | ha1 | fcs | drv | aen | all
Specify the mode.
See Also
116
None.

53-1000881-01
lport
Lists the logical port (lport) commands. A logical port is a port that is logged into a fabric.
Synopsis
Description
Operands
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.

- -list
Lists all the lport commands.
port_id
- -query
Lists the attributes of the logical port.
port_id
lpwwn
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.
- -stats
Displays the logical ports statistics.
port_id
Specify the ID of the port for which you want to display statistical information.
lpwwn
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.
- -statsclr
Example
port_id
lpwwn
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.
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
FC Addr
LPORT PWWN
LPORT NWWN
FC4 Roles
BP
062100
10:00:00:05:1e:53:0e:4a
20:00:00:05:1e:53:0e:4a
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

53-1000881-01
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
RSPN_ID
RSPN_ID
RSPN_ID
RSPN_ID
RSPN_ID
sent:
accepts:
rsp errors:
rejects:
alloc wait:
NS
NS
NS
NS
NS
RFT_ID
RFT_ID
RFT_ID
RFT_ID
RFT_ID
sent:
accepts:
rsp errors:
rejects:
alloc wait:
2
2
0
0
0
NS
NS
NS
NS
NS
NS
GID_FT
GID_FT
GID_FT
GID_FT
GID_FT
GID_FT
sent:
accepts:
rsp errors:
rejects:
unknown rsp:
alloc wait:
2
2
0
0
0
0
NS timeouts:
NS retries:
2
2
0
0
0
0
0
RSCN received :
0
port_id RSCN received : 0
# bcu> lport --statsclr 1/0
Successfully reset the lport level stats
See Also
118
None.

53-1000881-01
pbind
Lists, enables, and disables target persistent binding.
Synopsis
Description
Operands
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.
- -enable
port_id
- -disable
port_id
- -list
See Also
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.
port_id
Displays the ID of the port for which you want to display information.
pwwn
Displays the world wide name of the port for which you want to display
information.
None.

53-1000881-01
119
port
Lists the port commands (the physical ports on the HBA).
Synopsis
Operands
<adapter_id>
<port_id>
<port-pwwn>
<port-name>
<port-hwpath>
bcu>
bcu>
bcu>
bcu>
bcu>
bcu>
bcu>
bcu>
bcu>
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>
--query <port_id>
-speed <port_id> <1|2|4|8|auto>
--dfsize <port_id> [df_size]

- -list
Lists all the physical ports along with their basic attributes.
- -name
Query or set the port name. You can clear the port name using an empty
string ( ).
port_id
port_name
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.
- -enable
port_id
- -disable
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
120
Specify the ID of the port you want to disable.

Displays the physical port-level statistics.
Clears port-level statistics.
Queries and displays port-related information for a port.

53-1000881-01
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
Specify the ID of the port for which you want to set the port speed.
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.
Example
port_id
Specify the ID of the port for which you want to set the data field size.
df_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.
bcu> port --list
Port #
FC Addr
PWWN
Sfp
State
Spd
Type
1/0
1/1
2/0
2/1
3/0
010000
-- 010100
---
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
sw
-sw
-sw
Linkup
Linkdown
Linkup
Linkdown
Linkdown
4G
--8G
-----
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

53-1000881-01
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
bcu> port --dfsize 1/1 auto
See Also
122
adapter
IOC

53-1000881-01
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
Operands
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]

- -list
Lists all remote parts accessible for a given logical port.
port_id
Specify the ID of the port for which you want to display rport information.
lpwwn
Note: If the -l lpwwn argument is not specified, the base port is used.
- -osname
Displays the operating system.
port_id
Specify the ID of the port to the operating system.
lpwwn
Displays the logical port world wide name. This is an optional argument.
- -query
Displays detailed attributes of a remote port.
port_id
Specify the ID of the port for which you want to query attributes of a remote
port.
rpwwn
Specify the remote port world wide name for which you want to query
attributes.
lpwwn
Specify the logical port world wide name for which you want to query
attributes of a remote port. This is an optional argument.
- -stats
Displays remote port statistics.
port_id
rpwwn
Displays the remote ports port world wide name.
lpwwn
- -statsclr
Clears the remote port statistics.
port_id
Specify the ID of the port for which you want to clear remote port statistics.
rpwwn
Specify the remote ports port world wide name for which you want to clear
remote port statistics
lpwwn

53-1000881-01
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
124
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

53-1000881-01
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.

53-1000881-01
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.
- -destination_directory
Saves the collected supportsave information into an output file.
Example
126
# 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 =======

53-1000881-01
vport
Lists the commands that apply to a virtual port.
Note: vport commands are not supported on Solaris platforms.
Synopsis
Description
Operands
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.
- -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.
port_id
Specify the ID of the port for which you want to add a new vport.
vpwwn
Adds the virtual port by its world wide name. If no port wwn is specified, the
information provided is for the base vport.
n nwwn
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.
s sname
Adds the symbolic name for the virtual port. This is an optional argument.
- -delete
Deletes the specified vport. This deletes all associated objects, such as any
associated login sessions and active I/O requests.
port_id
Specify the ID of the port for which you want to delete a vport.
vpwwn
Deletes the virtual port by its world wide name. If no port wwn is specified,
the information provided is for the base vport.
- -query
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.
port_id
Specify the ID of the port for which you want to query vport information.
vpwwn
Queries the virtual port by its world wide name. If no port wwn is specified,
the information provided is for the base vport.
- -stats
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.
port_id
vpwwn
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.

53-1000881-01
127
A
- -statsclr
Example
See Also
128
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.
port_id
vpwwn
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:
0
0
0
0
0
0
No NPIV support:
Fabric offlines:
Fabric onlines:
Fabric cleanups:
0
6
6
0
fcpim
IOC

53-1000881-01
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)
Mnemonic
Description
Attributes in request CT_IU
0200
RHBA
Register HBA
HBA Identifier, Registered Port

List, HBA Attribute Block
0210
RPRT
Register Port
HBA Identifier, Port_Name, Port

Attribute Block
0211
RPA
Register Port Attributes
Port_Name, Port Attribute Block

53-1000881-01
129
130

53-1000881-01
Appendix
Standards Compliance
Standards Compliance Publications

Ref #
Publication Number
Description
Revision
INCITS 352
Fibre Channel Physical Interfaces (FC-PI)
Rev 13
NCITS TR-25:1999
Fibre Channel Methodologies for Jitter Specification

(FC-MJS)
Rev 10
ANSI X3.230:1994
Fibre Channel Physical and Signaling Interfaces (FC-PH)
Rev 4.3
ANSI X3.297:1997
Fibre Channel Physical and Signaling Interface - 2

(FC-PH-2)
Rev 7.4
ANSI X3.303:1998
Fibre Channel Physical and Signaling Interface - 3

(FC-PH-3)
Rev 9.4
ANSI/INCITS 373:2003
Fibre Channel Framing and Signaling Interface (FC-FS)
Rev 1.9
INCITS TR-30-2002
Fibre Channel - Methodologies for Interconnects (FC-MI)
Rev 1.92
ANSI X3.272:1996
Fibre Channel Arbitrated Loop (FC-AL)
Rev 4.5
NCITS 332: 1999
Fibre Channel Arbitrated Loop (FC-AL-2)
Rev 7.0
10
ANSI INCITS 350-2003
Fibre Channel Protocol for SCSI, Second Version (FCP-2)
Rev 8.0
11
ANSI INCITS 366-2003
SCSI Architecture Model - 2
Rev 24
12
NCITS TR-19:1998
Private loop SCSI direct attach (FC-PLDA). Technical

Report
Rev 2.1
13
NCITS TR-20:1998
Fabric Loop Attachment (FC-FLA) Technical report.
Rev 2.7
14
RFC-4338 (this obsoletes

RFC-2625)
Internet Protocol and ARP over Fibre Channel, June 1999

(IP over FC profile)
January 206
15
PCI-SIG Document
PCI Local Bus Specification Rev 2.3, March 29, 2002
N/A
16
PCI-SIG Document
PCI Local Bus Hot-Plug Specification, Rev 1.0, october 6,

1997. Adapter Card Requirements section only.
N/A
17
PCI-SIG Document
PCI-X Addendum to the PCI Local Bus Specification. Rev

1.0a. July 24, 2000
N/A
18
PCI-SIG Document
PCI-Express Card Electromechanical Specification, Rev

1.0a. April 15, 2003
Rev 1.1
Dated
3/28/2005
19
PCI-SIG Document
PCI-Express Base Specification, Rev 1.0a, April 15, 2003
Rev 1.1
Dated
3/28/2005
20
PCI-SIG Document
PCI-Express - Root Complex Discovery Topology, August 12,

2003
ECN to Rev
1.0a dated
8/12/2003

53-1000881-01
131
132
21
PCI-SIG Document
PCI-Express Reset Limit Adjustment, July 14, 2003
ECN dated
7/14/2003
22
PCI-SIG Document
Errata for PCI-Express Base Specification, Rev 1.0a,

October 7, 2003
Rev1.0a
dated
10/7/2003

53-1000881-01
Appendix
Glossary
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.

53-1000881-01
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

53-1000881-01
Index
A
adapter command, 99
advanced port configuration options, 31
application log, 55
auth command, 101
Authentication Configuration dialog box, 83
authentication, security, 19
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

53-1000881-01
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
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
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
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
host management, remote, 1
host security authentication, 15
log
application, 55
master log, 53
test, 62
log command, 30, 116
log off, 14
logging level
login, how to skip, 8
lport command, 117
LUN properties panel, 82
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
N
name configuration, 34
nickname association tasks, 34
NPIV configuration, 34
interrupt control coalesce, 32

IOC command, 112
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

53-1000881-01
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
pbind command, 119
persistent binding
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
Port POM panel, 79
port properties panel, 71
Port SFP panel, 77
port speed
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

53-1000881-01
properties
importing in EFCM format, 37
importing in FM format, 37
Protocol Tests diagnostics dialog box, 89
Q
queue depth
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
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
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

53-1000881-01

HCMAdmin

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

HCMAdmin

Uploaded by

Copyright:

Available Formats

53-1000881-01

Brocade Fibre Channel HBA

Copyright 2008 Brocade Communications Systems, Inc. All Rights Reserved.

Brocade Communications Systems, Incorporated

European and Latin American Headquarters

Brocade Fibre Channel HBA

About This Document

Getting Started with HCM Software

Brocade Fibre Channel HBA Administrators Guide

HCM software launch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Brocade Fibre Channel HBA Administrators Guide

HCM Dialog Boxes

Brocade Fibre Channel HBA Administrators Guide

Logical port (LPort) properties panel . . . . . . . . . . . . . . . . . . . . . . . . . 75

Brocade Command Line Utility (BCU)

Brocade Fibre Channel HBA Administrators Guide

Brocade Fibre Channel HBA Administrators Guide

Brocade Fibre Channel HBA Administrators Guide

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

Brocade Fibre Channel HBA Administrators Guide

Brocade Fibre Channel HBA Administrators Guide

Driver operating system support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

HCM operating system support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 collection sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Brocade Fibre Channel HBA Administrators Guide

Brocade Fibre Channel HBA Administrators Guide

About This Document

How this document is organized

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

Chapter 4, Monitoring, describe the HCM monitoring features.

Brocade Fibre Channel HBA Administrators Guide

Appendix D, Standards Compliance, provides reference information for standards

Identifies command names

Identifies CLI output

Notes, cautions, and warnings