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.

2 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. 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.

3 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 .. 8 WS- Management compatibility overview .. 8 Command line .. 10 Command line interface 10 Command line access.

4 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.

5 36 Telnet security .. 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.

6 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 .. 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.

7 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 .. 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.

8 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 .. 98 UPDATE_RIB_FIRMWARE .. 99 GET_FW_VERSION .. 101 HOTKEY_CONFIG .. 101 LICENSE .. 103 INSERT_VIRTUAL_MEDIA .. 104 EJECT_VIRTUAL_MEDIA.

9 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.

10 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.