HP ProLiant ML310e HP Scripting Toolkit 9.30 for Linux 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 Linux User Guide - Page 1
for Linux to configure HP ProLiant servers and BladeSystem infrastructure in a Linux environment. This document is intended for IT experts with experience in scripting operating system installations and configuring HP ProLiant servers and BladeSystem infrastructure. HP Part Number: 415597-407 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux 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 ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 3
to media 10 Configuring the target server 10 Installing the operating system 11 3 Booting and OS installation 12 SYSLINUX...12 Booting using PXE...12 Setting up a TFTP server...13 Populating the TFTP directory share 14 Setting up a DHCP server 14 Booting from a USB drive key 15 Performing - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 4
output...31 CONREP -s (Store to Data file) Example usage for HP ProLiant servers not using the Oxx ROM family...32 CONREP -l (Load from Data File) Example Usage for HP ProLiant servers not using the Oxx ROM family...32 CONREP Data File Sample Contents for HP ProLiant servers not using the Oxx ROM - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 5
Obtaining a specific configuration 58 Setting a configuration 59 HPONCFG command-line examples 59 5 Troubleshooting 60 Troubleshooting table...60 6 Support and other resources 61 Information to collect before contacting HP 61 How to contact HP...61 Subscription service...61 Related information - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 6
7 Documentation feedback 64 Acronyms and abbreviations 65 Index...67 6 Contents - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 7
of the Scripting Toolkit utilities can result in loss of critical data. Because of the potential data-loss risk, only individuals experienced in scripting operating system installations and configuring HP ProLiant server hardware should use the Scripting Toolkit utilities. Before using the Scripting - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 8
, and unattended manner. These utilities enable you to duplicate the configuration of a source server on target servers with minimal user interaction. IMPORTANT: HP ProLiant 100 series servers previous to Gen8 do not support all Scripting Toolkit commands. See the following descriptions for utility - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 9
hp.com/go/ProLiantSTK. 2. Extract the package on a common server that resides on the same network as the servers to be deployed. 3. Use the Linux NFS Server Configuration a reference configuration from the source server Procedure 1 1. At the source server, boot the media (CD/DVD, USB drive key, or - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 10
the channel interface driver for iLO: insmod /opt/hp/hp-ilo/bin/`uname -r`/hp_ilo.ko 7. Mount the network share: mkdir /mnt/toolkit_share 8. Capture a hardware discovery report using the HPDISCOVERY utility: cd /mnt/toolkit_share/utilities 9. Capture the system BIOS configuration using the CONREP - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 11
: /loadnet.sh 4. Load appropriate storage controller drivers: modprobe -f cciss 5. Load the channel interface driver for iLO: insmod /opt/hp/hp-ilo/bin/`uname -r`/hp_ilo.ko 6. Mount the network share: mkdir /mnt/toolkit_share 7. Apply the system BIOS configuration using the CONREP utility: ./conrep - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 12
executes to continue the process. Typically, the script uses Toolkit tools to configure and update the system, and then begins an operating system installation. This command causes the bootstrap script to load network drivers and use DHCP to acquire a network address. The bootstrap script included - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 13
: The tftp server serves files using the \ # trivial file transfer protocol. The tftp protocol is \ # often used to boot diskless workstations, download \ # configuration files to network-aware printers and to \ # start the installation process for some operating systems. service tftp { socket_type - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 14
is the root directory for all client access. To enable the TFTP service on your server, edit the disable line to read: disable = no Populating the TFTP Create a PXELINUX configuration file subdirectory called /tftpboot/pxelinux.cfg. 4. Copy the default file (the boot configuration used by pxelinux - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 15
the ideal medium as a writable medium. NOTE: Booting from a USB drive key is supported only on certain HP ProLiant servers. For more information, see the HP SPP website at http://www.hp.com/go/spp. To set up a USB drive key to boot the Scripting Toolkit environment: 1. Download ss_toolkit.linux.tar - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 16
hwquery ${HPDISCOVERY_FILE} allboards.xml SERVERNAME=SystemName`"; echo "Server Type: ${SERVERNAME}" case "${SERVERNAME}" in "ProLiant DL380 G4" ) # Apply System Configuration ./conrep -l -fdata_files/dl380g4_conrep.dat # Apply Array Configuration for Smart Array 6i Controller if present 16 Booting - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 17
manually since hardware discovery won't find IDE devices export BOOTDEVNODE=/dev/hda fi ## ADD EXTRA ProLiant ML310 G2 Configuration Steps HERE ;; ## ADD MORE SERVERS HERE ProLiant* ) echo "No configuration process defined for this ProLiant server" echo "Update $0 with steps for this ProLiant server - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 18
}" if [ -z ${BOOTDEVNODE} ]; then echo "MISSING boot device dev node. Check that the drivers are loaded." exec /bin/bash fi ls -al ${BOOTDEVNODE}* ln -s ${BOOTDEVNODE} /dev/sssd echo "### Linux Unattended Install using Kickstart ###" echo "clearing mbr and a few more sectors" dd if=/dev/zero of=/dev - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 19
.txt files to the C drive To use the install_win.sh sample script to install Microsoft Windows and install_w2k8.sh sample script to install Windows Server 2008: 1. Create an unattend.txt file by following the instructions in the Microsoft documentation at http://support.microsoft.com/kb/155197 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 20
/ --size 100 --grow install mouse genericps/2 timezone Etc/GMT-6 #xconfig --server "Mach64" --monitor "generic monitor" skipx rootpw iscrypted $1$ltK6jzho$7pPbE8WPNAeg44UlXqG27 auth --useshadow --enablemd5 lilo --location partition reboot %packages ElectricFence setup filesystem basesystem ldconfig - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 21
ypbind ypserv zlib zlib-devel %post The previous example contains a limited list of packages to be installed. Add to this section any other packages to be installed. The server deployment configuration and operating system installation process is complete. Performing an unattended operating system - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 22
destination to which the source transfers the data. The destination can consist of a drive letter and colon, a directory name, numbers, spaces, or any other character and is usually enclosed in double quotation marks. Utility online help Most Scripting Toolkit utilities include usage instructions - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 23
server configuration, and duplicate the configuration on a target server through a generated script file. The Scripting Toolkit utilities include: • REBOOT • SETBOOTORDER (Limited functionality for HP ProLiant 100 series servers) • STATEMGR (Utility is not supported argument, the drive indicated is - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 24
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 Linux User Guide - Page 25
Using RBSURESET RBSURESET resets the BIOS settings for a server by reapplying the default factory setting at the next reboot. RBSURESET does not erase array configurations or logical storage volumes. NOTE: This command is not yet supported on HP ProLiant 100 series servers, but will be in futures - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 26
successfully reset to the factory default. The BIOS settings have not been reset. Using BOOTEXTRACT BOOTEXTRACT is used to extract the boot sector files from Windows Server 2003. These files can be used later in the installation of Windows Server 2003. BOOTEXTRACT command-line syntax bootextract - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 27
on data that is in the file created by this utility. NOTE: Information may not be as detailed on HP ProLiant 100 series servers. HPDISCOVERY -line argument hpdiscovery -f /toolkit/hpdiscovery.xml Description This command generates the file hpdiscovery.xml in the /toolkit directory. Using IFHW - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 28
could not be understood Expression operators and terms Operator or term and or gt lt gte lte eq neq not PCI: HWQ: Result True if both operands are true True if either operand is true True if the first operand is greater than the second True if - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 29
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" control the deployment. The HWQUERY utility enables you to use data from the hardware discovery file in your own scripts. HWQUERY - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 30
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 Linux User Guide - Page 31
. CONREP screen output A typical screen output generated by CONREP is similar to the following: conrep 3.00 3.10 - Scripting Toolkit Configuration Replication Program Copyright (c) 2007-2012 Hewlett-Packard Development Company, L.P. System Type: ProLiant DL360 G4 ROM Date: 08/16/2005 ROM Family - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 32
name this 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 Linux User Guide - Page 33
name="Hot_Plug_Reservation">Auto Set Standard ECC Protection CONREP command file contents for HP ProLiant servers not using the Oxx ROM family A typical data file generated by the CONREP command is similar to the following: - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 34
> 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 Linux User Guide - Page 35
error occurred saving or loading the 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 P64 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 36
ACU GUI component. 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 37
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 Linux User Guide - Page 38
, 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 Linux User Guide - Page 39
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 Linux User Guide - Page 40
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 Linux User Guide - Page 41
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 Linux User Guide - Page 42
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 46). Otherwise, SSP is automatically disabled. SurfaceScanDelay Enter a number between - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 43
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 Linux User Guide - Page 44
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 Linux User Guide - Page 45
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 45). • When the Action mode is - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 46
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 Linux User Guide - Page 47
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 Linux User Guide - Page 48
. 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 Linux User Guide - Page 49
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 Linux User Guide - Page 50
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 Linux User Guide - Page 51
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 51 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 52
1 (for /l option only) Incorrect iboot BIOS code loaded (for /l option only) General error hba.ini generates hba.ini with HP ProLiant servers not using the Oxx ROM family. The LO100CFG utility enables you to configure the Lights Out 100 device that is available on the HP ProLiant 100 series servers - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 53
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 Linux User Guide - Page 54
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 Linux User Guide - Page 55
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 Linux User Guide - Page 56
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 Linux User Guide - Page 57
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 Linux User Guide - Page 58
= "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 Linux User Guide - Page 59
> 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 59 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 60
not compatible. HPACUSCRIPTING supports only HP Smart Array controllers. Review the HPACUSCRIPTING documentation for the latest information. Booting from a USB drive key is supported only on certain HP ProLiant servers. For more information, see the HP SPP website at http://www.hp.com/go/spp. Only - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 61
receive email notification of product enhancements, new driver versions, firmware updates, and other product resources. Related information For support software and drivers, see the HP software and drivers website at http://www.hp.com/ go/hpsc. HP also recommends installing the latest version of - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 62
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 Linux User Guide - Page 63
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 Linux User Guide - Page 64
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. 64 Documentation feedback - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 65
array of inexpensive (or independent) disks random 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 65 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 66
TFTP USB VPD WOL WWID WWN WWPN XML Trivial File Transfer Protocol universal serial bus vital product data Wake-on LAN World Wide ID World Wide Name worldwide port name extensible markup language 66 Acronyms and abbreviations - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 67
file sample HP ProLiant 100 series, 32 Load from Data file example HP ProLiant 100 series, 32 return codes, 31 screen output, 31 Store to Data file example HP ProLiant 100 series, 32 conventions document, 62 text symbols, 62 D deployment overview, 8 deployment procedure, 8 DHCP server setup PXE boot - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 68
in text, 62 syntax conventions, 22 SYSLINUX, 12 T target server configuring, 10 technical support, 61 text symbols, 62 TFTP directory share PXE boot, 14 TFTP server setup PXE boot, 13 troubleshooting, 60 typographic conventions, 62 U USB drive key boot, 15 utilities Scripting Toolkit, 22 V video
HP Scripting Toolkit for Linux User Guide
Abstract
This document provides information about the Scripting Toolkit for Linux utilities and how best to use the Scripting Toolkit for
Linux to configure HP ProLiant servers and BladeSystem infrastructure in a Linux environment. This document is intended for IT
experts with experience in scripting operating system installations and configuring HP ProLiant servers and BladeSystem
infrastructure.
HP Part Number: 415597-407
Published: October 2012
Edition: 16