#* #* 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-sun/src/SCCS/s.README README 1.3 7/6/01 @(#) #* #* Version=1.3 #* #* Change History: #* Modifier Date Change ID #*---------------------------------------------------------------------* #* Brian Karl Hiatt 07/06/01 Initial Version #*---------------------------------------------------------------------*/ README for IBMessutl package The following files are included in this package: /opt/IBMessutl/README /opt/IBMessutl/bin/essmap /opt/IBMessutl/bin/lsess /opt/IBMessutl/bin/ls2105 /opt/IBMessutl/bin/lssdd /opt/IBMessutl/bin/lsvp /opt/IBMessutl/bin/get_ess_port To install you will need to do the following: Uncompress and untar IBMessutl.tar.Z to some directory on your host. CD to the directory above pkgadd -d. IBMessutl Add /opt/IBMessutl/bin to your path 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 invoked by lsess. 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 ------ ------------ -------- ------- ----- --- --- ---- --- - ----------- c1t0d0 /sbus@a,0/fcaw@2,0/sd@0,0 30412342 2105F20 12.0 19 004 1301 2/2 N R1-B2-H4-ZA ls2105 and lssdd: These programs format data provided by solaris. # ls2105 Hostname hdisk Location LUN SN S Connection Size LSS Vol Rank -------- ----- -------- ------ - ---------- ---- --- --- ---- cinclair c1t0d0 /sbus@a,0/fcaw@2,0/sd@0,0 30412342 N R1-B2-H4-ZA 12.0 19 004 1301 # lssdd Hostname vpath hdisk Location LUN SN S Connection Size LSS Vol Rank -------- ----- ----- -------- ------ - ---------- ---- --- --- ---- cinclair vpath3 c1t1d0 /sbus@a,0/fcaw@2,0/sd@1,0 30412342 N R1-B4-H4-ZA 12.0 19 004 1301 cinclair vpath3 c1t0d0 /sbus@a,0/fcaw@2,0/sd@0,0 30412342 N R1-B2-H4-ZA 12.0 19 004 1301 cinclair vpath3 c1t15d0 /sbus@a,0/fcaw@2,0/sd@f,0 30412342 N R1-B1-H4-ZA 12.0 19 004 1301 cinclair vpath3 c1t6d0 /sbus@a,0/fcaw@2,0/sd@6,0 30412342 N R1-B3-H4-ZA 12.0 19 004 1301 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