Case 1

Collecting HBA Timeout Parameters

1. Run the esxcli storage core adapter list command to query the HBA model. The first figure in the following indicates an Emulex HBA while the second figure indicates a Qlogic HBA. The drive is qla2xxx.
   Figure 1 An Emulex HBA
   
   Figure 2 A Qlogic HBA
   

2. Obtain the WWPN, HBAName and HBADriver of every HBA whose Link State is link-up. (Obtain drivers started with lpfc and ql only). For example, WWPN: 10000090fa92bbe4, HBAName: vmhba5, HBADriver: lpfc.
   NOTE:

   • The WWPN is obtained from the UID, namely, the character string after the semicolon.
   • The LPe16000 in Description is not the real HBA model and cannot be used as reference here.

3. When a VMware operating system is used, HBAs are centrally managed by drivers, namely, the timeout settings of all the HBAs managed by the same driver are the same. Therefore, obtain the timeout settings of all the drivers queried in step 2.
   • If a driver manages Emulex HBAs, run the esxcli system module parameters list -m Driver | grep lpfc_devloss_tmo command to obtain the timeout setting.

   

   • If a driver manages Qlogic HBAs, run the esxcli system module parameters list -m Driver | grep qlport_down_retry command to obtain the timeout setting.

   

   NOTE:

   In the command output, if int is followed by blank, the default value 10 is used. The value range is 1 to 255 in the unit of seconds.

Error When Querying HBA Timeout Settings

If the timeout setting of an HBA does not pass the check (greater than 10), the error information is as follows:

(WWPN：10000090fa92bbe4, HBAName: vmhba3, HBADriver: lpfc)(Timeout：15);

(WWPN：2101001b32bea02e，HBAName: vmhba4, HBADriver: qlnativefc)(Timeout：15);

Modifying HBA Timeout Settings

NOTE:

The following timeout parameter is modified, and this case is illustrated with a recommended value of 10s. Before actual modification, please determine the modified value according to the business characteristics.

1. For an Emulex HBA:

   Run the esxcli system module parameters set -p "lpfc_devloss_tmo=X" -m Drivercommand to modify the HBA timeout setting. In the command, X indicates the timeout value and Driverthe driver type. In the following example, the timeout parameter is set to 10s.

2. For a Qlogic HBA:

   Run the esxcli system module parameters set -p "qlport_down_retry=X" -m Drivercommand to modify the HBA timeout setting. In the command, X indicates the timeout value and Driverthe driver type. In the following example, the timeout parameter is set to 10s.

Verifying the Modification of HBA Timeout Settings

CAUTION:

• Before restarting the system, confirm with the customer that the restart will not affect services.
• For Emulex and Qlogic HBAs, the command of modifying the timeout parameter is effective for the HBA ports of all the drivers of the same type. When multiple HBAs are used and managed by drivers of the same type, you only need to execute the command once to modify the timeout settings of all the ports. Restart the system after modifying the timeout settings.

Enter reboot to restart the system and make the modification take effect.

After the reboot completes, see Collecting HBA Timeout Parameters to verify if the modification takes effect.

Recommended Actions

If you have any questions or any other exceptions exist, contact Huawei technical support.