This case is applicable to Oracle Solaris 10 and Oracle Solaris 11 operating systems.
Collecting Timeout Parameters
- Run the fcinfo hba-port command to obtain HBA port information. Collect the manufacturer information (values of Manufacturer) about the HBAs of all the connections whose State is online. If the value of Manufacturer includes Emulex, it is an Emulex HBA. If the value of Manufacturer includes Qlogic, it is a Qlogic HBA.
fcinfo hba-port HBA Port WWN: 10000090fa50e412 OS Device Name: /dev/cfg/c9 Manufacturer: Emulex Model: LPe12002-M8 Firmware Version: 2.01a10 (U3D2.01A10) FCode/BIOS Version: Boot:5.12a11 Fcode:3.10a5 Serial Number: FC34310798 Driver Name: emlxs Driver Version: 2.31p (2008.12.11.10.30) Type: unknown State: offline Supported Speeds: 2Gb 4Gb 8Gb Current Speed: not established Node WWN: 20000120fa50e412 HBA Port WWN: 10000090fa50e413 OS Device Name: /dev/cfg/c10 Manufacturer: Emulex Model: LPe12002-M8 Firmware Version: 2.01a10 (U3D2.01A10) FCode/BIOS Version: Boot:5.12a11 Fcode:3.10a5 Serial Number: FC34310798 Driver Name: emlxs Driver Version: 2.31p (2008.12.11.10.30) Type: unknown State: offline Supported Speeds: 2Gb 4Gb 8Gb Current Speed: not established Node WWN: 20000120fa50e413 HBA Port WWN: 21000024ff2b86f8 OS Device Name: /dev/cfg/c7 Manufacturer: QLogic Corp. Model: QLE2562 Firmware Version: 4.04.01 FCode/BIOS Version: BIOS: 3.13; fcode: 3.19; EFI: 2.24; Serial Number: RFD1036F16738 Driver Name: qlc Driver Version: 20081115-2.29 Type: N-port State: online Supported Speeds: 2Gb 4Gb 8Gb Current Speed: 8Gb Node WWN: 20000024ff2b86f8 HBA Port WWN: 21000024ff2b86f9 OS Device Name: /dev/cfg/c8 Manufacturer: QLogic Corp. Model: QLE2562 Firmware Version: 4.04.01 FCode/BIOS Version: BIOS: 3.13; fcode: 3.19; EFI: 2.24; Serial Number: RFD1036F16738 Driver Name: qlc Driver Version: 20081115-2.29 Type: N-port State: online Supported Speeds: 2Gb 4Gb 8Gb Current Speed: 4Gb Node WWN: 20000024ff2b86f9 HBA Port WWN: 2100001b320ab32c OS Device Name: /dev/cfg/c3 Manufacturer: QLogic Corp. Model: QLE2462 Firmware Version: 4.04.01 FCode/BIOS Version: BIOS: 1.24; fcode: 1.24; EFI: 1.8; Serial Number: RFC0750G66803 Driver Name: qlc Driver Version: 20081115-2.29 Type: unknown State: offline Supported Speeds: 1Gb 2Gb 4Gb Current Speed: not established Node WWN: 2000001b320ab32c HBA Port WWN: 2101001b322ab32c OS Device Name: /dev/cfg/c4 Manufacturer: QLogic Corp. Model: QLE2462 Firmware Version: 4.04.01 FCode/BIOS Version: BIOS: 1.24; fcode: 1.24; EFI: 1.8; Serial Number: RFC0750G66803 Driver Name: qlc Driver Version: 20081115-2.29 Type: unknown State: offline Supported Speeds: 1Gb 2Gb 4Gb Current Speed: not established Node WWN: 2001001b322ab32c - If no Emulex HBA exists for host connections, there is no need to query. Otherwise, obtain the timeout settings of all Emulex HBAs by running the cat /kernel/drv/emlxs.conf | grep linkup-delay command to get the value of linkup-delay.
- If no Qlogic HBA exists for host connections, there is no need to query. Otherwise, obtain the timeout settings of all Qlogic HBAs by performing the following:
- Run the qaucli command. Ensure that the plug-in has been installed before performing this operation. If Please Enter Selection can be seen in the command output, the command has been executed successfully. Then go to the next step; otherwise, the timeout value is Unknown and the collection ends.
qaucli Using config file: /opt/QLogic_Corporation/QConvergeConsoleCLI/qaucli.cfg Installation directory: /opt/QLogic_Corporation/QConvergeConsoleCLI Working dir: /sys/class/scsi_host/host0 QConvergeConsole CLI - Version 2.1.0 (Build 11) Main Menu 1: Adapter Information 2: Adapter Configuration 3: Adapter Updates 4: Adapter Diagnostics 5: Monitoring 6: FabricCache CLI 7: Refresh 8: Help 9: Exit Please Enter Selection: - Enter 2 (Adapter Configuration) after Please Enter Selection at the end of the command output.
- Enter 3 (HBA Parameters).
- Obtain the following information from the command output, including the HBA model, port, and WWPN. (Information about ports in Link Down state does not need to be collected).
- Perform the following steps for every port (ports 1, 2, 3, 4). Port 1 is used as an example here:
- Input the port number (1).
- Enter 1 (Display HBA Parameters) to query HBA information. The value of Port Down Retry Count is the HBA timeout setting.
1 -------------------------------------------------------------------------------- HBA/OS Instance 3/7: QLE2562 Port 2 WWPN 21-00-00-24-FF-2B-86-F9 PortID 1B-0A-C0 Link: Online -------------------------------------------------------------------------------- Connection Options : 2 - Loop Preferred, Otherwise Point-to-Point Data Rate : Auto Frame Size : 2048 Hard Loop ID : 0 Loop Reset Delay (seconds) : 5 Enable Hard Loop ID : Disabled Enable FCP-2 Error Recovery : Enabled Login Retry Count : 4 Port Down Retry Count : 8 Out Of Order Frame Assembly : Disabled Enable LR : Disabled Enable Fabric Assigned WWN : N/A Press <Enter> to continue: - After obtaining the desired information, press Enter and enter 0 to go back to the selection directory. Repeat the steps to query information about the next port. After all the ports are queried, enter quit.
- Run the qaucli command. Ensure that the plug-in has been installed before performing this operation. If Please Enter Selection can be seen in the command output, the command has been executed successfully. Then go to the next step; otherwise, the timeout value is Unknown and the collection ends.
Error When Querying HBA Timeout Settings
If the timeout setting of an HBA does not pass the check (greater than 5), the error information is as follows:
- When the QConvergeConsoleCLI plug-in is installed:
HBA卡的端口（HBA model: All Emulex cards ）超时时间检查不通过（Timeout：60）； HBA卡的端口（HBA model: QLE2462, host ID： host1,WWPN：21-00-00-E0-8B-87-45-11）超时时间检查不通过（Timeout：30）； HBA卡的端口（HBA model: QLE2462, host ID： host2,WWPN：21-00-00-E0-8B-87-45-12）超时时间检查不通过（ Timeout：45）；
- When the QConvergeConsoleCLI plug-in is not installed:
HBA卡的端口（HBA model: All Emulex cards ）超时时间检查不通过（Timeout：60）；
- If the QConvergeConsoleCLI plug-in is not installed, the timeout settings of all Qlogic HBAs cannot be obtained. The check is not passed.
Modifying HBA Timeout Settings
For an Emulex HBA:
Run the cho X > /sys/class/scsi_host/hostY/lpfc_devloss_tmo command to modify the HBA timeout setting, where X indicates the timeout value and Y the FC port number. As shown in the following figure, the timeout value is 5s.
For a Qlogic HBA:
Run the qaucli command to modify the HBA timeout setting.
Enter 2 (Adapter Configuration).
Enter 3 (HBA Parameters).
Enter the number of the port for which you want to modify the timeout setting. Port 1 is used as an example here.
Enter 2 (Configure HBA Parameters).
Set the timeout parameter. In the following example, the timeout parameter is set to 15s.
Enter 19 (Commit Changes).
For HBAs from other vendors (HBA models: not started with LPe or QLE), try to use the method for Emulex HBAs.
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 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.
Restart the host for the settings to take effect.
Recommended Actions
If you have any questions or any other exceptions exist, contact Huawei technical support.