/ 
Compellent-CompCU-0.02
River stage zero No dependents
/ Compellent::CompCU

NAME

Compellent::CompCU - Perl interface to the Compellent command line tool.

SYNOPSIS

use Compellent::CompCU;
my $cli=new Compellent::CompCU({host=>"compellent.myorg.org",
                                user=>"user",
                                password=>"passwd",
                                java_path=>"/usr/bin/java",
                                java_args=>"-client",
                                compcu_path=>"/Users/ar881/Downloads/CU050501_004A/CompCU.jar"});
my $success;
my $output=[];
$cli->alert_acknowledge({controller=>8432,index=>6,success=>\$success,output=>$output});
$cli->mapping_show({success=>\$success,output=>$output);
$cli->volume_create({name=>"myvolume",size=>"1000000000m",success=>\$success,output=>$output});

DESCRIPTION

Compellent::CompCU provides a Perl wrapper around Compellent's command line tool. The Compellent command line tool is distributed in the jar file CompCU.jar. Consequently, you must have Java and the CompCU.jar file in order for this to work.

Note that since we are wrapping a Java application each function called invokes a new instance of the JVM and so scripts using this module may seem slower than one may initially expect. This shouldn't be a problem since raw blistering performance is seldom required for these types of tasks but this idiosyncrasy should be made clear.

Every one of the CompCU functions is available through this interface. Each function takes a hash reference as its single argument. Parameters to each function are provided as key/value pairs as shown in the examples.

This module is written in the pseudo literate programming style provided by Lip::Pod. As such it comes with internal and external documentation. The documentation on each and every function and the acceptable parameters for each is contained in the internal documentation. The internal documentation is generated by the lip2pod command installed with the Lip::Pod module. Once installed run the following command:

lip2pod Compellent/CompCU.pm | pod2html --title=Compellent::CompCU > compcu-i.html

And then view compcu-i.html in a web browser.

This page is obtained by pod2html directly:

pod2html --title=Compellent::CompCU --noindex Compellent/CompCU.pm > compcu-e.html

Of course you may use other pod translators if you would prefer a format other than html.

SEE ALSO

Whenever in doubt the authoritative reference is the vendor's documentation: "Storage Center Command Utility User Guide". This is distributed as a .pdf file by Dell.

AUTHOR

Adam Russell, <ac.russell@live.com>

COPYRIGHT AND LICENSE

Copyright (C) 2012 by Adam Russell

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.12.3 or, at your option, any later version of Perl 5 you may have available.