HP ProLiant WS460c HP Scripting Toolkit 9.50 for Linux User Guide - Page 36

</hprcu>

Using HPSSASCRIPTING

Starting with version 8.28.13.0, HP SSA Scripting is now a standalone application that is distributed

with the HP SSA CLI application. In HP SSA versions prior to 8.28.13.0, the scripting executable

was provided with the HP SSA GUI component.

For more information, see the

Configuring Arrays on HP Smart Array Controllers Reference Guide

on the HP website at

h

t

tp://w

w

w

.hp

.co

m/su

ppo

r

t/CA

S

A

C_R

G_e

n

.

Users familiar with the previous versions of HP SSA Scripting must now install the HP SSA CLI

application to obtain the scripting executable. The new HP SSA scripting executable

(

hpssascripting

) replaces the former executable (

cpqssaxe

) in all scripts.

The HP SSA Scripting application has two scripting modes:

•

Capture mode for capturing a configuration

(page 36)

HP SSA inspects the configuration of all internal and external array controllers connected to

the server and then writes a script file describing this configuration.

•

Input mode for using an Input script

(page 36)

HP SSA reads the array configuration described in a specified script file. See

“Creating an HP

SSA script file” (page 37)

. HP SSA then applies this configuration to a target system.

NOTE:

For a complete list of all command-line parameters, execute the

/?

utility.

Capturing a configuration

To capture the configuration of a system, enter the following command at the system command

line prompt:

hpssascripting -c [drive:][path]

OUTPUTFILENAME.ext

[-internal |

-external] -e [drive:][path]

ERRORFILENAME.ext

OUTPUTFILENAME

is the name of the capture file, and

ext

. is the file extension. If you do not

specify a name and location for this file, HP SSA uses the default name

HPSSAOUTPUT.ini

and

places the file in the HP SSA working directory.

The

-internal

and

-external

switches limit capture to internal or external controllers.

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.

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 37)

.

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.

36

Scripting Toolkit utilities

Section	Page
HP Scripting Toolkit for Linux 9.50 User Guide	1
Contents	3
1 Introduction	7
Scripting Toolkit	7
Minimum requirements	7
2 Deployment using the Scripting Toolkit	8
Deployment overview	8
Sample deployment procedure	8
Creating a network share	9
Capturing a reference configuration from the source server	9
Creating an ISO image to be written to media	10
Configuring the target server	11
Installing the operating system	11
3 Booting and OS installation	12
SYSLINUX	12
Booting using PXE	12
Setting up a TFTP server	13
Populating the TFTP directory share	14
Setting up a DHCP server	14
Booting from a USB drive key	15
Performing an unattended operating system installation	15
System hardware configuration	15
Microsoft Windows install_win.sh sample script	19
Red Hat Linux anaconda-ks.cfg sample file	19
4 Scripting Toolkit utilities	22
Native package formats	22
Syntax conventions	22
Utility online help	22
Using Scripting Toolkit utilities	23
Using REBOOT	23
REBOOT command-line syntax	23
REBOOT command-line arguments	23
REBOOT return codes	23
REBOOT command-line examples	24
Using SETBOOTORDER	24
SETBOOTORDER command-line syntax	24
SETBOOTORDER command-line arguments	24
SETBOOTORDER return codes	24
SETBOOTORDER command-line examples	24
Using STATEMGR	24
STATEMGR command-line syntax	25
STATEMGR command-line arguments	25
STATEMGR return codes	25
STATEMGR command-line examples	25
Using RBSURESET	25
RBSURESET command-line syntax	26
RBSURESET command-line arguments	26
RBSURESET return codes	26
Using BOOTEXTRACT	26
BOOTEXTRACT command-line syntax	26
BOOTEXTRACT command-line arguments	26
BOOTEXTRACT return codes	26
Using HPDISCOVERY	26
HPDISCOVERY command-line syntax	27
HPDISCOVERY command-line arguments	27
HPDISCOVERY return codes	27
HPDISCOVERY command-line examples	27
Using IFHW	27
IFHW command-line syntax	27
IFHW command-line arguments	27
IFHW return codes	28
IFHW command-line examples	28
Expression operators and terms	28
Expression examples	29
Using HWQUERY	29
HWQUERY command-line syntax	29
HWQUERY command-line arguments	29
HWQUERY return codes	29
HWQUERY command-line examples	30
Using CONREP	30
CONREP command-line syntax	31
CONREP command line arguments	31
CONREP return codes	31
CONREP screen output	31
CONREP -s (Store to Data file) Example usage for HP ProLiant servers not using the Oxx ROM family	32
CONREP –l (Load from Data File) Example Usage for HP ProLiant servers not using the Oxx ROM family	32
CONREP Data File Sample Contents for HP ProLiant servers not using the Oxx ROM family	32
CONREP command file contents for HP ProLiant servers not using the Oxx ROM family	33
Using HPRCU	34
HPRCU command-line syntax	34
HPRCU command line arguments	35
HPRCU return codes	35
HPRCU sample XML format	35
Using HPSSASCRIPTING	36
Capturing a configuration	36
Using an Input script	36
Creating an HP SSA script file	37
Sample custom input script	37
Script file options	38
Control category	39
Action mode	40
Method mode	40
Controller category	40
Controller	40
ChassisName	41
ClearConfigurationWithDataLoss	41
LicenseKey, DeleteLicenseKey	41
PreferredPathMode	41
ReadCache, WriteCache	41
RebuildPriority, ExpandPriority	42
SSPState	42
SurfaceScanDelay	42
Video performance options	42
Array category	43
Array	43
Drive	43
DriveType	43
OnlineSpare	44
Logical Drive category	44
ArrayAccelerator	44
LogicalDrive	44
LogicalDriveSSPState	44
ParityGroups	45
PreferredPath	45
RAID	45
Sectors	45
Size	45
SSPAdaptersWithAccess	46
StripeSize	46
HBA category	46
ConnectionName	46
HBA_WW_ID	47
HostMode	47
HP SSA scripting error messages	47
Using HPLPCFG	51
HPLPCFG command-line syntax	51
HPLPCFG command-line arguments	51
HPLPCFG return codes	51
HPLPCFG command-line examples	52
Using LO100CFG	52
LO100CFG command-line syntax	52
LO100CFG command-line arguments	53
LO100CFG return codes	53
LO100CFG command-file contents	53
Using HPQLAREP	54
HPQLAREP command-line syntax	54
HPQLAREP command-line arguments	54
HPQLAREP return codes	55
HPQLAREP command-line examples	55
Using HPONCFG	56
HPONCFG command-line syntax	56
HPONCFG command-line arguments	56
HPONCFG return codes	57
HPONCFG command file contents	57
Obtaining an entire configuration	57
Obtaining a specific configuration	58
Setting a configuration	59
HPONCFG command-line examples	59
5 Troubleshooting	60
Troubleshooting table	60
6 Support and other resources	61
Information to collect before contacting HP	61
How to contact HP	61
Subscription service	61
Related information	61
Scripting Toolkit support	62
Typographic conventions	62
HP Insight Remote Support software	62
HP Insight Online	63
7 Documentation feedback	64
Acronyms and abbreviations	65

HP ProLiant WS460c HP Scripting Toolkit 9.50 for Linux User Guide - Page 36

Using HPSSASCRIPTING, Capturing a configuration, Using an Input script

Page 36 highlights