Error loading Qlogic HBA driver module during initrd

This document (3331914) is provided subject to the disclaimer at the end of this document.

Environment

SUSE Linux Enterprise Server 11
SUSE Linux Enterprise Server 10



 

Situation

  • A driver for a Qlogic HBA fails to load during the initial RAM disk (initrd) phase of the boot process with an error message ERROR: Unknown symbol
  • Access to the SAN is lost after a reboot.
  • Unknown parameter errors observed

Sample messages observed during boot or in the boot.msg file:

SLES10/11

<3>qla2xxx: Unknown parameter `ql2xfailover'


 

Resolution

Remove unsupported parameters from /etc/modprobe.conf, /etc/modprobe.conf.local, or the associated /etc/modprobe.conf.d file.
Generate a new initial RAM disk (initrd) using mkinitrd
Reboot the system to use the new initrd.


You can see a list of valid kernel driver parameters using the modinfo command. For example:

# modinfo qla2xxx
filename:       /lib/modules/2.6.16.60-0.21-default/kernel/drivers/scsi/qla2xxx/qla2xxx.ko
version:        8.02.00-k6-SLES10-05
license:        GPL
description:    QLogic Fibre Channel HBA Driver
author:         QLogic Corporation
srcversion:     9C4DF7DECE33DFC897AE39B
alias:          pci:v00001077d00002532sv*sd*bc*sc*i*
alias:          pci:v00001077d00005432sv*sd*bc*sc*i*
alias:          pci:v00001077d00005422sv*sd*bc*sc*i*
alias:          pci:v00001077d00002432sv*sd*bc*sc*i*
alias:          pci:v00001077d00002422sv*sd*bc*sc*i*
alias:          pci:v00001077d00006322sv*sd*bc*sc*i*
alias:          pci:v00001077d00006312sv*sd*bc*sc*i*
alias:          pci:v00001077d00002322sv*sd*bc*sc*i*
alias:          pci:v00001077d00002312sv*sd*bc*sc*i*
alias:          pci:v00001077d00002300sv*sd*bc*sc*i*
alias:          pci:v00001077d00002200sv*sd*bc*sc*i*
alias:          pci:v00001077d00002100sv*sd*bc*sc*i*
depends:        scsi_mod,scsi_transport_fc,firmware_class
supported:      yes
vermagic:       2.6.16.60-0.21-default 586 REGPARM gcc-4.1
parm:           ql2xlogintimeout:Login timeout value in seconds. (int)
parm:           qlport_down_retry:Maximum number of command retries to a port that returns a PORT-DOWN status. (int)
parm:           ql2xplogiabsentdevice:Option to enable PLOGI to devices that are not present after a Fabric scan.  This is needed for several broken switches. Default is 0- no PLOGI. 1 - perfom PLOGI. (int)
parm:           ql2xloginretrycount:Specify an alternate value for the NVRAM login retry count. (int)
parm:           ql2xallocfwdump:Option to enable allocation of memory for a firmware dump during HBA initialization.  Memory allocation requirements vary by ISP type.  Default is 1 - allocate memory. (int)
parm:           ql2xextended_error_logging:Option to enable extended error logging, Default is 0 - no logging. 1 - log errors. (int)
parm:           ql2xfdmienable:Enables FDMI registratons Default is 0 - no FDMI. 1 - perfom FDMI. (int)
parm:           ql2xmaxqdepth:Maximum queue depth to report for target devices. (int)
parm:           ql2xqfullrampup:Number of seconds to wait to begin to ramp-up the queue depth for a device after a queue-full condition has been detected.  Default is 120 seconds. (int)
 

Additional Information

Root cause

In general, the parameters supported by a driver may differ between different versions of a driver and between drivers of different origin.

In the case of Qlogic HBAs, some vendors supply their own versions of drivers and document parameter settings which apply to those drivers and which may not apply to the Qlogic drivers shipped with SUSE Linux products.

When /etc/modprobe.conf contains settings for such parameters and a new initrd is generated which does not include the vendor-supplied drivers (e.g. as part of a kernel update), the new initrd may cause problems (like loss of access to a SAN) at boot time. In particular, loading of the qla2xxx driver may fail and cause subsequent failures to load the model-specific drivers like qla2100 andqla2300.

A partial list of such problematic parameters: buffers, mtu, ql2xallocfwdump, ql2xautorestore, ql2xmap2actpath.

Related information


TID 000016506 - Troubleshooting Common Boot Issues covers a more general list of (initrd-related) boot issues with Linux.
 

Disclaimer

This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.

  • Document ID:3331914
  • Creation Date: 15-Oct-2007
  • Modified Date:24-Feb-2021
    • SUSE Linux Enterprise Server

< Back to Support Search

For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]suse.com

SUSE Support Forums

Get your questions answered by experienced Sys Ops or interact with other SUSE community experts.

Join Our Community

Support Resources

Learn how to get the most from the technical support you receive with your SUSE Subscription, Premium Support, Academic Program, or Partner Program.


SUSE Customer Support Quick Reference Guide SUSE Technical Support Handbook Update Advisories
Support FAQ

Open an Incident

Open an incident with SUSE Technical Support, manage your subscriptions, download patches, or manage user access.

Go to Customer Center