Emulex HBA Manager Application for Windows

Release Notes

Broadcom HBAManager-Win-RN1404-101

July 12, 2022

Purpose and Contact Information

These release notes describe the new features, resolved issues, known issues, and technical tips associated with this

release of the Emulex

HBA Manager application for Windows.

For the latest product source files and documentation, and for supported driver versions, go to www.broadcom.com. If you

have questions or require additional information, contact an authorized Broadcom

Technical Support representative at

ecd-tech.support@broadcom.com.

NOTE: For support on LPe16000-series and LPe12000-series adapters, use release 12.8 software.

New Features

1. Support for congestion management commands is added to the Emulex HBA Manager CLI. See Technical Tips, Item 1,

in these release notes for detailed information.

NOTE: The Emulex SAN Manager application is an easy-to-use solution that dramatically reduces the operational cost

and complexity of running a Fibre Channel SAN. It adds the following benefits: visibility into the endpoints of the

fabric, centralized in-band access to managed HBAs, and automatic identification and mitigation of application

performance problems.

The Emulex SAN Manager application provides graphical views of fabric congestion events.

Further details are available at the following URL:

www.broadcom.com/products/storage/fibre-channel-host-bus-adapters/emulex-san-manager

2. The default management mode is changed to Strictly Local Management.

3. The port statistics counter can now count to more than 4.3 TB of data.

Resolved Issues

No issues were resolved in these releases.

Emulex

HBA Manager Application for

Windows

Releases 14.0.505.25-1 and 14.0.505.9-2

Broadcom HBAManager-Win-RN1404-101

Emulex HBA Manager Application for Windows Release Notes Releases 14.0.505.25-1 and 14.0.505.9-2

Known Issues

1. For an NVMe port, do not use the Emulex HBA Manager CLI utility to discover the host remotely. Otherwise, the port

type is displayed as FC instead of FC+NVMe.

Workaround

Use local management instead of remote management on NVMe ports.

2. The Emulex HBA Manager GUI does not display an added ESXi host with a password that begins with a # character.

Workaround

Modify the password on the ESXi host to begin with a different character, and then add the host with the new credentials

to the Emulex HBA Manager application.

3. If the Emulex HBA Manager application is updated from release 12.6.x to release 14.0.326.13 or later, existing CIM hosts

are no longer discovered.

Workaround

Remove the existing CIM hosts before updating the Emulex HBA Manager application, and then add them back after the

application is updated.

4. When the Emulex HBA Manager application is run on a Windows host, batch parameter update errors are not added to

the batch log.

Workaround

None.

5. If hbacmd is used to set a hash priority to a single value on an HBA port, ensure that the same hash priority value is set

on the switch. A difference between the hash priority values causes an authentication failure.

Technical Tips

1. To support congestion management, the following commands have been added to the Emulex HBA Manager CLI:

–The SetCongestParams command sets the congestion mode for a specific port.

HbaCmd SetCongestParams <WWPN> <Param> <Value>

where:

WWPN = the World Wide Port Name of the port for which you are setting the congestion mode

Param = the name of the congestion parameter whose value is to be set; cgn-mode is the only available parameter

at this time

Value = the value for the specified parameter with the following options:

 0 = Off

 1 = Tier 1: Minimally impact port performance to limit congestion

 2 = Tier 2: Moderately impact port performance to balance congestion

 3 = Tier 3: Aggressively impact port performance to relieve congestion

 4 = Monitor only

– The GetCongestParams command displays the congestion mode for a specific port.

HbaCmd GetCongestParams <WWPN>

where:

WWPN = the World Wide Port Name of the port for which you want to view the congestion mode.

Broadcom HBAManager-Win-RN1404-101

Emulex HBA Manager Application for Windows Release Notes Releases 14.0.505.25-1 and 14.0.505.9-2

–The GetCongestStats command provides congestion statistics for a specific port. It also allows you to reset the

congestion counters.

HbaCmd GetCongestStats <WWPN> [reset]

where:

WWPN = the World Wide Port Name of the port for which you want to view the congestion mode.

For more information, refer to the Emulex HBA Manager CLI help command for the parameter.

2. If the Emulex HBA Manager GUI is open when you disable Emulex HBA ports from the Device Manager, a system reboot

is required.

Workaround

Close the Emulex HBA Manager GUI before disabling the ports.

3. The Emulex HBA Manager application CLI commands might fail in Windows PowerShell.

The Emulex HBA Manager CLI commands with parameters that contain embedded commas, such as

SetDCBPriority, fail execution in Windows PowerShell.

Workaround

Enclose embedded commas in quotation marks. For example, the following command:

hbacmd SetDCBPriority 10:00:00:00:c9:3c:f7:88 3 0,1,2,4,5,6,7 3 0 0 0 0 0 0

must be formatted as follows to run successfully in Windows PowerShell:

hbacmd SetDCBPriority 10:00:00:00:c9:3c:f7:88 3 “0,1,2,4,5,6,7” 3 0 0 0 0 0 0

4. If the CLI (hbacmd) is used to perform a firmware download to a local adapter and the Emulex HBA Manager GUI is

running while the firmware download is occurring, the Emulex HBA Manager GUI might experience problems displaying

information on various window tabs after the download is completed. The value displayed for most of the fields on the

affected tabs or dialogs is N/A.

Workaround

Perform one of the following procedures:

– When a firmware download has been performed using the Emulex HBA Manager CLI, if N/A is shown for most of the

Emulex HBA Manager GUI display fields, exit the GUI, and then restart it. The fields are displayed correctly.

– Ensure that the Emulex HBA Manager GUI is stopped or is not running prior to performing a firmware download

using the Emulex HBA Manager CLI.

– Perform the firmware download using the Emulex HBA Manager GUI instead of the CLI.

5. The Emulex HBA Manager application does not display the OS device name for LUNs attached to vPorts.

In the LUN Information tab, under Mapping Information, the OS Device Name field displays N/A instead of the device

name. All other information on the LUN Information tab is displayed correctly.

6. When you install the Emulex HBA Manager application on a guest operating system, answers to the installer prompts

are ignored.

When you install the Emulex HBA Manager application on a guest operating system, you are presented with

management mode options (local only, full-management, read-only, and so on). Answers to these questions are ignored;

all installations on guest operating systems are set to local only, read-only, and remote management.

7. When you manage a host using the CIM interface and you initiate a batch download process, all of the adapters of the

CIM-managed host are displayed because the required validation logic is not available in the CIM provider.

Workaround

Manually deselect the adapters that you do not want included in the batch download before starting the download. If you

start the download without deselecting the nonmatching adapters, the firmware download is initiated and results in an

error for nonmatching adapters.

Broadcom HBAManager-Win-RN1404-101

Emulex HBA Manager Application for Windows Release Notes Releases 14.0.505.25-1 and 14.0.505.9-2

8. On an ESXi host, when FA-PWWN is enabled or disabled and an adapter port is reset using the esxcli elxmgmt

plug-in, operations performed on the adapter using the Emulex HBA Manager application might not work as expected.

Workaround

To discover the adapter ports with the new WWPN, restart the Small Footprint CIM Broker (SFCB) on the ESXi host and

refresh the Emulex HBA Manager application.

9. The 32-bit or 64-bit libcurl file is required and must be copied to the Windows system when downloading firmware

using HTTP or HTTPS services with the Windows Management Instrumentation (WMI) CIM Studio tool.

10. To manage a remote ESXi 6.5 host using the Emulex HBA Manager application, set the configuration parameter

enableSSLv3 to true in the SFCB configuration file (/etc/sfcb/sfcb.cfg). By default, this parameter is not present

in the configuration.

To add or update the enableSSLv3 parameter, perform these steps:

a. Stop the sfcb-watchdog application by typing the following command:

etc/init.d/sfcbd-watchdog stop

b. Add or update the following lines in the /etc/sfcb/sfcb.cfg file:

enableSSLv3: true

sslCipherList: HIGH

c. Start the sfcb-watchdog application by typing the following command:

etc/init.d/sfcbd-watchdog start

11. When managing adapters on ESXi hosts using the Emulex HBA Manager application on Windows, if a nonroot user is

used, the CIMOM might reject the request and return no data. This situation could happen even if the nonroot user has

root privileges.

Workaround

Specify a root user name when executing commands using hbacmd or when adding the host to the Emulex HBA

Manager application GUI.

12. Enabling and disabling an FA-PWWN might cause an adapter port’s WWPN to change. The Emulex HBA Manager

application discovery-tree might not display the port's newly assigned WWPN.

Workaround

Stop and restart the Emulex HBA Manager application services and daemons when prompted by the Emulex HBA

Manager application.

13. Windows driver parameters do not persist after a reboot if they are set with FA-PWWN enabled.

Workaround

a. Disable FA-PWWN, reset the port, and change the port’s WWPN using the Emulex HBA Manager application GUI.

b. Enable FA-PWWN and reboot the system.

c. Verify that the correct WWPN is used.

Broadcom HBAManager-Win-RN1404-101

Emulex HBA Manager Application for Windows Release Notes Releases 14.0.505.25-1 and 14.0.505.9-2

14. Using the Brocade

portdporttest command with the stop option causes the HBA to stop responding when running

D_Port from the switch. Disabling a port while running D_Port tests from the switch can cause the switch port to get stuck

in D_Port mode.

Workaround

Do not stop D_Port tests while they are running from the switch. Do not disable a port while D_Port tests are running

from the switch.

If the HBA stops responding, remove the D_Port configuration from the switch port using the following commands. Refer

to the Brocade switch documentation for more information.

portdisable <portnumber>

portcfgdport --disable <portnumber>

portenable <portnumber>

If the switch port is stuck in D_Port mode, use the portdporttest --exit command to clear the configuration.

15. When using the Emulex HBA Manager application CLI for Windows on remote ESXi hosts, the CLI does not immediately

display changes to the enable-auth driver parameter.

Workaround

Set the enable-auth driver parameter on the remote ESXi host using the L option instead of the G option to display

the changes immediately.

16. Enabling ExpressLane™ on LUNs assigned to vPorts with nonzero LUN IDs results in an error.

Workaround

None.

more information, go to www.broadcom.com. All trademarks, trade names, service marks, and logos referenced herein

belong to their respective companies.

Broadcom reserves the right to make changes without further notice to any products or data herein to improve reliability,

function, or design. Information furnished by Broadcom is believed to be accurate and reliable. However, Broadcom does

not assume any liability arising out of the application or use of this information, nor the application or use of any product or

circuit described herein, neither does it convey any license under its patent rights nor the rights of others.