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
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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 2
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 license. Microsoft, Windows, and Windows Server are U.S. registered trademarks of Microsoft Corporation - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 3
8 Deployment overview...8 Sample deployment procedure 8 Creating a network share...9 Capturing a reference configuration from the source server 9 Creating an ISO image to be written to media 10 Configuring the target server 10 Installing the operating system 11 3 Booting and OS installation 12 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 4
32 CONREP command file contents for HP ProLiant servers not using the Oxx ROM family 33 Using HPRCU...34 HPRCU command-line syntax 34 HPRCU command line arguments 35 HPRCU return codes...35 HPRCU sample XML format 35 Using HPACUSCRIPTING...36 Capturing a configuration 36 Using an Input script - 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
individuals experienced in scripting operating system installations and configuring HP ProLiant server hardware should use the Scripting Toolkit utilities. • Scripting Toolkit for Linux • HP Scripting Toolkit for Linux User Guide • A Linux workstation (any Linux distribution) Scripting Toolkit - 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 Load the network drivers using the loadnet script: /loadnet.sh 4. Load appropriate storage controller drivers: modprobe -f cciss - 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
), the following options are supported in the append statements. Option configure and update the system, and then begins an operating system installation. This command causes the bootstrap script to load network drivers the Linux system administrator's guide. The following figure illustrates - 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
drive key provides 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 16
${TOOLKIT} cp -a ${NFS_MAIN}/data_files ${TOOLKIT} echo "" echo "Loading storage drivers for hardware" ./load_modules.sh echo "" echo "Pausing to allow drivers to finish loading" sleep 15 echo "" echo "Configure server" ## run hardware discovery ./hpdiscovery -f ${HPDISCOVERY_FILE} ## use hwquery to - 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
.xml BOOTDEVNODE=DevNode` fi echo "Boot Device=${BOOTDEVNODE}" 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 19
many of the same hardware configuration tasks described in "Performing an Server 2008: 1. Create an unattend.txt file by following the instructions in the Microsoft documentation at http://support Hat Enterprise Linux Installation Guide at http://www.redhat.com/docs/ manuals/linux/. lang en_US - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 20
--size 30 part swap --size 128 part / --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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 21
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 installation 21 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 22
HP Software Delivery Repository under the Extras directory at http://downloads.linux.hp.com/SDR/downloads/Extras. Get started at http://downloads.linux.hp marks. Utility online help Most Scripting Toolkit utilities include usage instructions. To obtain help with the syntax, parameters, and switches - 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 defined boot order. This argument - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 24
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 ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 25
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 releases. Using - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 26
provides an inventory of the server being configured and must run on each deployed 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) • System name • ROM information 26 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 27
data that is in the file created by this utility. NOTE: Information may not be as detailed on HP ProLiant 100 series servers. HPDISCOVERY command-line syntax hpdiscovery [-f filename] [/?] HPDISCOVERY command-line arguments Command-line argument -f filename -? Description This argument specifies - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 28
Command-line argument IFHW return codes Description discovery into device names, such as "Smart Array 5i Controller." This argument specifies the query expression. See "Expression operators and terms" (page 28). Value 0 1 2 Meaning The expression is true. The expression is false. The - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 29
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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 30
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 family. Some platforms require special settings - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 31
argument saves the system configuration to a file. This argument loads the system configuration from a file and writes it to the target server. This argument defines Type: ProLiant DL360 G4 ROM Date: 08/16/2005 ROM Family: P52 XML System Configuration: conrep.xml Hardware Configuration: demo.dat - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 32
CONREP -s (Store to Data file) Example usage for HP ProLiant servers not using the Oxx ROM family To extract the BIOS settings from an SL160z G6 server and save the configuration to an "sl160zconrep.dat" data file: [root@ilo002481b08134 conrep]# ./conrep -s -xconrepSL160zg6_20090728.xml - - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 33
ECC Protection CONREP command file contents for HP ProLiant servers not using the Oxx ROM family A typical data file by conrep version 3.10--> - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 34
80 86 25 a3 00 HPRCU HPRCU is an RBSU configuration utility similar to CONREP. This utility is supported on HP ProLiant Gen8 servers and later. This utility does - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 35
, the XML configuration defaults to hprcu.xml. This argument displays program usage. Outputs the help and warning text for each feature. Only valid with the -s option. Command line argument 0 1 2 3 4 5 6 7 Description The command was completed successfully. The server is not supported by this - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 36
, 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 server and then writes a script file describing this configuration. • Input mode for using an Input script (page 36) ACU reads the array configuration - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 37
the target system. This method is useful for applying a standard configuration to several servers that have similar storage resources. • Write an original script. Each a RAID 50 or RAID 60 configuration in Auto mode. You must create such configurations manually using the Custom setting. Controller = - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 38
PreferredPathMode = Auto|Manual ; COMMENT: the following five entries | Windows(degrade | openVMS | Tru64 | Linux | Solaris | Netware | HP | Windows Sp2 ; COMMENT: The Windows(degrade value must be entered as be relevant for a particular configuration or scripting mode. 38 Scripting Toolkit utilities - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 39
this section of the script, you can script the other options in this category in any order. ConnectionName HBA_WW_ID HostMode Use these options to specify an HBA you are configuring. Control category The Control category has the following options: • "Action mode" (page 40) • "Method mode" (page - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 40
specify it. In Auto mode, ACU can perform an expansion, extension, or migration without user intervention if the values 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
a redundant array controller that is in an active/active configuration. Not all controllers support this feature, and controllers in an active/standby configuration disregard this option. • Auto is the default setting for new configurations. In this case, the storage system automatically selects the - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 42
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 44) instead. If you enable SSP, you must also - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 43
determines which drives are suitable to use. • To use all available drives, enter an asterisk as the value for this option. An array that is configured using this method cannot have a spare. DriveType The value that you enter for this option specifies the type of drive (SAS, SATA, or parallel SCSI - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 44
To specify 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. ACU automatically selects drive basis. Other controllers that support SSP use the SSPState option (page 42). 44 Scripting Toolkit utilities - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 45
RAID 50, four for RAID 60). PreferredPath If you select the Manual setting for PreferredPathMode, use the PreferredPath command to specify the path 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 46
array, as long as the operating system supports logical drive extension. You cannot reduce the size , depending on the controller. The default stripe size value depends on the action mode. • In Configure action mode, the default value is determined by the RAID level that you specified earlier in the - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 47
• OpenVMS • Tru64 • Linux • Solaris • Netware • HP-UX ACU scripting error messages Error code Error message Comment or clarification expansion, migration, ACU does not support multiple simultaneous expansions, or extension operations. migrations, or extensions without saving the configuration - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 48
running Microsoft Windows must have the System Management Driver loaded. 1110 Controller does not support license keys. - 1111 Invalid license key. array. The controller does not support expansion, or the current controller configuration is not expandable. 48 Scripting Toolkit utilities - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 49
2831 Cannot 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 50
. - 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 ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 51
range - is 0 (disabled) to 60 minutes. 2883 Invalid controller configuration value. - Expecting Yes or No. 2884 Invalid value for QueueDepth. Valid 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 52
hba.ini. Using LO100CFG NOTE: This section applies only to 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. Under Linux, LO100CFG uses the OpenIPMI library to communicate - 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 passed to the utility. Invalid command-line syntax was used. The IPMI driver may not be loaded or installed properly. XML failed validity tests. Field - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 54
privilege_level="oem" /> To disable the shared NIC configuration and make the Lights-Out 100 NIC dedicated, enter the following in 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 - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 55
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 ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 56
/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 ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 57
is an error in xml. The Management processor is not present, or the driver is not running. The iLO flash is still in progress. The script is configuration • Obtain a specific configuration • Set a configuration Obtaining an entire configuration HPONCFG can be used to obtain an entire configuration - 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
VALUE="17988"/> Setting a configuration A specific configuration can be sent to the iLO by using the command 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
's guide Not all options can be configured using Toolkit utilities. Some options must be configured manually or with other configuration utilities 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
. For information on the previous SmartStart Scripting Toolkit, which was used for HP ProLiant G7 and earlier servers and BladeSystems, see the documentation found on the HP website at http:// www.hp.com/go/foundation. For more information on unattended installation, see the following resources - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 62
level. Notifications may be sent to your authorized HP Channel Partner for onsite service, if configured and available in your country. HP Insight Remote Support software extends the HP enterprise remote support portfolio for customers with small and medium-sized IT environments. The software - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 63
to your IT environment through HP Insight Online, and is also the 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 - 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
graphical user interface host bus adapter HP Discovery Utility HP Lights-Out Online Configuration utility HP QLogic FC HBA BIOS configuration utility HP ROM Configuration 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
, 26 arguments, 26 command-line syntax, 26 return codes, 26 C clearing a configuration, 41 configuration capturing, 36 hardware, 15 target server, 10 configurations capturing, 9 CONREP, 30 arguments, 31 command file contents HP ProLiant 300/500/700 series, 33 command-line syntax, 31 data file sample - HP ProLiant ML310e | HP Scripting Toolkit 9.30 for Linux User Guide - Page 68
, 61 symbols 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
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