HP ProLiant ML310e HP Scripting Toolkit 9.30 for Windows User Guide
HP ProLiant ML310e Manual
View all HP ProLiant ML310e manuals
Add to My Manuals
Save this manual to your list of manuals |
HP ProLiant ML310e manual content summary:
- HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 1
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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 2
HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Microsoft, Windows, Windows Server - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 3
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 Booting Windows PE from a USB drive key 13 Flashing the ROM in a Windows PE environment 13 Erasing array configurations...15 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 4
output...25 CONREP -s (Store to Data file) Example usage for HP ProLiant servers 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 5
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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 6
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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 7
, USB drive key, or PXE). 3. Configure the system and storage hardware on the target server. 4. Install the operating system. 5. Update the drivers and agents as needed. IMPORTANT: Not all options can be configured using Scripting Toolkit utilities. Some options must be configured manually or with - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 8
Toolkit folder for configuration files. Captured 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 SPP, see the SPP website at http://www.hp.com/go/spp. Adding drivers to Windows PE 3.0 The - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 9
to work correctly, complete the following steps to ensure the appropriate iLO driver (based on OS and version number) is installed and the STK IO driver (hpsstkio.sys) is copied to the windows\system32\ drivers directory. To add drivers offline: 1. Mount the base image to a local directory by using - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 10
PE driver bundle in the drivers directory. NOTE: Before running HPDISCOVERY, you must install WMI. For more information on installing extra packages in Windows PE, see the Windows PE documentation. Capturing a reference configuration from the source server 1. Boot the media (CD/DVD, USB drive key - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 11
. d. Configure the iLO option: hponcfg -f s:\data\iLOconfig.xml 5. Insert the operating system DVD. 6. Reboot to run the operating system installation. For information on automated, unattended installation, see the following resources: • Operating system documentation • Windows Server Technical - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 12
HP ProLiant server. HPDISCOVERY generates HPDISCOVERY data in the hpdiscovery.xml file for the system name HP ProLiant RAID 5 ADG setting. The following example demonstrates how to use IFHW to detect a particular card or device: REM *** Configure the array controllers by reading the configuration - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 13
. 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. Flashing the ROM in a Windows PE environment You can run - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 14
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 a directory called - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 15
: End: For more information about Online ROM Flash Smart Components, 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 Before beginning the deployment process, you might want to erase the current array - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 16
line switch for executable files. Specifies the name of the hard disk drive, diskette drive, or other storage device. Specifies the route the operating system the installation process, read the source server configuration, and duplicate the configuration on a target server through a generated script - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 17
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) are A:, C:, CD, RBSU, or PXE. By specifying an argument, the drive indicated is set to boot on the next reboot, and the system is - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 18
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 devices to boot in this order: CD-ROM drive, hard drive, PXE, USB, diskette drive. This command sets the boot order to the - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 19
return code is 0. Using RBSURESET RBSURESET resets the BIOS settings for a server 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 20
detailed on HP ProLiant 100 series servers. HPDISCOVERY command-line syntax hpdiscovery /f /p [drive:][path]filename [/?] HPDISCOVERY command line arguments Command-line argument [drive:][path]filename /? /p /f Description This argument specifies the location and name of the HPDISCOVERY data file - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 21
WMI. For more information on installing extra packages in Windows PE, see the Windows PE documentation. Command line argument hpdiscovery /f x:\hpdiscovery.xml hpdiscovery /p plugin storage.dll hpdiscovery Description This command generates the hpdiscovery.xml file in the x:\ location. This - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 22
gt lt gte lte eq neq not PCI: HWQ: Result True if both operands are true True if either operand is true True 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 23
11/12/2004" Result True if the system is a ProLiant DL380 G2 with a Smart Array 5i Controller present and deployment. The HWQUERY utility enables you to use data from the hardware discovery file in your own scripts Command-line argument [drive:][path]hpdiscoveryfilename [drive:][path]allboards.xml - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 24
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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 25
ProLiant DL360 G4 ROM Date: 08/16/2005 ROM Family: P52 XML System Configuration: conrep.xml Hardware Configuration: demo.dat File contains global platform restrictions Global Restriction: [minimumconrepversion] OK Platform check: [ProLiant DL3] match [ProLiant DL5] no match Saving configuration data - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 26
the default name may cause an error while running the CONREP utility. CONREP -l (Load from Data file) Example usage for HP ProLiant servers not using the Oxx ROM family To load the BIOS configuration settings from a previously captured/edited data file (in this case sl160zconrep.dat) to an SL160z G6 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 27
">10 Protection CONREP command file contents A typical data file generated by the CONREP command is similar to the following: - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 28
> 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 does, which are located in the memory at system boot. When the BIOS changes or adds a new setting, no update to HPRCU is needed. • Default - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 29
the XML configuration defaults completed successfully. The server is not supported by this utility 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 ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 30
For more information, see 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 with the previous versions of ACU Scripting must now install the ACU CLI application to obtain the scripting executable. The new - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 31
configuration to several servers creating new logical drives. You can use this Configure|Reconfigure Method = Custom|Auto ; COMMENT: ACU cannot create a RAID 50 or RAID 60 configuration in Auto mode. You must create such configurations manually 10|20|25|30|40|50|60|70|75|80|90|100 WriteCache = 0|10 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 32
, the choices are Yes|No. Drive = * | N | Port:ID,Port:ID... | Box:Bay,Box:Bay... | Port:Box:Bay,Port:Box:Bay,... DriveType = SCSI | SAS | SATA LogicalDrive = 1|2|3|...32 RAID = 0|1|5|50|6|60|adg|auto ; COMMENT: RAID 6 and 60 are only available when SAAP is installed and the license key registered - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 33
options in this category in any order. ArrayAccelerator LogicalDrive LogicalDriveSSPState ParityGroups PreferredPath RAID Sectors Size SSPAdaptersWithAccess StripeSize Use these options to describe a logical drive you are configuring on an array previously specified in the script. (If no array was - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 34
logical drive extension, or a migration. These procedures do not destroy data, unless you specifically want the data to 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 35
drive is set for a redundant array controller that is in an active/active configuration. Not all controllers support this feature, and controllers in an active/standby configuration number between 0 and 100 to specify the percentage of cache to be allocated to drive write ratio 100:0 90:10 80:20 75:25 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 36
Array Cluster Storage controllers. RA4x00 controllers support SSP that is enabled on a logical drive basis, and use the LogicalDriveSSPState option logical drives by using the SSPAdaptersWithAccess option (page 40). Otherwise, SSP is automatically disabled. SurfaceScanDelay Enter a number between - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 37
of letters in the existing configuration. Drive You can use this option to add a drive to an existing array (to number of drives to use (not which specific drive IDs to use), enter that number as the value for this option. For example, if you enter drive=3, ACU uses the first three available drives - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 38
that is to be created or modified. The first logical drive on an array must have an ID of 1 (not 0), and logical drive numbering must be contiguous. • In Configure action mode, ACU accepts only the ID number of the next possible logical drive. • In Reconfigure action mode, ACU also accepts the ID - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 39
level that the controller and drive configuration can support except RAID 50 or RAID 60. To specify RAID 50 or 60 for a controller that supports either of these RAID levels, use the Custom setting. In this case, you must also specify the number of parity groups (page 39). • When the Action mode is - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 40
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 to identify the SSP adapters that you want to have access to a logical drive. The values are - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 41
occurred during the configuration process, but ACU cannot identify the error because there is an internal ACU error. 1052 Array requires an odd number of drives. This error message occurs if you attempt to add an odd number of drives to an array that has RAID 1 logical drives, and the controller - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 42
. Systems running Microsoft Windows must have the System Management Driver loaded. 1110 Controller does not support license keys. - 1111 Invalid license key. - 1112 Controller has maximum number of license - keys. 1114 Controller requires non-failed physical - drives to set license keys - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 43
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 the array. 2833 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 44
end with a space character or exceed the maximum number of characters allowed by the controller. 2852 Invalid SSP state. - 2853 Cannot change SSP settings. - 2854 Invalid SSP adapter ID. - 2855 Controller does not support logical drive - SSP states. Use the SSPState controller command to - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 45
configuration value 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 data error. Using HPLPCFG 45 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 46
1 (for /l option only) Incorrect iboot BIOS code loaded (for /l option only) General error hba.ini generates hba.ini HP ProLiant servers 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 47
arguments and supported XML tags. This argument loads and runs the given XML configuration file. This argument saves the current configuration to a drivers. NOTE: Return codes of 100 or higher are returned from the LO100 processor. LO100CFG command-file contents A typical data file generated by - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 48
lo100cfg> To disable the shared NIC configuration and make the Lights-Out 100 NIC dedicated, enter the following in your data file: - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 49
Name) was invalid. There was a Memory Allocation error. The adapter has no VPD. There was a failure reading the adapter VPD. The adapter has no VPD. VPD has bad checksum. The adapter serial number is missing in the VPD. HPQLAREP command-line examples hpqlarep /s hba.ini generates hba.ini with the - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 50
must be loaded on the server. HPONCFG displays a warning if the driver is not installed. For more information, see the HP iLO website at http://www.hp.com/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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 51
entire configuration from iLO. In this case, the utility executes from the command line without specification of an input file. The name of the output file is given on the command line. For example: hponcfg -w config.xml In this example, the utility indicates that it obtained the data successfully - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 52
= "mandy9" PASSWORD = ""> For security reasons, the user passwords are not returned. Obtaining a specific configuration A specific configuration can be obtained using the appropriate XML input file. For example, the contents of a typical XML input file - HP ProLiant ML310e | 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 ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 54
5 Troubleshooting Troubleshooting table Issue Data loss in STK Configuring options using STK utilities 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 55
product resources. Related 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 56
shortcuts. HP Insight Remote Support software HP strongly recommends that you install HP Insight Remote Support software to complete the installation or upgrade of your product and to enable enhanced delivery of your HP Warranty, HP Care Pack Service, or HP contractual support agreement. HP Insight - HP ProLiant ML310e | 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 ML310e | 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 ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 59
access memory ROM-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 - HP ProLiant ML310e | 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 ML310e | 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 , 40 logical drive category, 38 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Windows User Guide - Page 62
, 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 performance optimization, 36 W websites, 55 Windows Preinstallation Environment, 6 adding drivers to version 3.0, 8 adding
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