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

HWQUERY return codes

Meaning

Value

The command was completed successfully.

0

N

arguments were ignored because they were not in the

variable=<string>

format.

n

HWQUERY command-line examples

Description

Command-line argument

For a

hpdiscovery.xml

file that contains

<TotalRAM>768</TotalRAM>, HWQUERY produces the

following:

hwquery hpdiscovery.xml allboards.xml

MY_SYS_RAM=TotalRAM

MY_SYS_RAM=768

For a

hpdiscovery.xml

file that indicates a Smart Array

5i Controller is present, HWQUERY produces the following:


"TEST=Smart Array"

TEST=Smart Array 5i Controller

For a

hpdiscovery.xml

file that contains

<TotalRAM>768</TotalRAM> and


MYRAM=TotalRAM MYROMDATE=ROMDate

<ROMDate>11/15/2002</ROMDate>,HWQUERY

produces the following:

MYRAM=768

MYROMDATE=11/15/2002

Although the controller is present, HWQUERY produces

the following:


"TEST=smart array 5i"

TEST=

This behavior is correct. The string is case-sensitive, and

the argument uses lowercase lettering instead of the

uppercase found in the allboards.xml file.

Using CONREP

The CONREP utility generates a system configuration XML file used to duplicate the hardware

configuration of one HP ProLiant server onto another. The CONREP utility uses the hardware

configuration XML file to identify and configure the system, which defaults to

conrep.xml

. You

can change the default using the -x option. The actual system configuration file is captured as an

XML data file. The default name is

conrep.dat

.

CAUTION:

Improper modification of the CONREP data files can result in the loss of critical data.

Only experienced users of the Scripting Toolkit should attempt to modify the data files. Because

of the potential risk of data loss, take all necessary precautions to ensure that mission-critical systems

remain online if a failure occurs.

The CONREP utility reads the state of the system environment settings to determine the server

configuration and writes the results to a file that you can edit. The CONREP utility uses the data in

the generated file to configure the target server hardware.

The CONREP utility uses an XML definition file to determine what information to retrieve from and

restore to the server. You can modify this file to update new features or restrict features when

capturing configurations. The default

conrep.xml

file contains common hardware configuration

settings for most HP ProLiant series servers other than HP ProLiant 100 series servers using the Oxx

ROM family. Some platforms require special settings that are contained in other XML files. These

files are included in the Scripting Toolkit and are available from the HP website at

h

t

tp://

24

Scripting Toolkit utilities

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 24

HWQUERY return codes, HWQUERY command-line examples, Using CONREP

Page 24 highlights