53-1001583-01 21 June 2010 Brocade Adapters Administrator’s Guide Supporting HBA models 825, 815, 804, 425, 415 ®
Copyright © 2008-2010 Brocade Communications Systems, Inc. All Rights Reserved. Brocade, the B-wing symbol, BigIron, DCX, Fabric OS, FastIron, IronPoint, IronShield, IronView, IronWare, JetCore, NetIron, SecureIron, ServerIron, StorageX, and TurboIron are registered trademarks, and DCFM, Extraordinary Networks, and SAN Health are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries.
Contents About This Document In this section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x Text formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x Notes, cautions, and warnings . . . . . . . . . . . . . . . . . . . . . . . . . . .
Software downgrade using Adapter Software Installer . . . . . . . . . . . 9 Downgrading HCM and driver or HCM only . . . . . . . . . . . . . . . . . 9 Downgrading driver only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 HCM configuration data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Backing up data after an uninstall . . . . . . . . . . . . . . . . . . . . . . . 10 Data restoration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
NPIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Chapter 4 Monitoring In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Performance monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Polling frequency rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Resetting statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fibre Channel Security Protocol Configuration dialog box . . . . . . . 83 Hardware Tests Diagnostics dialog box . . . . . . . . . . . . . . . . . . . . . . . 85 HBA Properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 IOC Statistics dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Logical Port Statistics dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 LPORT Properties panel . . . . . . . . . . . . . . . . . . .
fcpim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143 ioc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145 log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 lport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148 pbind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
viii Brocade Adapters Administrator’s Guide 53-1001583-01
About This Document In this section • How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix • Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x • Notice to the reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi • Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi • Getting technical help .
Document conventions This section describes text formatting conventions and important notice formats used in this document.
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 165. 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.
Release notes are available on the MyBrocade website and are also bundled with the Fabric OS firmware. Other industry resources 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.
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.
xiv Brocade Adapters Administrator’s Guide 53-1001583-01
Chapter 1 Host Management Overview In this chapter • Host bus adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • HCM software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • HCM features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Tree node pop-up menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 HCM software HCM software The Host Connectivity Manager (HCM) is a management software application for configuring, monitoring, and troubleshooting Brocade HBAs, converged network adapters (CNAs) and FC mezzanine cards in a storage area network (SAN) environment. 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 adapter.
Tree node pop-up menus 1 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 (see Table 2).
1 Adapter support Adapter support The HBAs are supported on the operating systems listed in Table 3.
Chapter Getting Started with HCM Software 2 In this chapter • HCM software launch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 • Software downgrade using Adapter Software Installer. . . . . . . . . . . . . . . . . . 9 • HCM main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 • Legend Help menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 • Discovery . . . . .
2 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 Host_Connectivity_Manager icon to launch the application. • If using a KDE shell, click the Host_Connectivity_Manager icon to launch the application.
HCM software launch 2 1. From the Host Connectivity Manager, select Configure > Change Password > Change Password for HCM User. The Change HCM Password dialog box, shown in Figure 2, displays. FIGURE 2 Change HCM 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.
2 HCM software launch 1. From the Host Connectivity Manager, click Configure > Change Password > Change Agent Password. The Change HCM Agent Password dialog box, shown in Figure 3, displays. FIGURE 3 Change HCM Agent Password dialog box 2. Type the current password for the account. The default user name and password are admin 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.
Software downgrade using Adapter Software Installer 2 Software downgrade using Adapter Software Installer Although driver and HCM downgrades are not supported, the following procedures are recommended for downgrading between versions 2.1, 2.0, and 1.1 of the Brocade adapter software. If you are not downgrading previous software versions, proceed to HCM software launch.
2 Software downgrade using Adapter Software Installer 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. Be sure to back up configuration data when the backup message displays during uninstallation. You can perform a backup on an as-needed basis. Following are default locations for HCM configuration data. • Versions 1.1.0.8 and above - \HCM\data • Versions 1.1.0.
Software downgrade using Adapter Software Installer FIGURE 4 2 Restore Data dialog box 3. Click the Restore from previous backup data at button, and then click Browse and navigate to where the last backed up file resides. OR Click the Restore default data button. If you click this button, the Browse field is grayed out and the last restored data file is automatically retrieved. 4. Click Start Restore. 5. Restart the HCM application for the restoration to take effect.
2 HCM main window HCM main window From the Host Connectivity Manager main window, shown in Figure 5, 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 Adapters Installation and Reference Manual for instructions on how to install both the driver and GUI, the driver only, or the GUI only. 4. 1.
Legend Help menu 2 Legend Help menu To display the HCM product icons and the event severity icons, select Help > Legends from the Host Connectivity Manager. 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.
2 Discovery Event severity icons Table 5 describes the icons that represent the four event types. 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, For information about how to filter events, see “Filtering event log entries” on page 64.
Discovery 2 Setting up out-of-band discovery for an adapter When performing out-of-band discovery, you are managing the adapter 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 adapter 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.
2 Logging off HCM 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.
Chapter 3 Host Configuration In this chapter • Host security authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Buffer credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Basic port configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Boot over SAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3 Host security authentication 2. Select Configure > Authentication from the main menu, or perform the appropriate following step to open the security authentication dialog box: • From the host level, right-click the host and select Authentication from the list. The Fibre Channel Security Protocol Configuration (host level) dialog box displays, as shown in Figure 7. • From the adapter level, right-click the adapter and select Authentication from the list.
Host security authentication 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.
3 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. Buffer credit limits between each device and the fabric are communicated at the time of fabric login.
Basic port configuration 3 Opening the Basic Port Configuration dialog box You can access the Basic Port Configuration dialog box, shown in Figure 8, by selecting the Host, an HBA, or an HBA port from the device tree. NOTE There are slight changes in HCM’s Basic Port Configuration dialog box, depending on the operating system. 1. Select a device from the device tree. 2. Select Configure > Basic Port Configuration from the main menu. The Basic Port Configuration dialog box displays.
3 Basic port configuration Configuring the port logging level using HCM 1. Select Configure > Basic Port Configuration from the Host Connectivity Manager. The Basic Port Configuration dialog box displays. 2. Select a value from the Port Logging Level list. Supported values are Log Critical, Log Error, Log Warning, Log Info, and Log Invalid. 3. Click Apply to apply the changes. 4. Click OK to save the changes and close the window.
Basic port configuration 3 Configuring the port speed using the BCU Enter the following command to set the port speed. bcu port --speed [] Refer to “port” on page 151 for details about this command. 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. See “Buffer credits” on page 20 for information about buffer credits.
3 Basic port configuration Persistent binding Persistent binding enables you to permanently assign a system SCSI target ID to a specific FC device. Persistent binding can be achieved by binding to world wide port name (WWPN), world wide node name (WWNN), or device ID (DID). You can access the Persistent Binding dialog box by selecting the Host or an HBA from the device tree.
Basic port configuration 3 QoS 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. By default, all flows are marked as medium. This feature is supported only on 8 Gbps HBA ports installed on specific switch models that use Fabric OS 6.2 and later.
3 Basic port configuration Enter the following commands to enable or disable QoS support on the HBA side: • • • • • bcu qos --enable bcu qos --disable bcu qos --query bcu qos --stats bcu qos --statsclr Refer to “qos” on page 155 for details about this command. Path time out With path time out values (TOV), you can either force an immediate failover (by setting the TOV to 0) or you can specify a delay in seconds (1-60 seconds). The default TOV is 30.
Basic port configuration 3 Enabling and disabling rate limiting on the adapter side using HCM Target rate limiting is supported only when the adapter port is connected to the fabric. Therefore, target rate limiting is not supported when the port is directly connected with another device. 1. Select Configure > Basic Port Configuration from the Host Connectivity Manager. The Basic Port Configuration dialog box displays. 2. Enable the Target Rate Limiting feature by clicking the corresponding check box. 3.
3 Boot over SAN Boot over SAN Boot over SAN configuration using the Basic Port Configuration dialog box is enabled on all platforms if the HCM version is 1.1 or higher. The Boot over SAN feature allows you to target remote boot devices (LUNs on SAN storage arrays) from which to boot the host system.
Boot over SAN FIGURE 9 3 Boot-over-SAN dialog box 3. Click the BIOS Enable check box to enable Boot over SAN. 4. From the Boot Option list, select one of the following: • Auto Discovered from Fabric - Enables Boot over SAN using boot LUN information stored in the fabric. This is the default setting. • First Visible LUN - Enables Boot over SAN from the first discovered LUN in the SAN. • User Configured LUNs - Allows the user to select and prioritize the remote target and LUN for booting over SAN. 5.
3 Boot over SAN Pre-boot configuration Any parameters flagged with pre-boot were configured using a blade system management application. You cannot use HCM to create or modify a pre-boot configuration. If the port has been pre-boot enabled: • The BIOS Enable option is disabled. • The pre-boot configured LUNs in the LUN column are displayed as (Pre-boot), as shown in Figure 9.
Boot over SAN 3 Boot image update You can update a boot image at the host level or at the adapter level. At the host level, if the HCM version is lower than 2.1, the Upload Boot Image menu is enabled only when one HBA is visible. If the agent version is 2.1 and higher, the Upload Boot Image menu is always enabled if at least one adapter is visible and will update the image to all visible adapters. Uploading the boot image using HCM 1. Download the boot code (brocade_adapter_boot_fw_v2-1-1-0) from www.
3 Virtual port configuration Virtual port configuration Virtual ports (V_Ports) appear to the hosts as physical ports in the data network. One or more virtual ports are assigned to each host, and a host can access storage at a virtual port only if the virtual port has been assigned to the host. Virtual port restrictions • You cannot create a V_Port that already exists in the Names dialog box.
Virtual port configuration 3 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. (Optional). Provide a symbolic name for the virtual port. 4. (Optional). Provide an alias name for the virtual port. By creating an alias, you can assign a familiar name to a device or group multiple devices into a single name.
3 HCM logging levels FIGURE 11 Virtual Port Deletion dialog box 4. Click the check box that corresponds to one or multiple virtual ports you want to delete, and click OK. 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, DEBUG, which is the default, is used.
Advanced port configuration 3 Advanced port configuration You can access the Advanced Port Configuration dialog box by selecting an HBA 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. Table 7 lists the features and configuration options.
3 Advanced port configuration Interrupt Control Coalesce Interrupt control coalescing allows the system to optimize CPU utilization by varying the number of interrupts generated. Increasing the latency monitor timeout value should result in a lower interrupt count and less CPU utilization, which may result in higher throughput.
Name configuration 3 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. NOTE You can access the Define Names dialog box by right-clicking an adapter, port, remote port, or Virtual Port.
3 Name configuration Defining a name The Define Name dialog box, shown in Figure 14, enables you to assign a name to an existing world wide name (WWN) or media access control (MAC) address. 1. Select an adapter from the device tree. 2. Select Configure > Define Names from the Host Connectivity Manager. OR Right-click a device from the device tree and select Define Names. The Define Name dialog box displays. FIGURE 14 Define Name dialog box 3. Enter a meaningful name for the selected adapter or port.
Name configuration 3 The Configure Names dialog box, shown in Figure 15, displays all the discovered and detached (undiscovered) names. FIGURE 15 Configure Names dialog box 3. Select a row and edit the name, the WWN, and the description, as needed. 4. Click OK. Adding name entries You can add up to 2000 names which are then stored in the HbaAliasdb.properties file. The entries persist during reboot. 1. Select an HBA, an HBA port, or a Virtual Port from the device tree. 2.
3 Name configuration Removing a name entry The Remove functionality clears the name and description values of a selected detached WWN. 1. Select an HBA, an HBA port, or a Virtual Port from the device tree. 2. 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 all the names available at the host. 3.
Name configuration 3 4. Click the Export button. The Save dialog box displays. You can save the properties file in .txt, .csv, or .properties format. 5. Name the file, and click Save. 6. Click OK to close the window. Importing the properties for a WWN Complete the following steps to import WWN properties. 1. Select Configure > Names from the Host Connectivity Manager. OR Right-click a device from the device tree and select Configure Names. The Configure Names dialog box displays. 2.
3 Name configuration Importing properties in EFCM format You can use this procedure to import properties in Enterprise Fabric Connectivity Manager (EFCM) format. 1. In the Configure Names dialog box, select EFCM Format and then select Import. 2. Navigate to the location of the *.properties file from which you will import properties for the selected device. The format appears as follows. # Names Export File V 1.
Name configuration 3 Importing duplicated names The Duplicated Names dialog box, shown in Figure 16, displays when you import a file with a duplicate name. 1. Select Configure > Names from the Host Connectivity Manager. OR Right-click a device from the device tree and select Configure Names. The Configure Names dialog box displays. 2. Import a file with duplicate names in the Configure Names dialog box. The Duplicated Names dialog box displays. FIGURE 16 Duplicated Names dialog box 3.
3 NPIV 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.
Chapter 4 Monitoring In this chapter • Performance monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Master log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Application log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Syslog support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 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. 1. Click the Start Polling check box to manually poll the port statistics. 2.
Master log 4 Master log Event monitoring enables early fault detection and isolation on a selected adapter. When applicable events occur during adapter operation, the adapter driver generates event messages. These messages are captured in your host system logs. These messages are also captured in an agtEvent.log file by the HCM agent and displayed in the HCM master log.
4 Master log The Master Log Properties dialog box, described in Table 9, displays a list of all events that have occurred. See Table 5 on page 14 for a description of the event severities. You can filter the events based on the user-defined criteria shown in Figure 18. TABLE 9 48 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.
Master log 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 or a combination of the criteria shown in Figure 18. NOTE The Category is the type of event. The categories are listed in Table 9.
4 Application log Application log The HCM application log, shown in Figure 19, 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 NOTE Run-time memory information is logged in the application log whenever a supportSave is triggered from HCM or when the About dialog box is launched in HCM.
Syslog support 4 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. The HCM stores all the received events from the driver in the agtEvent.log file. By default, the location is /opt/hcmagent/log/hbaEvents.
4 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. Click Remove to remove the host as a Syslog destination. 5. Click OK to close the dialog box. Syslog host configuration using VMware VMware ESX 3.5 and 4.0 blocks the Syslog outbound port 514 by default.
Chapter 5 Diagnostics In this chapter • Diagnostics using the BCU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Diagnostics using HCM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Displaying test log details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Beaconing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • SFP management . . . . . . .
5 Diagnostics using the BCU diag commands The diag commands shown in Table 10 monitor hardware components and can be performed while the system is running (they are non-disruptive). Refer to “diag” on page 137 for command details. NOTE The sfpshow and beacon commands are not applicable for Brocade 804 mezzanine cards. TABLE 10 Fibre Channel diag commands Command Description beacon Blinks the appropriate port LED for physical identification. Beaconing can occur at the port or the link level.
Diagnostics using HCM 5 Diagnostics using HCM 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. NOTE When you invoke a test on an adapter, you can run diagnostics for one or both ports within the selected adapter. Running a hardware-level test using HCM 1.
5 Diagnostics using HCM 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 12. 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. Hardware-level test parameters TABLE 12 Hardware-level test parameters Hardware-level test Parameter Test Options Memory test None You can enable or disable this test.
Diagnostics using HCM 5 Running a Fibre Channel protocol-level test using HCM 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). Not supported in Solaris operating systems. • FC traceroute test, which requests to enumerate the route between two given end points. Not supported in Solaris operating systems.
5 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. 7. Click Start to run the test. Displaying test log details 1. Select Configure > Diagnostics from the Host Connectivity Manager. 2. Run any diagnostic test. 3.
Beaconing 5 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 adapter side and the switch side. NOTE Port beaconing is not supported on the Brocade 804 mezzanine card. Configuring beaconing using HCM You can configure beaconing from an HBA port. 1. Select an HBA port from the device tree. 2.
5 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. bcu diag --sfpshow Refer to “diag” on page 137 for details about this command.
Debugging 5 Debugging The following debug commands capture 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. • portlogclear Clears the port’s frame log. • portlogctl Enables or disables the portlog. Refer to “debug” on page 135 for details about these commands. supportSave The supportSave command collects debug information needed from the driver.
5 supportSave 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, as follows: USER HOME\HCM\data\10.32.116.1\supportsave For example: C:\Users\Administrator\HCM\data\10.32.116.1\supportsave supportSave collection sources Table 14 lists the sources from which you can gather supportSave information.
supportSave 5 supportSave collection using HCM There are two ways to trigger a supportSave collection using the HCM GUI, explained in this section. You can also gather supportSave information for the adapter using the DCFM application. For information about supportSave using DCFM, refer to the Data Center Fabric Manager User Manual. 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.
5 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) or the Data Center Fabric Manager (DCFM). 1.
Appendix HCM Dialog Boxes A In this appendix • Authentication Statistics dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 • Backup dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 • Base Port Properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 • Change HCM Password dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A In this appendix • Virtual Port Deletion dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 • Virtual Port Properties panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 • Virtual Port Statistics dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Authentication Statistics dialog box A Authentication Statistics dialog box 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. Select an HBA port from the device tree. 2. Select Configure > FC_SP > Authentication Statistics from the Host Connectivity Manager. Fields and components Field Description Date The date the statistics were run.
A Authentication Statistics dialog box Using the dialog box Refer to the following topics for specific procedures using this dialog box: • • • • • 68 “Configuring security authentication using HCM (Host and HBA)” “Port Statistics dialog box” “Polling frequency rate” “Resetting statistics” “Performance monitoring” Brocade Adapters Administrator’s Guide 53-1001583-01
Backup dialog box A Backup dialog box 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. Fields and components Field Description Output Directory text box Enter the location of the directory in which you want to back up the data and configuration files. Browse button Click to browse to the location of the backup directory.
A Base Port Properties panel Base Port Properties panel The Base Port Properties panel enables you to display the properties that are associated with the base port. Opening the properties panel 1. From the device tree, select a base port. 2. In the right pane, click the Base Port Properties tab. Fields and components 70 Field Description Base Port Indicates whether the port is a base port (true or false). Fabric Name The name of the Fabric associated with the base port.
Change HCM Password dialog box A Change HCM Password dialog box 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 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.
A Change HCM Agent Password dialog box Change HCM Agent Password dialog box 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. Fields and components Field Description Host Name Displays the IP address of the host. User Name Type your user name. Old password Type your existing password. New password Type a new password.
Configure Names dialog box A Configure Names dialog box 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. Opening the dialog box 1. Select any device from the device tree. 2. Select Configure > Names from the Host Connectivity Manager.
A Configure Names dialog box Using the dialog box Refer to the following topics for specific procedures using this dialog box: • • • • • 74 “Name configuration” “Adding name entries” “Removing a name entry” “Exporting the properties for a WWN” “Importing the properties for a WWN” Brocade Adapters Administrator’s Guide 53-1001583-01
Define Name dialog box A Define Name dialog box The Define Name dialog box enables you to assign a name to an existing world wide name. Opening the dialog box 1. Right-click on an HBA or a port in the device tree. 2. Type a name that represents the adapter or port. NOTE The WWN and the Type are not editable. 3. Click OK to apply the change and close the window. The new component is added to the Name list. Fields and components Field Description WWN/MAC The world wide name for the device.
A Duplicated Names dialog box Duplicated Names dialog box The Duplicated Names dialog box enables you to display configured names that are redundant. Opening the dialog box The Duplicated Names dialog box displays when you import a file with a duplicate name. 1. Select Configure > Names from the Host Connectivity Manager. OR Right-click a device from the device tree and select Configure Names. The Configure Names dialog box displays. 2.
Event Properties dialog box A Event Properties dialog box The Event Properties dialog box displays the properties associated with a selected event from the Master Log. Opening the dialog box 1. Click the Master Log tab, located on the bottom pane of the Host Connectivity Manager. A master summary of events on all discovered devices is displayed. 2. Double-click an event. Fields and components Field Description Date/Time The date when the event occurred. Time The time when the event occurred.
A Fabric Statistics dialog box Fabric Statistics dialog box 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. Select Monitor > Statistics > Fabric Statistics from the Host Connectivity Manager. Fields and components Field Description Keep Running Data check box Click to continue running statistical data. This is useful if you want to see a trend.
FCP IM Statistics dialog box A FCP IM Statistics dialog box 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 > 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.
A FCP IM Statistics dialog box Field Description HAL TM Firmware Responses The number of hardware abstraction layer (HAL) task management firmware responses. HAL TM Successes The number of hardware abstraction layer (HAL) task management successes. HAL TM Failures The number of hardware abstraction layer (HAL) task management failures. HAL TM Related IO Cleanups The number of hardware abstraction layer (HAL) TM-related I/O cleanups.
FCP IM Module Statistics dialog box A FCP IM Module Statistics dialog box 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 > Statistics > FCP IM Module Statistics from the Host Connectivity Manager. OR Right-click a port from the device tree and select Statistics > FCP IM Module Statistics.
A FCP IM Module Statistics dialog box 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.
Fibre Channel Security Protocol Configuration dialog box A Fibre Channel Security Protocol Configuration dialog box The Fibre Channel Security Protocol Configuration dialog box enables you to define security authentication on selected ports. Opening the dialog box Select Configure > Authentication from the main menu, or perform the appropriate following step to open the security authentication dialog box: • From the host level, right-click the host and select Authentication from the list.
A Fibre Channel Security Protocol Configuration dialog box Field Description Group list The DHNULL (group 0) is the only option available in the list. Apply button Click to apply the FC-SP settings.
Hardware Tests Diagnostics dialog box A Hardware Tests Diagnostics dialog box The Port Tests diagnostics dialog box enables you to run tests on the port and to configure parameters such as link speed and frame count. Opening the dialog box 1. Select an HBA or HBA port from the device tree. 2. Select Configure > Diagnostics from the Host Connectivity Manager. 3. Click the Hardware Tests tab. Fields and components Field Description Memory Test check box Check to run a Memory test on the port.
A HBA Properties panel HBA Properties panel The HBA Properties panel enables you to display the properties that are associated with a selected 4 Gbps or 8 Gbps Brocade HBA or mezzanine card. Opening the properties panel 1. Select an HBA in the device tree. 2. Click the Properties tab in the right pane. Fields and components Field Description HBA Parameters Node WWN The adapter node’s world wide name. Name The name representing the adapter. Operating Status Whether the HBA is enabled or disabled.
HBA Properties panel Field Description Current # of Lanes The number of PCI lanes, in Gbps, each way between the PCI slot and the adapter. Initial Negotiated # of Lanes The set number of PCI lanes that were initially negotiated. PCIe Generation The number of times the PCI Register is generated. A OEM Vital Product Data (VPD) Information OEM The name of the original equipment manufacturer. Part # The OEM part number of the HBA.
A IOC Statistics dialog box IOC Statistics dialog box 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 from the device tree. 2. Select Monitor > Statistics > IOC Statistics from the Host Connectivity Manager. Fields and components 88 Field Description Keep Running Data check box Click to continue running statistical data. This is useful if you want to see a trend.
IOC Statistics dialog box A Field Description Firmware IO: data frames DMA’d by f/w The number of data frames dropped by the firmware. Firmware IO: frames dropped by f/w The number of times the firmware dropped frames. Firmware IO: FCP data frames lost The number of FCP data frames lost. Firmware IO: RO set in xfr_rdy The number of RO set in xfr_rdy events on the firmware IO. Firmware IO: xfer_rdy_000 error The number of xfer_rdy_000 errors on the firmware IO.
A 90 IOC Statistics dialog box Field Description Firmware IO: IOH RO OOO event The number of IOH RO events that are out of range during firmware IO. Firmware IO: IOH CPU owned event The number of CPU-owned events during firmware IO. Firmware IO: IOH unex frame event The number of unexpected frames on the firmware IO. Firmware IO: IOH Error Interrupt The number of interrupted errors on the firmware IO. Firmware Port: Port FPG Interrupt The number of firmware port FPG interrupts.
IOC Statistics dialog box A Field Description Firmware Port PHYSM Module Invalid Events The number of invalid events in the Physical Port State Machine (PHYSM). Firmware Port: FPG Unknown Primitives The number of unknown primitive events on the firmware port. Firmware Port: PHYSM Module Validation Ignored The number of times Physical Port State Machine (PHYSM) module validation was ignored.
A IOC Statistics dialog box Field Description Firmware Port LKSM: LR TX Started The number of Link Reset (LR) transmissions started on the firmware port. Firmware Port LKSM: LRR TX Started The number of Link Reset Responsive (LRR) transmits started on the firmware port.. Firmware Port LKSM: NOS TX Started The number of Not Operational transmissions that were started. Firmware Port LKSM: OLS TX Started The number of Offline Sequence (OLS) transmits started on the firmware port.
Logical Port Statistics dialog box A Logical Port Statistics dialog box 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 OR Right-click a logical port (LPORT) from the device tree and select Logical Port Statistics. Fields and components NS Field Description Date The date and time of the most recent reset.
A Logical Port Statistics dialog box Field Description ns_rftid_alloc_wait The number of delayed Name Server Register FC4 Type identifier allocations. ns_gidft_sent The number of times a Name Server Get all Port ID request for a given FC4 type is sent. ns_gidft_accepts The number of times a Name Server Get all Port ID request for a given FC4 type is accepted. ns_gidft_rsp_err The number of response errors associated with a Name Server Get all Port ID request for a given FC4 type.
LPORT Properties panel A LPORT Properties panel 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. Click the LPORTs Properties tab in the right pane. Fields and components Field Description Base Port Indicates whether the logical port is used as the base port. FC Address The Fibre Channel address of the logical port. Node WWN The adapter’s world wide name.
A Master Log tab Master Log tab 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. Fields and components Field Description Filter button Click to launch the Master Log Filter dialog box. Sr No column Displays a numbering sequence in ascending order.
Master Log Filter dialog box A Master Log Filter dialog box The Master Log Filter dialog box enables you to filter the events you receive by time, severity, category, or world wide name. Opening the dialog box 1. Select the Master Log tab, located at the bottom pane of the Host Connectivity Manager, 2. Click the Filter button. Fields and components Field Description Event Time Type in a From and To value to represent the time during which events will be logged.
A Persistent Binding dialog box 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. You can view the Persistent Binding dialog box at the host level, the adapter level, or the port level. Opening the dialog box 1. Select a device that supports persistent binding from the device tree. Devices that support persistent binding include the local host, the adapter, and the port. 2.
Port Properties panel A Port Properties panel The Port Properties panel enables you to display the properties that are associated with a selected HBA port. Opening the properties panel 1. Select a port in the device tree. 2. Click the Properties tab in the right pane. Fields and components Field Description Port Parameters Port # The port number: 0 or 1. Port WWN The port’s world wide name. Node WWN The adapter’s world wide name. Factory Port WWN The factory-assigned port world wide name.
A Port Properties panel Field Description Frame Data Field Size The frame size, in byres, of the port. The default is 2112. Select auto to set the frame data field size automatically. # of Lports The number of logical ports in the configuration. Port Log Indicates whether port logging is enabled or disabled. Operating Parameters Path Time Out The value between 0 and 60 that specifies the time out session. The default value is 30. Logging Level The port logging level.
Port Statistics dialog box A Port Statistics dialog box The Port Statistics dialog box enables you to monitor the performance of the adapter and the traffic between the adapter and the LUNs. You can use the information to isolate and troubleshoot areas that affect application performance. Opening the dialog box Select Monitor > Statistics > Port Statistics from the Host Connectivity Manager.
A Port Statistics dialog box Field Description Rx CRC err frames The number of frames that have been received in error. Rx CRC err good EOF frames The number of received frames with good end of frames (EOF)s. Rx undersized frames The number of undersized received frames. Rx oversized frames The number of oversized received frames. Rx frames with bad EOF The number of received frames with end of frame (EOF) errors. Errored frames The number of frames received in error.
Protocol Tests dialog box A Protocol Tests dialog box 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. Click the FC Protocol Tests tab. Fields and components Field Description Echo Test check box Check to run an Echo Test on the selected port. FC Ping Test check box Check to run an FC Ping Test on the selected port.
A QoS Statistics dialog box QoS Statistics dialog box 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 Date The date and time of the most recent reset. QoS Flogi sent The number of QoS Fabric login (Flogi) requests sent. QoS Flogi Acc received The number of QoS Fabric login (Flogi) accept requests received.
Remote Port Properties panel A Remote Port Properties panel The Remote Port Properties panel enables you to display the properties that are associated with the remote port. Opening the properties panel 1. From the device tree, select a remote port (target or initiator). 2. Click the Remote Port Properties tab in the right pane. NOTE If it is a target port, there are two tabs in the right pane: Properties and LUNs.
A Restore dialog box Restore dialog box You can use the Restore Data dialog box to restore data that has been previously backed up. The Host Connectivity Manager (HCM) stores the location and version details of the most recently-taken backed up data and automatically points to the location of the data. NOTE Use HCM 2.1 or later to restore backed up data. HCM 2.0 and earlier versions do not support the Restore Data feature.
SFP Properties panel A SFP Properties panel The SFP Properties panel enables you to display the properties that are associated with a selected small form-factor pluggable (SFP) transceiver. NOTE Brocade 804 mezzanine cards connect to the embedded switch modules or embedded interconnect modules on the Blade System chassis by way of an internal backplane and therefore, no optical modules (SFPs) are involved.
A 108 SFP Properties panel Field Description Length Cu The length of the copper cable (for distances greater than 1 meter, where optimum performance is required). Vendor Name The vendor of the extended link. Vendor OUI The vendor’s 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.
Syslog Server Configuration dialog box A Syslog Server Configuration dialog box 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. Opening the dialog box 1. Select the host from the device tree. 2. Select Configure > Syslog from the main menu.
A Target Statistics dialog box Target Statistics dialog box The Target Statistics dialog box enables you to display statistical information for a selected remote port (R_Port). Opening the dialog box Select Monitor > Statistics > Remote port statistics > Target Statistics from the Host Connectivity Manager. OR Right-click a remote port and select Target Statistics. Fields and components 110 Field Description Date The date and time of the most recent reset.
Target Statistics dialog box Field Description LOGO received The number of times logouts are received. RPSC received The number of Report Port Speed Capabilities (RPSC) requests received. RPSC rejects The number of Report Port Speed Capabilities (RPSC) requests rejected. RPSC sent The number of Report Port Speed Capabilities (RPSC) requests sent. RPSC accepts The number of Report Port Speed Capabilities (RPSC) requests accepted.
A 112 Target Statistics dialog box Field Description fw delete: IOC down events The number of hardware abstraction layer (HAL) fw Delete IOC down events. fw delete: exception events The number of hardware abstraction layer (HAL) fw Delete Exception events. offline: delete events The number of hardware abstraction layer (HAL) Offline Delete events. offline: online events The number of hardware abstraction layer (HAL) Offline Online events.
Target Statistics dialog box A Using the dialog box Refer to the following topics for specific procedures using this dialog box: • • • • “Port Statistics dialog box” “Polling frequency rate” “Resetting statistics” “Performance monitoring” Brocade Adapters Administrator’s Guide 53-1001583-01 113
A Test Log Details dialog box Test Log Details dialog box The Test Log Details dialog box enables you to view details about a selected port or protocol test. Opening the dialog box 1. Select Configure > Diagnostics from the Host Connectivity Manager. 2. Run any diagnostic test. 3. Select and double-click a row of the test results in the bottom pane. Fields and components Field Description Time The date and time the test was run. Test The name of the test.
Virtual Port Creation dialog box A Virtual Port Creation dialog box The Virtual Port Creation dialog box enables you to create a new virtual port from a physical port. Opening the dialog box 1. Select a physical port from the device tree. 2. Select Configure > Virtual Port > Create from the main menu. OR Right-click the physical port and select Virtual Port > Create from the list. Fields and components Field Description Physical Port WWN Displays the world wide name for the physical port.
A Virtual Port Deletion dialog box Virtual Port Deletion dialog box The Virtual Port Deletion dialog box enables you to delete an existing virtual port. Opening the dialog box 1. Select a virtual port from the device tree. 2. Select Configure > Virtual Port > Delete from the main menu. OR Right-click the virtual port and select Virtual Port > Delete from the list. A warning message displays, asking for confirmation. 3. Click OK to continue. NOTE You cannot delete the base port.
Virtual Port Properties panel A Virtual Port Properties panel The Virtual Port Properties panel enables you to display the properties that are associated with a virtual port. Opening the properties panel Select a virtual port from the device tree and click the Properties tab. Fields and components Field Description Port WWN The port’s world wide name. Node WWN The adapter’s world wide name. Fabric Name The name of the Fabric associated with the virtual port.
A Virtual Port Statistics dialog box Virtual Port Statistics dialog box The Virtual Port Statistics dialog box enables you to view statistical information related to a selected virtual port. Opening the dialog box 1. Select a virtual port from the device tree. 2. Select Monitor > Statistics > Virtual Port Statistics from the Host Connectivity Manager. Fields and components 118 Field Description Keep Running Data check box Click to continue running statistical data.
Virtual Port Statistics dialog box A Using the dialog box Refer to the following topics for specific procedures using this dialog box: • • • • “Port Statistics dialog box” “Polling frequency rate” “Resetting statistics” “Performance monitoring” Brocade Adapters Administrator’s Guide 53-1001583-01 119
A 120 Virtual Port Statistics dialog box Brocade Adapters Administrator’s Guide 53-1001583-01
Appendix B Brocade Command Utility In this appendix • adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • auth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • bios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B 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 • Shell mode, accessed using the bcu shell; for example, bcu> port --topology . - To access the shell mode, type bcu shell. To exit out of shell mode, type exit.
BCU commands --statsclr --query --enable [-s speed] [-o auto|flash|firstlun] [-p pos] {-b pwwn,lun}* --disable --blunZone -c -p -r -l --update [adapter_id] [-a] --portlog --portlogclear --portlogctl B BIOS commands bcu bios Boot commands bcu boot Debug commands bcu debug Diagnostic commands Note: The sfpshow and beacon diagnostic tests are
B BCU commands bcu fcpim --query rpwwn [-l ] --stats ] --statsclr
BCU commands --dfsize B [dfsize] Target persistent binding commands Note: Target persistent binding is available in Windows operating systems only.
B adapter adapter Displays and sets adapter parameters. The adapters are HBA models 415, 425, 804, 815, and 825. NOTE When trunking is enabled, multiple physical ports are trunked together to form a logical Fibre Channel port. Synopsis bcu adapter --enable bcu adapter --disable bcu adapter --list bcu adapter --name bcu adapter --query Description Operands Displays and sets commands that apply to the physical adapter.
adapter Example B bcu adapter --list AD # NP HW-path Type Model-Info Serial-num Name 1 2 0000:01:00 FC Brocade-825 ALX0301D062 - - 2 2 0000:09:00 FC Brocade-825 ALX0411D01K - - bcu adapter --query 1 Example:# bcu adapter --query 1 Adapter Information: card type - FC model info: Brocade-825 OEM info: N/A num ports: 2 max speed: 8 Gbps chip revision: Rev-B hw path: 16:00 Serial Num: ALX0301D062 name: PCI Information: vendor id: 0x1657 device id: 0x0013 ssid: 0x0014 ssvid: 0x1657 PCIe Ge
B auth auth Enables authentication configuration on a per-port basis and the ability to display authentication status and statistics. Synopsis bcu auth --algo bcu auth --policy {on|off} bcu auth --reinit bcu auth --secret “secret_string” bcu auth --show bcu auth --stats bcu auth --statsclr Description Operands Configure and display authentication settings and status. --algo port_id Sets the authentication algorithm.
auth secret string --show Specifies the secret string. The maximum length of the secret is 63 bytes. The default secret for each interface is its pwwn without the colons; for example, 0102030405060708. Displays the authentication settings and current status. 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.
B 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 130 None Brocade Adapters Administrator’s Guide 53-1001583-01
bios B 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 Adapters Installation and Reference Manual for more information about configuring BIOS.
B 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 port using the storage system’s management or configuration utility. --disable port_id Example Disables boot over SAN for the specified port, if enabled.
boot B boot Allows the host’s boot LUN information to be stored in the fabric zone database using a zone name containing the PWWN of an adapter port and zone members consisting of the storage target PWWN and LUN WWN. The adapter boot code can query the zone member list for the zone name that matches the adapter PWWN to determine the boot target and LUN. NOTE A system reboot is required for the newly-updated image to be effective. Fabric OS 6.
B boot Example bcu boot --blunZone -c BLUN -p 10:00:00:05:1e:41:9a:cb -r 50:00:00:05:1e:41:9a:ca -l 09AABBCCDDEEFF00 To create the zone, copy the following line and run this command from the switch command line.
debug B debug The debug commands gather support information on Fibre Channel components. Synopsis bcu debug --portlog bcu debug --portlogclear bcu debug --portlogctl Description Operands 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.
B debug Time Module Event Len Log info --------------------------------------------------------------------------13fe083a Driver drvstrt 0 Driver Attach 14471130 HAL pstchg 0 Port Linkup 1447135f FCXP Tx 140 01290000,00000000,00080000,03000000 14471361 FCXP Tx 32 01290000,00000000,00080000,62000000 14471498 FCXP Rx 116 01980000,6c000000,051e7609,02000000 1447149c FCXP Tx 301 20290000,00000000,00080000,01000000 1447150d FCXP Rx 4 01980000,6d000000,051e7609,02000000 1447190e FCXP Rx 16 20980000,6e000000,051
diag B diag Lists the non-destructive group of diagnostic commands. The port can be identified using the adapter index, the port index, the port name, or the port world wide name. NOTE The sfpshow and beacon diag commands are not supported on the Brocade 804 mezzanine card.
B diag --pciloopback Checks the communications path between the host and the IO Controller (IOC). port_id Specifies the ID of the port for which you want to send a health check message. -p pattern Displays the data pattern. -c frame_count Specifies the frame count. --loopback port_id Tests the data path from the IOC to the desired network loopback point (internal, serdes, external) and back. This is an offline diagnostic test. Specifies the ID of the port on which you want to run a loopback test.
drvconf B drvconf Sets the basic parameters for the driver to function properly. Note: The drvconf commands are supported on Windows platforms only. Synopsis Description bcu --drvconf [-key ] [--val ] 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. Operands --key key_name The name of the bfa key.
B fabric fabric Prints and resets Fabric statistics. Synopsis bcu fabric --stats bcu fabric --statsclr Description Operands Displays or clears Fabric statistics. --stats port_id --statsclr port_id 140 Prints the fabric statistics. Specifies the ID of the fabric port for which you will print the statistics. Resets the fabric statistics. Specifies the ID of the fabric port for which you will reset the statistics.
fcdiag B fcdiag Runs diagnostic tests on Fibre Channel components. NOTE The fcdiag --linkbeacon command is not supported on the Brocade 804 HBA. Synopsis bcu fcdiag --fcping [-l lpwwn] bcu fcdiag --fctraceroute [-l lpwwn] bcu fcdiag --fcecho [-l lpwwn] bcu fcdiag --linkbeacon {on|off} bcu fcdiag --scsitest [-l lpwwn] Description Operands Fibre Channel diagnostic tests evaluate the integrity of Fibre Channel components.
B fcdiag --scsitest Example Tests the SCSI components. port_id Specifies the ID of the port for which you want to run the scsitest command. rpwwn Specifies the remote port world wide name. -l lpwwn Specifies the logical port world wide name. This is an optional argument. The base port is specified as 0; otherwise, the port is a virtual port.
fcpim B fcpim Enables or disables fast failover of initiator mode I/O. The default setting is off. Synopsis bcu fcpim --stats [-l ] bcu fcpim --statclr [-l ] bcu fcpim --pathtov bcu fcpim --query rpwwn [-l ] bcu fcpim --modstats bcu fcipim --modstatsclr Description Operands Enables or disables fast failover of the Fibre Channel Port (FCP) initiator mode I/O and displays or clears statistics.
B fcpim --modstatsclr port_id Example Clears statistics related to the Fibre Channel port initiator mode. Specifies the ID of the module for which you want to clear statistical information.
ioc B ioc Enables or disables the I/O Controller (IOC), which refers to the combination of port and the firmware controlling it. The port can be identified using the adapter index, the port index, the port world wide name or the port name.
B ioc -Delay Example 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. The default delay value is 25 for an HBA.
log B 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 [] [-m ] 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.
B lport lport Lists the logical port (lport) commands. Synopsis bcu lport --list bcu lport --query [-l lpwwn] bcu lport --stats [-l lpwwn] bcu lport --statsclr [-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.
lport B # 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: fcpim ipfc # bcu lport --query hba5_port0 - 1 01:bb:cc:dd:ee:ff:00:01 State: Online FC address: 0c0101 Port wwn: 01:bb:cc:dd:ee:ff:00:01 Node wwn: 01:bb:cc:dd:ee:ff:00:00 # bcu lport --statsclr hba5_port0 lport stats cleared The following are examples of a Brocade 1020 expansion card versus a Brocade 825 adapter: 1020 bcu lport --query [root
B 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 [] bcu pbind --clear Description Queries the list of mappings or clears existing persistent binding settings. NOTE The pbind command is only supported on the Windows platform. Operands --list Queries the list of mappings from the persistent binding module.
port B port Lists the port commands (the physical ports on the adaoter). The port can be identified by the adapter index, the port index, the port name, or the port world wide name. NOTE 1 Gbps speed is not valid for an 8 Gbps HBA; 4 Gbps speed is not valid for a 4 Gbps HBA.
B port --disable port_id --stats port_id --statsclr port_id --query port_id --speed port_id 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. Specifies the ID of the port you want to disable. Displays the physical port-level statistics.
port Example B # bcu port --list -----------------------------------------------------------------------Port# Type PWWN/MAC FC Addr/ Media State Spd Eth dev -----------------------------------------------------------------------1/0 fc 10:00:00:05:1e:ae:e3:a4 dd0500 mz Linkup 4G 1/1 fc 10:00:00:05:1e:ae:e3:a5 dd0500 mz Linkup 8G 1/1 fc 10:00:00:05:1e:ae:e3:a6 -- mz Disabled -1/1 fc 10:00:00:05:1e:ae:e3:a7 -- mz Disabled ------------------------------------------------------------------------# bcu port --n
B port # bcu port --query 1/0 port id: 1/0 port type: FC port instance: 0 port name: Media: mz pwwn: 10:00:00:05:1e:ae:e3:a4 nwwn: 20:00:00:05:1e:ae:e3:a4 Factory pwwn: 10:00:00:05:1e:ae:e3:a4 Factory nwwn: 20:00:00:05:1e:ae:e3:a4 state: Disabled Speed: current: 4G configured: Auto Topology: current: P2P configured: P2P SNIA port type: N supported classes: Class-3 symbolic name: Brocade-804 | 2.1.0.
qos B qos 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. By default, all flows are marked as medium.
B ratelim ratelim Enables or disables target rate limiting support on the HBA side. Synopsis bcu ratelim --enable bcu ratelim --disable bcu ratelim --query bcu ratelim --defspeed [<1|2|4>] Description The target rate limiting feature is used to minimize congestion at the HBA port due to a slow drain device operating in the fabric at a slower speed. A remote port’s operating speed is determined from the fabric.
rport B 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 [-l ] bcu rport --osname [-l ] bcu rport --query [-l ] bcu rport --stats [-l ] bcu rport --statsclr [-l ] Description Operands Lists all the remote ports (rports) under a given port ID.
B rport Example bcu rport --list 2/0 --------------------------------------------------------------------------FC Addr Remote Port PWWN QOS-P/F SPD State F df_sz --------------------------------------------------------------------------01fd01 50:00:1f:e1:50:10:09:48 U/0 --online T 2048 01f701 50:06:01:60:41:e0:68:c0 U/0 --online T 2048 01f202 50:06:0e:80:03:75:5e:05 U/0 --online T 2048 01f002 20:02:00:0e:11:10:fc:25 U/0 --online T 2048 01ff01 50:05:07:63:0e:04:12:ef U/0 --online T 2048 01fe01 50:06:01:60
rport RPSC rejected: B 0 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: e
B vport vport Lists the commands that apply to a virtual port. Synopsis bcu vport --create [-n ] [-s ] bcu vport --delete bcu vport --query bcu vport --stats bcu vport --statsclr Description The vport commands enable you to create and delete vports and display statistics about them. NOTE The vport commands are not supported on Solaris platforms.
vport --statsclr Example B 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. The V_Port WWN is a required argument.
B 162 vport Brocade Adapters Administrator’s Guide 53-1001583-01
Appendix HCM Troubleshooting C In this appendix 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.
C In this appendix HCM does not restrict duplicate WWNs if BCU is used to create V_Ports Problem Workaround The HCM GUI should post an error message for duplicate V_Ports (detected in the Vports.db file) and prompt the user to remove the duplicate when it detects duplicate world wide names (WWNs), but it does not. The HCM does not restrict duplicate WWNs when the BCU is used to create V_Ports. Do not use the BCU for virtual port management, because it does not handle duplicate V_Port world wide names.
DRAFT: BROCADE CONFIDENTIAL Appendix Glossary and Acronyms D Available BB_Credit A value used by a transmitter to determine permission to transmit frames and, if so, how many. The transmitter may transmit a frame when the available BB_Credit is greater than zero. Available_receive_buffers The current number of buffers in a receiving port that are available for receiving frames at link rate. Bandwidth The maximum information-carrying capacity of a system. Baud The encoded bit rate per second.
DRAFT: BROCADE CONFIDENTIAL D Glossary and Acronyms LLDP Link Layer Discovery Protocol. Lossless Ethernet MAC A full duplex Ethernet MAC supporting at least 2.5KB jumbo frames and implementing extensions to avoid Ethernet frame loss resulting from congestion. 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. MAC Media Access Control.
DRAFT: BROCADE CONFIDENTIAL Glossary and Acronyms D Topology An interconnection scheme that allows multiple Fibre Channel ports to communicate. For example, point-to-point and arbitrated loop are Fibre Channel topologies. VF Virtual Fabric. VLAN Virtual Local Area Network. 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.
DRAFT: BROCADE CONFIDENTIAL D 168 Glossary and Acronyms Brocade Adapters Administrator’s Guide 53-1001587-01
Index A adapter command, 126 advanced port configuration options, 35 application log, 50 auth command, 128 Authentication Configuration dialog box, 83 authentication, security, 19 configuring HCM logging level, 34 NPIV, 44 persistent binding, 24 port speed, 22 QoS using the BCU, 25 queue depth, 31 rate limiting using the CLI, 26 security authentication using the GUI, 17 B D base port properties panel, 70 beaconing configuring using the BCU, 59 configuring using the GUI, 59 boot groups, 28 boot over SAN
F fabric command, 140 fcdiag command, 141 fcpim command, 143 filtering event log entries, 49 frame data field size specifying using the BCU, 23 H HBA Properties panel, 86 HCM authentication, 6, 7 change password dialog box, 71 logging level configuration, 34 main window, 12 master log icons, 14 product icons, 13 software overview, 2 statistics monitoring, 2 host management, remote, 2 I IOC command, 145 L launching HCM on Linux, 6 on Windows, 5 Linux, launching HCM, 6 log application, 50 master log, 48 te
port-level test how to run using the GUI, 55 portlog command, 61 portlogclear command, 61 portlogct command, 61 properties importing in EFCM format, 42 importing in FM format, 42 Protocol Tests diagnostics dialog box, 103 T test log details, 58 Test Log Details dialog box, 114 tree node pop-up menus, 3 V Q VMware ESX 3.5 and 4.
172 Brocade Adapters Administrator’s Guide 53-1001583-01