HP 3PAR CheckHealth Command

If you are running a HP 3PAR storage array you want to be certain it’s in a healthy state at all times. While you could look through all of the management menus to check the status of components it’s far easier to leverage the checkhealth command.

Let’s take a look at the command and some of it’s options.

First we will connect to the 3PAR array (in this case a 3PAR simulator) via SSH.

I will connect using the standard 3PAR administrator account, if you have not changed the default password it will be as follows –

  • Username – 3paradm
  • Password – 3pardata

I would strongly recommend you change default passwords or better yet create a separate service account.

SSH to 3PAR

Once we are connected to the array we can enter the checkhealth command.

Checkhealth Command

As you can see the command executes providing feedback on each stage followed by a summary of any outstanding issues. As I mentioned above I am running this test on a copy of the 3PAR simulator so I fully expect to see some problems here.

Of course in an ideal world you wouldn’t want to see any issues listed in the summary but to be honest the odds are you are going to see something now and then.

We can leverage the help command to see additional information and options for checkhealth.

3PARLAB01 cli% help checkhealth

Help Checkhealth Command

As you can see there are a few command switches we can use, typically I use the –detail switch to get a complete review of the array.

3PARLAB01 cli% checkhealth -detail

Checkhealth -detail Command

You can see that additional output is provided, again as this is a simulator you will see issues which shouldn’t occur in an actual array.

If you wish to check a single component you can append this to the command as below.

3PARLAB01 cli% checkhealth snmp
Checking snmp
The following components are healthy: snmp

Or if you wish to check a number of components.

3PARLAB01 cli% checkhealth snmp host date
Checking snmp
Checking host
Checking date
The following components are healthy: snmp, host, date

 

There are of course other ways to check the health of your array with things like proactive alerts from the service processor (SP) or via other management tools and I will probably cover these in a future posting at some point.

For reference here is the full help output for the command –

3PARLAB01 cli% help checkhealth
checkhealth - Check the current health of the system.

SYNTAX
checkhealth [<options> | <Component>...]

DESCRIPTION
The checkhealth command checks the status of system hardware and software
components, and reports any issues

AUTHORITY
Super, Service
Any role granted the health_check right

OPTIONS
-lite
Will perform a minimal health check.

-list
Will list all components that will be checked.

-quiet
Will not display which component is currently being checked.

-detail
Will display detailed information regarding the status of the system.

SPECIFIERS
<Component>
Indicates the component to check. Use -list option to get the list of
components.

NOTES
None.

EXAMPLES
In the following example, the overall health status of all the components
is listed:

cli% checkhealth
Checking alert
Checking cabling
Checking cage
Checking dar
Checking date
Checking host
Checking ld
Checking license
Checking network
Checking node
Checking pd
Checking port
Checking rc
Checking snmp
Checking task
Checking vlun
Checking vv
Checking fs

 

2 thoughts on “HP 3PAR CheckHealth Command”

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.