Table Of Content

HP Integrated Lights-Out 2 Management Processor Scripting and Command Line Resource Guide HP Part Number: 382328-008 Published: July 2011 Edition: 2 © Copyright 2011 Hewlett-Packard Development Company, L.P Notices 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 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Microsoft, Windows, Windows Server, Windows Vista, Windows NT, and Windows XP are U.S. registered trademarks of Microsoft Corporation. AMD is a trademark of Advanced Micro Devices, Inc. Intel is a trademark of Intel Corporation in the U.S. and other countries. Java is a U.S. trademark of Oracle and/or its affiliates. UNIX is a trademark of The Open Group. 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 1 Introduction.............................................................................................10 Overview..............................................................................................................................10 New in this version.................................................................................................................10 HP Insight Control server deployment........................................................................................10 Server management through IPMI version 2.0 compliant applications............................................10 WS-Management compatibility overview...................................................................................11 2 Command line.........................................................................................13 Command line interface overview.............................................................................................13 Command line access.............................................................................................................13 Using the command line..........................................................................................................13 Escape commands..................................................................................................................15 Base commands.....................................................................................................................15 Specific commands.................................................................................................................16 User commands.................................................................................................................17 HP SIM SSO settings..........................................................................................................17 Network commands...........................................................................................................18 iLO 2 settings....................................................................................................................21 iLO 2 embedded health settings...........................................................................................22 SNMP settings...................................................................................................................24 License commands.............................................................................................................25 Directory commands..........................................................................................................25 Virtual media commands....................................................................................................26 Start and reset commands...................................................................................................29 Firmware update................................................................................................................30 Eventlog commands...........................................................................................................30 Blade commands...............................................................................................................31 Boot commands.................................................................................................................32 LED commands..................................................................................................................33 System properties and targets..............................................................................................33 Other commands...............................................................................................................36 3 Telnet......................................................................................................37 Telnet support........................................................................................................................37 Using Telnet...........................................................................................................................37 Telnet simple command set..................................................................................................37 Telnet security....................................................................................................................38 Supported key sequences........................................................................................................38 iLO 2 VT100+ key map......................................................................................................38 VT100+ codes for the F-keys................................................................................................40 Linux codes for the F-keys....................................................................................................40 4 Secure Shell.............................................................................................42 SSH overview.........................................................................................................................42 SSH features supported by iLO 2..............................................................................................42 Using Secure Shell..................................................................................................................42 SSH key authorization.............................................................................................................43 Tool definition files.............................................................................................................43 Mxagentconfig..................................................................................................................44 Importing SSH keys from PuTTY.................................................................................................44 Importing SSH keys generated using ssh-keygen..........................................................................46 Contents 3 5 Group administration and iLO 2 scripting....................................................47 Lights-Out Configuration Utility.................................................................................................47 Unauthenticated XML query.....................................................................................................47 Query definition in HP SIM......................................................................................................48 Application Launch using HP SIM.............................................................................................48 Batch processing using the Lights-Out Configuration Utility...........................................................49 Lights-Out Configuration Utility parameters.................................................................................49 6 Perl scripting............................................................................................52 Using Perl with the XML scripting interface.................................................................................52 XML enhancements.................................................................................................................52 Opening an SSL connection.....................................................................................................53 Sending the XML header and script body..................................................................................53 7 Virtual Media scripting..............................................................................56 Scripting Web server requirements............................................................................................56 Using virtual media scripting ...................................................................................................56 Using Virtual Media on Linux servers through an SSH connection..................................................57 Virtual media image files.........................................................................................................58 CGI helper application............................................................................................................58 Setting up IIS for scripted virtual media......................................................................................59 8 HPONCFG online configuration utility.........................................................62 HPONCFG............................................................................................................................62 HPONCFG supported operating systems...................................................................................62 HPONCFG requirements.........................................................................................................62 Installing HPONCFG...............................................................................................................62 Windows server installation.................................................................................................62 Linux server installation ......................................................................................................63 HPONCFG utility....................................................................................................................63 HPONCFG command line parameters..................................................................................63 Using HPONCFG on Windows servers............................................................................64 Using HPONCFG on Linux servers...................................................................................64 Obtaining the basic configuration........................................................................................64 Obtaining a specific configuration.......................................................................................66 Setting a configuration.......................................................................................................67 Using variable substitution...................................................................................................67 Capturing and restoring a configuration................................................................................68 9 Using RIBCL.............................................................................................70 Overview of the RIBCL.............................................................................................................70 XML header......................................................................................................................70 Data types........................................................................................................................70 String..........................................................................................................................70 Specific string...............................................................................................................70 Boolean string..............................................................................................................70 Response definitions...........................................................................................................70 RIBCL....................................................................................................................................71 RIBCL parameters...............................................................................................................71 RIBCL runtime errors...........................................................................................................71 LOGIN..................................................................................................................................71 LOGIN parameters.............................................................................................................72 LOGIN runtime errors.........................................................................................................72 USER_INFO...........................................................................................................................72 ADD_USER.......................................................................................................................72 ADD_USER parameters..................................................................................................73 ADD_USER runtime errors..............................................................................................74 4 Contents DELETE_USER....................................................................................................................74 DELETE_USER parameter................................................................................................74 DELETE_USER runtime errors...........................................................................................75 DELETE_CURRENT_USER....................................................................................................75 DELETE_CURRENT_USER parameters...............................................................................75 DELETE_CURRENT_USER runtime errors...........................................................................75 DELETE_SSH_KEY..............................................................................................................75 DELETE_SSH_KEY parameters.........................................................................................75 DELETE_SSH_KEY runtime errors......................................................................................76 GET_USER........................................................................................................................76 GET_USER parameter....................................................................................................76 GET_USER runtime errors...............................................................................................76 GET_USER return messages............................................................................................76 MOD_USER......................................................................................................................77 MOD_USER parameters.................................................................................................77 MOD_USER runtime errors.............................................................................................78 GET_ALL_USERS................................................................................................................78 GET_ALL_USERS parameters...........................................................................................79 GET_ALL_USERS runtime errors.......................................................................................79 GET_ALL_USERS return messages....................................................................................79 GET_ALL_USER_INFO........................................................................................................79 GET_ALL_USER_INFO parameters...................................................................................80 GET_ALL_USER_INFO runtime errors................................................................................80 GET_ALL_USER_INFO return messages............................................................................80 RIB_INFO..............................................................................................................................80 RESET_RIB.........................................................................................................................81 RESET_RIB parameters...................................................................................................81 RESET_RIB runtime errors................................................................................................81 GET_EVENT_LOG..............................................................................................................81 GET_EVENT_LOG parameters........................................................................................82 GET_EVENT_LOG runtime errors.....................................................................................82 GET_EVENT_LOG return messages..................................................................................82 CLEAR_EVENTLOG............................................................................................................83 CLEAR_EVENTLOG parameters.......................................................................................83 CLEAR_EVENTLOG runtime errors...................................................................................83 COMPUTER_LOCK_CONFIG..............................................................................................83 COMPUTER_LOCK_CONFIG parameters.........................................................................84 COMPUTER_LOCK_CONFIG runtime errors.....................................................................84 GET_NETWORK_SETTINGS................................................................................................85 GET_NETWORK_SETTINGS parameters..........................................................................85 GET_NETWORK_SETTINGS runtime errors.......................................................................85 GET_NETWORK_SETTINGS return messages....................................................................85 MOD_NETWORK_SETTINGS..............................................................................................86 MOD_NETWORK_SETTINGS parameters........................................................................88 MOD_NETWORK_SETTINGS runtime errors.....................................................................90 GET_GLOBAL_SETTINGS....................................................................................................90 GET_GLOBAL_SETTINGS parameters...............................................................................90 GET_GLOBAL_SETTINGS runtime errors...........................................................................90 GET_GLOBAL_SETTINGS return messages........................................................................90 MOD_GLOBAL_SETTINGS..................................................................................................91 MOD_GLOBAL_SETTINGS parameters.............................................................................94 MOD_GLOBAL_SETTINGS runtime errors.........................................................................96 GET_SNMP_IM_SETTINGS.................................................................................................96 GET_SNMP_IM_SETTINGS parameters............................................................................97 GET_SNMP_IM_SETTINGS runtime errors........................................................................97 Contents 5 GET_SNMP_IM_SETTINGS return messages.....................................................................97 MOD_SNMP_IM_SETTINGS...............................................................................................97 MOD_SNMP_IM_SETTINGS parameters..........................................................................97 MOD_SNMP_IM_SETTINGS runtime errors......................................................................98 UPDATE_RIB_FIRMWARE....................................................................................................98 UPDATE_RIB_FIRMWARE parameters...............................................................................99 UPDATE_RIB_FIRMWARE runtime errors...........................................................................99 GET_FW_VERSION...........................................................................................................99 GET_FW_VERSION parameters....................................................................................100 GET_FW_VERSION runtime errors.................................................................................100 GET_FW_VERSION return messages.............................................................................100 HOTKEY_CONFIG...........................................................................................................100 HOTKEY_CONFIG parameters.....................................................................................100 HOTKEY_CONFIG runtime errors..................................................................................101 Supported hot keys......................................................................................................101 LICENSE.........................................................................................................................102 LICENSE parameters...................................................................................................102 LICENSE runtime errors................................................................................................102 INSERT_VIRTUAL_MEDIA..................................................................................................103 INSERT_VIRTUAL_MEDIA parameters.............................................................................103 INSERT_VIRTUAL_FLOPPY runtime errors.........................................................................103 EJECT_VIRTUAL_MEDIA....................................................................................................104 EJECT_VIRTUAL_MEDIA parameters...............................................................................104 EJECT_VIRTUAL_MEDIA runtime errors...........................................................................104 GET_VM_STATUS............................................................................................................104 GET_VM_STATUS parameters.......................................................................................104 GET_VM_STATUS runtime errors....................................................................................104 GET_VM_STATUS return messages................................................................................105 SET_VM_STATUS.............................................................................................................105 SET_VM_STATUS parameters........................................................................................105 SET_VM_STATUS runtime errors.....................................................................................107 CERTIFICATE_SIGNING_REQUEST.....................................................................................107 CERTIFICATE_SIGNING_REQUEST parameters...............................................................107 CERTIFICATE_SIGNING_REQUEST errors.......................................................................107 CSR_CERT_SETTINGS......................................................................................................107 CSR_CERT_SETTINGS parameters.................................................................................108 CSR_CERT_SETTINGS errors.........................................................................................109 GET_CERT_SUBJECT_INFO...............................................................................................109 GET_CERT_SUBJECT_INFO parameters .........................................................................109 GET_CERT_SUBJECT_INFO errors .................................................................................109 IMPORT_CERTIFICATE......................................................................................................109 IMPORT_CERTIFICATE parameters.................................................................................110 IMPORT_CERTIFICATE errors.........................................................................................110 GET_TWOFACTOR_SETTINGS..........................................................................................110 GET_TWOFACTOR_SETTINGS parameters.....................................................................110 GET_TWOFACTOR_SETTINGS runtime errors.................................................................110 GET_TWOFACTOR_SETTINGS return messages..............................................................110 MOD_TWOFACTOR_SETTINGS........................................................................................111 MOD_TWOFACTOR_SETTINGS parameters...................................................................112 MOD_TWOFACTOR_SETTINGS runtime errors...............................................................113 DIR_INFO............................................................................................................................113 GET_DIR_CONFIG..........................................................................................................113 GET_DIR_CONFIG parameters.....................................................................................114 GET_DIR_CONFIG runtime errors..................................................................................114 GET_DIR_CONFIG return messages..............................................................................114 6 Contents IMPORT_SSH_KEY...........................................................................................................115 IMPORT_SSH_KEY parameters......................................................................................115 IMPORT_SSH_KEY runtime errors..................................................................................115 MOD_DIR_CONFIG........................................................................................................116 MOD_DIR_CONFIG parameters...................................................................................117 MOD_DIR_CONFIG runtime errors................................................................................118 RACK_INFO........................................................................................................................118 GET_RACK_SETTINGS.....................................................................................................119 GET_RACK_SETTINGS parameters................................................................................119 GET_RACK_SETTINGS runtime errors.............................................................................119 GET_RACK_SETTINGS return messages.........................................................................119 GET_DIAGPORT_SETTINGS..............................................................................................119 GET_DIAGPORT_SETTINGS parameters.........................................................................120 GET_DIAGPORT_SETTINGS runtime errors.....................................................................120 GET_DIAGPORT_SETTINGS return messages..................................................................120 MOD_DIAGPORT_SETTINGS............................................................................................120 MOD_DIAGPORT_SETTINGS parameters.......................................................................120 MOD_DIAGPORT_SETTINGS runtime errors...................................................................121 GET_ENCLOSURE_IP_SETTINGS........................................................................................121 GET_ENCLOSURE_IP_SETTINGS parameters..................................................................121 GET_ENCLOSURE_IP_SETTINGS return messages............................................................121 MOD_ENCLOSURE_IP_SETTINGS......................................................................................122 MOD_ENCLOSURE_IP_SETTINGS parameters................................................................122 MOD_ENCLOSURE_IP_SETTINGS runtime errors.............................................................123 GET_TOPOLOGY.............................................................................................................123 GET_TOPOLOGY parameters........................................................................................123 GET_TOPOLOGY return message..................................................................................123 MOD_BLADE_RACK........................................................................................................124 MOD_BLADE_RACK parameters...................................................................................124 MOD_BLADE_RACK runtime errors................................................................................125 SERVER_INFO......................................................................................................................125 GET_SERVER_NAME........................................................................................................126 GET_SERVER_NAME return message.............................................................................126 GET_SERVER_NAME runtime errors...............................................................................126 SERVER_NAME...............................................................................................................126 SERVER_NAME parameters..........................................................................................126 SERVER_NAME return message....................................................................................126 SERVER_NAME runtime errors......................................................................................127 GET_EMBEDDED_HEALTH................................................................................................127 GET_EMBEDDED_HEALTH parameters...........................................................................127 GET_EMBEDDED_HEALTH return messages....................................................................127 GET_POWER_READINGS.................................................................................................129 GET_POWER_READINGS parameters............................................................................129 GET_POWER_READINGS return messages.....................................................................129 GET_POWER_CAP..........................................................................................................130 GET_POWER_CAP parameters.....................................................................................130 GET_POWER_CAP return messages..............................................................................130 SET_POWER_CAP...........................................................................................................130 SET_POWER_CAP parameters......................................................................................131 SET_POWER_CAP runtime errors...................................................................................131 GET_HOST_POWER_SAVER_STATUS.................................................................................131 GET_HOST_POWER_SAVER_STATUS parameters............................................................131 GET_HOST_POWER_SAVER_STATUS runtime errors.........................................................131 GET_HOST_POWER_SAVER_STATUS return messages.....................................................131 SET_HOST_POWER_SAVER..............................................................................................132 Contents 7 SET_HOST_POWER_SAVER parameters.........................................................................132 SET_HOST_POWER_SAVER runtime errors......................................................................132 GET_HOST_POWER_REG_INFO.......................................................................................132 GET_HOST_POWER_REG_INFO parameters..................................................................133 GET_HOST_POWER_REG_INFO runtime errors...............................................................133 GET_HOST_POWER_REG_INFO return messages...........................................................133 GET_HOST_POWER_STATUS............................................................................................134 GET_HOST_POWER_STATUS Parameters.......................................................................134 GET_HOST_POWER_STATUS Runtime Errors...................................................................134 GET_HOST_POWER_STATUS Return Messages...............................................................134 SET_HOST_POWER.........................................................................................................134 SET_HOST_POWER Parameters....................................................................................135 SET_HOST_POWER Runtime Errors................................................................................135 GET_HOST_PWR_MICRO_VER..........................................................................................135 GET_HOST_PWR_MICRO_VER parameters....................................................................135 GET_HOST_PWR_MICRO_VER runtime errors.................................................................135 GET_HOST_PWR_MICRO_VER return messages..............................................................136 GET_ONE_TIME_BOOT...................................................................................................136 GET_ONE_TIME_BOOT parameters..............................................................................136 GET_ONE_TIME_BOOT runtime errors...........................................................................136 GET_ONE_TIME_BOOT return messages.......................................................................136 SET_ONE_TIME_BOOT....................................................................................................137 SET_ONE_TIME_BOOT parameters...............................................................................137 SET_ONE_TIME_BOOT runtime errors............................................................................137 SET_ONE_TIME_BOOT return messages........................................................................137 GET_PERSISTENT_BOOT...................................................................................................137 GET_PERSISTENT_BOOT parameters.............................................................................138 GET_PERSISTENT_BOOT runtime errors..........................................................................138 GET_PERSISTENT_BOOT return messages.......................................................................138 SET_PERSISTENT_BOOT...................................................................................................138 SET_PERSISTENT_BOOT parameters..............................................................................138 SET_PERSISTENT_BOOT runtime errors...........................................................................138 SET_PERSISTENT_BOOT return messages.......................................................................139 GET_PWREG_CAPABILITIES..............................................................................................139 GET_PWREG_CAPABILITIES parameters.........................................................................139 GET_PWREG_CAPABILITIES runtime errors......................................................................139 GET_PWREG_CAPABILITIES return messages..................................................................139 RESET_SERVER................................................................................................................141 RESET_SERVER errors...................................................................................................141 RESET_SERVER parameters...........................................................................................141 PRESS_PWR_BTN.............................................................................................................141 PRESS_PWR_BTN parameters.......................................................................................141 PRESS_PWR_BTN runtime errors....................................................................................141 HOLD_PWR_BTN............................................................................................................141 HOLD_PWR_BTN parameters.......................................................................................142 HOLD_PWR_BTN runtime errors....................................................................................142 COLD_BOOT_SERVER......................................................................................................142 COLD_BOOT_SERVER parameters.................................................................................142 COLD_BOOT_SERVER runtime errors.............................................................................142 WARM_BOOT_SERVER....................................................................................................142 WARM_BOOT_SERVER parameters...............................................................................143 WARM_BOOT_SERVER runtime errors...........................................................................143 SERVER_AUTO_PWR........................................................................................................143 SERVER_AUTO_PWR parameters..................................................................................143 SERVER_AUTO_PWR runtime errors...............................................................................143 8 Contents GET_SERVER_AUTO_PWR................................................................................................144 GET_SERVER_AUTO_PWR parameters...........................................................................144 GET_SERVER_AUTO_PWR return message.....................................................................144 GET_UID_STATUS............................................................................................................144 GET_UID_STATUS parameters.......................................................................................144 GET_UID_STATUS response..........................................................................................145 UID_CONTROL...............................................................................................................145 UID_CONTROL parameters..........................................................................................145 UID_CONTROL errors..................................................................................................145 GET_VPB_CABLE_STATUS (RILOE II only).............................................................................145 GET_VPB_CABLE_STATUS parameters............................................................................145 GET_VPB_CABLE_STATUS Runtime Errors.......................................................................145 GET_VPB_CABLE_STATUS return messages.....................................................................146 SSO_INFO..........................................................................................................................146 GET_SSO_SETTINGS.......................................................................................................146 GET_SSO_SETTINGS parameters..................................................................................147 GET_SSO_SETTINGS return messages...........................................................................147 MOD_SSO_SETTINGS.....................................................................................................147 MOD_SSO_SETTINGS parameters................................................................................148 MOD_SSO_SETTINGS runtime errors.............................................................................149 SSO_SERVER..................................................................................................................149 SSO_SERVER parameters.............................................................................................150 SSO_SERVER runtime errors..........................................................................................151 DELETE_SERVER...............................................................................................................151 DELETE_SERVER parameters.........................................................................................151 DELETE_SERVER runtime errors......................................................................................151 10 HPQLOMGC command language..........................................................152 Using HPQLOMGC..............................................................................................................152 ILO_CONFIG.......................................................................................................................152 11 iLO 2 ports...........................................................................................154 Enabling the iLO 2 Shared Network Port feature through XML scripting........................................154 Re-enabling the dedicated NIC management port.....................................................................154 12 iLO 2 parameters..................................................................................155 Status Summary parameters...................................................................................................155 User Administration parameters..............................................................................................156 Global Settings parameters....................................................................................................157 Network parameters.............................................................................................................159 Network DHCP/DNS parameters...........................................................................................160 SNMP/Insight Manager settings parameters............................................................................162 Directory settings parameters.................................................................................................162 BL p-Class parameters...........................................................................................................163 iLO Advanced Pack License Key..............................................................................................164 13 Technical support..................................................................................165 HP contact information..........................................................................................................165 Before you contact HP...........................................................................................................165 Acronyms and abbreviations.......................................................................166 Index.......................................................................................................168 Contents 9 1 Introduction Overview HP iLO 2 provides multiple ways to configure, update, and operate HP ProLiant servers remotely. 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. 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 2.06 and later. Before using the XML sample scripts downloaded from the HP website at http://www.hp.com/servers/lights-out, 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 2.06. The following commands were added/updated: • Updated CERTIFICATE_SIGNING_REQUEST • Added CSR_CERT_SETTINGS • Added GET_CERT_SUBJECT_INFO • Added GET_ONE_TIME_BOOT • Added SET_ONE_TIME_BOOT • Added GET_PERSISTENT_BOOT • Added SET_PERSISTENT_BOOT • Added DELETE_SSH_KEY HP Insight Control server deployment HP Insight Control server deployment integrates with iLO 2 to enable the management of remote servers and the performance of remote console operations regardless of the state of the operating system or hardware. The deployment server provides the ability to use the power management features of iLO 2 to power on, power off, or cycle power on the target server. Each time a server connects to the deployment server, the deployment server polls the target server to verify that a LOM management device is installed. If installed, the server gathers information including the DNS name, IP address, and user login name. Security is maintained by requiring the user to enter the correct password for that user name. For more information about the HP Insight Control server deployment, see the documentation that ships on the HP Insight Software DVD, or the HP Insight Control webpage at http://www.hp.com/ go/insightcontrol. Server management through IPMI version 2.0 compliant applications Server management through the IPMI is a standardized method for controlling and monitoring the server. iLO 2 provides server management based on the IPMI version 2.0 specification. 10 Introduction

ebook img

HP Integrated Lights-Out 2 Management Processor Scripting and Command Line Resource Guide PDF

173 Pages·2011·3.41 MB·English
by  
Save to my drive
Quick download
Download
Upgrade Premium
Most books are stored in the elastic cloud where traffic is expensive. For this reason, we have a limit on daily download.

Preview HP Integrated Lights-Out 2 Management Processor Scripting and Command Line Resource Guide

HP Integrated Lights-Out 2 Management Processor Scripting and Command Line Resource Guide HP Part Number: 382328-008 Published: July 2011 Edition: 2 © Copyright 2011 Hewlett-Packard Development Company, L.P Notices 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 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Microsoft, Windows, Windows Server, Windows Vista, Windows NT, and Windows XP are U.S. registered trademarks of Microsoft Corporation. AMD is a trademark of Advanced Micro Devices, Inc. Intel is a trademark of Intel Corporation in the U.S. and other countries. Java is a U.S. trademark of Oracle and/or its affiliates. UNIX is a trademark of The Open Group. 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 1 Introduction.............................................................................................10 Overview..............................................................................................................................10 New in this version.................................................................................................................10 HP Insight Control server deployment........................................................................................10 Server management through IPMI version 2.0 compliant applications............................................10 WS-Management compatibility overview...................................................................................11 2 Command line.........................................................................................13 Command line interface overview.............................................................................................13 Command line access.............................................................................................................13 Using the command line..........................................................................................................13 Escape commands..................................................................................................................15 Base commands.....................................................................................................................15 Specific commands.................................................................................................................16 User commands.................................................................................................................17 HP SIM SSO settings..........................................................................................................17 Network commands...........................................................................................................18 iLO 2 settings....................................................................................................................21 iLO 2 embedded health settings...........................................................................................22 SNMP settings...................................................................................................................24 License commands.............................................................................................................25 Directory commands..........................................................................................................25 Virtual media commands....................................................................................................26 Start and reset commands...................................................................................................29 Firmware update................................................................................................................30 Eventlog commands...........................................................................................................30 Blade commands...............................................................................................................31 Boot commands.................................................................................................................32 LED commands..................................................................................................................33 System properties and targets..............................................................................................33 Other commands...............................................................................................................36 3 Telnet......................................................................................................37 Telnet support........................................................................................................................37 Using Telnet...........................................................................................................................37 Telnet simple command set..................................................................................................37 Telnet security....................................................................................................................38 Supported key sequences........................................................................................................38 iLO 2 VT100+ key map......................................................................................................38 VT100+ codes for the F-keys................................................................................................40 Linux codes for the F-keys....................................................................................................40 4 Secure Shell.............................................................................................42 SSH overview.........................................................................................................................42 SSH features supported by iLO 2..............................................................................................42 Using Secure Shell..................................................................................................................42 SSH key authorization.............................................................................................................43 Tool definition files.............................................................................................................43 Mxagentconfig..................................................................................................................44 Importing SSH keys from PuTTY.................................................................................................44 Importing SSH keys generated using ssh-keygen..........................................................................46 Contents 3 5 Group administration and iLO 2 scripting....................................................47 Lights-Out Configuration Utility.................................................................................................47 Unauthenticated XML query.....................................................................................................47 Query definition in HP SIM......................................................................................................48 Application Launch using HP SIM.............................................................................................48 Batch processing using the Lights-Out Configuration Utility...........................................................49 Lights-Out Configuration Utility parameters.................................................................................49 6 Perl scripting............................................................................................52 Using Perl with the XML scripting interface.................................................................................52 XML enhancements.................................................................................................................52 Opening an SSL connection.....................................................................................................53 Sending the XML header and script body..................................................................................53 7 Virtual Media scripting..............................................................................56 Scripting Web server requirements............................................................................................56 Using virtual media scripting ...................................................................................................56 Using Virtual Media on Linux servers through an SSH connection..................................................57 Virtual media image files.........................................................................................................58 CGI helper application............................................................................................................58 Setting up IIS for scripted virtual media......................................................................................59 8 HPONCFG online configuration utility.........................................................62 HPONCFG............................................................................................................................62 HPONCFG supported operating systems...................................................................................62 HPONCFG requirements.........................................................................................................62 Installing HPONCFG...............................................................................................................62 Windows server installation.................................................................................................62 Linux server installation ......................................................................................................63 HPONCFG utility....................................................................................................................63 HPONCFG command line parameters..................................................................................63 Using HPONCFG on Windows servers............................................................................64 Using HPONCFG on Linux servers...................................................................................64 Obtaining the basic configuration........................................................................................64 Obtaining a specific configuration.......................................................................................66 Setting a configuration.......................................................................................................67 Using variable substitution...................................................................................................67 Capturing and restoring a configuration................................................................................68 9 Using RIBCL.............................................................................................70 Overview of the RIBCL.............................................................................................................70 XML header......................................................................................................................70 Data types........................................................................................................................70 String..........................................................................................................................70 Specific string...............................................................................................................70 Boolean string..............................................................................................................70 Response definitions...........................................................................................................70 RIBCL....................................................................................................................................71 RIBCL parameters...............................................................................................................71 RIBCL runtime errors...........................................................................................................71 LOGIN..................................................................................................................................71 LOGIN parameters.............................................................................................................72 LOGIN runtime errors.........................................................................................................72 USER_INFO...........................................................................................................................72 ADD_USER.......................................................................................................................72 ADD_USER parameters..................................................................................................73 ADD_USER runtime errors..............................................................................................74 4 Contents DELETE_USER....................................................................................................................74 DELETE_USER parameter................................................................................................74 DELETE_USER runtime errors...........................................................................................75 DELETE_CURRENT_USER....................................................................................................75 DELETE_CURRENT_USER parameters...............................................................................75 DELETE_CURRENT_USER runtime errors...........................................................................75 DELETE_SSH_KEY..............................................................................................................75 DELETE_SSH_KEY parameters.........................................................................................75 DELETE_SSH_KEY runtime errors......................................................................................76 GET_USER........................................................................................................................76 GET_USER parameter....................................................................................................76 GET_USER runtime errors...............................................................................................76 GET_USER return messages............................................................................................76 MOD_USER......................................................................................................................77 MOD_USER parameters.................................................................................................77 MOD_USER runtime errors.............................................................................................78 GET_ALL_USERS................................................................................................................78 GET_ALL_USERS parameters...........................................................................................79 GET_ALL_USERS runtime errors.......................................................................................79 GET_ALL_USERS return messages....................................................................................79 GET_ALL_USER_INFO........................................................................................................79 GET_ALL_USER_INFO parameters...................................................................................80 GET_ALL_USER_INFO runtime errors................................................................................80 GET_ALL_USER_INFO return messages............................................................................80 RIB_INFO..............................................................................................................................80 RESET_RIB.........................................................................................................................81 RESET_RIB parameters...................................................................................................81 RESET_RIB runtime errors................................................................................................81 GET_EVENT_LOG..............................................................................................................81 GET_EVENT_LOG parameters........................................................................................82 GET_EVENT_LOG runtime errors.....................................................................................82 GET_EVENT_LOG return messages..................................................................................82 CLEAR_EVENTLOG............................................................................................................83 CLEAR_EVENTLOG parameters.......................................................................................83 CLEAR_EVENTLOG runtime errors...................................................................................83 COMPUTER_LOCK_CONFIG..............................................................................................83 COMPUTER_LOCK_CONFIG parameters.........................................................................84 COMPUTER_LOCK_CONFIG runtime errors.....................................................................84 GET_NETWORK_SETTINGS................................................................................................85 GET_NETWORK_SETTINGS parameters..........................................................................85 GET_NETWORK_SETTINGS runtime errors.......................................................................85 GET_NETWORK_SETTINGS return messages....................................................................85 MOD_NETWORK_SETTINGS..............................................................................................86 MOD_NETWORK_SETTINGS parameters........................................................................88 MOD_NETWORK_SETTINGS runtime errors.....................................................................90 GET_GLOBAL_SETTINGS....................................................................................................90 GET_GLOBAL_SETTINGS parameters...............................................................................90 GET_GLOBAL_SETTINGS runtime errors...........................................................................90 GET_GLOBAL_SETTINGS return messages........................................................................90 MOD_GLOBAL_SETTINGS..................................................................................................91 MOD_GLOBAL_SETTINGS parameters.............................................................................94 MOD_GLOBAL_SETTINGS runtime errors.........................................................................96 GET_SNMP_IM_SETTINGS.................................................................................................96 GET_SNMP_IM_SETTINGS parameters............................................................................97 GET_SNMP_IM_SETTINGS runtime errors........................................................................97 Contents 5 GET_SNMP_IM_SETTINGS return messages.....................................................................97 MOD_SNMP_IM_SETTINGS...............................................................................................97 MOD_SNMP_IM_SETTINGS parameters..........................................................................97 MOD_SNMP_IM_SETTINGS runtime errors......................................................................98 UPDATE_RIB_FIRMWARE....................................................................................................98 UPDATE_RIB_FIRMWARE parameters...............................................................................99 UPDATE_RIB_FIRMWARE runtime errors...........................................................................99 GET_FW_VERSION...........................................................................................................99 GET_FW_VERSION parameters....................................................................................100 GET_FW_VERSION runtime errors.................................................................................100 GET_FW_VERSION return messages.............................................................................100 HOTKEY_CONFIG...........................................................................................................100 HOTKEY_CONFIG parameters.....................................................................................100 HOTKEY_CONFIG runtime errors..................................................................................101 Supported hot keys......................................................................................................101 LICENSE.........................................................................................................................102 LICENSE parameters...................................................................................................102 LICENSE runtime errors................................................................................................102 INSERT_VIRTUAL_MEDIA..................................................................................................103 INSERT_VIRTUAL_MEDIA parameters.............................................................................103 INSERT_VIRTUAL_FLOPPY runtime errors.........................................................................103 EJECT_VIRTUAL_MEDIA....................................................................................................104 EJECT_VIRTUAL_MEDIA parameters...............................................................................104 EJECT_VIRTUAL_MEDIA runtime errors...........................................................................104 GET_VM_STATUS............................................................................................................104 GET_VM_STATUS parameters.......................................................................................104 GET_VM_STATUS runtime errors....................................................................................104 GET_VM_STATUS return messages................................................................................105 SET_VM_STATUS.............................................................................................................105 SET_VM_STATUS parameters........................................................................................105 SET_VM_STATUS runtime errors.....................................................................................107 CERTIFICATE_SIGNING_REQUEST.....................................................................................107 CERTIFICATE_SIGNING_REQUEST parameters...............................................................107 CERTIFICATE_SIGNING_REQUEST errors.......................................................................107 CSR_CERT_SETTINGS......................................................................................................107 CSR_CERT_SETTINGS parameters.................................................................................108 CSR_CERT_SETTINGS errors.........................................................................................109 GET_CERT_SUBJECT_INFO...............................................................................................109 GET_CERT_SUBJECT_INFO parameters .........................................................................109 GET_CERT_SUBJECT_INFO errors .................................................................................109 IMPORT_CERTIFICATE......................................................................................................109 IMPORT_CERTIFICATE parameters.................................................................................110 IMPORT_CERTIFICATE errors.........................................................................................110 GET_TWOFACTOR_SETTINGS..........................................................................................110 GET_TWOFACTOR_SETTINGS parameters.....................................................................110 GET_TWOFACTOR_SETTINGS runtime errors.................................................................110 GET_TWOFACTOR_SETTINGS return messages..............................................................110 MOD_TWOFACTOR_SETTINGS........................................................................................111 MOD_TWOFACTOR_SETTINGS parameters...................................................................112 MOD_TWOFACTOR_SETTINGS runtime errors...............................................................113 DIR_INFO............................................................................................................................113 GET_DIR_CONFIG..........................................................................................................113 GET_DIR_CONFIG parameters.....................................................................................114 GET_DIR_CONFIG runtime errors..................................................................................114 GET_DIR_CONFIG return messages..............................................................................114 6 Contents IMPORT_SSH_KEY...........................................................................................................115 IMPORT_SSH_KEY parameters......................................................................................115 IMPORT_SSH_KEY runtime errors..................................................................................115 MOD_DIR_CONFIG........................................................................................................116 MOD_DIR_CONFIG parameters...................................................................................117 MOD_DIR_CONFIG runtime errors................................................................................118 RACK_INFO........................................................................................................................118 GET_RACK_SETTINGS.....................................................................................................119 GET_RACK_SETTINGS parameters................................................................................119 GET_RACK_SETTINGS runtime errors.............................................................................119 GET_RACK_SETTINGS return messages.........................................................................119 GET_DIAGPORT_SETTINGS..............................................................................................119 GET_DIAGPORT_SETTINGS parameters.........................................................................120 GET_DIAGPORT_SETTINGS runtime errors.....................................................................120 GET_DIAGPORT_SETTINGS return messages..................................................................120 MOD_DIAGPORT_SETTINGS............................................................................................120 MOD_DIAGPORT_SETTINGS parameters.......................................................................120 MOD_DIAGPORT_SETTINGS runtime errors...................................................................121 GET_ENCLOSURE_IP_SETTINGS........................................................................................121 GET_ENCLOSURE_IP_SETTINGS parameters..................................................................121 GET_ENCLOSURE_IP_SETTINGS return messages............................................................121 MOD_ENCLOSURE_IP_SETTINGS......................................................................................122 MOD_ENCLOSURE_IP_SETTINGS parameters................................................................122 MOD_ENCLOSURE_IP_SETTINGS runtime errors.............................................................123 GET_TOPOLOGY.............................................................................................................123 GET_TOPOLOGY parameters........................................................................................123 GET_TOPOLOGY return message..................................................................................123 MOD_BLADE_RACK........................................................................................................124 MOD_BLADE_RACK parameters...................................................................................124 MOD_BLADE_RACK runtime errors................................................................................125 SERVER_INFO......................................................................................................................125 GET_SERVER_NAME........................................................................................................126 GET_SERVER_NAME return message.............................................................................126 GET_SERVER_NAME runtime errors...............................................................................126 SERVER_NAME...............................................................................................................126 SERVER_NAME parameters..........................................................................................126 SERVER_NAME return message....................................................................................126 SERVER_NAME runtime errors......................................................................................127 GET_EMBEDDED_HEALTH................................................................................................127 GET_EMBEDDED_HEALTH parameters...........................................................................127 GET_EMBEDDED_HEALTH return messages....................................................................127 GET_POWER_READINGS.................................................................................................129 GET_POWER_READINGS parameters............................................................................129 GET_POWER_READINGS return messages.....................................................................129 GET_POWER_CAP..........................................................................................................130 GET_POWER_CAP parameters.....................................................................................130 GET_POWER_CAP return messages..............................................................................130 SET_POWER_CAP...........................................................................................................130 SET_POWER_CAP parameters......................................................................................131 SET_POWER_CAP runtime errors...................................................................................131 GET_HOST_POWER_SAVER_STATUS.................................................................................131 GET_HOST_POWER_SAVER_STATUS parameters............................................................131 GET_HOST_POWER_SAVER_STATUS runtime errors.........................................................131 GET_HOST_POWER_SAVER_STATUS return messages.....................................................131 SET_HOST_POWER_SAVER..............................................................................................132 Contents 7 SET_HOST_POWER_SAVER parameters.........................................................................132 SET_HOST_POWER_SAVER runtime errors......................................................................132 GET_HOST_POWER_REG_INFO.......................................................................................132 GET_HOST_POWER_REG_INFO parameters..................................................................133 GET_HOST_POWER_REG_INFO runtime errors...............................................................133 GET_HOST_POWER_REG_INFO return messages...........................................................133 GET_HOST_POWER_STATUS............................................................................................134 GET_HOST_POWER_STATUS Parameters.......................................................................134 GET_HOST_POWER_STATUS Runtime Errors...................................................................134 GET_HOST_POWER_STATUS Return Messages...............................................................134 SET_HOST_POWER.........................................................................................................134 SET_HOST_POWER Parameters....................................................................................135 SET_HOST_POWER Runtime Errors................................................................................135 GET_HOST_PWR_MICRO_VER..........................................................................................135 GET_HOST_PWR_MICRO_VER parameters....................................................................135 GET_HOST_PWR_MICRO_VER runtime errors.................................................................135 GET_HOST_PWR_MICRO_VER return messages..............................................................136 GET_ONE_TIME_BOOT...................................................................................................136 GET_ONE_TIME_BOOT parameters..............................................................................136 GET_ONE_TIME_BOOT runtime errors...........................................................................136 GET_ONE_TIME_BOOT return messages.......................................................................136 SET_ONE_TIME_BOOT....................................................................................................137 SET_ONE_TIME_BOOT parameters...............................................................................137 SET_ONE_TIME_BOOT runtime errors............................................................................137 SET_ONE_TIME_BOOT return messages........................................................................137 GET_PERSISTENT_BOOT...................................................................................................137 GET_PERSISTENT_BOOT parameters.............................................................................138 GET_PERSISTENT_BOOT runtime errors..........................................................................138 GET_PERSISTENT_BOOT return messages.......................................................................138 SET_PERSISTENT_BOOT...................................................................................................138 SET_PERSISTENT_BOOT parameters..............................................................................138 SET_PERSISTENT_BOOT runtime errors...........................................................................138 SET_PERSISTENT_BOOT return messages.......................................................................139 GET_PWREG_CAPABILITIES..............................................................................................139 GET_PWREG_CAPABILITIES parameters.........................................................................139 GET_PWREG_CAPABILITIES runtime errors......................................................................139 GET_PWREG_CAPABILITIES return messages..................................................................139 RESET_SERVER................................................................................................................141 RESET_SERVER errors...................................................................................................141 RESET_SERVER parameters...........................................................................................141 PRESS_PWR_BTN.............................................................................................................141 PRESS_PWR_BTN parameters.......................................................................................141 PRESS_PWR_BTN runtime errors....................................................................................141 HOLD_PWR_BTN............................................................................................................141 HOLD_PWR_BTN parameters.......................................................................................142 HOLD_PWR_BTN runtime errors....................................................................................142 COLD_BOOT_SERVER......................................................................................................142 COLD_BOOT_SERVER parameters.................................................................................142 COLD_BOOT_SERVER runtime errors.............................................................................142 WARM_BOOT_SERVER....................................................................................................142 WARM_BOOT_SERVER parameters...............................................................................143 WARM_BOOT_SERVER runtime errors...........................................................................143 SERVER_AUTO_PWR........................................................................................................143 SERVER_AUTO_PWR parameters..................................................................................143 SERVER_AUTO_PWR runtime errors...............................................................................143 8 Contents GET_SERVER_AUTO_PWR................................................................................................144 GET_SERVER_AUTO_PWR parameters...........................................................................144 GET_SERVER_AUTO_PWR return message.....................................................................144 GET_UID_STATUS............................................................................................................144 GET_UID_STATUS parameters.......................................................................................144 GET_UID_STATUS response..........................................................................................145 UID_CONTROL...............................................................................................................145 UID_CONTROL parameters..........................................................................................145 UID_CONTROL errors..................................................................................................145 GET_VPB_CABLE_STATUS (RILOE II only).............................................................................145 GET_VPB_CABLE_STATUS parameters............................................................................145 GET_VPB_CABLE_STATUS Runtime Errors.......................................................................145 GET_VPB_CABLE_STATUS return messages.....................................................................146 SSO_INFO..........................................................................................................................146 GET_SSO_SETTINGS.......................................................................................................146 GET_SSO_SETTINGS parameters..................................................................................147 GET_SSO_SETTINGS return messages...........................................................................147 MOD_SSO_SETTINGS.....................................................................................................147 MOD_SSO_SETTINGS parameters................................................................................148 MOD_SSO_SETTINGS runtime errors.............................................................................149 SSO_SERVER..................................................................................................................149 SSO_SERVER parameters.............................................................................................150 SSO_SERVER runtime errors..........................................................................................151 DELETE_SERVER...............................................................................................................151 DELETE_SERVER parameters.........................................................................................151 DELETE_SERVER runtime errors......................................................................................151 10 HPQLOMGC command language..........................................................152 Using HPQLOMGC..............................................................................................................152 ILO_CONFIG.......................................................................................................................152 11 iLO 2 ports...........................................................................................154 Enabling the iLO 2 Shared Network Port feature through XML scripting........................................154 Re-enabling the dedicated NIC management port.....................................................................154 12 iLO 2 parameters..................................................................................155 Status Summary parameters...................................................................................................155 User Administration parameters..............................................................................................156 Global Settings parameters....................................................................................................157 Network parameters.............................................................................................................159 Network DHCP/DNS parameters...........................................................................................160 SNMP/Insight Manager settings parameters............................................................................162 Directory settings parameters.................................................................................................162 BL p-Class parameters...........................................................................................................163 iLO Advanced Pack License Key..............................................................................................164 13 Technical support..................................................................................165 HP contact information..........................................................................................................165 Before you contact HP...........................................................................................................165 Acronyms and abbreviations.......................................................................166 Index.......................................................................................................168 Contents 9 1 Introduction Overview HP iLO 2 provides multiple ways to configure, update, and operate HP ProLiant servers remotely. 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. 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 2.06 and later. Before using the XML sample scripts downloaded from the HP website at http://www.hp.com/servers/lights-out, 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 2.06. The following commands were added/updated: • Updated CERTIFICATE_SIGNING_REQUEST • Added CSR_CERT_SETTINGS • Added GET_CERT_SUBJECT_INFO • Added GET_ONE_TIME_BOOT • Added SET_ONE_TIME_BOOT • Added GET_PERSISTENT_BOOT • Added SET_PERSISTENT_BOOT • Added DELETE_SSH_KEY HP Insight Control server deployment HP Insight Control server deployment integrates with iLO 2 to enable the management of remote servers and the performance of remote console operations regardless of the state of the operating system or hardware. The deployment server provides the ability to use the power management features of iLO 2 to power on, power off, or cycle power on the target server. Each time a server connects to the deployment server, the deployment server polls the target server to verify that a LOM management device is installed. If installed, the server gathers information including the DNS name, IP address, and user login name. Security is maintained by requiring the user to enter the correct password for that user name. For more information about the HP Insight Control server deployment, see the documentation that ships on the HP Insight Software DVD, or the HP Insight Control webpage at http://www.hp.com/ go/insightcontrol. Server management through IPMI version 2.0 compliant applications Server management through the IPMI is a standardized method for controlling and monitoring the server. iLO 2 provides server management based on the IPMI version 2.0 specification. 10 Introduction

See more

The list of books you might like

Upgrade Premium
Most books are stored in the elastic cloud where traffic is expensive. For this reason, we have a limit on daily download.
DMCA & Copyright: Dear all, most of the website is community built, users are uploading hundred of books everyday, which makes really hard for us to identify copyrighted material, please contact us if you want any material removed.
Copyright @ PDFdrive.to, 2022 | We love our users