HPFOCUS

HP-UX 11i v3 - fcmsutil Returns "ERROR: Unable to get NPIV information. Invalid Parameter"

Issue

User updated the fiber channel driver (FC-FCD) from B.11.31.1003.01 to B.11.31.1009. Now, the fcmsutil command fails with errors.

FC drivers installed on the server:

# swlist -l product | grep -I fibre
FC-FCD B.11.31.1003.01 FibreChannel (FCD) Driver
FC-FCD B.11.31.1009 FibreChannel (FCD) Driver
FC-FCLP B.11.31.0909 PCIe FibreChannel
FC-TACHYON-TL B.11.31.0909 FibreChannel (TD) Driver
FCMassStorage B.11.31 Fibre Channel Mass Storage
PHKL_36790 1.0 Fibre Channel Mass Storage Patch

ioscan shows:

fc 2 0/0/1/1/0 fcd CLAIMED INTERFACE HP AB379-60101 4Gb Dual Port PCI/PCI-X Fibre Channel Adapter (FC Port 1)
/dev/fcd2

fcmsutil /dev/fcd2 reports an error:

ERROR: Unable to get NPIV information. Invalid Parameter.

The /opt/fcms/bin/fcddiag is reporting usage errors such as:

+ fcdlist -n -N
ioscan: option requires an argument -- H
usage: ioscan [-N] [-k | -u] [-e] [-d driver | -C class] [-I instance] [-H hw_path]
[-l] [-A] [-f | -F[F] [-n]] [devfile]
[-b] -M driver -H hw_path [-I instance]
[-t]

Solution

Check at the swlist output; there are 2 versions of FCD driver:

FC-FCD B.11.31.1003.01 FibreChannel (FCD) Driver
FC-FCD B.11.31.1009 FibreChannel (FCD) Driver

Usually, after the installation of the new driver, it should show the new driver version installed only. That means that it must show B.11.31.1009.

Check the filesets . It shows:

FC-FCD.FC-FCD-KRN B.11.31.1009 Fibre Channel Driver (FCD) Kernel Module
FC-FCD.FC-FCD-RUN B.11.31.1003.01 Fibre Channel Driver (FCD) User Space files

Check the binary file:

# what /opt/fcms/bin/fcdutil:

/opt/fcms/bin/fcdutil:
$Revision: B.11.31.1003.01_LR

NOTE: This means there is a mismatch between the fiber channel driver versions.

The correct information for fcdutil should be:

/opt/fcms/bin/fcdutil:
fcdutil : May 9 2010, 15:36:19
$Revision: B.11.31.1009_LR

Summary:

Due to the mismatch of the fiber channel driver, fcmsutil /fcdutil /fcddiag can return many different errors. This can be caused by the following:

Either the installation of the new fiber channel driver was incorrect (check swagent.log for more details).

Or, the depot did not contain the full filesets. In other words, the FC-FCD depot must contain 2 filesets, 1 for Kernel and 1 for Runtime. For example:

# FC-FCD B.11.31.1009 FibreChannel (FCD) Driver
FC-FCD.FC-FCD-KRN B.11.31.1009 Fibre Channel Driver (FCD) Kernel Module
FC-FCD.FC-FCD-RUN B.11.31.1009 Fibre Channel Driver (FCD) User Space file

Resolution:

Install FC driver depot again through swinstall . It is not necessary to change any options in swinstall TUI because swinstall will check the missing filesets and then it will pick them and perform the installation.

Check /var/adm/sw/swagent.log for errors and check with swlist output to make sure the driver was updated.

NOTE: An alternative fix.

Same error has been detected after updating driver due to fcd driver being somehow (could not identify the reason) duplicated into the kernel configuration:

#kcmodule -v fcd

Module fcd (1.0)

Description PCI-X/PCIe Fibre Channel Driver

Timestamp Mon May 10 00:39:31 2010 [4BE739A3]

State unused

State at Next Boot unused

Capable loaded static unused

Depends On module esctl:0.0.0

module wsio:0.0.0

interface HPUX_11_31_PERF:1.0

Module fcd (1.0)

Timestamp Wed Jan 6 07:02:27 2010 [4B442773]

State loaded (best state)

State at Next Boot loaded (best state)

To fix it, a copy of current configuration was created using kconfig:

# kconfig -c current hp

Then disable/enable module in new configuration:

# kcmodule -c hp -v fcd=unused

# kcmodule -c hp -v fcd=best

Configure it to be used at next boot:

# kconfig -n hp

After rebooting, fcdutil will be working fine.

浅显的道理就是不同版本的软件不兼容吧。