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

1 Introduction

Scripting Toolkit for Windows

The Scripting Toolkit for Windows is a server deployment product that delivers an unattended

automated installation for high-volume HP ProLiant server and BladeSystem infrastructure

deployments. This document describes how to best use the Scripting Toolkit to configure HP ProLiant

servers and BladeSystem infrastructure. It also contains information about the Scripting Toolkit

utilities and how to use them in an unattended environment. This document does

not

include

information about installing the operating system.

The Scripting Toolkit is designed for IT experts with experience in scripting operating system

installations and configuring HP ProLiant and BladeSystem infrastructure server hardware.

CAUTION:

Improper use of the Scripting Toolkit utilities can result in loss of critical data. Because

of the potential data-loss risk, only experienced individuals should use the Scripting Toolkit utilities.

Before using the Scripting Toolkit, all necessary precautions must be taken to ensure that

mission-critical systems remain online if a failure occurs.

NOTE:

This release of the Scripting Toolkit uses Smart Storage Administrator (HP SSA), instead

of the Array Configuration Utility (ACU). HP SSA includes all of the functions previously contained

in ACU.

Microsoft Windows Preinstallation Environment

Microsoft Windows Preinstallation Environment (Windows PE) is a small footprint of the Windows

Server environment that enables you to run tools in a 32- or 64-bit Windows environment. Because

Windows PE is based on the Windows kernel running in protected mode, only a subset of features

and APIs are available in this environment. This document is applicable to Windows PE 3.0 and

4.0 only, and is not backward compatible with previous versions of Windows PE.

Windows PE enables you to install the Windows operating system, establish a connection with

network servers, and perform hardware configuration using the Scripting Toolkit. You can use

Windows PE to customize and configure your servers before the operating system is installed.

To obtain Windows PE 3.0, download the Microsoft Windows Automated Installation Kit for

Windows 7 and Windows Server 2008 R2 from the Microsoft website at

h

t

tp://w

w

w

.mi

c

r

o

s

o

f

t

.co

m

.

To obtain Windows PE 4.0, download the Microsoft Windows Assessment and Deployment Kit

for Windows 8 and Windows Server 2012 from the Microsoft website at

h

t

tp://w

w

w

.mi

c

r

o

s

o

f

t

.co

m

.

Minimum requirements

Before beginning the deployment process, be sure to have the following items available:

•

HP Scripting Toolkit for Windows

•

HP Scripting Toolkit for Windows User Guide

•

Microsoft Windows Automated Installation Kit for Windows 7 and Server 2008 R2 (for the

creation of Windows PE 3.0) or Microsoft Windows Assessment and Deployment Kit for

Windows 8 and Windows Server 2012 (for the creation of Windows PE 4.0).

•

The operating system to be deployed (Windows Server 2008 R2, Windows Server 2012 or

Windows Server 2012 R2)

6

Introduction

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 6

Introduction, Scripting Toolkit for Windows, Microsoft Windows Preinstallation Environment

Page 6 highlights