1. By Platform Technical Support
hpacucli
By Platform Technical Support
May 18 | Confidential

2. Contents Example of a rebuilding drive
Description/Location/How to Run/Requirements
Shorthand Symbols
Help Options
Information Needed
“show” command
The Logical Drive
How to look at the all physical drives
How to look at the logical drive
How to show all the information for a controller array
How to show all the information for a physical drive
How to turn on/off a physical drive LEDp
Example of a rebuilding drive
May 18 | Confidential

3. Description/Location/How to Run/Requirements
hpacucli is a Array Configuration Utility CLI is a commandline-based disk configuration program for Smart Array Controllers and RAID Array Controllers.
Can be used while NPS is running with no impact to NPS
Location:
/opt/compaq/hpacucli/bld
How to Run:
/opt/compaq/hpacucli/bld/hpacucli
Requirements:
Need to be logged in as root
May 18 | Confidential

4. Shorthand Symbols
Shorthand symbols can be used wherever regular target and command keywords are used in order to save keystrokes.
aa = arrayaccelerator
ai = adapterid
ch = chassisname (also known as boxname or raidarrayid)
cn = connectionname
cr = cacheratio
ctrl = controller
dt = drivetype
ep = expandpriority
ld = logicaldrive
pd = physicaldrive
ps = parallelscsi
rp = rebuildpriority
ssd = surfacescandelay
sn = serialnumber
ss = stripesize
td = tapedrive
May 18 | Confidential

5. Help Options CLI Internal Help Command Help:
The CLI has it's own internal help system that provides syntax and usage examples.
Command Syntax: /opt/compaq/hpacucli/bld/hpacucli help
Command Help:
For detailed command information type any of the following:
help add
help create
help delete
help modify
help remove
help shorthand
help show
help target
help rescan
May 18 | Confidential

6. Information Needed What HP Model you have
The “slot” you will use to gather information on the host array will have a different number depending on what Host you have.
How to determine the host remotely
As root: dmidecode | grep Product
Slot Numbers:
DL380 G3 => Slot 0
DL385 G1 => Slot 0
DL385 G2 => Slot 1
DL585 G1 => Slot 0
DL585 G2 => Slot 9
May 18 | Confidential

7. Information Needed (cont)
How to get information on the MSA Array
The MSA is a little bit harder as you need to acquire the Serial Number for it, which can be done by the following command:
/opt/compaq/hpacucli/bld/hpacucli ctrl all show
MSA500 G2 at M3XSLYPN8C (sn: PAB360NX3UC056, csn: M3XSLYPN8C)
Smart Array 642 in Slot 2 (sn: P9226AGXQTM05A)
Smart Array P400 in Slot 9 (sn: P61630D9SUL0D5)
The serial number is in red
May 18 | Confidential

8. show /opt/compaq/hpacucli/bld/hpacucli help show
The show command outputs information about a device or a list of devices.
<target> show [config] [detail]
The show command outputs information about the specified device. To force a
more detailed and verbose output, specify the "detail" parameter. To see the
configuration, which includes the targeted device along with all of the
devices that it aggregates, specify the "config" parameter. The target can
be any valid device except when using the "config" parameter. In this case
the specified target must be a controller.
<target> show [status]
Displays the status information for the specified device(s). The target can
be any valid device.
<target> show [ssp]
Displays the ssp information for the specified controller. The target can be
any valid controller that supports ssp.
Examples:
ctrl ch="lab 3" show config detail
ctrl all show status
ctrl ch="lab 3" show ssp
May 18 | Confidential

9. The Logical Drive
The Logical Drive is the single drive that all the physical drives make
How to view it:
On a Host: /opt/compaq/hpacucli/bld/hpacucli ctrl slot=X ld all show
On the MSA: /opt/compaq/hpacucli/bld/hpacucli ctrl sn=X ld all show
Samples:
Normal Logical Drive
logicaldrive 1 (410 GB, RAID 5, OK)
When a drive is rebuilding, the logical drive will be rebuilding
logicaldrive 1 (410 GB, RAID 5, Rebuilding)
If a rebuild is required to make the array normal again, you will something like this
logicaldrive 1 (410 GB, RAID 5, Ready for Rebuild)
May 18 | Confidential

10. How to look at all physical drives
NON MSA:
/opt/compaq/hpacucli/bld/hpacucli ctrl slot=X pd all show
Where X equals the Host slot number
Sample:
/opt/compaq/hpacucli/bld/hpacucli ctrl slot=9 pd all show
Smart Array P400 in Slot 9
array A
physicaldrive 1I:1:1 (port 1I:box 1:bay 1, SAS, 72 GB, OK)
physicaldrive 1I:1:2 (port 1I:box 1:bay 2, SAS, 72 GB, OK)
physicaldrive 1I:1:3 (port 1I:box 1:bay 3, SAS, 72 GB, OK)
physicaldrive 1I:1:4 (port 1I:box 1:bay 4, SAS, 72 GB, OK)
physicaldrive 2I:1:5 (port 2I:box 1:bay 5, SAS, 72 GB, OK)
physicaldrive 2I:1:6 (port 2I:box 1:bay 6, SAS, 72 GB, OK)
physicaldrive 2I:1:7 (port 2I:box 1:bay 7, SAS, 72 GB, OK)
physicaldrive 2I:1:8 (port 2I:box 1:bay 8, SAS, 72 GB, OK, spare)
May 18 | Confidential

11. How to look at all physical drives (cont)
MSA:
Use the earlier slide on how to acquire the MSA Serial Number and then
/opt/compaq/hpacucli/bld/hpacucli ctrl sn=X pd all show
Where X equals the MSA Serial Number
Sample
1) You need to acquire the serial number for the MSA:
/opt/compaq/hpacucli/bld/hpacucli ctrl all show
MSA500 G2 at M3XSLYPN8C (sn: PAB360NX3UC056, csn: M3XSLYPN8C)
Smart Array 642 in Slot 2 (sn: P9226AGXQTM05A)
Smart Array P400 in Slot 9 (sn: P61630D9SUL0D5)
2) You then need to copy and paste the serial number like below
/opt/compaq/hpacucli/bld/hpacucli ctrl sn=PAB360NX3UC056 pd all show
MSA500 G2 at M3XSLYPN8C
array A
physicaldrive 1:1 (box 1:bay 1, Parallel SCSI, 146 GB, OK)
physicaldrive 1:2 (box 1:bay 2, Parallel SCSI, 146 GB, OK)
physicaldrive 1:8 (box 1:bay 8, Parallel SCSI, 146 GB, OK)
physicaldrive 1:9 (box 1:bay 9, Parallel SCSI, 146 GB, OK)
physicaldrive 1:3 (box 1:bay 3, Parallel SCSI, 146 GB, OK, spare)
May 18 | Confidential

12. How to get information on the controller array (NOT MSA)
Input the slot number for your host into the command below
/opt/compaq/hpacucli/bld/hpacucli ctlr slot=0 show
Controller Smart Array 5i in Slot 0
Bus Interface: pci
slot: 0
RAID ADG status: False
Controller Status: OK
Chassis Slot: 1
Hardware Revision: Rev B
Firmware Version: 2.66
Rebuild Priority: Low
Expand Priority: Low
Surface Scan Delay: 15 sec
Cache Board Present: True
Cache Status: OK
Accelerator Ratio: 100/0 (read/write)
Read Cache Size: 48 MB
Write Cache Size: 0 MB
Total Cache Size: 48 MB
Battery Backed Cache Size: 0 MB
Non Battery Backed Cache Size: 48 MB
Battery Pack Count: 0
May 18 | Confidential

13. How to get information on the controller array (MSA)
Use the earlier slide to get the Serial Number for the MSA Array and then input it in the following command like such
/opt/compaq/hpacucli/bld/hpacucli ctrl sn=PAB360JX3TA094 show
Controller MSA500 G2 at MAJJLYPN6V
Bus Interface: scsi
serialnumber: PAB360JX3TA094
chassisname: MAJJLYPN6V
SSP Type: controller centric ssp
RAID ADG status: True
SSP State: disabled
Controller Status: OK
Redundancy State: Active
Redundancy Status: OK
Redundancy Mode: activestandby
Chassis Slot: 1
Redundant Controller:
Chassis Slot: 2, sn: PAB360KX3TC08N
Hardware Revision: Rev A
Firmware Version: 1.56
Rebuild Priority: Low
Expand Priority: Low
Surface Scan Delay: 15 sec
Cache Board Present: True
Cache Status: OK
Accelerator Ratio: 50/50 (read/write)
Read Cache Size: 128 MB
Write Cache Size: 128 MB
Total Cache Size: 256 MB
Battery Backed Cache Size: 256 MB
Non Battery Backed Cache Size: 0 MB
Battery Pack Count: 1
Battery Status: OK
May 18 | Confidential

14. How to show all the information for a physical drive
Input the slot number for your host into the commands below
1) Identify the drive you want by looking at a list of then all
/opt/compaq/hpacucli/bld/hpacucli ctlr slot=0 pd all show
Smart Array 5i in Slot 0
array A
physicaldrive 2:0 (port 2:id 0 , Parallel SCSI, GB, OK)
physicaldrive 2:1 (port 2:id 1 , Parallel SCSI, GB, OK)
physicaldrive 2:2 (port 2:id 2 , Parallel SCSI, GB, OK)
physicaldrive 2:3 (port 2:id 3 , Parallel SCSI, GB, OK)
2) Once you picked out the drive you, insert the location like below
/opt/compaq/hpacucli/bld/hpacucli ctlr slot=0 pd 2:0 show
physicaldrive 2:0
SCSI Bus: 2
SCSI ID: 0
Status: OK
Drive Type: Data Drive
Interface Type: Parallel SCSI
Size: GB
Transfer Mode: Ultra 3 Wide
Transfer Speed: 160 MB/Sec
Rotational Speed: 10000
Firmware Revision: HPB8
serialnumber: 3HY8LGLT ZRKM
For a drive on the MSA, first use the earlier slide to get the Serial Number for the MSA, then use the same commands above but replace “slot=#” with “sn=X”
May 18 | Confidential

15. How to turn on/off a physical drive LED
1) List all the drives:
/opt/compaq/hpacucli/bld/hpacucli ctrl slot=X pd all show
Where X equals the slot number
2) Identify the drive you want
3) Turn ON LED
/opt/compaq/hpacucli/bld/hpacucli ctrl slot=X pd Y:Z modify led=on
<LED: blinking RED for NON G2, and solid blue on G2’s>
For example:
On a NON G2:
/opt/compaq/hpacucli/bld/hpacucli ctrl slot=0 pd 1:2 modify led=on
On a G2:
/opt/compaq/hpacucli/bld/hpacucli ctrl slot=9 pd 1I:1:1 modify led=on
4) Turn OFF LED
/opt/compaq/hpacucli/bld/hpacucli ctrl slot=X pd Y:Z modify led=off
May 18 | Confidential

16. Example of a rebuilding drive
When a host drive is replaced, you will see the system rebuilding to that drive for roughly 3 hours.
Here is a sample of how it will look:
/opt/compaq/hpacucli/bld/hpacucli ctrl slot=0 pd all show
Smart Array 5i in Slot 0
array A
physicaldrive 1:0 (port 1:id 0 , Parallel SCSI, GB, OK)
physicaldrive 1:1 (port 1:id 1 , Parallel SCSI, GB, OK)
physicaldrive 2:0 (port 2:id 0 , Parallel SCSI, GB, Rebuilding)
physicaldrive 2:1 (port 2:id 1 , Parallel SCSI, GB, OK)
May 18 | Confidential