HP Integrated Lights-Out Management Processor …

1 HP Integrated Lights-Out Management Processor Scripting and Command Line Resource guide for HP Integrated Lights-Out 2 version Part Number 382328-007 June 2010 (Seventh Edition) Copyright 2005, 2010 Hewlett-Packard Development Company, The information contained herein is subject 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 or omissions contained herein. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR and , Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the Government under vendor s standard commercial license.

2 Microsoft, Windows, Windows Server, Windows Vista, Windows NT, and Windows XP are registered trademarks of Microsoft Corporation. AMD is a trademark of Advanced Micro Devices, Inc. Intel is a trademark of Intel Corporation in the and other countries. Java is a trademark of Sun Microsystems, Inc. Intended audience This document is for the person who installs, administers, and troubleshoots servers and storage systems. HP assumes you are qualified in the servicing of computer equipment and trained in recognizing hazards in products with hazardous energy levels. Contents Introduction .. 7 guide overview .. 7 New in this version .. 7 HP ProLiant Essentials Rapid Deployment Pack Integration .. 7 Server Management through IPMI version compliant applications.

3 8 WS- Management compatibility overview .. 8 Command line .. 10 Command line interface 10 Command line access .. 10 Using the command line .. 10 Escape commands .. 12 Base commands .. 12 Specific commands .. 13 User commands .. 14 HP SIM SSO settings .. 15 Network commands .. 16 iLO 2 settings .. 19 iLO 2 embedded health settings .. 21 SNMP settings .. 22 License commands .. 23 Directory commands .. 23 Virtual media commands .. 24 Start and reset commands .. 27 Firmware update .. 28 Eventlog commands .. 29 Blade commands .. 30 Boot 31 LED commands .. 32 System properties and targets .. 32 Other commands .. 35 Telnet .. 36 Telnet support .. 36 Using Telnet .. 36 Telnet simple command set .. 36 Telnet security.

4 37 Supported key sequences .. 37 iLO 2 VT100+ key map .. 37 VT100+ codes for the F-keys .. 40 Linux codes for the F-keys .. 40 Secure Shell .. 41 SSH overview .. 41 SSH features supported by iLO 2 .. 41 Using Secure Shell .. 42 SSH key authorization .. 42 Tool definition 43 Mxagentconfig .. 43 Importing SSH keys from PuTTY .. 43 Importing SSH keys generated using ssh-keygen .. 45 Group administration and iLO 2 scripting .. 46 Lights-Out Configuration Utility .. 46 Unauthenticated XML query .. 46 Query definition in HP SIM .. 47 Application Launch using HP SIM .. 47 Batch processing using the Lights-Out Configuration Utility .. 48 Lights-Out Configuration Utility parameters .. 49 Perl scripting .. 51 Using Perl with the XML scripting interface.

5 51 XML enhancements .. 51 Opening an SSL connection .. 52 Sending the XML header and script body .. 53 Virtual Media scripting .. 55 Scripting Web server requirements .. 55 Using virtual media scripting .. 55 Using Virtual Media on Linux servers through an SSH connection .. 56 Virtual media image files .. 57 CGI helper application .. 57 Setting up IIS for scripted virtual media .. 58 HPONCFG online configuration utility .. 61 HPONCFG .. 61 HPONCFG supported operating systems .. 61 HPONCFG requirements .. 61 Installing HPONCFG .. 62 Windows server installation .. 62 Linux server 62 HPONCFG utility .. 62 HPONCFG command line 63 Obtaining the basic configuration .. 64 Obtaining a specific configuration .. 65 Setting a configuration.

6 66 Using variable substitution .. 67 Capturing and restoring a configuration .. 67 Using RIBCL .. 69 Overview of the RIBCL .. 69 XML header .. 69 Data types .. 70 Response definitions .. 70 RIBCL .. 71 RIBCL parameters .. 71 RIBCL runtime errors .. 71 LOGIN .. 71 LOGIN parameters .. 71 LOGIN runtime errors .. 71 USER_INFO .. 72 ADD_USER .. 72 DELETE_USER .. 74 DELETE_CURRENT_USER .. 75 GET_USER .. 75 MOD_USER .. 76 GET_ALL_USERS .. 78 GET_ALL_USER_INFO .. 79 RIB_INFO .. 80 RESET_RIB .. 81 GET_EVENT_LOG .. 82 CLEAR_EVENTLOG .. 83 COMPUTER_LOCK_CONFIG .. 84 GET_NETWORK_SETTINGS .. 85 MOD_NETWORK_SETTINGS .. 87 GET_GLOBAL_SETTINGS .. 91 MOD_GLOBAL_SETTINGS .. 93 GET_SNMP_IM_SETTINGS .. 97 MOD_SNMP_IM_SETTINGS.

7 98 UPDATE_RIB_FIRMWARE .. 99 GET_FW_VERSION .. 101 HOTKEY_CONFIG .. 101 LICENSE .. 103 INSERT_VIRTUAL_MEDIA .. 104 EJECT_VIRTUAL_MEDIA .. 105 GET_VM_STATUS .. 106 SET_VM_STATUS .. 107 CERTIFICATE_SIGNING_REQUEST .. 108 IMPORT_CERTIFICATE .. 109 GET_TWOFACTOR_SETTINGS .. 109 MOD_TWOFACTOR_SETTINGS .. 110 DIR_INFO .. 113 GET_DIR_CONFIG .. 113 IMPORT_SSH_KEY .. 115 MOD_DIR_CONFIG .. 116 RACK_INFO .. 118 GET_RACK_SETTINGS .. 119 GET_DIAGPORT_SETTINGS .. 119 MOD_DIAGPORT_SETTINGS .. 120 GET_ENCLOSURE_IP_SETTINGS .. 121 MOD_ENCLOSURE_IP_SETTINGS .. 122 GET_TOPOLOGY .. 123 MOD_BLADE_RACK .. 124 SERVER_INFO .. 125 GET_SERVER_NAME .. 126 SERVER_NAME .. 127 GET_EMBEDDED_HEALTH .. 127 GET_POWER_READINGS .. 130 GET_POWER_CAP.

8 130 SET_POWER_CAP .. 131 GET_HOST_POWER_SAVER_STATUS .. 132 132 GET_HOST_POWER_REG_INFO .. 133 GET_HOST_POWER_STATUS .. 135 SET_HOST_POWER .. 135 GET_HOST_PWR_MICRO_VER .. 136 137 RESET_SERVER .. 139 PRESS_PWR_BTN .. 139 HOLD_PWR_BTN .. 140 COLD_BOOT_SERVER .. 140 WARM_BOOT_SERVER .. 141 SERVER_AUTO_PWR .. 142 GET_SERVER_AUTO_PWR .. 142 GET_UID_STATUS .. 143 UID_CONTROL .. 144 GET_VPB_CABLE_STATUS (RILOE II only) .. 144 SSO_INFO .. 145 GET_SSO_SETTINGS .. 145 MOD_SSO_SETTINGS .. 146 SSO_SERVER .. 148 DELETE_SERVER .. 150 HPQLOMGC command language .. 152 Using HPQLOMGC .. 152 ILO_CONFIG .. 152 iLO 2 ports .. 154 Enabling the iLO 2 Shared Network Port feature through XML scripting .. 154 Re-enabling the dedicated NIC Management port.

9 154 iLO 2 parameters .. 156 Status Summary parameters .. 156 User Administration parameters .. 157 Global Settings parameters .. 158 Network parameters .. 164 Network DHCP/DNS parameters .. 165 SNMP/Insight Manager settings parameters .. 166 Directory settings parameters .. 167 BL p-Class parameters .. 169 iLO Advanced Pack License Key .. 170 Technical support .. 171 HP contact information .. 171 Before you contact HP .. 171 Acronyms and abbreviations .. 172 Index .. 178 Introduction 7 Introduction guide overview HP iLO 2 provides multiple ways to configure, update, and operate HP ProLiant servers remotely. The HP Integrated Lights-Out User guide and the HP Integrated Lights-Out 2 User guide describe each feature and explain how to use these features with the browser-based interface and RBSU.

10 The HP Integrated Lights-Out Management Processor Scripting and Command Line Resource guide describes the syntax and tools available to use iLO 2 through a command line or scripted interface. Sample XML scripts downloaded from the HP website contain commands for all iLO, iLO 2, and RILOE II firmware. Unless otherwise specified, examples in this guide are specifically for iLO 2 firmware version and later. Before using the XML sample scripts downloaded from the HP website ( ), read the firmware support information in each sample script to tailor the script for the intended firmware and version. New in this version This guide reflects changes in the iLO 2 firmware. This guide covers iLO 2 version This version of the guide includes updates for the following: Updates: "Directory commands (on page 23)" HP ProLiant Essentials Rapid Deployment Pack Integration HP ProLiant Essentials Rapid Deployment Pack integrates with iLO 2 to allow the Management of remote servers and the performance of remote console operations regardless of the state of the operating system or hardware.