HP ProLiant SL2500 HP Scripting Toolkit 9.60 for Windows User Guide - Page 31

Using an Input script

To use an Input script to configure or reconfigure a system, first locate a suitable HP SSA script or

see

“Creating an HP SSA script file” (page 31)

.

Then, enter the following command at the system command line prompt:

hpssascripting -i [drive:][path]

FILENAME.ext

[-internal | -external]

[-reset] -e [drive:][path]

ERRORFILENAME.ext

FILENAME

is the name of the HP SSA input file, and

ext

is the file extension. If you do not specify

the name and location of this file, HP SSA searches for

HPSSAINPUT.ini

in the HP SSA working

directory.

The

-internal

and

-external

switches limit configuration operations to internal or external

controllers.

The

-reset

flag destroys any existing data and overwrites the current configuration with the

configuration specified in the script.

The

-e

switch information is used only if HP SSA must generate an error file. By default, HP SSA

names the error file

ERROR.ini

and places it in the HP SSA working directory.

Creating an HP SSA script file

To create a valid HP SSA script file, use one of the following methods:

•

Modify the sample custom input script

(page 31)

.

•

Create a Capture file for capturing a configuration

(page 30)

.

You can create a capture file from any server that has HP SSA loaded, and then modify the

values of options in the file as necessary for the target system. This method is useful for applying

a standard configuration to several servers that have similar storage resources.

•

Write an original script.

Each line of text in an HP SSA script file is in the format

option = value

and can be written

in uppercase or lowercase letters. For information about possible option values and the

minimum configuration information that a valid script must have, see

“Sample custom input

script” (page 31)

.

You can add blank lines and comments to any script to make it easier to read and understand. To

create a comment, enter a semicolon, and then enter the comment text. HP SSA ignores all text on

the same line after a semicolon.

Sample custom input script

The sample script in this section gives all possible values for each option.

•

If an

option

is shown in bold type, you must enter a value for that option when writing your

own script.

•

If a

value

is shown in bold type, HP SSA uses that value as a default setting when creating

new logical drives.

You can use this script as a template for your own script. The Control category has the following

options:

•

Action mode

•

Method mode

Action

= Configure|Reconfigure

Method

= Custom|

Auto

;

COMMENT: HP SSA cannot create a RAID 50 or

RAID 60 configuration in Auto mode. You must create such

configurations manually using the Custom setting.

Using HPSSASCRIPTING

31

Section	Page
HP Scripting Toolkit for Windows 9.60 User Guide	1
Contents	3
1 Introduction	6
Scripting Toolkit for Windows	6
Microsoft Windows Preinstallation Environment	6
Minimum requirements	6
2 Deployment using the Scripting Toolkit for Windows	7
Deployment overview	7
Sample deployment procedure	7
Creating a network share	8
Adding drivers to Windows PE 3.0	8
Adding drivers to Windows PE 4.0	9
Capturing a reference configuration from the source server	10
Configuring the target server and installing the operating system	11
3 Advanced topics	12
Overview	12
Customizing deployment scripts using HPDISCOVERY and IFHW	12
Querying the HPDISCOVERY file based on system name	12
Querying the HPDISCOVERY file to determine the presence of a particular card	12
Querying the HPDISCOVERY file to determine the presence of a card family	13
Booting Windows PE from a USB drive key	13
Flashing the ROM in a Windows PE environment	13
Erasing array configurations	15
4 Scripting Toolkit utilities	16
Syntax conventions	16
Utility online help	16
Using Scripting Toolkit utilities	16
Using REBOOT	17
REBOOT command-line syntax	17
REBOOT command-line arguments	17
REBOOT return codes	17
REBOOT command-line examples	18
Using SETBOOTORDER	18
SETBOOTORDER command-line syntax	18
SETBOOTORDER command-line arguments	18
SETBOOTORDER return codes	18
SETBOOTORDER command-line examples	18
Using STATEMGR	19
STATEMGR command-line syntax	19
STATEMGR command-line arguments	19
STATEMGR return codes	19
STATEMGR command-line examples	19
Using RBSURESET	19
RBSURESET command-line syntax	20
RBSURESET command-line arguments	20
RBSURESET return codes	20
Using HPDISCOVERY	20
HPDISCOVERY command-line syntax	20
HPDISCOVERY command line arguments	20
HPDISCOVERY return codes	21
HPDISCOVERY command line examples	21
Using IFHW	21
IFHW command-line syntax	21
IFHW command-line arguments	22
IFHW return codes	22
IFHW command line examples	22
Expression operators and terms	22
Expression examples	23
Using HWQUERY	23
HWQUERY command-line syntax	23
HWQUERY command line arguments	23
HWQUERY return codes	24
HWQUERY command-line examples	24
Using CONREP	24
CONREP command-line syntax	25
CONREP command-line arguments	25
CONREP return codes	25
CONREP screen output	26
CONREP -s (Store to Data file)	26
CONREP –l (Load from Data File)	26
CONREP Data File Sample Contents for HP ProLiant servers not using the Oxx ROM family	27
CONREP command file contents	28
Using HPRCU	28
HPRCU command-line syntax	29
HPRCU command line arguments	29
HPRCU return codes	29
HPRCU sample XML format	29
Using HPSSASCRIPTING	30
Capturing a configuration	30
Using an Input script	31
Creating an HP SSA script file	31
Sample custom input script	31
Script file options	33
Control category	34
Action mode	34
Method mode	34
Controller category	34
Controller	35
ChassisName	35
ClearConfigurationWithDataLoss	35
LicenseKey, DeleteLicenseKey	35
PreferredPathMode	35
ReadCache, WriteCache	36
RebuildPriority, ExpandPriority	36
SSPState	36
SurfaceScanDelay	37
Video performance options	37
Array category	37
Array	37
Drive	37
DriveType	38
OnlineSpare	38
Logical Drive category	38
ArrayAccelerator	39
LogicalDrive	39
LogicalDriveSSPState	39
ParityGroups	39
PreferredPath	39
RAID	39
Sectors	40
Size	40
SSPAdaptersWithAccess	40
StripeSize	40
HBA category	41
ConnectionName	41
HBA_WW_ID	41
HostMode	41
HP SSA scripting error messages	41
Using HPLPCFG	45
HPLPCFG command-line syntax	45
HPLPCFG command-line arguments	45
HPLPCFG return codes	46
HPLPCFG command-line examples	46
Using LO100CFG	47
LO100CFG command-line syntax	47
LO100CFG command-line arguments	47
LO100CFG return codes	47
LO100CFG command-file contents	48
Using HPQLAREP	48
HPQLAREP command-line syntax	48
HPQLAREP command-line arguments	49
HPQLAREP return codes	49
HPQLAREP command-line examples	50
Using HPONCFG	50
HPONCFG command-line syntax	50
HPONCFG command-line arguments	50
HPONCFG return codes	51
HPONCFG command file contents	51
Obtaining an entire configuration	51
Obtaining a specific configuration	52
Setting a configuration	53
HPONCFG command-line examples	53
5 Troubleshooting	54
Troubleshooting table	54
6 Support and other resources	55
Information to collect before contacting HP	55
How to contact HP	55
Subscription service	55
Related information	55
Scripting Toolkit support	55
Typographic conventions	56
HP Insight Remote Support software	56
HP Insight Online	56
7 Documentation feedback	58
Acronyms and abbreviations	59

HP ProLiant SL2500 HP Scripting Toolkit 9.60 for Windows User Guide - Page 31

Using an Input script, Creating an HP SSA script file, Sample custom input script, Action, Method

Page 31 highlights