Test Description

This test checks whether the configurable parameters for loaded HBA drivers match the best practices.

This test case issues a warning if:

One of the parameter values does not match the best practice.

HBA active port configuration doesn't fit the driver configuration.

This test case passes if:

All of the parameter values match the best practices.

How-to fix this test

Finding the driver configuration file

Ubuntu: /etc/modprobe.d/infinidat.conf

Redhat 5 or 6: /etc/modprobe.conf

Redhat 7 and later: /etc/modprobe.d/infinidat.conf

SLES:  /etc/modprobe.d/infinidat.conf

Conflicts in driver configuration

In case you got this warning, there is another configuration file that conflicts with the driver recommended configuration.

WARNING: There are conflicts in driver configuration. The lpfc_lun_queue_depth parameter is configured to 126 while we need 128

Use the following steps to resolve this issue:

  1. Check if /etc/modprobe.conf has this parameter configured for the bad value.

  2. Use `grep -n lpfc_lun_queue_depth /etc/modprobe.d/*` (when lpfc_lun_queue_depth specify the parameter shown on warning) to find the conflict files.

  3. Make sure that no other application needs this configuration, and remove the conflict parameters setting.

  4. Rerun the test.

Automatic fix

The automatic fix performs the following steps:

  1. Writes the recommended options to the configuration file
  2. The automatic fix requires a reboot if the fiber channel driver cannot be reloaded.

Manual fix

To make the driver parameters persistent across module loads and reboots:

  1. Create or modify if exist the configuration file, using the Options command.
  2. Reload the driver.
  3. ramdisk the image.

Example: the following sets the verbose flag.

options lpfc lpfc_log_verbose=0xffff

If the same option is specified both in the configuration file and on the modprobe command line, the
option setting in the command line takes precedence.

Below are the recommended values that are applied:


Driver name: lpfc




The maximum number of FCP commands that can queue to an Emulex adapter

lpfc_lun_queue_depth128301128The default maximum commands sent to a single logical unit (disk)
lpfc_devloss_tmo5300255Seconds to hold I/O error if device disappears


0xff000xffffExtra activity logging (bit mask)


Driver name: qla2xxx 




Option to enable/disable MSI/MSI-X interrupt scheme.

This recommended value disables MSI/MSI-X interrupt scheme

ql2xmaxqdepth12832 or 640N/AMaximum queue depth to set for each LUN

Option to enable extended extra logging (bitmask)

The recommended value is the preferred value for capturing essential debug information


Driver name: bfa



128321N/ALUN queue depth

rport_del_timeout5901N/ARport delete timeout (seconds)

Disable Message Signaled Interrupts

msix_disable_ct1001Disable Message Signaled Interrupts


Driver name: fnic




Queue depth to report for each LUN

More Information

List of recommended HBA drivers

Applies To

  • Red Hat / CentOS / Oracle Linux
  • Ubuntu
  • SLES

Was this article helpful?
0 out of 0 found this helpful

0 out of 0 found this helpful

Last edited: 2022-08-06 08:25:34 UTC