NAME

Parse::HP::ACU - Parse the output of HP's hpacucli utility.

VERSION

Version 0.03

SYNOPSIS

Parse::HP::ACU parses the output of HP's hpacucli utility to allow programmatic access to the RAID configuration information provided by the hpacucli utility on HP ProLiant servers.

    use Parse::HP::ACU;

    my $acu = Parse::HP::ACU->new();

Run the hpacucli tool directly to query the hardware (requires root):

    my $controllers = $acu->parse_config();
    

Parse a text file created already by running hpacucli tool:

    my $controllers = $acu->parse_config_file("foo.txt");

Read from a file descriptor already opened by the program:

    my $controllers = $acu->parse_config_fh(\*STDIN);

SUBROUTINES/METHODS

new

Return an instance of the HP::Parse::ACU class that can be used to parse input in one of several ways.

parse_config

Attempt to run the hpacucli utility, and parse the output. This command actually uses parse_config_fh() after opening a pipe to the relevant command.

The command that is actually run is approximately:

This command requires root access, and Parse::HP::ACU makes no attempt to use sudo or any other method to gain root access. It is recommended to call your script which uses this module as root.

The parse_config_fh() and parse_config_file() will expect output equivalent to that from the above command.

parse_config_file

Open and parse a file containing the output from hpacucli.

parse_config_fh

Read from the file handle and parse it, returning a hash-of-hashes.

AUTHOR

Jeremy Cole, <jeremy at jcole.us>

BUGS

Please report any bugs or feature requests to bug-parse-hp-acu at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Parse-HP-ACU. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

This module has been tested with at least the following RAID controllers:

This module has been tested with at least the following RAID configurations:

Other controllers or configurations may or may not work. Your feedback is appreciated in order to further test and refine the parsing code.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Parse::HP::ACU

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Parse-HP-ACU

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Parse-HP-ACU

• CPAN Ratings

  http://cpanratings.perl.org/d/Parse-HP-ACU

• Search CPAN

  http://search.cpan.org/dist/Parse-HP-ACU/

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2010 Jeremy Cole.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

cpanm Parse::HP::ACU

perl -MCPAN -e shell
install Parse::HP::ACU