Case 1

Collecting HBA Timeout Parameters

1. After logging in to the device, run the cat /etc/*-release command to obtain the operating system version. If the operating system is SUSE Linux Enterprise Server 10, go to step 2.

   linux-8jmd:~ # cat /etc/*-release  
   SUSE Linux Enterprise Server 10 (x86_64)  
   VERSION = 10  
   PATCHLEVEL = 4  
   LSB_VERSION="core-2.0-noarch:core-3.0-noarch:core-2.0-x86_64:core-3.0-x86_64"

2. Run the ls /sys/class/fc_host command to obtain a list of HBA ports.

   ls /sys/class/fc_host  host3  host4  host5  host6  host7  host8

3. Run the cat /sys/class/fc_host/hostX/port_state command to query the port status. X in hostX indicates the HBA port number. Or you can replace hostX with host* to queryinformation about all the ports in Online state.

   

4. Run the cat /sys/class/scsi_host/hostX/model*name command to query the model of every HBA port and record the results. X in hostX indicates the HBA port number. Or you can replace hostX with host* to query the models of all the HBA ports. HBA models include Emulex and Qlogic.
   Figure 1 Figure 1-1 An Emulex HBA
   
   Figure 2 Figure 1-2 A Qlogic HBA
   

5. Collect timeout parameters using different commands based on the HBA model.

   • If the HBA model is Emulex (started with LPe), use the following method to query the timeout parameters:

     1. X/lpfc_devloss_tmo command to obtain the timeout setting of every HBA port one by one. X in hostX indicates the HBA port number. You can also replace hostX with host* to query the timeout settings of all the FC ports.

        

     2. hostX/port_name command to obtain the WWPN of every port when an error occurs. X in hostX indicates the HBA port number.

        [root@centos5 host0]# cat /sys/class/fc_host/host3/port_name  
        0x10000000c9aa552a

   • If the HBA model is Qlogic (started with QLE), use the following method to query the timeout parameters:

1. qaucli command. (A plug-in needs to be installed before executing this command.) 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 setting is Unknown and the collection ends.

   

2. Please Enter Selection, enter 2 (Adapter Configuration).

   

   1. Enter 3 (HBA Parameters).

      

   2. state does not need to be collected.)

      

   3. Perform the following steps for every port (ports 1, 2, 3, 4). Port 1 is used as an example here:

      1. Enter the port number (1).

         

      2. 

      3. Enter 0 to go back to the previous directory. Repeat the steps to query information about the next port. After all the ports are queried, enter quit.

         • For HBAs from other vendors (HBA models: not started with LPe or QLE), try to use the method for Emulex HBAs.

Error When Querying HBA Timeout Settings

CAUTION:

If thecommand querying HBA information fails to be executed, an error will be reportedand "Command execution failure: execution error!" is added in theHTML file. Add the error information in the TXT document. Fill in Errorin the HBA timeout setting in the Excel. Continue to collect information aboutother HBAs.

1. If the timeout setting of an Emulex HBA does not pass the check, the error information is as follows:

   (HBA model:  LPe11002, host ID： host3,WWPN：0x10000000c9aa552a)(Timeout：30)
   (HBA model:  LPe11002, host ID： host4,WWPN：0x10000000c9aa5456)(Timeout：45)

2. If the timeout setting of a Qlogic HBA does not pass the check, the error information is as follows:

   • When the QConvergeConsoleCLI plug-in is installed:

     (HBA model:  LPe11002, host ID： host3,WWPN：0x10000000c9aa552a)(Timeout：30);
     (HBA model:  LPe11002, host ID： host4,WWPN：0x10000000c9aa5456)(Timeout：45);
     (HBA model:  QLE2462, host ID： host1,WWPN：21-00-00-E0-8B-87-45-11)(Timeout：30);
     (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 model:  LPe11002, host ID： host3,WWPN：0x10000000c9aa552a)(Timeout：30);
     (HBA model:  LPe11002, host ID： host4,WWPN：0x10000000c9aa5456)(Timeout：45);

   • If the QConvergeConsoleCLI plug-in is not installed, the timeout settings of all Qlogic HBAs cannot be obtained. The check is not passed.

3. For HBAs from other vendors, the error information is as follows:

   {'Timeout': 'Error', 'HBAModel': 'HPAE312A', 'Host': {'PortID': 'host2', 'HBAName': 'NA'}, 'HBADriver': 'NA', 'WWPN': '0x50014380020021b0'},

Modifying HBA Timeout Settings

1. 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.

     

2. For a Qlogic HBA:

   1. Run the qaucli command to modify the HBA timeout setting.

      

   2. Enter 2 (Adapter Configuration).

      

   3. Enter 3 (HBA Parameters).

      

   4. Enter the number of the port for which you want to modify the timeout setting. Port 1 is used as an example here.

      

   5. Enter 2 (Configure HBA Parameters).

      

   6. Set the timeout parameter. In the following example, the timeout parameter is set to 15s.

      

   7. Enter 19 (Commit Changes).

      

3. 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

The modification takes effect immediately but will become invalid after a restart. You can collect timeout parameters again for verification.

Figure 3 Figure 1-3 Verifying the timeout setting modification of an Emulex HBA

Figure 4 Figure 1-4 Verifying the timeout setting modification of a Qlogic HBA

Recommended Actions

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