Brocade Communications Systems BR-1010 Administrator's Manual
Brocade Communications Systems BR-1010 Administrator's Manual

Brocade Communications Systems BR-1010 Administrator's Manual

Supporting cna and supporting hba models
Table of Contents

Advertisement

53-1001256-01
53-1001256-01
®
12 June 2009
Brocade Adapters
Administrator's Guide
Supporting CNA models BR-1010 and BR-1020
Supporting HBA models 415, 425, 815, 825

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BR-1010 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Brocade Communications Systems BR-1010

  • Page 1 53-1001256-01 53-1001256-01 ® 12 June 2009 Brocade Adapters Administrator’s Guide Supporting CNA models BR-1010 and BR-1020 Supporting HBA models 415, 425, 815, 825...
  • Page 2 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.
  • Page 3: Table Of Contents

    Contents About This Document In this section ......... . . xiii How this document is organized .
  • Page 4 Supported features ........9 OS-specific features .
  • Page 5 HCM Logging levels ........37 Configuring the HCM logging level using the GUI .
  • Page 6 Beaconing ..........69 Configuring beaconing using the GUI .
  • Page 7 LPORT Properties panel (HBA and CNA) .....115 Master Log tab (HBA and CNA) ......116 Master Log Filter dialog box (HBA and CNA) .
  • Page 8 ethlog ..........171 ethport .
  • Page 9 Figures Figure 1 HCM Login dialog box ..........11 Figure 2 Change HCM Password dialog box .
  • Page 10 Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 11 Tables Table 1 HCM tree pop-up menus ..........7 Table 2 Ethernet Link Layer Driver operating system support .
  • Page 12 Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 13: About This Document

    About This Document In this section • How this document is organized ........xiii •...
  • Page 14: Document Conventions

    • Appendix C, “HCM Troubleshooting,” provides a summary of HCM navigation problems and workarounds. Document conventions This section describes text formatting conventions and important notice formats used in this document. 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...
  • Page 15: Key Terms

    Key terms For definitions specific to Brocade and Fibre Channel, see the Brocade Glossary. For definitions specific to this document, see “Glossary and acronyms” on page 201. For definitions of SAN-specific terms, visit the Storage Networking Industry Association online dictionary http://www.snia.org/education/dictionary Notice to the reader This document may contain references to the trademarks of the following corporations.
  • Page 16: Other Industry Resources

    Document Title 53-1000884-01 Brocade Fibre Channel Adapter Installation and Reference Manual supporting CNA models BR-1010 and BR-1020 and HBA models 415, 425, 815, and 825 53-1000885-01 Brocade Fibre Channel Adapter Troubleshooting Guide supporting CNA models BR-1010 and BR-1020 and HBA models 415, 425, 815, and 825 53-1000598-03 Fabric OS Administrator’s Guide supporting Fabric OS v6.1.0...
  • Page 17: Document Feedback

    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.
  • Page 18 xviii Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 19: Chapter 1 Fibre Channel Over Ethernet

    Chapter Fibre Channel over Ethernet In this chapter • FCoE overview ..........1 •...
  • Page 20: Drivers

    Enhanced Ethernet features Drivers Three types of adapter drivers are provided in installation packages: • Storage driver - This is a unified driver that provides Fibre Channel frame transport for Brocade HBAs and FCoE transport for Brocade CNAs. The adapter logic detects either a FCoE or Fibre Channel network and the appropriate driver support is provided automatically.
  • Page 21: Priority-Based Flow Control

    Enhanced Ethernet features Priority-based flow control Priority flow control pauses traffic based on the priority levels. A high-level pause algorithm follows: • During periods of heavy congestion, the receive buffers reach high threshold and generate a pause. • The pause tells transmission (Tx) queues to stop transmitting. •...
  • Page 22: Fcoe Protocols Supported

    FCoE protocols supported FCoE protocols supported The Brocade FCoE converged network adapter supports two layers of protocols: Ethernet link layer and FCoE layer. They are listed in the following sections. Ethernet link layer protocols supported The following protocols support the Ethernet link layer. •...
  • Page 23: In This Chapter

    Chapter HCM Overview In this chapter • HCM software ..........5 •...
  • Page 24: Hcm Features

    HCM features HCM features Common HBA and CNA management software features include the following: • Discovery using the agent software running on the servers attached to the SAN, which 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: •...
  • Page 25: Table 1 Hcm Tree Pop-Up Menus

    Tree node pop-up menus TABLE 1 HCM tree pop-up menus SAN component Pop-up menu feature Host Refresh All Start Polling Upload Boot Code Image Change Agent Password Configure Names Basic Port Configuration Persistent Binding Statistics > Port Statistics FC-SP Support Save Tree >...
  • Page 26: Operating System Support

    Operating system support Operating system support There are slight differences in the operating systems (OSs) that are supported on the driver, on the Host Connectivity Manager (HCM), and the Brocade Command Line Utility (BCU), and the HCM agent. Ethernet Link Layer Driver OS support Table 2 lists the operating systems supported on the driver.
  • Page 27: Fcoe Driver Os Support

    Supported features FCoE Driver OS support Table 3 lists the operating systems supported on the FCoE driver. TABLE 3 FCoE driver operating system support Operating System IA64 IEM64T AMD64 SPARC Windows Server 2003, R2, SP2 Requires SP2 plus Hotfix 932755 and KB943545 Windows Server 2008 Linux SuSE Enterprise Server (SLES)
  • Page 28: Os-Specific Features

    OS-specific features OS-specific features Some features are available only in specific OS environments. The features are shown in Table TABLE 5 OS-specific features Features Windows Linux Solaris VMWare Storage - NPIV support Ethernet - VLAN support Ethernet - Receive Side Scaling (RSS) Ethernet - Header Data Split (HDS) Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 29: Getting Started With Hcm Software

    Chapter Getting Started with HCM Software In this chapter • HCM software launch ......... . . 11 •...
  • Page 30: Launching The Application On Linux Platforms

    HCM software launch Launching the application on Linux platforms After installing the HCM software, locate Brocade HCM on the Linux platform. • If using a GNOME shell, double-click the BROCADE_FCHBA icon to launch the application. • If using a KDE shell, single-click the BROCADE_FCHBA icon to launch the application. Start the application from the command prompt using the following commands: suse116208:~ # cd /opt/brocade/fchba/client suse116208:<installed directory>/fchba/client # ./BROCADE_FCHBA...
  • Page 31: Changing An Hcm Application Password

    HCM software launch Changing an HCM application 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 your user identity by supplying your old password before you can change to a new password.
  • Page 32: Changing An Hcm Agent Password

    HCM software launch Changing an HCM agent password You can change the default password of the agent to a different password using the Change HCM Agent Password dialog. Note the following when you change a password: • You must validate your user identity by supplying your old password before you can change to a new password.
  • Page 33: Resetting A Password Or Restoring A Factory Default Password

    HCM software launch 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).
  • Page 34: Hcm Main Window

    Refer to the Brocade Fibre Channel CNA Installation and Reference Manual supporting CNA models BR-1010 and BR-1020 and HBA models 415, 425, 815, and 825 for instructions on how to install both the driver and GUI, the driver only, or the GUI only.
  • Page 35: Hcm Product Icons

    HCM product icons HCM product icons On the left side of the Host Connectivity Manager, there is a navigation tree for representing the managed host with adapters 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.
  • Page 36: Discovery

    Discovery Discovery Discovery enables you to contact the adapters 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.
  • Page 37: Logging Off Hcm

    Logging off HCM 2. From the Host Name list, select the host name from where you will discover the adapter. 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.
  • Page 38 Logging off HCM Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 39: Host Configuration

    Chapter Host Configuration In this chapter • Host security authentication........21 •...
  • Page 40: Configuring Security Authentication Using The Gui (Host And Hba)22

    Host security authentication Configuring security authentication using the GUI (Host and HBA) You can access the Fibre Channel Security Protocol Configuration dialog box by selecting the Host, an HBA, or an HBA port from the device tree. NOTE FC-SP is not available for Solaris platforms. 1.
  • Page 41: Configuring Security Authentication Using The Bcu

    Host security authentication 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.
  • Page 42: Buffer Credits

    Buffer credits 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.
  • Page 43: Opening The Basic Port Configuration Dialog Box

    Basic port configuration Opening the Basic Port Configuration dialog box There are slight changes in HCM’s basic port configuration dialog, depending on the operating system. You can access the Basic Port Configuration dialog box by selecting the Host, an HBA, an HBA port, a CNA, or an FCoE port from the device tree.
  • Page 44: Port Logging Level

    Basic port configuration Port logging level The number of messages logged by the host depends on the predetermined logging level. Although the adapter might generate many messages, only certain types of messages are logged based on the specified logging level. Configuring the port logging level using the GUI 1.
  • Page 45: Port Speed

    Basic port configuration Port speed Port speed 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). NOTE For the 10 Gbps CNA, the only option is auto-negotiate. Configuring the port speed using the GUI 1.
  • Page 46: Frame Data Field Size

    Basic port configuration Frame data field size Buffer credits determine the maximum amount of frame data. If the number of buffer credits is not large enough to handle the link distance and speed, performance can be severely limited. “Buffer credits” on page 24 for information about buffer credits.
  • Page 47: Qos (Hba Only)

    Basic port configuration Enabling and disabling persistent binding using the BCU 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.
  • Page 48: Mpio (Hba Only)

    Basic port configuration NOTE You must first enter the command, followed by the bcu port -disable <port_id> command, before the bcu port -enable <port_id> bcu qos -enable bcu qos -disable commands take effect. Enter the following commands to enable or disable QoS support on the HBA side. bcu qos - -enable <port_id>...
  • Page 49: Path Time Out

    Basic port configuration Path Time Out You can enable or edit the Path Time Out field only when MPIO is disabled. Specifying Path Time Out using the GUI 1. Select Configure > Basic Port Configuration from the Host Connectivity Manager. The Basic Port Configuration dialog box displays.
  • Page 50: Boot Over San (Hba Only)

    Boot over SAN (HBA only) Enabling and disabling rate limiting on the adapter side using the BCU Enter the following command to enable or disable rate limiting on the adapter side. NOTE You must first enter the command, followed by the bcu port --disable <port_id>...
  • Page 51: Configuring Boot Over San

    Boot over SAN (HBA only) Configuring Boot over SAN The boot-LUN table lists the vendor information, LUN capacity, and whether the LUNs are accessible. These fields are not editable. You can access the Boot over SAN dialog box by selecting the Host, an HBA, or an HBA port from the device tree.
  • Page 52: Boot Code Image Upload (Hba Only)

    Boot over SAN (HBA only) 8. Select the Boot Device Port WWN row in the table, then click the up and down arrows to move the row up or down in the table. The host will attempt to boot from the first LUN in the table, and then move on to succeeding LUNs.
  • Page 53: Virtual Port Configuration

    Virtual Port configuration FIGURE 9 Boot Code Image Upload dialog box 4. Click the Browse button and navigate to the location of the boot code image. 5. Select the boot code image and click Open. The selected file uploads. If an error occurs during the uploading process, an error message displays.
  • Page 54: Deleting A Virtual Port

    Virtual Port configuration NOTE By default, the Use auto-generated check box is selected and the Generate Again button is enabled. You can still edit the Virtual Port WWN field if Use auto-generated is selected. FIGURE 10 Virtual Port Creation dialog box 3.
  • Page 55: Hcm Logging Levels

    HCM Logging levels 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.
  • Page 56: Advanced Port Configuration

    Advanced port configuration Advanced port configuration You can access the Advanced Port Configuration dialog box by selecting an HBA port or an FCoE port from the device tree. For each port, you can configure the following parameters using the Advanced Port Configuration dialog box, the Brocade Command Line utility (BCU), or both.
  • Page 57: Queue Depth Configuration

    Advanced port configuration 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.
  • Page 58: Npiv

    NPIV Configuring the Interrupt Control Coalesce using the GUI (HBA only) 1. Select a port from the device tree. • From the Host Connectivity Manager, select Configure > Advanced Port Configuration. The Advanced Port Configuration dialog box displays. • Right-click a port and select Port Configuration > Advanced. 2.
  • Page 59: Name Configuration

    Name configuration Name configuration The Host Connectivity Manager allows you to configure names as a method of providing familiar, simple names to world wide names for adapters, ports, virtual ports, and remote ports in the SAN. (A logical port can be a base port or a virtual port.) Only unique names are allowed. You can access the Configure Names dialog box by selecting an HBA, an HBA port, a Virtual Port, a CNA or a CEE port from the device tree.
  • Page 60: Editing The Name Fields

    Name configuration Editing the name fields Only the name, the world wide name (WWN), and the description fields are editable. Depending on the component, the following occurs when you edit the name fields: • Name changes on the adapter and ports are sent to the agent and stored in the *.properties file.
  • Page 61: Adding Name Entries

    Name configuration Adding name entries You can add up to 2000 names which are then stored in the HbaAliasdb.properties file. The entries persist during reboot. The WWN types are as follows: • Node • Port • Remote Port • V_Port •...
  • Page 62: Exporting The Properties For A Wwn

    Name configuration 4. 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 of the discovered WWN and the entire row of the detached (undiscovered) WWN. 5.
  • Page 63: Importing The Properties For A Wwn

    Name configuration Importing the properties for a WWN 1. Select Configure > Names from the Host Connectivity Manager. Right-click a device from the device tree and select Configure Names. The Configure Names dialog box displays. 2. Select one of the following from the Display list: •...
  • Page 64: Dcfm Support For Fcoe

    Name configuration Importing properties in DCFM or FM format You can use this procedure to import properties in DCFM or Fabric Manager (FM) format. 1. In the Configure Names dialog box, select DCFM/FM Format and then select Import. 2. Navigate to the location of the *.properties file from which you will import properties for the selected device.
  • Page 65: Importing Duplicated Names

    Name configuration Importing duplicated names The Duplicated Names dialog box displays when you import a file with a duplicate name. 1. Select Configure > Names from the Host Connectivity Manager. Right-click a device from the device tree and select Configure Names. If there are duplicate names, the Duplicated Names dialog box displays.
  • Page 66: Vlan Configuration

    VLAN configuration VLAN configuration A Virtual LAN (VLAN) is a collection of network nodes that share the same broadcast domain regardless of their physical location or connection point to the network. A VLAN serves as a logical workgroup with no other physical barriers and allows users to share information and resources as though located on the same LAN.
  • Page 67: Figure 15 Vlan Configuration Dialog Box

    VLAN configuration The VLAN Configuration dialog displays. FIGURE 15 VLAN Configuration dialog box 3. Click the Add button that corresponds to the VLANs table. 4. Click Add on the VLAN Configuration dialog (Figure 15). The Add VLAN dialog displays. Figure 16 shows a VLAN configuration before a passthru VLAN is configured.
  • Page 68: Vlan Configuration Conflicts

    VLAN configuration VLAN configuration conflicts Figure 17 shows the VLAN Configuration dialog box if a PORT VLAN exists in the configuration. When a PORT VLAN exists, the VLAN Add, Edit, and Remove buttons are disabled. FIGURE 17 VLAN Configuration dialog box with PORT VLAN A port VLAN cannot co-exist with a regular or Passthru VLAN.
  • Page 69: Removing A Vlan

    VLAN configuration 3. Click Edit on the VLAN Configuration dialog (Figure 15). The Edit VLAN dialog displays. FIGURE 19 Edit VLAN dialog box 4. Type a new name in the VLAN Name text box. 5. Click OK. Removing a VLAN You can access the VLAN Configuration dialog box by selecting an Ethernet port from the device tree.
  • Page 70 VLAN configuration Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 71: Monitoring

    Chapter Monitoring In this chapter • Performance monitoring ......... 53 •...
  • Page 72: Polling Frequency Rate

    Performance monitoring 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 system’s 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.
  • Page 73: Master Log

    Master Log Master Log The Master Log Properties dialog box, described in Table 10, displays a list of all events that have occurred. Event monitoring enables early fault detection and isolation on a selected adapter. You can filter the events based on the user-defined criteria shown in Figure TABLE 10 Master Log fields...
  • Page 74: Filtering Event Log Entries

    Master Log 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.
  • Page 75: Application Log

    Application log 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 23 HCM Application Log Brocade Adapters Administrator’s Guide...
  • Page 76: Syslog Support

    Syslog support Syslog support Syslog forwarding is the process by which you can configure the Host Connectivity Manager (HCM) agent to send Syslog messages to other computers through port 514. You can configure the HCM agent to forward events to a maximum of three Syslog destinations. These events will display in the operating system logs.
  • Page 77: Removing A Host Server

    Syslog support Removing a host server 1. Select Configure > Syslog from the main menu. The Syslog Server Configuration dialog box displays. 2. Enter the host name of the destination device into the Hostname field. 3. Enter the IP address of the destination device into the IP Address field. 4.
  • Page 78 Syslog support Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 79: Diagnostics

    Related diagnostic documentation Part Number Document Title 53-1001254-01 Brocade Adapters Installation and Reference Manual Supporting CNA models BR-1010 and BR-1020 Supporting HBA models 415, 425, 815, 825 53-1001253-01 Brocade Adapters Troubleshooting Guide Supporting CNA models BR-1010 and BR-1020 Supporting HBA models 415, 425, 815, 825 53-1001336-01 Fabric OS Administrator’s Guide supporting Fabric OS v6.3.0...
  • Page 80: Fibre Channel Diagnostics Using The Bcu

    Fibre Channel diagnostics using the BCU Fibre Channel diagnostics using the BCU The purpose of diagnostic commands is to evaluate the integrity of the system hardware. Be sure to disable the port before running any type of port diagnostics. In addition, it is advisable that you do not perform other operations on the adapter while running HCM or BCU diagnostics.
  • Page 81: Fibre Channel Diagnostics Using The Gui

    Fibre Channel diagnostics using the GUI Fibre Channel diagnostics using the GUI The purpose of diagnostic commands is to evaluate the integrity of the system hardware. Be sure to disable the port(s) before running any type of port diagnostics. In addition, it is advisable that you do not perform other operations on the adapter while running HCM or BCU diagnostics.
  • Page 82: Hardware-Level Test Parameters

    Fibre Channel diagnostics using the GUI 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 NOTE Click the Stop on Error check box if you want the test to stop running if an error occurs. 5.
  • Page 83: Running A Fibre Channel Protocol-Level Test Using The Gui

    Fibre Channel diagnostics using the GUI Running a Fibre Channel protocol-level test using the GUI There are three protocol-level tests: • Echo test, which sends an FC Echo ELS to a remote port. • FC ping test, which requests the management server to test the connectivity with a given remote port (without zoning restrictions).
  • Page 84: Displaying Test Log Details

    Displaying test log details 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 how many times the test runs by specifying the test cycle number. The default test cycle number is 1.
  • Page 85: Figure 27 Test Log Details For Echo Test Dialog Box

    Displaying test log details FIGURE 27 Test Log Details for Echo Test dialog box FIGURE 28 Test Log Details for FC trace test dialog box Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 86: Ethernet Diagnostics

    Ethernet diagnostics Ethernet diagnostics The Ethernet loopback test generates and sends out the desired number of packets and expects to receive the same number of packets through the loopback interface (Serdes or external). Each time a packet is sent it is selected from a different starting point of the data buffer so that any two consecutively transmitted packets will not be the same.
  • Page 87: Beaconing

    Beaconing The Ethernet Test options are described in Table TABLE 17 Ethernet Test parameters • Ethernet loopback test Subtest ID External • Serdes Link Speed 10 Gbps NOTE: For an External Loopback test, you must plug in the loopback connector. Frame Count Integer from 1-131072 (128K).
  • Page 88: Sfp Management

    SFP Management 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 Enter the following command to view the SFP information. If the firmware detects a non-Brocade SFP, the port is disabled.
  • Page 89: Debugging

    Debugging TABLE 18 SFP management information SFP category SFP information displayed • Port technology SFP supported • Connector type • Transceiver • Media • Speed (in MBps) • Extended information Extended ID • Encoding • Baud rate • Length (9u, 50u, 62.5u, Cu) •...
  • Page 90: Supportsave

    supportSave 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 TABLE 19 supportSave categories...
  • Page 91 supportSave Automatic statistics collection The port statistics log file is collected as part of the supportSave activity. Port statistics collection occurs every eight hours and will be logged in to a rolling file under the /log/ directory. There are a maximum of five backup files and each file has a 100 KB size limit. A new backup file overwrites the oldest file.
  • Page 92 supportSave 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).
  • Page 93: Hcm Dialog Boxes

    Appendix HCM Dialog Boxes In this section • Authentication Statistics dialog box (HBA and CNA) ....77 • Backup dialog box (HBA and CNA) ....... . . 79 •...
  • Page 94 In this section • Port Statistics dialog box (HBA and CNA)......123 • Protocol Tests dialog box (HBA and CNA)......125 •...
  • Page 95: Authentication Statistics Dialog Box (Hba And Cna)

    Authentication Statistics dialog box (HBA and CNA) Authentication Statistics dialog box (HBA and CNA) The Authentication Statistics dialog box enables you to display statistical information related to transmitted and received DH-CHAP attempts for a selected port. Opening the dialog box 1.
  • Page 96 Authentication Statistics dialog box (HBA and CNA) Using the dialog box Refer to the following topics for specific procedures using this dialog box: • “Configuring security authentication using the GUI (Host and HBA)” • “Port Statistics dialog box (HBA and CNA)” •...
  • Page 97: Backup Dialog Box (Hba And Cna)

    Backup dialog box (HBA and CNA) Backup dialog box (HBA and CNA) The Backup dialog box allows you to create a backup of data and configuration files. Opening the dialog box Select any device from the device tree and select Tool > Backup Data from the Host Connectivity Manager.
  • Page 98: Base Port Properties Panel (Hba And Cna)

    Base Port Properties panel (HBA and CNA) Base Port Properties panel (HBA and CNA) The Base Port Properties panel enables you to display the properties that are associated with the base port. Opening the properties panel 1. From the device tree, select a base port. 2.
  • Page 99: Cee Properties Panel (Cna Only)

    CEE properties panel (CNA only) CEE properties panel (CNA only) The CEE properties panel enables you to display the properties that are associated with a selected converged network adapter (CNA). Operational CEE Configuration is displayed when the CEE Status is Active. The Remote CEE Configuration table is visible only when the CEE status is inactive and error reason is not one of the following.
  • Page 100: Cee Port Properties Panel (Cna Only)

    CEE Port Properties panel (CNA only) CEE Port Properties panel (CNA only) The Port Properties panel enables you to display the properties that are associated with a selected CEE port. Opening the properties panel 1. Select a CEE port in the device tree. 2.
  • Page 101: Cee Statistics Dialog Box (Cna Only)

    CEE Statistics dialog box (CNA only) CEE Statistics dialog box (CNA only) The CEE Statistics dialog box enables you to display the statistics that are associated with the link layer port. Opening the CEE Statistics dialog box 1. From the device tree, select a physical port of a CNA. 2.
  • Page 102 CEE Statistics dialog box (CNA only) Field Description DCBX Receive Sequence Numbers The number of DCBX receive sequence numbers on the physical port of the CNA. DCBX Receive Acknowledgements The number of receive acknowledgements for DCBX. CEE HW Config Changed The number of times the physical port of the CNA changed.
  • Page 103: Change Hcm Password Dialog Box (Hba And Cna)

    Change HCM Password dialog box (HBA and CNA) Change HCM Password dialog box (HBA and CNA) The Change HCM Password dialog box enables you to change an existing password for the application. Opening the dialog box Select Configure > Change HCM Password from the Host Connectivity Manager. Fields and components Field Description...
  • Page 104: Change Hcm Agent Dialog Box (Hba And Cna)

    Change HCM Agent dialog box (HBA and CNA) Change HCM Agent dialog box (HBA and CNA) The Change HCM Agent Password dialog box enables you to change an existing password for the host. Opening the dialog box Select Configure > Change Password > Change Agent Password from the Host Connectivity Manager.
  • Page 105: Cna Properties Panel (Cna Only)

    CNA Properties panel (CNA only) CNA Properties panel (CNA only) The CNA Properties panel enables you to display the properties that are associated with a selected Converged network adapter (CNA). Opening the properties panel 1. Select a CNA in the device tree. 2.
  • Page 106 CNA Properties panel (CNA only) Field Description Vendor ID The identifier of the PCI Register’s 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.
  • Page 107: Configure Names Dialog Box (Hba And Cna)

    Configure Names dialog box (HBA and CNA) Configure Names dialog box (HBA and CNA) The Configure Names dialog box enables you to add a world wide name and an associated name for an adapter, port, or storage device that is not yet discovered. You can also remove a device from the Name display list and import from or export properties to a file.
  • Page 108: Define Name Dialog Box (Hba And Cna)

    Define Name dialog box (HBA and CNA) Define Name dialog box (HBA and CNA) The Define Name dialog box enables you to assign a name to an existing world wide name. Opening the dialog box 1. Right-click on an HBA, a CNA or a port in the device tree. NOTE You can not define a name on an FCoE port or an Ethernet port.
  • Page 109: Duplicated Names Dialog Box (Hba And Cna)

    Duplicated Names dialog box (HBA and CNA) Duplicated Names dialog box (HBA and CNA) The Duplicated Names dialog box enables you to display configured names that are redundant. Opening the dialog box 1. Select Configure > Names from the Host Connectivity Manager. 2.
  • Page 110: Eth Ioc Statistics Dialog Box (Cna Only)

    Eth IOC Statistics dialog box (CNA only) Eth IOC Statistics dialog box (CNA only) The Eth IOC Statistics dialog box enables you to display statistical information related to the Ethernet IOC. Opening the dialog box 1. Select an Ethernet port from the device tree. 2.
  • Page 111: Ethernet Port Properties Panel (Cna Only)

    Ethernet Port Properties panel (CNA only) Ethernet Port Properties panel (CNA only) The Ethernet Port Properties panel enables you to display the properties that are associated with a selected Ethernet port. Opening the properties panel 1. Select an Ethernet port in the device tree. 2.
  • Page 112: Eth Statistics Dialog Box (Cna Only)

    Eth Statistics dialog box (CNA only) Eth Statistics dialog box (CNA only) The Eth Statistics dialog box enables you to display statistical information related to the Ethernet port. Opening the dialog box 1. Select an Ethernet port from the device tree. 2.
  • Page 113 Eth Statistics dialog box (CNA only) Field Description Rxf0 Multicast Vlan Total number of received multicast VLANs. Rxf0 Broadcast Octets Total number of received broadcast octets Rxf0 Broadcast Total number of received broadcast frames. Rrxf0 Broadcast Vlan Total number of received broadcast VLANs. Rxf0 frame drops Total number of received frame drops.
  • Page 114: Event Properties Dialog Box (Hba And Cna)

    Event Properties dialog box (HBA and CNA) Event Properties dialog box (HBA and CNA) The Event Properties dialog box displays the properties associated with a selected event from the Master Log. Opening the dialog box 1. Click the Master Log tab, located on the bottom pane of the Host Connectivity Manager. A master summary of events on all discovered devices is displayed.
  • Page 115: Fabric Statistics Dialog Box (Hba And Cna)

    Fabric Statistics dialog box (HBA and CNA) Fabric Statistics dialog box (HBA and CNA) The Fabric Statistics dialog box enables you to view statistics on a selected Fabric. Opening the dialog box 1. Select a port from the device list. 2.
  • Page 116: Fcoe Port Properties (Cna Only)

    FCoE port properties (CNA only) FCoE port properties (CNA only) The FCoE Port properties panel enables you to display the properties that are associated with a selected FCoE port. Opening the properties panel Select an FCoE port in the device tree and click the Properties tab in the right pane. Fields and components Field Description...
  • Page 117 FCoE port properties (CNA only) Field Description Operating Speed The configured speed of the FCoE port. Max Speed Supported The maximum speed that is supported on the FCoE port. Operating Topology The topology setting. Options include auto, point-to-point, and loop. Frame Data Field Size The frame size, in bytes, of the FCoE port.
  • Page 118: Fcoe Statistics Dialog Box (Cna Only)

    FCoE Statistics dialog box (CNA only) FCoE Statistics dialog box (CNA only) The FCoE Statistics dialog box enables you to display statistical information related to the Fibre Channel over Ethernet (FCoE) port. Opening the dialog box 1. Select an FCoE port from the device tree. 2.
  • Page 119: Fcp Im Statistics Dialog Box (Hba And Cna)

    FCP IM Statistics dialog box (HBA and CNA) FCP IM Statistics dialog box (HBA and CNA) The FCP IM Statistics dialog box enables you to display Fibre Channel Protocol Input Method (FCP IM) statistical information for initiators and targets. Opening the dialog box Select Monitor >...
  • Page 120 FCP IM Statistics dialog box (HBA and CNA) Field Description HAL TM Related IO Cleanups The number of hardware abstraction layer (HAL) TM-related I/O cleanups. HAL TM Firmware Queue Resumed The number of times the hardware abstraction layer (HAL) task management firmware queue is resumed.
  • Page 121: Fcp Im Module Statistics Dialog Box (Hba And Cna)

    FCP IM Module Statistics dialog box (HBA and CNA) FCP IM Module Statistics dialog box (HBA and CNA) The FCP IM Module Statistics dialog box enables you to display statistical information for each initiator target nexus (ITN). Opening the dialog box Select Monitor >...
  • Page 122 FCP IM Module Statistics dialog box (HBA and CNA) Field Description IO comp with unknown tags The number of I/Os with unknown tags. IO implicitly aborted The number of times an I/O was implicitly aborted. IO aborted due to TM commands The number of I/Os that were aborted because of target mode commands.
  • Page 123: Fibre Channel Security Protocol Dialog Box (Hba And Cna)

    Fibre Channel Security Protocol dialog box (HBA and CNA) Fibre Channel Security Protocol dialog box (HBA and CNA) The Fibre Channel Security Protocol (FC SP) dialog box enables you to define security authentication on selected ports. Opening the dialog box 1.
  • Page 124: Hardware Tests Diagnostics Dialog Box (Hba And Cna)

    Hardware Tests Diagnostics dialog box (HBA and CNA) Hardware Tests Diagnostics dialog box (HBA and CNA) The Port Tests diagnostics dialog box enables you to run tests on the port and to configure parameters such as link speed and frame count. Opening the dialog box 1.
  • Page 125: Hba Properties Panel (Hba Only)

    HBA Properties panel (HBA only) HBA Properties panel (HBA only) The HBA Properties panel enables you to display the properties that are associated with a selected 4 Gbps or 8 Gbps Brocade HBA. Opening the properties panel 1. Select an HBA in the device tree. 2.
  • Page 126 HBA Properties panel (HBA only) Field Description Current # of Lanes The number of PCI lanes, in Gbps, each way between the PCI slot and the adapter. PCIe Generation The number of times the PCI Register is generated. Initial Negotiated # of Lanes The set number of PCI lanes that were initially negotiated.
  • Page 127: Ioc Statistics Dialog Box (Hba And Cna)

    IOC Statistics dialog box (HBA and CNA) IOC Statistics dialog box (HBA and CNA) The IOC Statistics dialog box enables you to view statistics related to the input/output controller (IOC). Opening the dialog box 1. Select a physical port of the HBA or an FCoE port of a CNA from the device tree. 2.
  • Page 128 IOC Statistics dialog box (HBA and CNA) Field Description intr_cause0 The number of 0 cause interrupts on the firmware port. intr_evt The number of event-type interrupts on the firmware port. intr_other The number of other-type interrupts on the firmware port. intr_other_ign The number of other_ign interrupts on the firmware port.
  • Page 129 IOC Statistics dialog box (HBA and CNA) Field Description prim_unknown The number of unknown primitive events that occurred on the firmware port. proto_err_cnt The number of I/O protocol errors. psp_errors The number of primitive sequence protocol errors. rectov_timedout_cnt The number of Receiver Time Out events. seq_cnt_frm_drop_cnt The number of sequential frame drops.
  • Page 130: Lldp Properties Panel (Cna Only)

    LLDP Properties panel (CNA only) LLDP Properties panel (CNA only) The LLDP Properties panel enables you to display the link layer properties that are associated with the selected converged network adapter (CNA), both locally and remotely. Opening the properties panel 1.
  • Page 131: Logical Port Statistics Dialog Box (Hba And Cna)

    Logical Port Statistics dialog box (HBA and CNA) Logical Port Statistics dialog box (HBA and CNA) The Logical Port Statistics dialog box enables you to display statistics that are related to a selected logical port. Opening the dialog box Select Monitor > Statistics > Logical Port Statistics from the Host Connectivity Manager Right-click a logical port (LPORT) from the device tree and select Logical Port Statistics.
  • Page 132 Logical Port Statistics dialog box (HBA and CNA) Field Description 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.
  • Page 133: Lport Properties Panel (Hba And Cna)

    LPORT Properties panel (HBA and CNA) LPORT Properties panel (HBA and CNA) The LPORT Properties panel enables you to display the properties that are associated with a logical port. Opening the properties panel 1. From the device tree, select a physical port. 2.
  • Page 134: Master Log Tab (Hba And Cna)

    Master Log tab (HBA and CNA) Master Log tab (HBA and CNA) The Master Log enables you to display a list of all events that have occurred. Opening the Master Log 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.
  • Page 135 Master Log tab (HBA and CNA) Using the dialog box Refer to the following topics for specific procedures using this dialog box: • “Master Log” • “Event severities” • “Filtering event log entries” Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 136: Master Log Filter Dialog Box (Hba And Cna)

    Master Log Filter dialog box (HBA and CNA) Master Log Filter dialog box (HBA and CNA) The Master Log Filter dialog box enables you to filter the events you receive by time, severity, category, or world wide name. Opening the dialog box 1.
  • Page 137: Persistent Binding Dialog Box (Hba And Cna)

    Persistent Binding dialog box (HBA and CNA) Persistent Binding dialog box (HBA and CNA) The Persistent Binding dialog box enables target port world wide name binding to a persistent target ID for the OS stack. You can view the Persistent Binding dialog box at the host level, the CNA level, or the port level.
  • Page 138: Port Pom Properties Panel (Hba And Cna)

    The 4 Gbps SFP (bundled with the Brocade 415 or 425) is referred to as “SFP,” the 8 Gbps SFP (bundled with the Brocade 815 or 825), is referred to as “SFP+,” and the 10 Gbps SFP (bundled with the BR-1010 and BR-1020) is referred to as “XFP.” Opening the properties panel 1.
  • Page 139: Port Properties Panel (Hba Only)

    Port Properties panel (HBA only) Port Properties panel (HBA only) The Port Properties panel enables you to display the properties that are associated with a selected HBA port. NOTE QoS properties apply only to the HBA. Opening the properties panel 1.
  • Page 140 Port Properties panel (HBA only) Field Description Queue Depth The number of I/O operations that can be run in parallel on a device. Interrupt Control Coalesce 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.
  • Page 141: Port Statistics Dialog Box (Hba And Cna)

    Port Statistics dialog box (HBA and CNA) Port Statistics dialog box (HBA and CNA) The Port Statistics dialog box enables you to monitor the performance of the CNA and the traffic between the CNA and the LUNs. You can use the information to isolate and troubleshoot areas that affect application performance.
  • Page 142 Port Statistics dialog box (HBA and CNA) Using the dialog box Refer to the following topics for specific procedures using this dialog box: • “Port Statistics dialog box (HBA and CNA)” • “Polling frequency rate” • “Resetting statistics” • “Performance monitoring” Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 143: Protocol Tests Dialog Box (Hba And Cna)

    Protocol Tests dialog box (HBA and CNA) Protocol Tests dialog box (HBA and CNA) The Protocol Tests dialog box enables you to run diagnostic tests on Fibre Channel components. Opening the dialog box 1. Select Configure > Diagnostics from the Host Connectivity Manager. 2.
  • Page 144: Qos Statistics Dialog Box (Hba Only)

    QoS Statistics dialog box (HBA only) QoS Statistics dialog box (HBA only) The QoS Statistics dialog box enables you to view statistics related to Quality of Service (QoS). Opening the dialog box Select Monitor > Statistics > QoS Statistics from the Host Connectivity Manager. Fields and components Field Description...
  • Page 145: Remote Port Properties Panel (Hba And Cna)

    Remote Port Properties panel (HBA and CNA) Remote Port Properties panel (HBA and CNA) The Remote Port Properties panel enables you to display the properties that are associated with the remote port. Opening the properties panel 1. From the device tree, select a remote port (target or initiator). 2.
  • Page 146: Sfp Properties Panel

    The 4 Gbps SFP (bundled with the Brocade 415 or 425) is referred to as “SFP,” the 8 Gbps SFP (bundled with the Brocade 815 or 825), is referred to as “SFP+,” and the 10 Gbps SFP (bundled with the BR-1010 and BR-1020) is referred to as “XFP.” Fields and components...
  • Page 147 SFP Properties panel Field Description 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. Options Displays details about the transceiver; for example, the type of port connector, type of transceiver, and enable/disable status.
  • Page 148: Syslog Server Configuration Dialog Box (Hba And Cna)

    Syslog Server Configuration dialog box (HBA and CNA) Syslog Server Configuration dialog box (HBA and CNA) The Syslog Server Configuration dialog box enables you to configure the host connectivity manager (HCM) to send Syslog messages to other computers through port 514. You can configure the HCM agent to forward events to a maximum of three Syslog destinations.
  • Page 149: Target Statistics Dialog Box (Hba And Cna)

    Target Statistics dialog box (HBA and CNA) Target Statistics dialog box (HBA and CNA) The Target Statistics dialog box enables you to display statistical information for a selected remote port (R_Port) or FCoE port. Opening the dialog box Select Monitor > Statistics > Remote port statistics > Target Statistics from the Host Connectivity Manager.
  • Page 150 Target Statistics dialog box (HBA and CNA) Field Description LOGO Received The number of times logouts are received. HAL uninit Create Events The number of hardware abstraction layer (HAL) uninit create events. HAL uninit Exception Events The number of hardware abstraction layer (HAL) uninit exception events.
  • Page 151 Target Statistics dialog box (HBA and CNA) Field Description HAL Offline exception events The number of hardware abstraction layer (HAL) offline exception events. HAL Delete f/w Responses The number of hardware abstraction layer (HAL) delete f/w responses. HAL Delete IOC down Events The number of hardware abstraction layer (HAL) Delete IOC down events.
  • Page 152: Test Log Details Dialog Box (Hba And Cna)

    Test Log Details dialog box (HBA and CNA) Test Log Details dialog box (HBA and CNA) The Test Log Details dialog box enables you to view details about a selected port or protocol test. Opening the dialog box 1. Select Configure > Diagnostics from the Host Connectivity Manager. 2.
  • Page 153: Virtual Port Creation Dialog Box (Hba And Cna)

    Virtual Port Creation dialog box (HBA and CNA) Virtual Port Creation dialog box (HBA and CNA) The Virtual Port Creation dialog box enables you to create a new virtual port from a physical port or FCoE port. Opening the dialog box 1.
  • Page 154: Virtual Port Deletion Dialog Box (Hba And Cna)

    Virtual Port Deletion dialog box (HBA and CNA) Virtual Port Deletion dialog box (HBA and CNA) The Virtual Port Deletion dialog box enables you to delete an existing virtual port or FCoE port. Opening the dialog box 1. Select a virtual port from the device tree. 2.
  • Page 155: Virtual Port Properties Panel (Hba And Cna)

    Virtual Port Properties panel (HBA and CNA) Virtual Port Properties panel (HBA and CNA) The Virtual Port Parameters properties panel enables you to display the properties that are associated with a virtual port or FCoE port. Opening the properties panel Select a virtual port from the device tree and click the Properties tab.
  • Page 156: Virtual Port Statistics Dialog Box (Hba And Cna)

    Virtual Port Statistics dialog box (HBA and CNA) Virtual Port Statistics dialog box (HBA and CNA) The Virtual Port Statistics dialog box enables you to view statistical information related to a selected virtual port or FCoE port. Opening the dialog box 1.
  • Page 157 Virtual Port Statistics dialog box (HBA and CNA) Using the dialog box Refer to the following topics for specific procedures using this dialog box: • “Port Statistics dialog box (HBA and CNA)” • “Polling frequency rate” • “Resetting statistics” • “Performance monitoring”...
  • Page 158: Vlan Configuration Dialog Box (Cna Only)

    VLAN Configuration dialog box (CNA only) VLAN Configuration dialog box (CNA only) The VLAN Configuration dialog box enables you to create a logical work group consisting of up to 64 VLANs. You can also add, edit, or remove VLANs using the VLAN Configuration dialog box. Opening the dialog box 1.
  • Page 159: Vlan Configuration - Add A Vlan Dialog Box (Cna Only)

    VLAN configuration - Add a VLAN dialog box (CNA only) VLAN configuration - Add a VLAN dialog box (CNA only) The Add VLAN dialog box allows you to create a VLAN. You can create a VLAN by selecting an Ethernet port. Opening the dialog box 1.
  • Page 160: Vlan Configuration - Edit A Vlan Dialog Box (Cna Only)

    VLAN configuration - Edit a VLAN dialog box (CNA only) VLAN configuration - Edit a VLAN dialog box (CNA only) The Edit VLAN dialog box allows you to edit an existing VLAN. Opening the dialog box 1. Select an Ethernet port from the device tree. 2.
  • Page 161: Vlan Statistics Dialog Box (Cna Only)

    VLAN Statistics dialog box (CNA only) VLAN Statistics dialog box (CNA only) The VLAN Statistics dialog box enables you to display statistics related to a selected virtual LAN. NOTE If a PORT VLAN exists in the VLAN configuration, you cannot perform any add, delete, or edit operations on any VLAN.
  • Page 162 VLAN Statistics dialog box (CNA only) Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 163: Brocade Command Utility

    Appendix Brocade Command Utility In this appendix • adapter ............151 •...
  • Page 164: About The Bcu

    About the BCU About the BCU 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: bcu port --topology <port_id>...
  • Page 165 BCU commands Boot commands boot over SAN commands apply to the 8 Gbps HBA only. bcu boot --blunZone -c <cfg> -p <port_wwn> -r <rport_wwn> -l <lun_id | lun#> --upload [adapter_id] <image_file> [-a] Converged Enhanced Ethernet (CEE) commands bcu cee --query <port_id>...
  • Page 166 BCU commands bcu ethlog --level <port_id> Ethernet Port commands bcu ethport --stats <port_id> --statsclr <port_id> FC diagnostic commands bcu 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] FCP initiator mode commands Note: fcpim - -mpiomode is not supported on Solaris platforms.
  • Page 167 BCU commands --disable <port_id> --stats <port_id> --statsclr <port_id> --query <port_id> --topology <port_id> {auto | p2p|loop} --speed <port_id> <speed> --dfsize <port_id> [dfsize] Remote port (rport) commands bcu rport --list <port_id> [-l <lpwwn>] --query <port_id> <rpwwn> [-l <lpwwn>] --stats <port_id> <rpwwn> [-l <lpwwn>] --statsclr <port_id>...
  • Page 168 BCU commands Virtual port (vport) commands Note: vport commands are not supported on Solaris platforms. bcu 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> Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 169: Adapter

    Displays and sets adapter parameters. The adapters are HBA models 415, 425, 815, and 825 and CNA single-port models BR-1010 and BR-1020. NOTE When trunking is enabled, multiple physical ports are trunked together to form a logical Fibre Channel port.
  • Page 170 Type Model-Info Serial-num Name 0000:01:00 Brocade-825 ALX0303D01C 0000:09:00 Brocade-825 ALX0301D06D 0000:14:00 BR-1010 ALX0714D05R bcu adapter --query 1 Example:# bcu adapter --query 1 Adapter Information: model info: BR-1020 OEM info: N/A num ports: 2 max speed: 10 Gbps chip revision: Rev-X...
  • Page 171 Flash Information: status: good fw version: FCHBA2.0.0.0 bios version: brocade_adapter_boot_fw_v2-0-0-0 bcu adapter --query 3 Adapter Information: model info: BR-1010 card type: CNA num ports: max speed: 10 Gbps chip revision: Rev-X hw path: 0000:14:00 Serial Num: ALX0714D05R name: PCI Information:...
  • Page 172: Auth

    auth auth Enables authentication configuration on a per-port basis and the ability to display authentication status and statistics. Synopsis bcu auth --algo <port_id> <md|sha1|ms|sm> bcu auth --policy <port_id> {on|off} bcu auth --secret <port_id> “secret_string” bcu auth --show <port_id> bcu auth --stats <port_id> bcu auth --statsclr <port_id>...
  • Page 173 auth port_id Specifies the ID of the port for which you want to display information. --stats Displays the authentication statistics. port_id Specifies the ID of the port for which you want to display information. --statsclr Clears the authentication statistics. port_id Specifies the ID of the port for which you want to clear statistical information.
  • Page 174 auth auth_tx_stats: auth_rjts: 0 auth_negs: 2 auth_dones: 0 dhchap_challenges: 0 dhchap_replies: 2 dhchap_successes: 0 auth --statsclr 4/1 Successfully cleared auth stats See Also None. Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 175: Bios

    bios bios Enables the basic input/output system (BIOS) in preparation for Boot Over SAN. The BIOS is the firmware code that, when first powered on, is a type of boot loader. NOTE Refer to the Brocade Fibre Channel CNA Installation and Reference Manual for more information about configuring BIOS.
  • Page 176 bios b pwwn,lun Specifies the host boots from the LUN information defined by the target port world wide name (PWWN) and LUN value (lun*). Specify the PWWN as a colon-separated value and the LUN as a 64-bit decimal value. The LUN must be the same LUN that you bound to the CEE port using the storage system’s management or configuration utility.
  • Page 177: Boot (Hba Only)

    boot (HBA only) boot (HBA only) Updates the boot code in flash. The boot-over-SAN feature is not supported on the converged network adapter (CNA). The adapter id could be any one of the following: • <adapter_id> • <adapter_sn> • <adapter_name> •...
  • Page 178: Cee

    Queries the Converged Enhanced Ethernet information on the port and displays statistics. The port_id could be any of the following: • Adapter ID or port ID • Port name • Port hardware path NOTE All switches must be in non-willing mode. Synopsis bcu cee --query <port_id>...
  • Page 179 Priority Table CoS: 0 1 2 3 4 5 6 7 ____________________ PGID 2 2 1 1 1 2 2 2 FCoE Priority Table # bcu cee --stats 1/0 _________________________ CEE Statistics _________________________ LLDP Frames Transmitted LLDP Frames Aged Out LLDP Frames Discarded LLDP Frames with Error LLDP Frames Received...
  • Page 180: Debug

    debug debug The debug commands gather support information on Fibre Channel components. Synopsis bcu debug --portlog <port_id> bcu debug --portlogclear <port_id> bcu debug --portlogctl <port_id> <enable | disable> bcu debug does not support the bcu debug --supportsave command. bfa_supportsave, however, supports the following options: •...
  • Page 181 debug Example bcu debug --portlog 10/0 --------------------------------------------------------------------------- time event port code args --------------------------------------------------------------------------- 08:35:28.430 10/0 00001234, 00050001 08:35:28.431 mbox 10/0 00001234, 00050001 08:35:28.433 ioctl 10/0 101d9910,0 08:35:28.433 10/0 02fffffd, 00fffffd, 0005ffff, 10000000 08:35:28.433 10/0 c0fffffd, 00fffffd, 00050006 08:35:28.433 10/0 03fffffd, 00fffffd, 00050006, 02000000 08:35:28.433 10/0 c0fffffd, 00ffffd, 00050006...
  • Page 182 debug Warning: No saved firmware trace Done. ===================== Fetching Firmware trace for port 3/1 ===================== Warning: No saved firmware trace Done. ========================= Fetching supportshow details ========================= Done. ============================== Creating a tar ball ============================= ===================================== Done ===================================== See Also None Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 183: Diag

    diag diag Lists the non-destructive group of diagnostic commands. Synopsis bcu diag --sfpshow <port_id> bcu diag --tempshow [ad_id] bcu diag --beacon <port_id> {on | off} [-t <secs>] bcu diag --pciloopback <port_id> <pattern> bcu diag --loopback <port_id> [-t <sub_test_id>] [-s <speed>] [-c <count>] [-p <pattern>] bcu diag --memtest <port_id>...
  • Page 184 diag --loopback Sends a health check message from the host to the firmware through message queues memory-mapped over the PCI. This is an offline diagnostic test. port_id Specifies the ID of the port on which you want to run a loopback test. -t sub_test_id Specifies the loopback test type.
  • Page 185 diag bcu diag --tempshow 1 temperature: 43.131800 C bcu diag --beacon 1/1 on Port beacon turned on To turn on the first LED with green color: bcu diag --ledtest 1/0 1 on green led turned on See Also “fcdiag” Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 186: Drvconf

    drvconf drvconf Sets the basic parameters for the driver to function properly. Note: The drvconf commands are supported on Windows platforms only. Synopsis bcu drvconf - -key <key_name> [- -val <value>] Description Changes the values for basic Windows registry entry parameters. NOTE You can directly change these values by editing the Windows registry entries for these values, or you can use the drvconf commands for the same purpose.
  • Page 187: Ethdiag

    ethdiag ethdiag The Ethernet Port Loopback Test that tests the Ethernet data path from the host to Serdes or external loopback based on your selection. Synopsis bcu ethdiag --loopback <port_id> [-t <loopback_type] [-c <frame_count>] [-p pattern] Description Runs the Ethernet diagnostic loopback test and indicates when the adapter is running at a normal operation state.
  • Page 188: Ethioc

    ethioc ethioc Displays or clears Ethernet IOC statistics. The port_id could be any of the following: • Adapter ID or port ID • Port name • Port hardware path Synopsis bcu ethioc --enable <port_id> bcu ethioc --disable <port_id> bcu ethioc --query <port_id> bcu ethioc --stats <port_id>...
  • Page 189: Ethlog

    ethlog ethlog Sets the log level for each Ethernet driver. The port_id could be any of the following: • Adapter ID or port ID • Port name • Port hardware path Synopsis bcu ethlog --level <port_id> [<level>] Description The number of messages logged by the host depends on the predetermined logging level. Although the CNA might generate many messages, only certain types of messages are logged based on the specified logging level.
  • Page 190: Ethport

    ethport ethport Displays or clears statistical information on the Ethernet port. An Ethernet port is a logical Ethernet that uses CNA’s physical port as a transport. Synopsis bcu ethport --stats <port_id> bcu ethport --statsclr <port_id> Description Displays or clears Ethernet port statistics. Operands --stats Displays Ethernet port statistics.
  • Page 191 ethport bcu ethport --statsclr 1/0 Successfully reset the ethernet port stats See Also None Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 192: Fabric

    fabric fabric Prints and resets Fabric statistics. Synopsis bcu fabric --stats <port_id> bcu fabric --statsclr <port_id> Description Displays or clears Fabric statistics. Operands --stats Prints the fabric statistics. port_id Specifies the ID of the fabric port for which you will print the statistics. --statsclr Resets the fabric statistics.
  • Page 193: Fcdiag

    fcdiag fcdiag Runs diagnostic tests on Fibre Channel components. Synopsis bcu fcdiag --fcping <port_id> <rpwwn> [-l <lpwwn>] bcu fcdiag --fctraceroute <port_id> <rpwwn> [-l <lpwwn>] bcu fcdiag --fcecho <port_id> <rpwwn> [-l <lpwwn>] bcu fcdiag --linkbeacon <port_id> {on|off} bcu fcdiag --scsitest <port_id> <rpwwn> [-l <lpwwn>] Description Fibre Channel diagnostic tests evaluate the integrity of Fibre Channel components.
  • Page 194 fcdiag Examples bcu fcdiag --fctraceroute 2/0 50:05:07:63:04:13:46:eb Error: Reject from attached fabric bcu fcdiag --fctraceroute 2/0 50:05:07:63:04:13:46:eb FC Traceroute completed successfully. Path Info: Switch WWN Switch Domain ID Ingress Port # Egress Port # 10:00:08:00:88:03:31:8b 10:00:08:00:88:03:31:8b bcu fcdiag --fctraceroute 2/0 50:05:07:63:04:13:46:e1 FC Traceroute Failed.
  • Page 195: Fcpim

    fcpim fcpim Enables or disables fast failover of initiator mode I/O. The default setting is off. Synopsis bcu fcpim --stats <port_id> bcu fcpim --statsclear <port_id> bcu fcpim --qdepth <port_id> <q_depth_value> bcu fcpim --query <port_id> <rpwwn> [-l <lpwwn>] bcu fcpim --modstats <port_id> bcu fcipim --modstatsclr <port_id>...
  • Page 196 fcpim Example bcu fcpim --stats 1/0 50:00:1f:e1:50:0d:da:a9 rport onlines: rport offlines: PRLI sent: PRLI Accepts: PRLI error responses: PRLI responses parse err: fcxp alloc waits: Second level err recovery: Num times in initiator mode: HAL fcpim statistics online events: offline events: create events: delete events: create completions:...
  • Page 197: Ioc

    Enables or disables the IO Controller (IOC), which refers to the combination of port and the firmware controlling it. NOTE The Interrupt Control Coalesce feature is not supported on the converged network adapter (CNA). Synopsis bcu ioc --stats <port_id> bcu ioc --statsclr <port_id> bcu ioc --enable <port_id>...
  • Page 198 delay Sets the delay timeout interrupt value. A delay can be between 0 to 1125 microseconds. A delay value of 0 disables the delay timeout interrupt. Example # bcu ioc --stats 1/0 Num suspends: 7 bcu ioc --statsclr 1/0 ioc stats cleared. bcu ioc --enable 1/0 ioc is enabled bcu ioc --enable ad1_p0...
  • Page 199: Log

    Sets the log level for each module. If no log level is specified, the current level is used. Synopsis bcu log --level <port_id> [<level>] [-m <fw|ha1|fcs|drv|aen|all>] Description The number of messages logged by the host depends on the predetermined logging level. Although the CNA might generate many messages, only certain types of messages are logged based on the specified logging level.
  • Page 200: Lport

    lport lport Lists the logical port (lport) commands. Synopsis bcu lport --list <port_id> bcu lport --query <port_id> [-l lpwwn] bcu lport --stats <port_id> [-l lpwwn] bcu lport --statsclr <port_id> [-l lpwwn] Description Lists all the logical ports (lports) under a given port ID. A logical port is a port that is logged into a fabric.
  • Page 201 lport Logical Port PWWN Logical Port NWWN FC Addr FC4 Roles aa:bb:cc:dd:ee:ff:00:01 aa:bb:cc:dd:ee:ff:00:02 645500 01:bb:cc:dd:ee:ff:00:01 01:bb:cc:dd:ee:ff:00:00 645501 IM, IP 02:bb:cc:dd:ee:ff:00:01 02:bb:cc:dd:ee:ff:00:00 645502 04:bb:cc:dd:ee:ff:00:01 04:bb:cc:dd:ee:ff:00:00 645503 # bcu lport --query hba5_port0 State: Online FC address: 0c0100 Port wwn: aa:bb:cc:dd:ee:ff:aa:bb Node wwn: cc:dd:cc:aa:ff:cc:aa:ff Symbolic name: FC4 Role:...
  • Page 202: Pbind

    pbind pbind Enables target port world wide name (WWN) binding to a persistent target ID for an operating system (OS) stack. Synopsis bcu pbind --list <port_id> [<pwwn>] bcu pbind --clear <port_id> Description Queries the list of mappings or clears existing persistent binding settings. NOTE The pbind command is only supported on the Windows platform.
  • Page 203: Port

    port port Lists the port commands (the physical ports on the CNA). Synopsis bcu port --list bcu port --name <port_id> [port_name] bcu port --enable <port_id> bcu port --disable <port_id> [-f] bcu port --stats <port_id> bcu port --statsclr <port_id> bcu port --query <port_id> bcu port --topology <port_id>...
  • Page 204 port --stats Displays the physical port-level statistics. port_id Specifies the ID of the port for which you want to display statistical information. --statsclr Clears port-level statistics. port_id Specifies the ID of the port for which you want to clear statistical information. --query Queries and displays port-related information for a port.
  • Page 205 port port --name 1/0 emc_fab3_ad5_p0 Port 1/0’s name set to emc_fab3_ad5_p0 port --name 1/0 Port 1/0’s 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 bcu port --stats 4/0 tx_frames: 4096...
  • Page 206 State: Linkup Speed: 10G FCoE: MAC: 00:05:1e:12:34:56 pwwn: 10:00:00:05:1e:0d:60:6b nwwn: 20:00:00:05:1e:0d:60:6b supported classes: Class-3 symbolic name: BR-1010 maximum frame size: 2112 receive bb credits: 50 transmit bb credits: 8 QoS: Disabled TRL: Disabled TRL default speed: fcpim MPIO mode: Disabled (Path TOV = 30 seconds)
  • Page 207 port bcu port --dfsize 1/1 2112 Setting will be enforced after port --disable and --enable bcu port --dfsize 1/1 auto Setting will be enforced after port --disable and --enable bcu port --dfsize 1/1 2112 Port maximum receive data field size met bcu port --dfsize 1/1 auto Port maximum receive data field size set to driver default.
  • Page 208: Qos (Hba Only)

    qos (HBA only) qos (HBA only) NOTE The QoS feature is not supported on the converged network adapter (CNA). Quality of Service (QoS) works in conjunction with the QoS feature on Brocade switch F_ports. The Fabric operating system (FOS) provides a mechanism to assign traffic priority (high, medium, or low) for a given source and destination traffic flow.
  • Page 209: Ratelim (Hba Only)

    ratelim (HBA only) ratelim (HBA only) Enables or disables target rate limiting support on the HBA side. NOTE .The target rate limiting feature is not supported on the converged network adapter (CNA). Synopsis bcu ratelim --enable <port_id> [-s <default_speed>] bcu ratelim --disable <port_id> bcu ratelim --query <port_id>...
  • Page 210: Rport

    rport rport Lists the commands that apply to a remote port in a fabric. A remote port is a port that is physically separated from the adapter. Synopsis bcu rport --list <port_id> [-l <lpwwn>] bcu rport --osname <port_id> [-l <lpwwn>] bcu rport --query <port_id>...
  • Page 211 rport Examples bcu rport --list 2/0 Num RPORTs = 3 --------------------------------------------------------------------------- FC Addr Remote Port PWWN Remote Port NWWN State df_sz --------------------------------------------------------------------------- 010ada 21:00:00:04:cf:75:6a:04 20:00:00:04:cf:75:6a:04 online 2048 010adc 21:00:00:04:cf:75:5b:3b 20:00:00:04:cf:75:5b:3b online 2048 010ae1 21:00:00:04:cf:75:6d:44 20:00:00:04:cf:75:6d:44 online 2048 bcu rport --query 1/0 21:00:00:04:cf:75:6a:04 RPORT FC Address: 01f701 RPORT port wwn:...
  • Page 212 rport 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: 0 online: offline events: online: delete events: online: IOC down events:...
  • Page 213: Vlan

    vlan vlan Lists the commands that apply to an Ethernet virtual LAN (Windows only). The port ID can be either the adapter ID or the port ID. Synopsis bcu vlan --add <port_id> <vlan_id> | [<vlan_name>] bcu vlan --remove {<vlan_id> {<port_id> bcu vlan --edit <port_id>...
  • Page 214 vlan Examples bcu vlan --list 1/0 Vlan id Vlan Name VLAN0001 3000 VLAN3000 bcu vlan --query 1 vlan id: 1 vlan name: VLAN0001 vlan statistics: Tx Bytes: 200 Rx Bytes: 100 Duration: 2:30:32 [Hr:Min:sec] /*rolls up and shows days also* Status: Connected See Also None.
  • Page 215: Vport

    vport vport Lists the commands that apply to a virtual port. Synopsis bcu vport --create <port_id> <vpwwn> [-n <nwwn>] [-s <sname>] bcu vport --delete <port_id> <vpwwn> bcu vport --query <port_id> <vpwwn> bcu vport --stats <port_id> <vpwwn> bcu vport --statsclr <port_id> <vpwwn> Description The vport commands enable you to create and delete vports and display statistics about them.
  • Page 216 vport --statsclr Clears the statistics that are associated with the V_Port. If you do not specify the port’s world wide name, the statistics listed are for the base V_Port. port_id Specifies the ID of the port for which you want to clear statistical information. vpwwn Clears the statistics for the virtual port by its world wide name.
  • Page 217: Hcm Troubleshooting

    Appendix HCM Troubleshooting This section discusses known problems with HCM usability features and the workaround. HCM tab navigation Problem There are various places within the Host Connectivity Manager (HCM) where you cannot navigate without using the mouse on the KDE GUI on the Linux operating system. If you use the tab key to enter any of the fields listed below, you cannot exit the field without using the mouse.
  • Page 218 HCM tab navigation Brocade Adapters Administrator’s Guide 53-1001256-01...
  • Page 219: Appendix D Glossary And Acronyms

    Appendix Glossary and acronyms Address assignment A process whereby addresses are assigned to switches and switch ports. Address identifier A 24-bit address value used to uniquely identify the source (S_ID) and destination (D_ID) of Fibre Channel frames. Available BB_Credit A value used by a transmitter to determine permission to transmit frames and, if so, how many.
  • Page 220 Glossary and acronyms A fabric inter-element port used to connect bridge devices with E_Ports. Byte A group of eight data bits. Common Diagnostic Model. Converged Enhanced Ethernet. Common Information Model. CIMOM Common Information Model Object Manager. Class of service A frame delivery scheme exhibiting a specified set of delivery characteristics and attributes.
  • Page 221 Glossary and acronyms Data Center Bridging. DCBX DCB Capability Exchange Protocol. DCFM Data Center Fabric Manager Distributed Services Timeout Value (D_S_TOV) The maximum time that a requestor will wait for a response to an FC-CT distributed services request. Domain_ID An eight-bit value that identifies a domain. Ethernet Link Manager.
  • Page 222 Glossary and acronyms Host Bus Adapter. Host Connectivity Manager. Host Bus Adapter (HBA) A hardware facility in a node that provides an interface attachment. I/O Controller. Initiator-Target-LUN. An Initiator Port (HBA controller) talks to one Target Port addressing one LUN. LLDP Link Layer Discovery Protocol.
  • Page 223 Glossary and acronyms NL_Port A port within a node that is capable of arbitrated loop operations. 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).
  • Page 224 Glossary and acronyms Type Length Value, where: • Type is a numeric code that indicates the kind of field this part of the message represents. • Length is the size of the value field, typically measured in bytes. • Value is a variable-sized set of bytes that contain data for this part of the message.
  • Page 225 Index command adapter auth adapter command debug advanced port configuration options diag application log fabric auth command fcdiag Authentication Configuration dialog box fcpim authentication, security lport port portlog portlogclear backing up data prior to uninstalling portlogct base port properties panel rport beaconing vlan...
  • Page 226 dialog box host management, remote Authentication Configuration Configure Names Define Master Log Filter Define Name Event Properties interrupt control coalesce Persistent Binding configuring using the GUI Protocol Tests diagnostics IOC command Security Authentication Test Log Details discovery description of setting up launching HCM setting up out-of-band on Linux...
  • Page 227 operating system-specific features properties importing in EFCM format importing in FM format Protocol Tests diagnostics dialog box panel HBA Properties Port POM Port SFP Port Statistics quality of service (QoS), configuring remote port properties queue depth password configuring using the BCU how to change configuring using the GUI how to reset...
  • Page 228 test log details Test Log Details dialog box tree node pop-up menus uninstalling the software vlan command vport command Windows, launching HCM application adding a name exporting importing removing Brocade Adapters Administrator’s Guide 53-1001256-01...

This manual is also suitable for:

Br-1020415425825815

Table of Contents