HP ProLiant DL320e HP Scripting Toolkit 9.30 for Windows User Guide
HP ProLiant DL320e Manual
View all HP ProLiant DL320e manuals
Add to My Manuals
Save this manual to your list of manuals |
HP ProLiant DL320e manual content summary:
- HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 1
Toolkit for Windows User Guide Abstract This document provides information about the Scripting Toolkit for Windows utilities and how best to use the Scripting Toolkit for Windows to configure HP ProLiant servers and BladeSystem infrastructure in a Windows environment. This document is intended - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 2
to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 3
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 - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 4
not using the Oxx ROM family...26 CONREP -l (Load from Data file) Example usage for HP ProLiant servers not using the Oxx ROM family...26 CONREP Data File Sample Contents for HP ProLiant servers not using the Oxx ROM family.........26 CONREP command file contents 27 Using HPRCU...28 HPRCU command - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 5
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 - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 6
in scripting operating system installations and configuring HP ProLiant and BladeSystem infrastructure server hardware. CAUTION: Improper use of HP Scripting Toolkit for Windows • HP Scripting Toolkit for Windows User Guide • Microsoft Windows Automated Installation Kit for Windows 7 and Server - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 7
server on target servers with minimal user interaction. IMPORTANT: HP ProLiant 100-Series servers previous to Gen8 do not support all Scripting Toolkit commands, and those that are supported Toolkit utilities. Some options must be configured manually or with other configuration utilities, which are - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 8
www.hp.com/go/ProLiantSTK. 2. Install the Scripting Toolkit SoftPaq on a common server that resides on the same network as the servers to files are stored in this directory. HP also recommends installing the latest version of the HP Service Pack for ProLiant (SPP). To obtain the most current - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 9
about Windows PE 3.0, see the Windows Preinstallation Environment User's Guide (WinPE.chm) located in the Windows Automated Installation Kit. Windows PE documentation. Adding drivers to Windows PE 4.0 The Scripting Toolkit contains HP drivers that are to be used with Windows PE 4.0. These drivers are - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 10
\system32\drivers For more information about Windows PE 4.0, see the Windows Advanced Deployment Guide for System Builders located in the Microsoft Windows Assessment and Deployment Kit for Windows 8 and Windows Server 2012. For more information about the Windows PE drivers included in the Scripting - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 11
the storage of the target server with the captured settings: a. Change to the directory where HPACUSCRIPTING resides. b. Apply the captured configuration to the target array: bin \hpacuscripting.exe -i s:\data\filename 4. (Optional) Configure the iLO option. HP recommends that you set these - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 12
deployment scripts using HPDISCOVERY and IFHW Use the HPDISCOVERY utility to determine which devices and capabilities are available in a particular HP ProLiant server. HPDISCOVERY generates an XML-based output file that provides information such as system ROM version, amount of RAM available, and - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 13
key provides the ideal medium for this type of activity. NOTE: Booting from a USB drive key is supported only on certain HP ProLiant servers. For more information, see the SPP website at http://www.hp.com/go/spp. To boot Windows PE from a USB drive key, see the Microsoft Windows PE documentation - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 14
2 goto REBOOTREQUIRED if errorlevel 1 goto NEXT2 goto end NEXT1: REM Try next system type System\ifhw hpdiscovery.xml System\allboards.xml HWQ:SystemName eq "ProLiant DL380 G3" if errorlevel 1 goto NEXT2 REM ---REM This section performs the System ROM Flash. Online Flash components REM are kept in - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 15
, see the HP Online ROM Flash User Guide on the HP Software and Driver Downloads website at http://www.hp.com/support. Erasing array configurations file called ErasePart.txt that contains the following commands: REM This file instructs Diskpart.exe to select the first disk as REM target, then clean - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 16
file name followed by /? in the command line. For example, for usage instructions on the CONREP utility, enter the following command: CONREP /? The utility installation process, read the source server configuration, and duplicate the configuration on a target server through a generated script file. - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 17
• RBSURESET • HPDISCOVERY • IFHW • HWQUERY • CONREP • HPRCU • HPACUSCRIPTING • HPLPCFG • LO100CFG (Utility only supports HP ProLiant 100 series servers) • HPQLAREP • HPONCFG (Not supported on HP ProLiant 100 series servers using the Oxx ROM family) Using REBOOT The REBOOT utility enables the user to - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 18
to the SETBOOTORDER take affect at the next reboot. For HP ProLiant servers with Oxx ROM Family (most 100 series servers), only one device can be set as the boot device and others cannot be re-ordered. These Oxx servers do not support the default or usb parameters. SETBOOTORDER command-line syntax - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 19
by reapplying the default factory setting at the next reboot. To prevent accidental or malicious damage to a server's configuration, this utility only functions in a Windows PE environment. It will not operate in any other Windows environment. RBSURESET does not erase array configurations or - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 20
server. HPDISCOVERY is executed by the server configuration script and captures the following information: • System ID (This field is not supported on 100 series servers NOTE: Information may not be as detailed on HP ProLiant 100 series servers. HPDISCOVERY command-line syntax hpdiscovery /f /p [ - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 21
HPDISCOVERY return codes Value 0 1..255 Meaning The command was completed successfully. A usage message might appear. An error has occurred. See error message for details. HPDISCOVERY command line examples NOTE: Before running HPDISCOVERY, you must install WMI. For more information on installing - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 22
number, used for comparison Expression examples Expression input "PCI:Smart Array 5i" HWQ:TotalRAM gte 512 HWQ:ROMDate neq "11/12/2004" HWQ:SystemName eq "ProLiant DL380 G2" Result True if the Smart Array 5i Controller is found in the system True if the amount of RAM in the hardware discovery - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 23
G2" and "PCI:Smart Array 5i" and HWQ:ROMDate eq "11/12/2004" Result True if the system is a ProLiant DL380 G2 with a Smart Array 5i Controller present and a ROM date of 11/12/2004 "PCI:Smart Array 5i" or "PCI:Smart Array True if - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 24
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 http:// www.hp.com on the support - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 25
loads the system configuration from a file and writes it to the target server. This argument defines the name and location of the XML hardware definition file Copyright (c) 2007-2012 Hewlett-Packard Development Company, L.P. System Type: ProLiant DL360 G4 ROM Date: 08/16/2005 ROM Family: P52 XML - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 26
, otherwise, the default file names Conrep.xml and Conrep.dat are used, respectively. NOTE: A platform specific XML file needs to be used for HP ProLiant 100-series servers. Using the default name may cause an error while running the CONREP utility. CONREP -l (Load from Data file) Example usage for - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 27
to the following: - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 28
78 c1 Using HPRCU HPRCU is an RBSU configuration utility similar to CONREP. This utility is supported on HP ProLiant Gen8 servers and later. This utility does not use a definition XML file like the CONREP utility, but directly reads the same table that - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 29
The command was completed successfully. The server is not supported by this utility. The input XML server settings. See the error message for details. HPRCU sample XML format A sample XML format generated by HPRCU is similar to the following: ProLiant DL380 Gen8 - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 30
the Configuring Arrays on HP Smart Array Controllers Reference Guide on the HP website at http://www.hp.com/support/CASAC_RG_en. Users familiar the configuration of all internal and external array controllers connected to the server and then writes a script file describing this configuration. • Input - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 31
for capturing a configuration (page 30). You can create a capture file from any server that has ACU loaded, and then modify the values of options in the file as RAID 60 configuration in Auto mode. You must create such configurations manually using the Custom setting. Controller = All | First | Slot - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 32
PreferredPathMode = Auto|Manual ; COMMENT: the following five entries are used to optimize the controller performance Default | Windows | Windows(degrade | openVMS | Tru64 | Linux | Solaris | Netware | HP | Windows Sp2 ; COMMENT: The Windows(degrade value must be entered as written. Script file - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 33
The options for each category are listed in the following table and described in more detail in the remainder of this section. Category Control Controller Array Logical Drive HBA Options Description Action Method Use these options to define the overall behavior of ACU when it processes scripts - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 34
[N]-Configure the shared storage controller that has serial number N. • IOCabinet[N],IOBay[N],IOChassis[N],Slot[N],Cabinet[N],Cell[N]-Configure the controller in the Integrity server that has the slot path information defined by this sequence of identifiers. 34 Scripting Toolkit utilities - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 35
controller that is in an active/active configuration. Not all controllers support this feature, and controllers in an active/standby configuration disregard this to the logical drive and dynamically load balances all paths. • Manual enables you to assign the logical drive to a specific redundant - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 36
valid only for controllers that enable SSP on a controller basis, such as the MSA1000 or the Smart Array Cluster Storage controllers. RA4x00 controllers support SSP that is enabled on a logical drive basis, and use the LogicalDriveSSPState option (page 38) instead. If you enable SSP, you must also - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 37
Array category The Array category has the following options: • "Array" (page 37) • "Drive" (page 37) • "DriveType" (page 37) • "OnlineSpare" (page 38) Array Enter a letter or pair of letters to identify the array you are creating or reconfiguring, and observe these additional limitations: • In - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 38
ID number of any existing logical drive. LogicalDriveSSPState This option is valid only for controllers that enable SSP on a logical drive basis. Other controllers that support SSP use the SSPState option (page 36). 38 Scripting Toolkit utilities - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 39
RAID 50, four for RAID 60). PreferredPath If you select the Manual setting for PreferredPathMode, use the PreferredPath command to specify the path for the chassis slot numbers, use the show command on a controller that supports redundant controllers. RAID The value that you enter for this option - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 40
array, as long as the operating system supports logical drive extension. You cannot reduce the size of the logical drive. CAUTION: Back up all data before extending a logical drive. SSPAdaptersWithAccess Enter values here - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 41
• OpenVMS • Tru64 • Linux • Solaris • Netware • HP-UX ACU scripting error messages Error code Error message Comment or clarification array that has RAID 1 logical drives, and the controller does not support RAID-level migration. 1053 Cannot remove physical drives from existing array. This - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 42
expansion if, for example, the cache battery has low charge, another expansion or migration is already in progress, or the array has the maximum supported number of physical drives. 2825 Invalid array. The array ID is invalid. 2826 Array not specified. The script file has commands that require - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 43
change array spare. This error message appears if you try to change the number of spares in an array when the configuration does not support the addition or subtraction of spares. 2832 Invalid physical drive. A specified physical drive is not a valid physical drive, or it cannot be placed in - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 44
. - 2869 command expected. The command is missing or in the wrong place in the script file. 2870 is not a supported command. - 2871 is not a Controller command. The command does not belong in the Controller section of the script file. 2872 - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 45
WWID of the boot volume and the LUN number that the WWID boots from. The HPLPCFG utility discovers the WWID of the HBA in the server blade and writes the information in the text file. The text file presents the options in human readable format. The HPLPCFG utility updates the hardware - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 46
not using the Oxx ROM family. LO100CFG enables you to configure the LightsOut 100 device that is available on the HP ProLiant 100 series servers. Under Windows, WMI is used through the Microsoft_IPMI class, make sure WMI is installed in the Windows PE environment. LO100CFG command-line syntax - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 47
and then exits. This argument captures the current status and outputs it to the console. The argument lists basic command line arguments and supported XML tags. This argument loads and runs the given XML configuration file. This argument saves the current configuration to a file. This argument has - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 48
WWID of the boot volume and the LUN number that they will boot from. The hpqlarep utility discovers the WWID of the HBA in the server blade and writes the information in the text file. The text file presents the options in human readable format. The hpqlarep utility updates the hardware - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 49
HPQLAREP return codes Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Meaning The command was completed successfully. There was an invalid command line option. There was a file open error. There was an NVRAM checksum error. There was an NVRAM data error. There was no adapter found on this - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 50
/go/ilo. Also, see the HP iLO 4 Scripting and Command Line Guide (for Gen8 servers) on the HP website at http://www.hp.com/go/proliantgen8/docs or the HP ProLiant Integrated Lights-Out 3 v1.20 Scripting and Command Line Guide (for G7 servers) on the HP website at www.hp.com/go/ilo. HPONCFG command - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 51
HPONCFG return codes Value 0 1 Meaning The script was sent successfully to the device. The script could not be sent to the device. If the script itself fails, errors are reported in the log file created by HPONCFG. HPONCFG command file contents HPONCFG can be used to perform the following tasks: - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 52
- HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 53
> The specified user will be added to the device. HPONCFG command-line examples For HPONCFG command line examples, see the appropriate user guide on the HP iLO website at http://www.hp.com/go/ilo. Using HPONCFG 53 - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 54
Input files for HPONCFG Sample script files HP ProLiant drivers WMI support Non-functioning IFHW CONREP version compatibility HPACUSCRIPTING support Booting from a USB drive key Customizing the DEPLOYSERVER.CMD script SETBOOTORDER changes Troubleshooting Improper use of the Scripting Toolkit - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 55
information For support software, drivers and firmware, see the HP software and drivers website at http:// www.hp.com/go/hpsc. HP also recommends installing the latest version of the HP SPP, which contains system software, drivers, and firmware for HP ProLiant servers and BladeSystem infrastructure - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 56
of your HP Warranty, HP Care Pack Service, or HP contractual support agreement. HP Insight Remote Support supplements your in two variants: • HP Insight Remote Support 7.x software is optimized to support up to 500 devices and can be installed on a Windows ProLiant hosting device or a Windows - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 57
recommended version for HP Proactive Care Service. • HP Insight Remote Support Advanced supports medium-sized to large environments with up to 3,500 devices. It can be installed on a Windows ProLiant hosting device or a Windows ESXi Virtual Machine and requires HP Systems Insight Manager. Optionally - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 58
documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback ([email protected]). Include the document title and part number, version number, or the URL when submitting your feedback. 58 Documentation feedback - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 59
-Based Setup Utility Remote Insight Board Command Language read-only memory serial attached SCSI serial ATA small computer system interface HP Service Pack for ProLiant Selective Storage Presentation State Manager utility universal serial bus vital product data Windows Management Instrumentation 59 - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 60
WOL WWID WWN WWPN XML Wake-on LAN World Wide ID World Wide Name worldwide port name extensible markup language 60 Acronyms and abbreviations - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 61
configurations erasing, 15 C clearing a configuration, 35 configuration capturing, 30 target server, 11 configurations capturing, 10 CONREP, 24 arguments, 25 command file contents, 27 command-line syntax, 24 data file sample HP ProLiant 100 series, 26 Load from Data file example, 26 return codes, 25 - HP ProLiant DL320e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 62
, 19 command-line examples, 19 command-line syntax, 18 return codes, 19 support, 55 symbols in text, 56 syntax conventions, 16 T target server configuring, 11 technical support, 55 text symbols, 56 troubleshooting, 54 typographic conventions, 56 U utilities Scripting Toolkit, 16 62 Index V video
HP Scripting Toolkit for Windows User
Guide
Abstract
This document provides information about the Scripting Toolkit for Windows utilities and how best to use the Scripting Toolkit
for Windows to configure HP ProLiant servers and BladeSystem infrastructure in a Windows environment. This document is
intended for IT experts with experience in scripting operating system installations and configuring HP ProLiant server hardware.
HP Part Number: 415598-409
Published: October 2012
Edition: 18