HP Array Configuration Utility User Guide (416146-001, January 2006)

Scripting in ACU 31
Scripting in ACU
In this section
Introduction to scripting in ACU ............................................................................................................... 31
Operating modes................................................................................................................................... 31
Command line syntax ............................................................................................................................. 31
Sample custom input script ...................................................................................................................... 32
Script file options ................................................................................................................................... 33
Error reporting ....................................................................................................................................... 40
Introduction to scripting in ACU
ACU provides scripting support to enable you to configure array controllers in a customized, predictable,
and unattended manner.
Each line of text in an ACU script file is written in the format option=value and can be in either
uppercase or lowercase letters. You can improve the clarity of the script by leaving lines blank and by
creating comments. To create a comment, enter a semicolon and then the comment text. ACU ignores all
text on the same line after a semicolon.
Operating modes
Scripting in ACU has two modes of operation:
In Capture mode, the configuration of all internal and external array controllers that are connected to
a server is saved to a script file. You can then use the script file to replicate the array configuration
on other servers that have similar storage resources.
NOTE: You can also perform array replication by using the HP Array Configuration Replicator (ACR).
However, the two utilities are not functionally identical. ACU can read unmodified capture files from ACR,
but ACR cannot necessarily use ACU files.
In Input mode, the array configuration that is specified in a script file is applied to a target system.
The script file can be an unmodified or modified capture file, or you can write the script file from
scratch.
Input mode is subdivided into Automatic and Custom configuration modes.
In Automatic mode, you can enter the values for a few critical options and allow ACU to use default
values for all other options.
In Custom mode, you can specify every detail of the array configuration.
Command line syntax
In Capture mode:
cpqacuxe -c FILENAME