HP StorageWorks Performance Advisor XP Software command-line user interface user guide Part number: T1789-96026 First edition: September 2007
Legal and notice information © Copyright 1999, 2006 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice.
Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . Intended audience . . . . . . . . Prerequisites . . . . . . . . . . Related documentation . . . . . . Document conventions and symbols Rack stability . . . . . . . . . . HP technical support . . . . . . . HP websites . . . . . . . . . . . 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Host configuration script (HOSTCFG) . . . . . . HOSTCFG usage . . . . . . . . . . . . HOSTCFG sample output . . . . . . . . . User host configuration script (USERHOSTCONFIG) USERHOSTCONFIG usage . . . . . . . . RAID group data script (RAIDGRP) . . . . . . . RAIDGRP usage . . . . . . . . . . . . . RAIDGRP sample output . . . . . . . . . Event log data script (EVNTLOG) . . . . . . . . EVNTLOG usage . . . . . . . . . . . . EVNTLOG sample output . . . . . . . . . User-defined group script (USERGRP) . . . . . .
Tables 1 ..Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2 ..XP48/128 (1 ACP Pair) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 3 ..XP 48/128 (2 ACP Pairs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 4 ..XP 256/512/1024 . 5 ..XP 12000 . . . . . 6 ..XP10000 and SVS200 7 ..XP24000 . . . . . . 8 ..XP20000 . . . . . . 96 96 96 97 97 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
About this guide This guide provides an overview of the command–line user interface scripts and commands of the Performance Advisor XP (PA XP) software.
Document conventions and symbols Table 1 Document conventions Convention Element Blue text: Table 1 Cross-reference links and email addresses Blue, underlined text: http://www.hp.
WARNING! To • • • • • reduce the risk of personal injury or damage to equipment: Extend leveling jacks to the floor. Ensure that the full weight of the rack rests on the leveling jacks. Install stabilizing feet on the rack. In multiple-rack installations, fasten racks together securely. Extend only one rack component at a time. Racks can become unstable if more than one component is extended. HP technical support For worldwide technical support information, see the HP support website at: http://www.hp.
About this guide
1 Introduction This document discusses the command-line user interface (CLUI) supported in HP StorageWorks Performance Advisor XP Software (PA XP). You can use the CLUI to gain access to performance data, set alarms, modify data collection intervals, and configure host information. Shell scripts are available for most of the commands in the CLUI, and HP recommends that you use these scripts to access commands. The CLUI is divided into two parts: a report CLUI and a configuration CLUI.
Introduction
2 Installating and uninstalling PA XP Preparing for installation Complete the following steps before installing the PA XP CLUI: 1. Installation requirements for the CLUI are the same as the installation requirements for the PA XP Host Agent. For more information, see the HP StorageWorks Performance Advisor Software installation guide. The installation prerequisites include JRE version 1.4.2_06. The JRE is automatically installed when you install the PA XP Host Agent on a host. 2.
2. Unpack the appropriate .tar file for your platform, and save the contents in a temporary directory. For Windows, use the WinZip program to open this file and extract the contents. Extract all files from this archive. 3. Open the command prompt (DOS prompt in Windows), and run the appropriate install script (install.bat for Windows, install.sh for UNIX variants). Installing PA XP CLUI on the Windows operating system is different from installing PA XP on the UNIX operating system. For UNIX variants: 1.
3 Reporting and configuring CLUI shell scripts The supported shell scripts enable you to use the CLUI easily. Each CLUI script is provided with a shell script, except for the version and encrypt scripts. Following are the CLUI shell scripts: External storage script (Ext-Lun) The report CLUI application provides a script that displays the Ext-Lun data. The –dkc switch is a required element.
LDEV E-Port E-Seq E-LDEV 0:01 CL1C 20074 1:01 0:02 CL1C 20074 1:02 0:03 CL1C 20074 1:03 0:04 CL2C 20074 1:04 0:05 CL1C 20074 1:05 0:05 CL2C 20074 1:05 16 Reporting and configuring CLUI shell scripts
CLPR (CACHEGRP) The report CLUI application provides a script that displays the CLPR data. The -dkc switch is a required element. Optionally, you can specify a management station by using –ms , and specify a username and password pair by using –auth .
CACHEGRP sample output The following are output data samples for the CLUI shell script described in the previous section: cachegrp -dkc 10851 -clpr 0 -hr RaidGroup Cache Size (MB) 36864 1-1 36864 1-10 36864 1-11 36864 1-12 36864 1-13 36864 1-14 cachegrp -dkc 10851 -perf hr CLPR 0 TIME Cache Size (MB) Write Pending (MB) Sidefile Usage (MB) 2006-02-23 17:15:00.
Disk Controller snapshot script (DKCS) The report CLUI application provides a script that displays Disk Controller Snapshot data. The —dkc switch is a required element. Optionally, you can specify a management station by using ms , and specify a username and password pair by using auth .
dkcs -L -dkc 30143 Array Type, Serial No.
dkcs -L -dkc 30143 Array Type, Serial No.
Array Type: XP 24000 Serial #: 10001 Record Time: 16:30:00 Record Date: 03/30/2007 Micro Code: 60-00-20/00 Raid Manager Lib: 01.12.
Disk controller history script (DKCH) The report CLUI application provides a script that displays Disk Controller History data. The -dkc switch is a required element. Optionally, you can specify a management station by using ms , and specify a username and password pair by using auth .
dkch -dkc 10055 hr Start Time: 05:30:00 01.01.1970 End Time: 05:30:00 01.01.1970 Array Type: XP 12000 Serial #: 10055 Record Time: 10:30:00 Record Date: 06/27/2006 Micro Code: 50-04-31 Raid Manager Lib: 0 Chip Data: ACP Data: E = 0.0% 0.0% 0.0% 0.0% 0.0% 78.0% 0.0% 0.0% A = 11.0% 14.0% 11.0% 8.0% 10.0% 8.0% 11.0% 2.0% F = 0.0% 66.0% 0.0% 0.0% 1.0% 0.0% 0.0% 0.0% B = 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% G = 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% L = 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% 0.0% H = 0.0% 0.
dkch -L -dkc 30143 Start Time, End Time, Time, Date, Serial No.
The ACP data displays as U for upper and L for lower. For example, ACP A Upper displays as AU. The following is an example of the output data of the –dkcs command for an XP24000 array: Start Time: 15:45:00 03.30.2007 Array Type: XP 24000 Serial #: 10001 Record Time: 15:45:00 Record Date: 03/30/2007 Micro Code: 60-00-20/00 Raid Manager Lib: 01.12.03 Chip Data: EU = 0.0% EL = 0.0% FU = 0.0% FL = 0.0% GU = 0.0% GL = 0.0% HU = 0.0% HL = 0.0% QU = 0.0% QL = 0.0% RU = 0.0% RL = 0.0% TU = 0.
Logical unit host snapshot script (LUNH) The report CLUI application provides a script that displays Logical Unit Host Snapshot data. The output for this script is ordered by the DKC ID. The required element for this command is –ha. Optionally, you can specify a management station by using –ms , and specify a username and password pair by using –auth .
NOTE: Labels in labeled outputs (specified by -hr or -L in the command line) are in bold. Cache Fast Writes and DASD Fast Writes are applicable to mainframe volumes only. If an array is connected to a host agent that is running HP-UX 11i v3 operating system, the DSF (device special file) is displayed in a new format. A legacy DSF is displayed in parenthesis next to the new format. lunh -ha xpslk.user.server.com –hr Retrieving records 0 - 1999 Array ID: 30143 Lun ID: 5 Volume-Grp.:-Dev.
lunh -ha hpbs1428.user.server.com -hr -dver 010600 Array ID: 30143 Array Type: XP512 Lun ID:1 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c0t0d1 LDEV ID: 0:01 LDEV IO/Sec: 1437 LDEV MB/Sec: 3 Emulation: OPEN-3 SS ID: 0004 Raid Grp.: 1-2 CHP Port ID: CL1A CHP Port Util: 100 ACP Pair ID: BH ACP Pair Util: 29 Cont.
lunh -ha hpbs1428.user.server.com -hr -dver 015100 Array ID: 30143 Array Type: XP512 Lun ID:0 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c0t0d0 LDEV ID: 0:00 LDEV IO/Sec: 1401 LDEV MB/Sec: 3 Emulation:OPEN-3 SS ID: 0004 Raid Grp.: 1-1 Host Group: UNKNOWN CHP Port ID: CL1A CHP Port Util: 97 ACP Pair ID: BL ACP Pair Util: 29 Cont.
lunh -ha angus -dkc 10 001 hr Array ID: 10001 Dev. File: /dev/rdisk/disk552(/dev/rdsk/c53t2d4) Lun ID: 20 Volume-Grp.:LDEV ID: 0:00 LDEV IO/Sec: 8 Emulation: OPEN-V-CVS-CM SSID: 000C Raid Grp.: 1-1 CHP Port ID: CL7B CHP Port Util: 1 ACP Pair ID: AUMU ACP Pair Util: 0 +++++++++++++++++++++++++++++++++++++++ Array ID: 10001 Dev. File: /dev/rdisk/disk553(/dev/rdsk/c53t2d5) Lun ID: 21 Volume-Grp.:LDEV ID: 0:01 LDEV IO/Sec: 0 Emulation: OPEN-V-CVS SSID: 000C Raid Grp.
Logical unit disk controller snapshot script (LUND) The report CLUI application provides a command that displays Logical Unit Disk Controller Snapshot data. Output for this command is ordered by Host ID. The required element for this command is -dkc. Optionally, you can specify a management station by using ms , and specify a username and password pair by using auth .
NOTE: Labels in labeled outputs (specified by –hr or –L in the command line) are in bold. The amount of data has been reduced for this document. Cache Fast Writes and DASD Fast Writes are applicable to mainframe volumes only. If an array is connected to a host agent that is running HP-UX 11i v3 operating system, the DSF (device special file) is displayed in a new format. A legacy DSF is displayed in parenthesis next to the new format. lund -hr -dkc 30143 Retrieving records 0 - 1999 Host ID: hpbs2167.user.
lund -dkc 30143 hpbs2167.user.server.com,0, ,/dev/rdsk/c17t0d0,0:0,0,OPEN-3-CM,0004,’1-1,CL2D,0,1,1 hpbs2196.user.server.com,0, ,/dev/rdsk/c17t0d0,0:0,0,OPEN-3-CM,0004,’1-1,CL2D,0,1,1 xpslc360.user.server.com,0, ,/dev/rdsk/c3t0d0,0:0,0,OPEN-3-CM,0004,’1-1,CL1A,0,1,1 xpslk.user.server.com,5, ,/dev/rdsk/c5t3d5,0:0,0,OPEN-3-CM,0004,’1-1,CL1B,0,1,1 hpbs2167.user.server.com,1, ,/dev/rdsk/c13t0d1,0:1,1,OPEN-3-CM,0004,’1-1,CL2B,0,1,1 hpbs2196.user.server.
lund -dkc 30143 -hr -dver 015100 Host ID: hpbs1428.user.server.com Lun ID: 0 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c0t0d1 LDEV ID: 0:00 LDEV IO/Sec: 1440 LDEV MB/Sec: 3 Emulation: OPEN-3-CM SS ID: 0004 Raid Grp.: 1-1 Host Group: UNKNOWN CHP Port ID: CL1A CHP Port Util: 96 ACP Pair ID: BH ACP Pair Util: 29 Cont.
lund -hr -dkc Host ID: cvsuse232.rose.hp.com Dev. File: /dev/sdl Lun ID: 10 Volume-Grp.:LDEV ID: 0:0 LDEV IO/Sec: 0 Emulation: OPEN-V-CVS-CM SS ID: 1234 Raid Grp.: THP-PID(1) CHP Port ID: CL1A CHP Port Util: 2 ACP Pair ID: AM ACP Pair Util: 1 +++++++++++++++++++++++++++++++++++++++ Host ID: cvsuse232.rose.hp.com Dev. File: /dev/sdl Lun ID: 10 Volume-Grp.:LDEV ID: 1:0 LDEV IO/Sec: 0 Emulation: OPEN-0V SSID: 1234 Raid Grp.
Logical device history script (LDEV) The report CLUI application provides a command that displays Logical Device History data. The required elements for this command are –dkc, and –ldev. Optionally, you can specify a management station by using –ms , and specify a username and password pair by using –auth .
ldev -dkc 30143 -ldev 1:6C -st 01.03.2001 12:49:00 -et 01.03.
ldev -dkc 10055 -hr -ldev 0:7E -dver Start Time: 06262006 093800 End Time: 06262006 153000 +++++++++++++++++++++++++++++++++++++++ Ldev ID: 0:7E Date: 06262006 Time: 093800 Array ID: 10055 Rand: Reads: 0 Read Cache Hits: 0 Read Cache Misses: 0 Rand: Writes: 0 Write Cache Hits: 0 Write Cache Misses: 0 Rand: Reads MB/s: 0 Writes MB/s: 0 Seq: Reads: 1 Read Cache Hits: 0 Read Cache Misses: 1 Seq: Writes: 0 Write Cache Hits: 0 Write Cache Misses: 0 Seq: Reads MB/s: 0 Writes MB/s: 0 Total IO: 1 Backend Transfer S
ldev -dkc 10055 -ldev 0:7E -dver 010600 L Start Time, End Time 1151294880100,1151316000119 Time, Date,Random Reads, Random Read Hits, Random Writes, Random Write Hits, Sequential Reads, Sequential Read Hits, Sequential Writes, Sequential Write Hits, Array ID, Ldev ID, Rand. Read Cache Misses, Rand. Write Cache Misses, Seq.Read Cache Misses, Seq.
Alarm history script (ALMH) This command is now deprecated and does nothing if called. Use the Alarm history script (ALARMHIST) command instead. Alarm history script (ALARMHIST) This CLUI script provides a command that displays the Alarm History data. Alarm History objects are created when array usage exceeds a certain user-defined threshold in one of the categories.
–metric Constrains the output by the metric category.
–d The delimiter for delimited display. Used with –list and –details. –hr Displays human-readable output. Used with –list and –details. –? Prints the usage statement.
alarmhist -hr Alarm ID: 2 Array ID: 10227 Metric Category: THP POOL OCCUPANCY Alarm State: Level_1 Time Posted: 2002-03-01 11:40:00.0 Time Dispatched: 1969-12-31 17:00:00.0 Metric Value: 1 Threshold: 9 Time Updated: 2002-03-07 16:50:00.0 +++++++++++++++++++++++++++++++++++++++ Alarm ID: 1 Array ID: 10227 Metric Value: 0 Metric Category: SNAPSHOT POOL OCCUPANCY Alarm State: Level_0 Threshold: 999999 Time Posted: 2002-03-01 11:21:11.0 Time Updated: 2002-03-07 16:50:00.0 Time Dispatched: 1969-12-31 17:00:00.
Port performance data script (PORT) The CLUI provides a command that displays port performance data. The required elements for this command are –dkc and –port. Optionally, you can specify a management station by using –ms , and specify a username and password pair by using –auth .
port -dkc 30143 -port cl1a -hr Serial #: 30143 Port ID: CL1A Time Date Max IO/s Min IO/s AvgIO/s Max MB/s Min MB/s Avg MB/s 023000 11022001 900 700 800 8 6 023200 11022001 900 700 800 8 6 023400 11022001 900 700 800 8 6 023600 11022001 900 700 800 8 6 023800 11022001 900 700 800 8 6 024000 11022001 900 700 800 8 6 024200 11022001 900 700 800 8 6 024400 11022001 900 700 800 8 6 024600 11022001 900 700 800 8 6 024800 11022001 900 700 800 8 6 025000 11022001 900 700 800 8 6 025200 11022001 900 700 800 8 6 0254
–dkc The array serial number. Not required if -list is used. –mval - The items for which alarms are being created. This is a csv list. Not required if -list is used. –metric The alarm metric to watch. Not required if -list is used.
–ms The URL of the management station. –auth The username and password. –pf Can be used in place of -auth. NOTE: The password file must be created using only the encrypt command. –th1 The first threshold of these alarms. –th2 The second threshold of these alarms. –th3 The third threshold of these alarms. –email A csv list of email destinations. –snmp A csv list of SNMP destinations.
configalarm -list -hr Array ID: 30143 Item: 1:F6 Dispatch Level: 3 Threshold 1: 999999 Threshold 2 : 999999 Threshold 3: 999999 Email Destinations: SNMP Destinations: Send to VPO: NO Alarm Enabled: YES +++++++++++++++++++++++++++++++++++++++ Array ID: 30143 Item: 0:22 Dispatch Level: 2 Threshold 1: 99 Threshold 2: 999 Threshold 3: 9999 Email Destinations:> SNMP Destinations: Send to VPO: NO Alarm Enabled: NO +++++++++++++++++++++++++++++++++++++++ configalarm -list L Active,Array,Item,Metric Category,Thresh
configalarm —list N,10227,0,SNAPSHOT POOL OCCUPANCY,99999,99999,99999,3, , ,NO configalarm -list hr Array ID: 10001 Item: THP-PID(3) Dispatch Level: 3 Metric Category: THP Pool Occupancy Threshold 1: 10 Threshold 2: 40 Threshold 3: 100 Email Destinations: SNMP Destinations: Send to VPO: NO Alarm Enabled: NO +++++++++++++++++++++++++++++++++++++++ The following is the sample output for the Continuous Access Journal file usage: configalarm -dkc 10001 -mval 0 -metric JOURNAL_FILE_USAGE_UTIL -th1 10 -th2 40 -t
Host configuration script (HOSTCFG) This CLUI script requests array information from a Host Agent, removes unwanted hosts, or unrequests array information. HOSTCFG usage Following is the general format of the command to invoke the script: hostcfg –op -ha [-auth ] [-ms ] [-L] [d] [-hr] [-?] Following are the arguments for this command: Required arguments: –op The operation to be performed. Not necessary if -list is used.
User host configuration script (USERHOSTCONFIG) This CLUI script enables you to request the host configuration information. USERHOSTCONFIG usage Following is the general format of the command to invoke the script: [-filein in_name | -streamin | -database colon:separated:no_spaces] -fileout out_name -streamout -header -send -ms management_station_name [-auth user:password | -pf password_file] -? where: –filein When repeated, only uses the last in_name. –streamin The default input value.
NOTE: Only one input source is accepted in one invocation. Output rows to file or screen have fields separated by commas. Either -auth or -pf is accepted, but not both. The password file must be created using only the encrypt command. There is no output to file or to the screen unless requested. The commands are not case-sensitive. The order of command options does not matter. If command options are not provided, the streamed-in input is checked.
RAID group data script (RAIDGRP) PA XP maintains some information about the RAID groups of the array, such as the RAID level, ACP Pair, Control Unit, and some of the mechanics of the disks. RAIDGRP usage Following is the general format of the command to invoke the script: raidgrp -dkc -rg [-auth ] [-ms ][-L] [-d] [-hr] [-?] [-pf ] where: Required arguments: –dkc The array serial number. –rg The RAID group that is being queried.
raidgrp -dkc 10055 -rg 1-5 1-6 10055,1-5 1-6,5,AM,R0004,R0104,R0204,R0304,R0414,R0514,R0614, R0714,R0005,R0105,R0205,R0305,R0415,R0515,R0615,R0715 HP StorageWorks Performance Advisor XP Software command-line user interface user guide 55
Event log data script (EVNTLOG) The event log keeps track of events such as data purge or collection configuration. With this script, you can use the CLUI to access event log data. EVNTLOG usage Following is the general format of the command to invoke the script: evntlog [-auth ] [-ms ] [-L] [-d] [-hr] [-?] [-type ] [-sev ] [-st ] [-et ] where: –type The type of the event. –sev The severity of the alarm, range 1 - 10.
evntlog -L Time,Date,Type,Severity,Description 16:20:37,02.14.2002,10,5,Purged all performance 16:20:35,02.14.2002,10,5,All records purged for evntlog 16:20:37,02.14.2002,10,5,Purged all performance 16:20:35,02.14.2002,10,5,All records purged for data for array 30143. array 30143. data for array 30143. array 30143.
User-defined group script (USERGRP) This script enables you to create, list, and remove user-defined groups. USERGRP usage Following is the general format of the command to invoke the script: usergrp [-auth ] [-ms ] [-L] [-d] [-hr] [-?] –items - | -list | -details | -rem [-name ] [-gid ] Required arguments: –items Indicates that a new user-defined group is to be created. A name is required with this option.
usergrp -items 10033::CLPR1-CLPR2 name custom1 Operation completed successfully usergrp -list -hr Group ID, Group Name 1 demo1 usergrp -list -L Group ID, Group Name 1,demo1 usergrp -list 1,demo1 usergrp -details -hr -gid 1 Array ID: 20112 Array Type: XP48 Lun ID: 6 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c3t15d6 LDEV ID: 1:FE Emulation: OPEN-3 SS ID: 0004 Raid Grp.: 1-7 Host Group: LUSE: N LUSE Master: NA CHP Port ID: CL1F ACP Pair ID: BL Cont.
usergrp -details -hr -gid 1 Array ID: Array Type: XP24000 Lun ID: 6 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c3t15d6 LDEV ID: 1:FE Emulation: OPEN-3 SS ID: 0004 Raid Grp.: THP-PID(2) Host Group: LUSE: N LUSE Master: NA CHP Port ID: CL1F ACP Pair ID: BL Cont. Access Volume: SMPL Business Copy Volume 0: SMPL Business Copy Volume 1: SMPL Business Copy Volume 2: SMPL Business Copy Volume 2: SMPL usergrp -details -hr -gid 1 Array ID: Array Type: XP24000 Lun ID: 8 Volume-Grp.
Database configuration script (DBCONFIG) This script provides some database configuration capabilities. The user can modify data retention times, purge data based on an array or on a particular date, or modify the log level stored in the database. DBCONFIG usage Following is the general format of the command to invoke the script: dbconfig [-auth ] [-ms ] [-L] [-d] [-hr] [-?] purge | -list | -loglvl [-days ] [-dkc ] [-et
Aggregate script (AGGREGATE) The report CLUI application provides a command that displays the Cache Partitioning data. Use the aggregate command to request performance data that is added together to obtain total performance metric, which is displayed based on time, to view the related metrics for the specific RAID Group/LDEVs. AGGREGATE usage Following is the general format of the command to invoke the script: aggregate [-items - ] [-L] [-hr] [-a] [-st] [-et
–items- A CSV list of DKCs, metrics, and items on the DKC for which you want the aggregated data. It uses the form Metric:dkc serial:itemlist, or Metric:User Defined Group. Itemlist A list of LDEVs, ports, ACP Pairs, RAID Groups, or ranges of each (except for RAID Groups) separated by a "+". Ranges are in the form lowitem-highitem separated by a "-". Items must be entered in their string form (case insensitive, no "-" within the port).
LDEV_IO_TOTAL Total LDEV IOs/sec LDEV_IO_RAND_TOTAL - Total Random LDEV IOs/sec LDEV_IO_RAND_READ LDEV Random IO reads/sec LDEV_IO_RAND_READCACHE LDEV Random IO Reads/sec from cache LDEV_IO_RAND_WRITE LDEV Random IO writes/sec LDEV_IO_SEQ_TOTAL - LDEV Total Sequential Ldev IOs/sec LDEV_IO_SEQ_READ LDEV Sequential IO reads/sec LDEV_IO_SEQ_READCACHE LDEV Sequential IO reads/sec from cache LDEV_IO_SEQ_WRITE - LDEV Sequential IO writes/sec LDEV_IO_CFW_TOTAL - LDEV CFW total IOs/sec LDEV_IO_CFW_READ - LDEV CFW r
ACP_PAIR_IO_TOTAL - ACP pair total IO’s/sec ACP_PAIR_IO_RTOTAL - ACP pair total random IO’s/sec ACP_PAIR_IO_RREAD - ACP pair random read IO’s/sec ACP_PAIR_IO_RREAD_HITS - ACP pair random read IO’s/sec in cache ACP_PAIR_IO_RWRITE - ACP pair random write IO’s/sec ACP_PAIR_IO_STOTAL - ACP pair total sequential IO’s/sec ACP_PAIR_IO_SREAD - ACP pair sequential read IO’s/sec ACP_PAIR_IO_SREAD_HITS - ACP pair sequential read IO’s/sec in cache ACP_PAIR_IO_SWRITE - ACP pair sequential write IO’s/sec ACP_PAIR_MB_TOTA
RAIDGRP_IO_TOTAL - Raid group total IO’s/sec RAIDGRP_IO_RTOTAL - Raid group total random IO’s/sec RAIDGRP_IO_RREADS - Raid group random read IO’s/sec RAIDGRP_IO_RREAD_HITS - Raid group random read IO’s/sec in cache RAIDGRP_IO_RWRITES - Raid group random write IO’s/sec RAIDGRP_IO_STOTAL - Raid group sequential total IO’s/sec RAIDGRP_IO_SREADS - Raid group sequential read IO’s/sec RAIDGRP_IO_SREAD_HITS - Raid group sequential read IO’s/sec in cache RAIDGRP_IO_SWRITES - Raid group sequential write IO’s/sec RAI
CFW_TOTAL LDEV IO type CFW_READ LDEV IO type CFW_READ_CACHE LDEV IO type CFW_WRITE LDEV IO type CFW_WRITE_CACHE LDEV IO type DFW_COUNT LDEV IO type DFW_NRML_COUNT LDEV IO type DFW_SEQ_ACCESS LDEV IO type DFW_WRITE_HITS LDEV IO type DFW_SA_WRITE_HITS LDEV IO type AGGREGATE sample output The following are output data samples for the CLUI shell script described in the previous section: aggregate -items ldev_io_total:10033:CLPR2 -st 09.16.2003 06:00:00 -et 09.16.
aggregate -items ldev_io_total:Fred 4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4396.0 aggregate -items ldev_io_total:Fred L 2002-06-12 11:08:00.0,2002-06-12 11:09:00.0,2002-06-12 11:10:00.0,2002-06-12 11:11:00.0,2002-06-12 11:12:00.0,2002-06-12 11:13:00.0,2002-06-12 11:14:00.0,2002-06-12 11:15:00.0,2002-06-12 1:16:00.0,2002-06-12 11:16:33.04320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4396.
aggregate -items ldev_io_total:20031:1:f4-1:f9+1:fc —hr 2002-06-12 2002-06-12 2002-06-12 2002-06-12 2002-06-12 11:08:00.0: 11:10:00.0: 11:12:00.0: 11:14:00.0: 11:16:00.0: 5040.0 5040.0 5040.0 5040.0 5040.0 2002-06-12 2002-06-12 2002-06-12 2002-06-12 2002-06-12 11:09:00.0: 11:11:00.0: 11:13:00.0: 11:15:00.0: 11:16:33.0: 5040.0 5040.0 5040.0 5040.0 5114.0 aggregate -items port_io_max:50129:CL1E -st 09.16.2003 05:00:00 -ct 09.16.2003 07:15:00 -hr 2003-09-16 05:00:00.0: 1574.0 2003-09-16 05:00:00.0: 1169.
Overall Raid Group Utilization sample output Utilization is expressed as a percentage with fractional precision. For example: 100.0 is 100% aggregate –items RAIDGRP_UTIL_OVRALL:10227:1-1 -hr -st 04.01.2007 00:00:00 –et 04.01.2007 00:40:00 2007-02-01 2007-02-01 2007-02-01 2007-02-01 2007-02-01 00:00:00.0: 00:10:00.0: 00:20:00.0: 00:30:00.0: 00:40:00.0: 1.0 1.0 1.0 1.0 1.0 2007-02-01 2007-02-01 2007-02-01 2007-02-01 00:05:00.0: 00:15:00.0: 00:25:00.0: 00:35:00.0: 1.0 1.0 1.07 2.
Properties utility script (PROPUTILITY) This CLUI script enables you to configure the properties file which in turn enables you to integrate other software and shell scripts. PROPUTILITY usage Following is the general format of the command to invoke the script: proputility [-i] [-ms ] [-rauth ] [-cauth ] where: –i Interactive mode. The user is prompted for the URL of the management station.
THP sample output The following are output data samples for the CLUI shell script described in the previous section: thp dkc -hr PoolID Occupancy(%) 0 25 1 40 aouthp dkc -L 0,25 1,40 aouthp dkc -pid 1 2006-02-23 2006-02-23 2006-02-23 2006-02-23 2006-02-23 16:10:00.0: 16:20:00.0: 16:30:00.0: 16:40:00.0: 16:50:00.0: 10 20 30 40 40 2006-02-23 2006-02-23 2006-02-23 2006-02-23 2006-02-23 16:15:00.0: 16:25:00.0: 16:35:00.0: 16:45:00.0: 16:55:00.
Snapshot script (SNAPSHOT) This command enables you to obtain Snapshot Pool related information. This command provides the Snapshot pool occupancy value in percentage. SNAPSHOT usage Following is the general format of the command to invoke the script: snapshot -dkc -pid [-auth ] [-ms ] [-L] [-d] [-hr] [-?] [-pf ] where: –pid The snapshot pool ID that is being queried. –ms The URL of the management station.
Continuous Access Journal script (JNL) This command enables you to obtain Continuous Access Journal related information. This command provides the following Continuous Access Journal information: JID — Displays the journal group ID MU — Displays the mirror descriptions on journal group CTG —Displays the CT group ID for the journal group JNLS —Displays the following status in the journal group Primary Journal: String Status value Constant value JSTAT_SMPL Journal pool is not used in a journal group.
where: –jid The journal ID that is being queried. –resp The journal LDEV’s read and write response time. –st Constrain by a certain start time. –et Constrain by a certain end time. –ms The delimiter for delimited display. –auth The username and password. –pf Can be used in place of –auth. NOTE: The password file must be created using the encrypt command only. –d Set the delimiter for delimited display.
jnl -hr -dkc 10001 -jid 0 JID 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 76 MU 0 0 0 1 1 1 2 2 2 3 3 3 0 0 0 1 1 1 2 2 2 3 3 3 0 0 0 1 1 1 CTG 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 JNLS 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 AP 1 1 1 0 0 0 0 0 0 0 0 0 1 1 1 0 0 0 0 0 0 0 0 0 1 1 1 0 0 0 U(%) 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Q-Marker 109095574 109095574 109095574 0 0 0 0 0 0 0 0 0 109095574 109095574 109095574 0 0 0
jnl -hr -dkc 10001 -jid 0 -st 4.5.2007 03:00:00 -et 4.5.2007 03:10:00 TIME DATE JID Q-Marker Q-CNT 03:02:00 04.05.2007 0 1287 03:02:00 04.05.2007 0 1288 03:02:00 04.05.2007 0 1289 03:02:00 04.05.2007 0 1287 03:02:00 04.05.2007 0 1288 03:02:00 04.05.2007 0 1289 03:02:00 04.05.2007 0 1287 03:02:00 04.05.2007 0 1288 03:02:00 04.05.2007 0 1289 03:02:00 04.05.2007 0 1287 03:02:00 04.05.2007 0 1288 03:02:00 04.05.2007 0 1289 03:06:00 04.05.2007 0 1287 03:06:00 04.05.2007 0 1288 03:06:00 04.05.
03:10:00 1287 03:10:00 1288 03:10:00 1289 03:10:00 1287 03:10:00 1288 03:10:00 1289 03:10:00 1287 03:10:00 1288 03:10:00 1289 03:10:00 1287 03:10:00 1288 03:10:00 1289 04.05.2007 0 0 0 3 1 0 109095574 0 3 04.05.2007 0 0 0 3 1 0 109095574 0 3 04.05.2007 0 0 0 3 1 0 109095574 0 3 04.05.2007 0 1 0 3 0 0 0 0 3 04.05.2007 0 1 0 3 0 0 0 0 3 04.05.2007 0 1 0 3 0 0 0 0 3 04.05.2007 0 2 0 3 0 0 0 0 3 04.05.2007 0 2 0 3 0 0 0 0 3 04.05.
4 Database Administration Commands The PA XP CLUI supports the following commands for database administration: ExportDB Command You can use the ExportDB command to export data, for charting or graphing, and including the Ext-Lun information to a data visualization program, such as Microsoft Excel. The output of the ExportDB command for the dkc performance data contains the maximum configuration of an XP12000 array, even though the XP10000 array has a maximum of 4 CHIPs and 2 ACPs.
–d An optional parameter used to specify delimited output data. There is no space between d and the delimiter character. –L An optional parameter used to specify labeled and delimited output data. –hr An optional parameter used to request the data in a human-readable format. –ms The address of a management station in the form http://path.to.managementstation/. –auth A username and password pair in the form username:password. The array serial number. –st
Example 3. Exportdb 1 Exportdb st 07.06.2001 11:00:00 et 07.06.2001 12:00:00 file 0706export.txt -dkc 31045 This command retrieves the data collected between 11am and noon, and places the data in a single text file named 0706export.txt. Using this command, without the -dver switch, ensures that the output produced is consistent with PA Version 1.05.00. If you want the output to be consistent with the PA Version 1.06.00 formatting, use the –dver switch, as shown in the next example. Example 4.
record. E-Port list can have one or more Port names because of the dual paths configuration. If the -hr option is not used, the E-Port list, E-DEV, and LDEV ID are in integer format. where: E-Port list The Ext-Lun Initiator port(s) that is connected to the external array. E-Seq The external array serial number. E-LDEV The LDEV ID at the external array. CLPR The Cache Partitioning ID. Sample usage and output: ...,E-Port list, E-Seq, E-LDEV, CLPR ..., -1, -1, -1, -1 ..., CL1C, 20074, 0:90, CLPR0 ...
exportdb -dkc 10055 -st 09.14.2006 12:00:00 -et 09.14.2006 13:00:00 -dver 020000 -file test.csv -resp all Data records exported: 12 Data record export complete. -resp write Max Write Response Time(msec)-valid for last 30 secs -resp read Max Read Response Time(msec)-valid for last 30 secs -resp all Max Write Response Time(msec)-valid for last 30 secs and Max Read Response Time(msec)-valid for last 30 secs The following is the portion of data in the output file ldev_xxx.
The following is the sample output for the exportdb command on an XP24000 array. Time Stamp,DKC Serial Number,JID,MU,CTG,JNLS,AP,U(%),Q-Marker,Q-CNT,Num,LDEV# 2007-04-05 01:02:00.093,10001,0,0,0,3,1,0,109095574,0,3,1287 2007-04-05 01:02:00.093,10001,0,0,0,3,1,0,109095574,0,3,1288 2007-04-05 01:02:00.093,10001,0,0,0,3,1,0,109095574,0,3,1289 2007-04-05 01:02:00.093,10001,0,1,0,3,0,0,0,0,3,1287 2007-04-05 01:02:00.093,10001,0,1,0,3,0,0,0,0,3,1288 2007-04-05 01:02:00.
2007-04-05 2007-04-05 2007-04-05 2007-04-05 2007-04-05 2007-04-05 2007-04-05 2007-04-05 2007-04-05 2007-04-05 2007-04-05 2007-04-05 01:22:00.109,10001,0,0,0,3,1,0,109095574,0,3,1287 01:22:00.109,10001,0,0,0,3,1,0,109095574,0,3,1288 01:22:00.109,10001,0,0,0,3,1,0,109095574,0,3,1289 01:22:00.109,10001,0,1,0,3,0,0,0,0,3,1287 01:22:00.109,10001,0,1,0,3,0,0,0,0,3,1288 01:22:00.109,10001,0,1,0,3,0,0,0,0,3,1289 01:22:00.109,10001,0,2,0,3,0,0,0,0,3,1287 01:22:00.109,10001,0,2,0,3,0,0,0,0,3,1288 01:22:00.
Database Administration Commands
5 CLUI for partially supported hosts For some hosts (such as Linux), PA XP can retrieve performance data, but cannot obtain configuration information directly from the host. To offer some level of support, a set of CLUI commands is provided for administrators to manually enter configuration information, so that these hosts can still be used to monitor performance. A separate document, UserHostConfig.
CLUI for partially supported hosts
6 Version Command The report CLUI application provides a command that displays the version of the PA. Version usage Following is the general format of the command to invoke the script: version [-v] [-?] where: –v Displays full version string. –? Prints the usage statement. Version sample output The following is the output data sample for the CLUI shell script described in the previous section: version -v hp StorageWorks performance advisor 3.2 version 3.3.1 BUILD: 04.10.06:05.50.
Version Command
7 Troubleshooting This section addresses questions and problems that customers have experienced while using the Performance Advisor XP CLUI. Following are some common error messages, their causes, and suggested solutions: Classpath error Problem: Unable to initialize threads: cannot find class java/lang/Thread Could not create Java VM. Solution: Earlier versions of the Performance Advisor XP CLUI required the user to set some environment variables.
Troubleshooting
8 Translating LDEV from PA XP data into a cu:ldev pair The cu:ldev mapping is obtained by dividing the LDEV value by 256. The quotient is the CU value and the remainder is the LDEV value.
Translating LDEV from PA XP data into a cu:ldev pair
9 Array mapping To correctly map the ACP and CHIP pairs, see the following tables for the respective array: Table 2 lists 1 ACP pair for disk array XP48/128. NOTE: The cards are lettered A-M, omitting I. Table 2 XP48/128 (1 ACP Pair) B, L ACP Pair 1 ACP B = 0; L = 4 C, G CHIP Pair 1 Chip C = 0; G = 4 D, J CHIP Pair 2 Chip D = 1; J = 5 F, K CHIP Pair 3 Chip F = 2; K = 6 Table 3 lists the 2 ACP pairs for disk array XP48/128. NOTE: The cards are lettered A-M, omitting I.
Table 4 XP 256/512/1024 A, M ACP Pair 1 ACP A = 0; M = 4 B, N ACP Pair 2 ACP B = 1; N = 5 L, X ACP Pair 3 ACP L = 2; X = 6 K, W ACP Pair 4 ACP K = 3; W = 7 E, Q CHIP Pair 1 Chip E = 0; Q = 4 F, R CHIP Pair 2 Chip F = 1; R = 5 G, T CHIP Pair 3 Chip G = 2; T = 6 H, U CHIP Pair 4 Chip H = 3; U = 7 A, M CHIP Pair 5 Chip A = 8; M = 12 B, N CHIP Pair 6 Chip B = 9; N = 13 L, X CHIP Pair 7 Chip L = 10; X = 14 K, W CHIP Pair 8 Chip K = 11; W = 15 Table 5 lists the 2 ACP pairs for
Table 7 XP24000 1AU/2MU 1AL/2ML DKA Set 1 DKA AU=0 , AL=1, DKA MU=8, ML=9 1BU/2NU 1BL/2NL DKA Set 2 DKA BU=2, BL=3 DKA NU=10,NL=11 1LU/2XU 1LL/2XL DKA Set 3 DKA LU=4, LL=5 DKA XU=12,XL=13 1KU/2WU 1KL/2WL DKA Set 4 DKA KU=6, KL=7 DKA WU=14,WL=15 1EU, 2QU 1EL, 2QL CHA Pair 1 CHA EU=0, EL=1 CHA QU=8,QL=9 1FU,2 RU 1FL,2 RL CHA Pair 2 CHA FU=2,FL=3 CHA RU=10,RL=11 1GU, 2TU 1GL, 2TL CHA Pair 3 CHA GU=4,GL=5 CHA TU=12,TL=13 1HU,2UU 1HL,2UL CHA Pair 4 CHA HU=6,HL=7 CHA UU=14,UL=15 1AU,2MU 1A