Follow

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: /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:

Emulex

Driver name: lpfc

ParameterRecommendedDefaultMinMaxDescription

lpfc_hba_queue_depth

40964096328192

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

lpfc_log_verbose

0xff000xffffExtra activity logging (bit mask)

QLogic

Driver name: qla2xxx 

ParameterRecommendedDefaultMinMaxDescription

ql2xenablemsix

0102

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
ql2xextended_error_logging507510784000x7fffffff

Option to enable extended extra logging (bitmask)

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

Brocade

Driver name: bfa

ParameterRecommendedDefaultMinMaxDescription

bfa_lun_queue_depth

128321N/ALUN queue depth


rport_del_timeout5901N/ARport delete timeout (seconds)
msix_disable_cb1001

Disable Message Signaled Interrupts

msix_disable_ct1001Disable Message Signaled Interrupts

Cisco

Driver name: fnic

ParameterRecommendedDefaultMinMaxDescription

fnic_max_qdepth

128321N/A

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

Comments