HP ProLiant SL2500 HP Scripting Toolkit 9.60 for Windows User Guide
HP ProLiant SL2500 Manual
View all HP ProLiant SL2500 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP ProLiant SL2500 manual content summary:
- HP ProLiant SL2500 | HP Scripting Toolkit 9.60 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: 722152-003 Published - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 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 SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 3
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 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 4
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 Capturing a configuration 30 Using an Input script...31 Creating an HP SSA script file 31 Sample custom input script 31 Script file - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 5
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 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 6
experts with experience in scripting operating system installations and configuring HP ProLiant and BladeSystem infrastructure server hardware. following items available: • HP Scripting Toolkit for Windows • HP Scripting Toolkit for Windows User Guide • Microsoft Windows Automated Installation - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 7
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 might not work as expected. For example, SETBOOTORDER might behave differently on these systems. For a better understanding, read the - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 8
Create an empty directory called \DATA in the Scripting 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 ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 9
do not work correctly. copy c:\ssstk\drivers\system\ hpsstkio\ hpsstkio.sys c:\SSSTK.TMP\ windows see the Windows Preinstallation Environment User's Guide (WinPE.chm) located in the Windows Adding drivers to Windows PE 4.0 The Scripting Toolkit contains HP drivers that are to be used with Windows PE - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 10
\ hpsstkio\ hpsstkio.sys c:\SSSTK.TMP\ windows\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 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 11
.exe -i s:\data\filename 4. (Optional) Configure the iLO option. HP recommends that you set these parameters: a. Edit the sample iLOconfig.xml s:\data\iLOconfig.xml 5. Insert the operating system DVD. 6. Reboot to run the operating system installation. For information on automated, unattended - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 12
based on the outcome of the tests. Querying the HPDISCOVERY file based on system name In the following script, the IFHW utility searches the HPDISCOVERY data in the hpdiscovery.xml file for the system name HP ProLiant BL20p. If the system name is found, the script calls the bl20p.cmd file. ifhw - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 13
components, require the use of a writable medium. A writable file system allows for the expansion of the contents of the components and provides 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 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 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 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 15
REM ---REBOOTREQUIRED: System\reboot PXE ErasePart.txt that contains the following commands: REM This file instructs Diskpart.exe to select the first disk as REM target, clear the partition table: diskpart /s .\ErasePart.txt 2. Use HP SSA to erase the array configurations: hpssascripting -i erase.ini - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 16
drive, diskette drive, or other storage device. Specifies the route the operating system must follow through the directory structure to locate a directory or file. A followed by -h in the command line. For example, for usage instructions on the CONREP utility, enter the following command: CONREP -h - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 17
• LO100CFG (Utility only supports HP ProLiant 100 series servers) • HPQLAREP • HPONCFG (Not supported on HP ProLiant 100 series servers using the set to boot on the next reboot, and the system is restarted. If no argument is provided, then the system is set to boot using the defined boot order. - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 18
device and others cannot be re-ordered. These Oxx servers do not support the default or usb parameters. SETBOOTORDER command-line syntax setbootorder [floppy for the system devices. Each term can be used only once in any order. It is not necessary to use all terms. HP ProLiant 100 series servers - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 19
utility enables the user to keep track of the execution state during system reboots. This utility saves persistent state information across reboots of the system. NOTE: The STATEMGR utility is not supported on 100 series servers. STATEMGR command-line syntax STATEMGR [-R] [EVNAME] [-h] - or STATEMGR - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 20
System ID (This field is not supported on 100 series servers) • System name • ROM information • Processor information • NIC information • PCI devices present in the system • HP . NOTE: Information may not be as detailed on HP ProLiant 100 series servers. HPDISCOVERY command-line syntax hpdiscovery -f - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 21
Command-line argument -c -f HPDISCOVERY return codes Description This argument chooses the name and location of the configuration file. If the user does not pass in this parameter, then the default filename will be hpdisc_plugins.dat, and it will be saved in the current directory. This argument - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 22
IFHW command-line arguments Command-line argument [drive:][path]hpdiscoveryfilename [drive:][path]allboards.xml IFHW return codes Description This argument specifies the hardware discovery file used to run the query. This argument specifies the allboards.xml PCI device list file, - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 23
the ROM date in the hardware discovery file is not 11/12/2004 HWQ:SystemName eq "ProLiant DL380 G2" True if the system name in the hardware discovery file exactly matches "ProLiant DL380 G2" HWQ:SystemName eq "ProLiant DL380 G2" and "PCI:Smart Array 5i" and HWQ:ROMDate eq "11/12/2004" True if - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 24
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 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 25
Tag Protection - Lock/Unlock cannot be read or changed on the HP ProLiant DL580 Gen8 server using CONREP. To change this feature, use the UEFI System Utilities. For more information, see the HP UEFI System Utilities User Guide. CONREP command-line syntax conrep [-s | -l] [-x hardware_definition_file - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 26
Company, L.P. System Type: ProLiant DL360 G4 ROM Date: 08/16/2005 ROM Family: P52 XML System Configuration: conrep. dat are used, respectively. NOTE: A platform specific XML file needs to be used for HP ProLiant 100-series servers. If you use the default name this may cause an error while - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 27
Processor Manufacturer : Intel XML System Configuration : conrep_SL160zg6_20090728.xml Hardware Configuration : sl160zconrep.dat Loading configuration from sl160zconrep.dat. ASM values not set! aborting CONREP Return code: 0 CONREP Data File Sample Contents for HP ProLiant servers not using the Oxx - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 28
Using HPRCU HPRCU is an RBSU configuration utility similar to CONREP. This utility is supported on all HP ProLiant Gen8 servers except the HP ProLiant DL580 Gen8 server. This utility does not use a definition XML file like the CONREP utility, but directly reads the same - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 29
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. • The HPRCU XML file shows the default settings for each RBSU option. HPRCU is not supported on UEFI-based ProLiant servers. Instead, use CONREP. HPRCU command-line syntax - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 30
ProLiant DL380 Gen8 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 HP SSA Scripting must now install the HP an HP SSA script file" (page 31). HP SSA then applies this configuration to a target system. - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 31
system, first locate a suitable HP SSA script or see "Creating an HP SSA script file" (page 31). Then, enter the following command at the system HP SSA searches for HPSSAINPUT.ini in the HP then enter the comment text. HP SSA ignores all text on value is shown in bold type, HP SSA uses that value as a - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 32
|75|80|90|100 RebuildPriority = Low|Medium|High ExpandPriority = Low|Medium|High SurfaceScanDelay = N SSPState = Enable|Disable PreferredPathMode = Auto|Manual ; COMMENT: the following five entries are used to optimize the controller performance for video MNPDelay = 0|1|2|...|60 ; units are minutes - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 33
script file to configure all controllers in a system, and you DPOEnable ElevatorSortEnable ExpandPriority can configure the controller previously specified in the script. (If no controller was previously specified, HP SSA stops processing the script and creates an error file.) Although the Array - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 34
unless you specifically want the data to be deleted. In this mode, HP SSA does not change an existing option setting unless you specifically script a want to use Custom mode, you must specify it. In Auto mode, HP SSA can perform an expansion, extension, or migration without user intervention if the - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 35
that you want to configure: • All-Configure all detected controllers in the system. • Slot [N][:M]-Configure the internal controller in slot number N, or the such as the RA4x00, MSA1000, and Smart Array Cluster Storage support the ChassisName option. The RA4x00 controller uses a 24-character string - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 36
Auto is the default setting for new configurations. In this case, the storage system automatically selects the I/O path from the redundant controller to the logical drive and dynamically load balances all paths. • Manual enables you to assign the logical drive to a specific redundant controller. If - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 37
the MSA1000 or the Smart Array Cluster Storage controllers. RA4x00 controllers support SSP that is enabled on a logical drive basis, and use creating or reconfiguring, and observe these additional limitations: • In Configure mode, HP SSA creates a new array. The value that you specify for the array - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 38
only the number of spares (not the that are already present in the configuration. exact IDs), enter that number as the value for this option. HP SSA automatically selects only those drives that are suitable for the array. To specify that the array should not have spares, enter None. Auto Yes - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 39
50, four for RAID 60). PreferredPath If you select the Manual setting for PreferredPathMode, use the PreferredPath command to specify the path the Method mode is Auto, HP SSA automatically selects the highest RAID level that the controller and drive configuration can support except RAID 50 or RAID - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 40
is the existing size of the logical drive. If you enter a larger value, HP SSA extends the logical drive to the new size if there is unused drive capacity on the same array, as long as the operating system supports logical drive extension. You cannot reduce the size of the logical drive. CAUTION - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 41
all modes are available on all devices. Not all HBAs support a HostMode. The following operating system options might be available: • Default • Microsoft Windows • OpenVMS • Tru64 • Linux • Solaris • Netware • HP-UX HP SSA scripting error messages Error code Error message Comment or clarification - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 42
occurred during the configuration process, but HP SSA cannot identify the error because there is an internal HP SSA error. 1052 Array requires slot information online. Systems running Microsoft Windows must have the System Management Driver loaded. 1110 Controller does not support license keys. - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 43
arrays. The controller has no unassigned physical drives, or it already has the maximum number of arrays or logical drives. The controller does not support expansion, or the current controller configuration is not expandable. This error message appears if you try to change the number of spares in an - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 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 SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 45
were found that could be used as spares for the specified array. 2878 Spare request for RAID 0 is invalid. RAID 0 does not support spares. 2879 Reset and reconfigure combined error. A controller reset with data loss was specified while in Reconfigure mode. 2880 Invalid drive type specified - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 46
Command-line argument BootDeviceWWID=22334455 BootDeviceLUN[0]=1111 HPLPCFG return codes Description Your input or current value when read from HBA Your input, default LUN, or current value when read from HBA Value 0 1 2 3 4 5 6 7 8 0x10 0x11 0xFF Meaning The command was completed successfully. - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 47
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 configuration to a file. This argument has been deprecated and is no longer supported. Value 0 10 12 14 16 17 18 50 101 Meaning All operations - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 48
still applied. The Lights Out 100 returned a code the application did not expect. See console output for code returned from the LO100 processor. System is unsupported or is not running IPMI drivers. NOTE: Return codes of 100 or higher are returned from the LO100 processor. LO100CFG command-file - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 49
HPQLAREP command-line arguments Command-line argument hpqlarep -s filename hpqlarep -l filename Where filename has the following format: [HBA0] WWID=11223344 HostAdapterBiosEnable=1 SelectBootEnable=1 BootDeviceWWID=22334455 BootDeviceLUN[0]=1111 HPQLAREP return codes Value 0 1 2 3 4 5 6 7 8 9 10 11 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 50
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 the HP ProLiant Integrated Lights-Out 3 v1.20 Scripting and Command - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 51
Command-line argument -f filename -l filename -w filename -get_hostinfo -m -mouse Description This argument sets the iLO configuration based on the information in the XML input file named filename. This argument logs replies to the text log file named filename. This argument writes the iLO - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 52
< - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 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 SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 54
HP ProLiant drivers WMI support Non-functioning IFHW CONREP version compatibility HPSSASCRIPTING support HPRCU compatibility Booting from a USB drive key Customizing the DEPLOYSERVER.CMD script SETBOOTORDER changes 54 Troubleshooting Troubleshooting systems manually in this guide are provided only - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 55
. 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 and BladeSystem - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 56
Online Setup Guide for ProLiant Gen8 Servers and BladeSystem c-Class Enclosures on the HP website (http://www.hp.com/go/ enterprise/docs). HP Insight Remote Support is available as part of HP Warranty, HP Care Pack Service, or HP contractual support agreement. HP Insight Online HP Insight Online - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 57
more information about using HP Insight Online, see the HP Insight Online User's Guide. • For more information about installing HP Insight Remote Support and enabling HP Insight Online, see the HP Insight Remote Support and Insight Online Setup Guide for ProLiant Gen8 Servers and BladeSystem c-Class - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 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 SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 59
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 Smart Storage Administrator Selective Storage Presentation State Manager utility universal serial bus vital product data 59 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 60
WMI WOL WWID WWN WWPN XML Windows Management Instrumentation Wake-on LAN World Wide ID World Wide Name worldwide port name extensible markup language 60 Acronyms and abbreviations - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 61
28 command-line arguments, 25 command-line syntax, 25 data file sample HP ProLiant 100 series, 27 Load from Data file example HP ProLiant 100 series, 26 return codes, 25 screen output, 26 Store to deployment scripts, 12 return codes, 22 iLO, 50 installation operating system, 11 L LO100CFG, 47 61 - HP ProLiant SL2500 | HP Scripting Toolkit 9.60 for Windows User Guide - Page 62
8 O online help, 16 Online ROM Flash Component Utility, 13 operating system installation, 11 operators and terms, 22 R RBSURESET, 19 arguments, 20 command return codes, 19 support, 55 syntax conventions, 16 T target server configuring, 11 technical support, 55 troubleshooting, 54 typographic
HP Scripting Toolkit for Windows 9.60 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: 722152-003
Published: February 2014
Edition: 1