#* #* Licensed Internal Code - Property of IBM #* #* 2105 Licensed Internal Code #* #* (C) Copyright IBM Corp. 1998, 1999 All Rights Reserved. #* #* US Government Users Restricted Rights - Use, duplication or #* disclosure restricted by GSA ADP Schedule Contract with IBM Corp. #* %EPS #*------------------------------------------------------------------------------ #* #@(#) /usr/pfe/source/essutil-hp/opt/IBMessutil/src/SCCS/s.README README 1.2 8/1/01 @(#) #* #* Version=1.2 #* #* Change History: #* Modifier Date Change ID #*---------------------------------------------------------------------* #* Brian Karl Hiatt 07/06/01 Initial Version #*---------------------------------------------------------------------*/ README for IBMessutil.depot The following files are included in this depot file: /opt/IBMessutil/README /opt/IBMessutil/bin/lsess /opt/IBMessutil/bin/ls2105 /opt/IBMessutil/bin/lssdd /opt/IBMessutil/bin/lsvp /opt/IBMessutil/bin/get_ess_port To install you will need to do the following: Use SAM to install IBMessutil.depot Note: If you have already installed the tar version of essutil you should delete all the previous files before installing this version. Header definitions: Disk - hdisk name assigned by the host Location - physical location code of host adapter lun is accessed through LUN SN - unique serial number for each lun within the ESS Type - device and model Size - configured capacity of lun in giga bytes LSS - logical subsystem where lun resides Vol - volume number within the LSS Rank - unique identifier for each raid-array with the ESS C/A - cluster and adapter accessing the array S - shared by two or more ESS ports, Yes or No Connection - physical location code of ESS adapter lun is accessed through The following four programs can be run from the command line: lsess ls2105 lssdd lsvp Descriptions and Examples: lsess: This program displays data collected from the essmap program. essmap issues scsi commands directly to the disks (inquery, read capacity, and log sense) to collect the information displayed. # lsess Disk Location LUN SN Type Size LSS Vol Rank C/A S Connection ------ ------------ -------- ------- ----- --- --- ---- --- - ----------- c12t2d1 0/4/0/0.2.16.0.32.2.1 [FC] 011FC106 2105E20 002.0 16 017 1001 1/1 Y R1-B2-H4-ZA c14t2d1 0/4/0/0.2.17.0.32.2.1 [FC] 011FC106 2105E20 002.0 16 017 1001 1/1 Y R1-B1-H4-ZA ls2105 and lssdd: These programs format data collected by HP-UX and essmap. # ls2105 Hostname VG hdisk Location LUN SN S Connection Size LSS Vol Rank -------- -- ----- -------- ------ - ---------- ---- --- --- ---- genisys none c12t2d1 0/4/0/0.2.16.0.32.2.1 011FC106 Y R1-B2-H4-ZA 002.0 16 017 1001 genisys none c14t2d1 0/4/0/0.2.17.0.32.2.1 011FC106 Y R1-B1-H4-ZA 002.0 16 017 1001 # lssdd Hostname VG vpath hdisk Location LUN SN S Connection Size LSS Vol Rank -------- -- ----- ----- -------- ------ - ---------- ---- --- --- ---- genisys sddvg vpath0 c31t2d1 0/7/0/0.2.19.0.32.2.1 011FC106 Y R1-B3-H4-ZA 002.0 16 017 1001 genisys sddvg vpath0 c30t2d1 0/7/0/0.2.18.0.32.2.1 011FC106 Y R1-B4-H4-ZA 002.0 16 017 1001 lsvp: This program shows vpath status from an ESS physical location code perspective. Included is the capability to set SDD paths offline using an ESS location code. Usage: lsvp [-adt] [-o] [-l location_code] -a Display SDD logical path to ESS physical location code -d Display path status for each vpath device -t Test physical access to hdisks, can only be used with -d option -o Attempts to set all SDD paths ONLINE -l Set SDD paths OFFLINE for specified ESS location code location_code must be in one of the following formats: single port = R1-Bx-Hy-Zz all ports on card = R1-Bx-Hy all ports on bay = R1-Bx # lsvp -d BAY-1(B1) BAY-2(B2) BAY-3(B3) BAY-4(B4) H1 H2 H3 H4 H1 H2 H3 H4 H1 H2 H3 H4 H1 H2 H3 H4 A B A B A B A B A B A B A B A B A B A B A B A B A B A B A B A B 0 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 1 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 2 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 3 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 4 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 5 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 6 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 7 - - - - - - Y - - - - - - - Y - - - - - - - Y - - - - - - - Y - 8 - - - - - - O - - - - - - - O - - - - - - - O - - - - - - - O - 9 - - - - - - O - - - - - - - O - - - - - - - O - - - - - - - O - 10 - - - - - - O - - - - - - - O - - - - - - - O - - - - - - - O - 11 - - - - - - O - - - - - - - O - - - - - - - O - - - - - - - O - Y = online/open O = online/closed N = offline X = not-available - = path not configured ? = path information not available PD = path down