Hp XP Performance Advisor Software Manuel d'utilisateur

HP StorageWorks Performance Advisor XPSoftware command-line user interface userguidePart number: T1789-96026First edition: September 2007

10About this guide

1IntroductionThis document discusses the command -line user interface (CLUI) suppor ted in HP StorageWorksPerformance Advisor XP Soft ware (PA XP) . Y

12Introduction

2 Install ating and uninstalling PAXPPreparing for installationComplete the following steps before installing the PA XP CLUI:1. Installation requireme

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

3 Reportin g an d configuring CLUIshell scriptsThe supported shell scripts enable you to use the CLU I easily. Each CLUI script is provided with a shel

LDEV E-PortE-SeqE-LDEV0:01 CL1 C200741:010:02 CL1 C200741:020:03 CL1 C200741:030:04CL2C20074 1:040:05 CL1 C200741:050:05 CL2 C200741:0516Reporting and

CLPR (CACHEGRP)The report CLUI application provides a script that displays the CLPR data. The -dkc switch is a requiredelement. Optionally, you can sp

CACHEG RP sample outputThefollowingareoutputdatasamplesfortheCLUIshellscriptdescribedintheprevioussection:cachegrp -dkc 10851 -clpr 0 -hrRaidGroup Cac

Disk Controller snapshot script (DKCS)The report CLUI application provides a script that displays Disk Controller Snapshot data. The —dkcswitch is a r

Legal and notice information© Copyright 1999, 2006 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP requi

dkcs -L -dkc 30143Array Type, Serial No., Record Time, Record Date, Micro Code,RMLib Version,Chip P MP 0,Chip P MP 1,Chip P MP 2,Chip P MP 3,Chip Q MP

dkcs -L -dkc 30143Array Type, Serial No., Record Time, Record Date, Micro Code, RMLib Version,Chip P MP 0,Chip P MP 1,Chip P MP 2,Chip P MP 3,Chip Q M

Array Type: XP 24000Serial #: 10001Record Time: 16:30:00Record Date: 03/30/2007Micro Code: 60-00-20/00Raid Manager Lib: 01.12.03Chip Data: ACP Data:EU

Disk controller history script (DKCH)The report CLUI application provides a script that displays Disk Controller History data. The -dkc switch isarequ

dkch -dkc 10055 hrStart Time: 05:30:00 01.01.1970End Time: 05:30:00 01.01.1970Array Type: XP 12000Serial #: 10055Record Time: 10:30:00Record Date: 06/

dkch -L -dkc 30143Start Time, End Time, Time, Date, Serial No., TypeChip P MP1,Chip P MP 2,Chip P MP 3,Chip P MP 4,Chip Q MP 1,Chip Q MP 2,Chip Q MP 3

The ACP data displays as <ACP Name>U for upper and <ACP Name>L for lower. For example, ACP AUpper displays as AU.The following is an examp

Lo gical unit host snapshot script (LUNH)The report CLUI application provides a script that displays Logical Unit Host Snapshot data. The outputfor th

NOTE:Labels in labeled outputs (specifiedby-hror-Linthecommandline)areinbold.Cache Fast Wr ites and DA SD Fast Writes are applicable to mainframe volum

lunh -ha hpbs1428.user.server.com -hr -dver 010600Array ID: 30143 Array Type: XP512Lun ID:1 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c0t0d1LDEV ID:

ContentsAboutthisguide ... 7Intendedaudience... 7Prerequisites ...

lunh -ha hpbs1428.user.server.com -hr -dver 015100Array ID: 30143 Array Type: XP512Lun ID:0 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c0t0d0LDEV ID:

lunh -ha angus -dkc 10 001 hrArray ID: 10001Dev. File: /dev/rdisk/disk552(/dev/rdsk/c53t2d4)Lun ID:20 Volume-Grp.:- LDEV ID: 0:00LDEV IO/Sec:8 Emulati

Logical unit disk controller snapshot script (LUND)The report C LUI application provides a command that displays Logical Unit Disk Controller Snapshot

NOTE:Labels in labeled outputs (specified by –hr or –L in the command line) are in bold. The amount of datahas been reduced for this document.Cache Fas

lund -dkc 30143hpbs2167.user.server.com,0, ,/dev/rdsk/c17t0d0,0:0,0,OPEN-3-CM,0004,’1-1,CL2D,0,1,1hpbs2196.user.server.com,0, ,/dev/rdsk/c17t0d0,0:0,0

lund -dkc 30143 -hr -dver 015100Host ID: hpbs1428.user.server.comLun ID: 0 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c0t0d1LDEV ID: 0:00 LDEV IO/Sec

lund -hr -dkc <array sn no>Host ID: cvsuse232.rose.hp.com Dev. File: /dev/sdlLun ID:10 Volume-Grp.:- LDEV ID: 0:0 LDEV IO/Sec :0Emulation: OPEN-

Logical device history script (LDEV)The report CLUI application provides a comma nd that displays Logical Device History data.The required elements fo

ldev -dkc 30143 -ldev 1:6C -st 01.03.2001 12:49:00 -et 01.03.2001 14:20:00Start Time: 08092006 151500 End Time: 08092006 154200+++++++++++++++++++++++

ldev -dkc 10055 -hr -ldev 0:7E -dverStart Time: 06262006 093800 End Time: 06262006 153000+++++++++++++++++++++++++++++++++++++++Ldev ID: 0:7E Date: 06

Host configurationscript(HOSTCFG)... 51HOSTCFGusage ... 51HOSTCFGsampleoutput...

ldev -dkc 10055 -ldev 0:7E -dver 010600 LStart Time, End Time1151294880100,1151316000119Time, Date,Random Reads, Random Read Hits, Random Writes, Rand

Alarm history script (ALMH)This command is now deprecated and does nothing if called. Use the Alarm history script (ALARMHIST)command instead.Alarm hi

–metric <Category>Constrains the output by the metric category. Valid values are as follows:IO_TOTAL - LDEV IO TotalIO_RAND_TOTAL LDEV – IO Rand

–d<delim>The delimiter for delimited display. Used with –list and –details.–hr Displays human-readable output. Used with –list an d –details.–?P

alarmhist -hrAlarm ID:2 Array ID: 10227 Metric Value:1Metric Category: THP POOL OCCUPANCYAlarm State: Level_1 Threshold:9Time Posted: 2002-03-01 11:40

Port performance data script (PORT)The CLUI provides a command that displays port performance data. The required elements for thiscommand are –dkc and

port -dkc 30143 -port cl1a -hrSerial #: 30143Port ID: CL1ATime Date Ma x IO/s Min IO/s AvgIO/s Max MB/s Min MB/s Avg MB/s023000 11022001 900 700 800 8

–dkc <serial num>The array serial number. Not required if -list is used.–mval <Item List>The items for which alarms are being created. Thi

–ms <managementstation>The URL of the management station.–auth <user:passwd>The username andpassword.–pf <password file> Can be used

configalarm -list -hrArray ID: 30143 Item: 1:F6 Dispatch Level:3Threshold 1: 999999 Threshold 2 : 999999 Threshold 3: 999999Email Destinations:SNMP De

Tables1..Documentconventions ... 82..XP48/128(1ACPPair)... 953..XP48/128(2ACPPairs)...

configalarm —listN,10227,0,SNAPSHOT POOL OCCUPANCY,99999,99999,99999,3, , ,NOconfigalarm -list hrArray ID: 10001 Item: THP-PID(3) Dispatch Level: 3Met

Host configuration script (HOSTCFG)This CLUI script requests array information from a Host Agent, removes unwanted hosts, or un requestsarray informati

User host configuration script (USERHOSTCONFIG)This CLUI script enables you to request the host configuration information.USERHOST CONFIG usageFollowing

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,

RAID group data script (RAIDGRP)PA XP maintains some information about the RAID g roups of the array, such as the RAID level, ACP Pair,Control Unit, a

raidgrp -dkc 10055 -rg 1-5 1-610055,1-5 1-6,5,AM,R0004,R0104,R0204,R0304,R0414,R0514,R0614,R0714,R0005,R0105,R0205,R0305,R0415,R0515,R0615,R0715HP Sto

Event log data script (EVNTLOG)The event log keeps track of events such as data purge or collection con figuration. With this script,you can use the CL

evntlog -LTime,Date,Type,Severity,Description16:20:37,02.14.2002,10,5,Purged all performance data for array 30143.16:20:35,02.14.2002,10,5,All records

User-defined group script (USERGRP)This script enables you to create, list, and remove user-defined groups.USERGRP usageFollowing is the general format

usergrp -items 10033::CLPR1-CLPR2 name custom1Operation completed successfullyusergrp -list -hrGroup ID, Group Name1 demo1usergrp -list -LGroup ID, Gr

6

usergrp -details -hr -gid 1Array ID: <array sn no> Array Type: XP24000Lun ID: 6 Volume-Grp.:-/dev/vg00 Dev. File: /dev/rdsk/c3t15d6LDEV ID: 1:FE

Database configuration script (DBCONFIG)This script provides some database configuration capabilities. The user can modif y data retention times,purge d

Aggregate script (AGGREGATE)The report CLUI application provides a command that displays the Cache Par titioning data. Use theaggregate command to req

–items<item list>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:ite

LDEV_IO_TOTAL Total LDEV IOs/secLDEV_IO_RAND_TOTAL - Total Random LDEV IOs/secLDEV_IO_RAND_READ LDEV Random IO reads/secLDEV_IO_RAND_READCACHE LDEV Ra

ACP_PAIR_IO_TOTAL - ACP pair total IO’s/secACP_PAIR_IO_RTOTAL - ACP pair total random IO’s/secACP_PAIR_IO_RREAD - ACP pair random read IO’s/secACP_PAI

RAIDGRP_IO_TOTAL - Raid group total IO’s/secRAIDGRP_IO_RTOTAL - Raid group total random IO’s/secRAIDGRP_IO_RREADS - Raid group random read IO’s/secRAI

CFW_TOTAL LDEV IO typeCFW_READ LDEV IO typeCFW_READ_CACHE LDEV IO typeCFW_WRITE LDEV IO typeCFW_WRITE_CACHE LDEV IO t ypeDFW_COUNT LDEV IO typeDFW_NRM

aggregate -items ldev_io_total:Fred4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4320.0,4396.0aggregate -items ldev_io_total:Fred L2002-06-1

aggregate -items ldev_io_total:20031:1:f4-1:f9+1:fc —hr2002-06-12 11:08:00.0: 5040.0 2002-06-12 11:09:00.0: 5040.02002-06-12 11:10:00.0: 5040.0 2002-0

About this guideThis guide provides an overview of the command–line user interface scripts and commands of thePerformance Advisor XP (PA XP) software.

Overall Raid Group Utilization sample outputUtilization is expressed as a percentage with fractional precision.For example: 100.0 is 100%aggregate –it

Properties utility script (PROPUTILITY)This CLUI script enables you to configure the properties filewhichinturnenablesyoutointegrateothersoftware and s

THP sample outputThefollowingareoutputdatasamplesfortheCLUIshellscriptdescribedintheprevioussection:thp dkc <array sn no> -hrPoolID Occupancy(%)

Snapshot script (SNAPSHOT)This command enables you to obtain Snapshot Pool related information. This command provides theSnapshot pool occupancy value

Continuous Access Journal scr ipt (JNL)This command enables you to obtain Continuous Access Journal related information. This commandprovides the foll

where:–jid The journal ID that is being queried.–respThe journal LDEV’s read and write response time.–st <mm.dd.yyyyhh:mm:ss>Constrain by a cert

jnl -hr -dkc 10001 -jid 0JID MU CTG JNLS AP U(%) Q-Marker Q-CNT Num LDEV#0 0 0 3 1 0 109095574 0 3 12870 0 0 3 1 0 109095574 0 3 12880 0 0 3 1 0 10909

jnl -hr -dkc 10001 -jid 0 -st 4.5.2007 03:00:00 -et 4.5.2007 03:10:00TIME DATE JID MU CTG JNLS AP U(%)Q-Marker Q-CNT Num LDEV#03:02:00 04.05.2007 0003

03:10:00 04.05.2007 0003 10 109095574 0 3128703:10:00 04.05.2007 0003 10 109095574 0 3128803:10:00 04.05.2007 0003 10 109095574 0 3128903:10:00 04.05.

4 Datab ase Adminis trationC ommandsThe PA XP CLUI supports the following commands for database administration:ExportDB CommandYou can use theExportDB

Document conventions and symbolsTable 1 Document conventionsConventionElementBlue text: Table 1Cross-reference links and email addressesBlue, underlin

–d<delim>An optional parameter used to specify delimited output data. There is no space betweend and the delimiter character.–LAn optional param

Example 3. E xportdb 1Exportdb st 07.06.2001 11:00:00 et 07.06.2001 12:00:00 file 0706export.txt-dkc 31045This comma nd retrieves the data collected b

record. E-Por t list can have one or m ore Port n ames because of the dual paths configuration. If the -hroption is not used, the E-Port list, E-DEV, a

exportdb -dkc 10055 -st 09.14.2006 12:00:00 -et 09.14.2006 13:00:00 -dver 020000-file test.csv -resp allData records exported: 12Data record export co

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,Nu

2007-04-05 01:22:00.109,10001,0,0,0,3,1,0,109095574,0,3,12872007-04-05 01:22:00.109,10001,0,0,0,3,1,0,109095574,0,3,12882007-04-05 01:22:00.109,10001,

86Database Administration Commands

5CLUIforpartiallysupportedhostsFor some hosts (such as Linux), PA XP can retrieve performance data, but cannot obtain configurationinformation directly

88CLUI for pa rtially supported hosts

6VersionCommandThe report CLUI application provides a command that displays the version of the PA.Version usageFollowing is the general format of the

WARNING!To reduce the risk of personal injury or damage to equipment:• Extend leveling jacks to the floor.• Ensure that the full wei ght of the rack re

90Version Command

7 TroubleshootingThis section addresses questions and problems that customers have experienced while using thePerformance Advisor XP CLUI. Following a

92Troubleshooting

8 Transl ating LDEV from PA XPdata into a cu:ldev pairThe cu:ldev mapping is obtained by dividing the LD EV value by 256. The quotient is the CU value

94Translating LDEV from PA XP data into a cu:ldev pair

9 Array mappingTo correctly map the ACP and CHIP pairs, see the following tables for the respective a rray:Table 2 lists 1 AC P pair for disk array XP

Ta b l e 4 XP 256/512/1024A, M ACP Pair 1 ACP A = 0; M = 4B, N ACP Pair 2 ACP B = 1; N = 5L, XACPPair3 ACPL=2;X=6K, W ACP Pair 4 ACP K = 3; W = 7E, Q

Ta ble 7 XP240001AU/2MU1AL/2MLDKA Set 1 DKA AU=0 , AL=1,DKA MU=8, ML=91BU/2NU1BL/2NLDKA Set 2 DKA BU=2, BL=3DKA N U=10,NL=111LU/ 2X U1LL/2XLDKA Set 3