SAM reports incorrect LUN information on several Third Party Storage Devices

From Wiki-UX.info
Jump to: navigation, search

Abstract

System Administration Manager (SAM) will display incorrect LUN information on Third Party Storage Devices. The problem manifest as:

  1. On Disk and File System - Disk Devices section, a very large Number of Paths per Hardware Path value is displayed.
  2. On Disk and File System - Volume groups section, a large number of Physical Volumes per volume group value is displayed.

Problem Symptoms

1. Very large Number of Paths per Hardware Path:

+ ===                 Disks and File Systems (hostname) (1)                    +
¦File List View Options Actions                                           Help ¦
¦                       Press CTRL-K for keyboard help.                        ¦
¦                                                                              ¦
¦                                                                              ¦
¦------------------------------------------------------------------------------¦
¦Disk Devices                                                   1 of 4 selected¦
¦------------------------------------------------------------------------------¦
¦  Hardware                   Number              Volume      Total            ¦
¦  Path                       of Paths   Use      Group      Mbytes   Descr    ¦
¦+---------------------------------------------------------------------------+ ¦
¦¦ 0/0/0/3.0.6.0              1          LVM      vg00        70007   HP 73. ^ ¦
¦¦ 0/3/2/0.1.0.0              1          Unused   --              0   DVD-ROM  ¦
¦¦ 0/0/10/0/0.4.0.239.0.0.0   156        LVM      vg01        11509   DGC      ¦
¦¦ 1/0/0/3.0.6.0              1          LVM      vg00        70007   HP 73.   ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                           v ¦
¦ <------------------------------------------------------------------------->+ ¦
¦                                                                              ¦
+------------------------------------------------------------------------------+


2. A large number of Physical Volumes per volume group.

+ ===                 Disks and File Systems (swtape01) (1)                    +
¦File List View Options Actions                                           Help ¦
¦                       Press CTRL-K for keyboard help.                        ¦
¦                                                                              ¦
¦                                                                              ¦
¦------------------------------------------------------------------------------¦
¦Volume Groups                                                  0 of 1 selected¦
¦------------------------------------------------------------------------------¦
¦                Mbytes           Physical   Logical                           ¦
¦  Name   Type   Available         Volumes   Volumes                           ¦
¦+---------------------------------------------------------------------------+ ¦
¦¦ vg00   LVM    57872 of 69984          2         8                         ^ ¦
¦¦ vg01   LVM        0 of 11186        156         1                           ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                             ¦
¦¦                                                                           v ¦
¦+---------------------------------------------------------------------------+ ¦
¦                                                                              ¦
+------------------------------------------------------------------------------+

The problem is caused because SAM cannot match the LUN identification string in its device database files with the string of the presented LUN. The database is keep on a plain text file at /usr/sam/lib/C/pd_devinfo.tx.

Typically devices that are unknown to SAM are unsupported by Hewlett-Packard. Nevertheless you can try try to circumvent SAM by modifiying the /usr/sam/lib/C/pd_devinfo.tx database file.

For unknown disk devices SAM uses the serial number to identify alternate PV links. Some disk arrays (including Nikes and AutoRAIDs) show the same serial number for all configured LUNs, so SAM needs a special handling in these cases.

A CRC checksum of the serial number can be found in the last 4 columns of the 12th field of ioscan -F.

Example:

On a Sun Microsystem StorageTek 9176, the same disk serial number is reported for several paths of the LUN.

# ioscan -FkC disk | grep awk -F: '{print $18"\t"$12}' 
STK OPENstorage 9176 0 0 2 2 0 0 0 0 57 145 86 53 249 250 207 23 
STK OPENstorage 9176 0 0 2 2 0 0 0 0 57 145 86 53 249 250 207 23 
STK OPENstorage 9176 0 0 2 2 0 0 0 0 57 145 86 53 249 250 207 23 
STK OPENstorage 9176 0 0 2 2 0 0 0 0 57 145 86 53 249 250 207 23 
STK OPENstorage 9176 0 0 2 2 0 0 0 0 57 145 86 53 249 250 207 23 
STK OPENstorage 9176 0 0 2 2 0 0 0 0 57 145 86 53 249 250 207 23 
STK OPENstorage 9176 0 0 2 2 0 0 0 0 57 145 86 53 249 250 207 23

Default SAM Disk Array entries

A quick review of the database /usr/sam/lib/C/pd_devinfo.tx files reveal which devices requires special handling of the CRC check.

# grep -F DISK_ARRAY /usr/sam/lib/C/pd_devinfo.tx
DISK:::sdisk::::.*C2430D.*:::::::HP C2430D SCSI Disk Array:::::::::::::DISK_ARRAY,3_5_MODULE_ONLY
DISK:::sdisk:::.*DGC.*1300.*::::::::::::::HP Model 10 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*2300.*::::::::::::::HP Model 20 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*3400.*::::::::::::::HP Model 30 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*C3586A.*::::::::::::::HP AutoRAID LUN:::::DISK_ARRAY,HP_AUTORAID
DISK:::sdisk:::.*C5447A.*::::::::::::::HP AutoRAID LUN:::::DISK_ARRAY,HP_AUTORAID
DISK:::sdisk:::.*A5277A.*::::::::::::::HP FC60 LUN:::::DISK_ARRAY,OPTIMUS
DISK:::sdisk:::.*HP.*Universal Xport.*::::::::::::::HP FC60 UTM LUN:::::DISK_ARRAY,OPTIMUS
DISK:::sdisk:::.*A6188A.*::::::::::::::HP SureStore Virtual Array 7100 :::::DISK_ARRAY,SDM
DISK:::sdisk:::.*A6189A.*::::::::::::::HP SureStore Virtual Array 7400 :::::DISK_ARRAY,SDM
DISK:::sdisk:::.*A6189B.*::::::::::::::HP SureStore Virtual Array 7110 :::::DISK_ARRAY,SDM
DISK:::sdisk:::.*A6218A.*::::::::::::::HP SureStore Virtual Array 7410 :::::DISK_ARRAY,SDM
DISK:::sdisk:::.*EMC.*SYMMETRIX.*::::::::::::::EMC SYMMETRIX LUN:::::DISK_ARRAY,EMC_SYMMETRIX
DISK:::sdisk:::.*OPEN-.*::::::::::::::HP XP LUN:::::DISK_ARRAY,XP_OPEN
DISK:::sdisk::::.*C2425D.*:::::C2425D SCSI Disk Array::DISK_ARRAY
DISK:::disc3::::.*C2425D.*:::::C2425D SCSI Disk Array::DISK_ARRAY
DISK:::disc3::::.*C2430D.*::::C2430D SCSI Disk Array::DISK_ARRAY,3_5_MODULE_ONLY
DISK:::disc3:::.*DGC.*1300.*::::::::::::::HP Model 10 LUN:::::DISK_ARRAY,CLARIION
DISK:::disc3:::.*DGC.*2300.*::::::::::::::HP Model 20 LUN:::::DISK_ARRAY,CLARIION
DISK:::disc3:::.*DGC.*3400.*::::::::::::::HP Model 30 LUN:::::DISK_ARRAY,CLARIION
DISK:::disc3:::.*C3586A.*::::::::::::::HP AutoRAID LUN:::::DISK_ARRAY,HP_AUTORAID
DISK:::disc3:::.*C5447A.*::::::::::::::HP AutoRAID LUN:::::DISK_ARRAY,HP_AUTORAID
DISK:::disc3:::.*A5277A.*::::::::::::::HP FC60 LUN:::::DISK_ARRAY,OPTIMUS
DISK:::sdisk:::.*EMC.*SYMMETRIX.*::::::::::::::EMC SYMMETRIX LUN:::::DISK_ARRAY,EMC_SYMMETRIX
DISK:::disc3:::.*DGC.*::::::::::::::NON-EXISTANT LUN:::::DISK_ARRAY,CLARIION,BAD_ENTRY

To make SAM of the Third Party Disk Array, add an entry to the file /usr/sam/lib/C/pd_devinfo.tx. The database is a : separate record. The seventh field contains a regular expression to match the Device ID String.

After that SAM should be able to show and configure all LUNs of the Disk Array. However SAM is unable to distinguish the different LUNs since they show up with the same serial number. The result may be the following warning message:

SAM has detected unused disks with non-unique device identifications. These disks may have multiple hardware paths. If this is the case, use the Disk Devices Action "Mark Disk As Used" on the entries that correspond to additional hardware paths to prevent possible data corruption.

NOTES:
  1. The pd_devinfo.tx file may be overwritten by any SAM patch installation. All changes need to be re-applied in such situations!
  2. Changing the pd_devinfo.tx file is unsupported by HP. It is only a workaround to make SAM work with unsupported devices!

Common Third Party required entries

CLARiiON CX300, CX500 and CX700

Note that on that database file there are entries to support HP Model 10,20,30 EMC Clariion branded devices. Add the following entries on a suitable position in the file, for example, after the HP Model 30 LUN

DISK:::sdisk:::.*DGC.*3400.*::::::::::::::HP Model 30 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*CX300.*::::::::::::::EMC CX300 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*CX500.*::::::::::::::EMC CX500 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*CX700.*::::::::::::::EMC CX700 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*C3586A.*::::::::::::::HP AutoRAID LUN:::::DISK_ARRAY,HP_AUTORAID

Clariion CX4 120, 240, 480 and 960

Note that on that database file there are entries to support HP Model 10,20,30 EMC Clariion branded devices. Add the following entries on a suitable position in the file, for example, after the HP Model 30 LUN

DISK:::sdisk:::.*DGC.*3400.*::::::::::::::HP Model 30 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*CX4-120.*::::::::::::::EMC CX4 Model 120 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*CX4-240.*::::::::::::::EMC CX4 Model 240 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*CX4-480.*::::::::::::::EMC CX4 Model 480 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*DGC.*CX4-960.*::::::::::::::EMC CX4 Model 960 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*C3586A.*::::::::::::::HP AutoRAID LUN:::::DISK_ARRAY,HP_AUTORAID

Sun Microsystems OPENstorage

Add the following entries on a suitable position in the file, for example, after the HP Model 30 LUN

DISK:::sdisk:::.*DGC.*3400.*::::::::::::::HP Model 30 LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*STK.*OPENstorage.*::::::::::::::STK OPENstorage LUN:::::DISK_ARRAY,CLARIION
DISK:::sdisk:::.*C3586A.*::::::::::::::HP AutoRAID LUN:::::DISK_ARRAY,HP_AUTORAID

Reference

Authors