Dell Emulex Family of Adapters User Manual

Page 287

Advertising
background image

OneCommand™ Manager Application

P010066-01A Rev. A

14. Troubleshooting

Emulex Driver for Linux and OneCommand Manager Application Situations

287

LPFC driver fails to recognize an adapter and
logs “unknown IOCB” messages in the system
log during driver load. The adapter is running
outdated firmware.

Update adapter firmware to minimum supported revision listed in
the driver installation guide (or newer).

rmmod of LPFC driver hangs and module
reference count is 0.

Due to a small race condition in the kernel it is possible for an
rmmod command to hang. Issue the rmmod-w command. If this
does not help, reboot the computer.

System panics when booted with a failed
adapter installed.

Remove the failed adapter and reboot.

rmmod fails to unload the driver because the
device or resource is busy. This message occurs
when you attempt to remove the driver
without first stopping the OneCommand
Manager application, when the OneCommand
Manager application is installed and running or
when FC disks connected to a LightPulse
adapter are mounted.

Stop the OneCommand Manager application before attempting to
unload the driver. The script is located in the
/usr/sbin/ocmanager directory.
Type

./stop_ocmanager

Unmount any disks connected to the adapter.
Unload the driver.
Type

rmmod lpfc

Driver install fails. The lpfc-install script
fails to install the driver.

The install script may fail for the following reasons:
• A previous version of the driver is installed. Run the

/usr/src/lpfc/lpfc-install --uninstall script and then try to
install the driver.

• The current driver is already installed.
• The kernel source does not match the standard kernel name or

you are running a custom kernel.

• “No module lpfc found for kernel” error

message. When updating the kernel, rpm
generates the following error: “No module
lpfc found for kernel KERNELVERSION”.

• A recently updated kernel cannot find the

ramdisk. After updating the kernel, the
kernel cannot find the ramdisk which halts
or panics the system.

• The driver is not loaded after a system

reboot after updating the kernel.

These three situations may be resolved by updating the kernel.
There are two ways to install the driver into an updated kernel.
The method you use depends on whether or not you are updating
the driver.
• Update the kernel using the same version of the driver.
• Update the kernel using a new version of the driver.
See the Installation section of the driver manual for these
procedures.

Driver uninstall fails. The lpfc-install
--uninstall script fails with an error.

Try the following solutions:
• Uninstall the OneCommand Manager application by running

the ./uninstall script from the OneCommand Manager
application installation directory.

• Unmount all FC disk drives.
• Unload the LPFC driver.

lpfc-install script exit code.

The lpfc-install script contains exit codes that can be useful in
diagnosing installation problems. See the lpfc-install script for a
complete listing of codes and definitions.

Table 14-2 Emulex Driver for Linux and OneCommand Manager Application Situations (Continued)

Situation

Resolution

Advertising