Group Administration and iLO Scripting | HP Integrated Lights-Out

	241
Group Administration and iLO Scripting
In This Section
Lights-Out Configuration Utility	241
Group Administration Using the Lights-Out Configuration Utility	242
Batch Processing Using the Lights-Out Configuration Utility	247
Lights-Out Configuration Utility Parameters	247

Lights-Out Configuration Utility

The Lights-Out Configuration Utility (CPQLOCFG.EXE) is a Windows®-based utility that connects to iLO using a secure connection over the network. RIBCL scripts are passed to iLO over the secure connection to CPQLOCFG. This utility requires a valid user ID and password with the appropriate privileges. The CPQLOCFG utility can be launched from Insight Manager 7 or Systems Insight Manager for Group Administration or used independently from a command prompt for batch processing. This utility can be downloaded from the HP website (http://h18004.www1.hp.com/support/files/lights-out/us/index.html).

Version 2.20 or later of CPQLOCFG.EXE is required to configure iLO Directory Settings using RIBCL scripts.

Insight Manager 7 and System Insight Manager discover iLO devices as management processors. The Lights-Out Configuration Utility sends a RIBCL file to a group of iLO processors to manage the user accounts for those iLO processors. iLO processors then perform the action designated by the RIBCL file and send a response to the log file.

The Lights-Out Configuration Utility is used to execute RIBCL scripts on iLO and must reside on the same server as Insight Manager 7 or Systems Insight Manager. The Lights-Out Configuration Utility generates two types of error messages: runtime and syntax.

•Runtime errors occur when an invalid action is requested. Runtime errors are logged to the following directories:

Image 241

HP Integrated Lights-Out manual Group Administration and iLO Scripting, Lights-Out Configuration Utility

Contents

HP Integrated Lights-Out User Guide Audience Assumptions Contents User Guide Integrated Lights-Out ILO Security 135 Certificate Services 189 Insight Manager 7 Integration 223 Lights-Out DOS Utility 249 Login Modglobalsettings Moddiagport Settings ILO Parameters 331 Contents Technical Support 397 New in This Version Operational OverviewThis Section Network Connection Overview Usage Model Supported Server Operating System Software Supported Browsers Configuring Linux Font Size Linux Browser ConfigurationPage ILO Configuration Options Configuring iLO ILO Rbsu Browser-Based Setup Scripted Setup Installing iLO Device Drivers Select Software and Drivers Installing or Updating the iLO Drivers for MicrosoftILO Pre-requisite Files for Microsoft Novell NetWare Server Driver Support Installing or Updating iLO Drivers for NetWareILO Pre-Requisite Files for NetWare ILO Pre-requisite Files for Red Hat and SuSE Linux Files Red Hat Linux and SuSE Linux Server Driver SupportInstaling or Updating iLO Linux and SuSE Drivers Enabling iLO Advanced Functionality ILO Advanced Evaluation License Activating iLO Advanced Features Using a BrowserILO Advanced License Options User Guide Integrated Lights-Out Activating iLO Advanced Using Scripting ProLiant BL p-Class Configuration ProLiant BL p-Class User Requirements Static IP Bay Configuration Configuring Static IP Bay Settings Configuring a ProLiant BL p-Class Blade Enclosure User Guide Integrated Lights-Out ProLiant BL p-Class Advanced Configuration Parameters ProLiant BL p-Class Standard Configuration Parameters Ribcl Rackinfo Commands Enable iLO IP Address Assignment Getting Static IP Bay Configuration Settings Ribcl Rackinfo Command ExamplesModifying Static IP Bay Configuration Settings Integration with Riloe II Accessory Boards Logging in to iLO for the First Time Using iLO Logging in to iLO for the First Time Using a Browser Using iLO User Guide Integrated Lights-Out Using iLO Help Progressive Delays for Failed Browser Login Attempts Status Summary System StatusILO Status Server Status ILO Event Log Integrated Management Log Post Diagnostic Results for the Host Server Server and iLO Diagnostics Virtual NMI Button Nvram Environment Variables Listing ILO Self-Test Results Remote Console Option Remote Console Remote Console Information Option Recommended Client Settings Enhanced Features of the Remote ConsoleOptimizing Performance for Graphical Remote Console Display Properties Recommended Server Settings Remote Console Linux SettingsRemote Console Mouse Properties Microsoft Windows Server 2003 Settings Microsoft Windows NT 4.0 and Windows 2000 Settings Novell NetWare Settings Red Hat Linux and SuSE Linux Server SettingsRemote Console Hot Keys Supported Hot Keys Remote Console Single-Cursor Single- and Dual-Cursor Modes for Graphical Remote Console Remote Console Dual-Cursor Virtual Devices Virtual Power Using iLO Virtual Media MS-DOS Operating System USB Support USB USB CD USB CD2 ILO Virtual Floppy Using iLO Virtual Media DevicesSelect Local Floppy Drive Click Connect Access iLO through a browser Connect Click Create Disk Image Select Local CD-ROM Drive ILO Virtual CD-ROM Using an Image File Virtual Media CD-ROM Operating System Notes Mounting USB Virtual Media CD in NetWare Mount /dev/scd0 /mnt/cdrom -t iso9660 Virtual Media Composite Device Support Select Local Floppy Drive ILO Virtual Media Privilege Virtual Media Applet TimeoutVirtual Media Scripting Command Line Input Result Virtual Media Image Files Scripting Web Server Requirements CGI Helper Application Virtual Indicators Windows EMS Console Virtual Serial Port Virtual Serial Port and Linux Security Information User Administration AdministrationLinux End-to-End Support Adding a New User Click View/Modify User Viewing or Modifying an Existing Users Settings Click Global Settings Global SettingsDeleting a User User Guide Integrated Lights-Out Network Settings Click Network Settings Using iLO ILO Diagnostic Port Configuration Parameters Recovering from a Failed iLO Firmware Update SNMP/Insight Manager Settings Enabling Snmp Alerts Generating Test Alerts Click Apply Settings Configure Insight Manager Integration Upgrade iLO Firmware Click Send firmware image Licensing Certificate Administration ProLiant BL p-Class Advanced Management Directory Settings User Guide Integrated Lights-Out Rack Settings Server Blade Management Module Power Management Module ILO Control of ProLiant BL p-Class Server LEDs Redundant Power Management Module Hot-Plug Keyboard Insufficient Power NotificationKeyboard Definitions Server Post Tracking Hot-Plug Keyboard Recommended Usage Hot-Plug Keyboard Troubleshooting User Guide Integrated Lights-Out Terminal Services Client Requirements Terminal Services Pass-Through Option Windows RDP Pass-Through Service Terminal Services Pass-Through Installation Windows 2000 Terminal Services Port Change Enabling the Terminal Services Pass-Through Option Terminal Services Warning Message Terminal Services Pass-Through Status Terminal Services Button Display Remote Console and Terminal Services Clients ComputerPropertiesRemoteRemote Desktop Terminal Services TroubleshootingManagerMultifunction Adapters Telnet Support HP ProLiant Essentials Rapid Deployment Pack IntegrationViewerApplication Telnet Simple Command Set Using Telnet Telnet Security Supported Key Sequences ILO VT100+ Key Map Altk Altlowerj Linux Codes for the F-Keys VT100+ Codes for the F-Keys Using SSH Using Secure ShellSecure Shell Using OpenSSH ILO Supported SSH FeaturesUsing PuTTY ILO Shared Network Port Requirements ILO Shared Network Port ILO Shared Management Port Features and Restrictions Enabling the iLO Shared Network Port Feature Select AdministrationNetwork Settings Re-enabling the Dedicated iLO Management Port Select NetworkNICTCP/IP, and press the Enter key Command Line Interface Escape CLI CommandsHelp Remcons Power Exit VspPage ILO Security Security FeaturesGeneral Security Guidelines Encryption ILO Security Override Switch Administration User Accounts Privileges Login Security Global Security Settings Password Guidelines Certificates Securing Rbsu Page Benefits of Directory Integration Directory Services Features Supported by Directory Integration Installing Directory Services Schema Documentation Directory Services Support Schema Required Software Schema Installer EDirectory Installation Prerequisites Schema Preview Setup Directory Services 151 Results Management Snap-In Installer Active Directory Installation Prerequisites Directory Services for Active Directory Directory Services Preparation for Active Directory Start MMC Install the Active Directory Schema snap-in in MMC Snap-In Installation and Initialization for Active Directory Directory Services 157 User Guide Integrated Lights-Out Directory Services 159 User Guide Integrated Lights-Out Directory Services 161 Directory Services Objects Active Directory Snap-Ins HP Devices Active Directory Role Restrictions Members User Guide Integrated Lights-Out Time Restrictions Enforced Client IP Address or DNS Name Access Remove Active Directory Lights-Out Management Snap-in Installation and Initialization for eDirectory Directory Services for eDirectory User Guide Integrated Lights-Out Directory Services 173 Apply Directory Services 175 Directory Services Objects for eDirectory Role Managed Devices Role Restrictions EDirectory Role Restrictions Time Restrictions Delete Lights-Out Management Directory Services 183 Configuring Directory Settings Directory Services 185 Directory Tests User Login Using Directory Services User Guide Integrated Lights-Out Introduction to Certificate Services Certificate ServicesInstalling Certificate Services Configuring Automatic Certificate Request Verifying Directory Services Certificate Services 191 Page Introduction to Directory-Enabled Remote Management Directory-Enabled Remote Management Using Bulk Import Tools Using Existing Groups Using Multiple Roles AdminUserAdminRole Server UserRole Restricting Roles Creating Roles to Follow Organizational StructureRole Time Restrictions IP Address and Subnet Mask Restrictions IP Address Range RestrictionsDNS-Based Restrictions Role Address Restrictions How Directory Login Restrictions are Enforced User Address Restrictions How User Time Restrictions are Enforced Creating Multiple Restrictions and Roles Directory-Enabled Remote Management 203 User Guide Integrated Lights-Out Introduction to Lights-Out Migration Utilities Lights-Out Directories Migration Utilities Compatibility Pre-Migration Checklist HP Lights-Out Directory Package Finding Management Processors Hpqlomig Operation Lights-Out Directories Migration Utilities 209 Upgrading Firmware on Management Processors Enter your Login NamePassword and click Find Lights-Out Directories Migration Utilities 211 Naming Management Processors Select either Use Network Address or Create Name Using Index Configuring Directories Browse Click Update Directory Setting Up Management Processors for Directories Click Configure Hpqlomgc Operation Firmware version is validated and updated if necessary Launching Hpqlomgc Using Application LaunchManagement processor directory settings are updated Directory is updated Lights-Out Directories Migration Utilities 219 Hpqlomgc Command Language Iloconfig Page Integrating iLO with Insight Manager Insight Manager 7 Integration Identification and Association Functional Overview Queries StatusLinks Configuring Identification of iLO Insight Manager 7 Integration 227 Receiving Snmp Alerts in Insight Manager Port Matching Insight Manager 7 Integration 229 User Guide Integrated Lights-Out ProLiant BL p-Class Rack Visualization User Guide Integrated Lights-Out Integrating iLO with Systems Insight Manager Systems Insight Manager Integration Systems Insight Manager Functional Overview System Insight Manager Status System Insight Manager Identification and Association System Insight Manager Links Configuring System Insight Manager Identification of iLOSystem Insight Manager Systems Lists Receiving Snmp Alerts in Systems Insight Manager System Insight Manager Port Matching Systems Insight Manager Integration 239 Page Lights-Out Configuration Utility Group Administration and iLO Scripting \PROGRAM FILES\INSIGHT MANAGER\HP\SYTEMS Select Management Processor and click OK Query Definition in Insight Manager Application Launch Using Insight Manager Click ToolsCustom CommandsNew Custom Command Create a Custom CommandCreate a Customized List Click either Schedule or Run Now Create a Task Lights-Out Configuration Utility Parameters Batch Processing Using the Lights-Out Configuration Utility Cpqlocfg Overview of the Lights-Out DOS Utility Lights-Out DOS Utility Cpqlodos Recommended Usage Command Line ArgumentsCpqlodos General Guidelines Lights-Out DOS Utility 251 Cpqlodos Runtime Error Ribcl XML Commands for CpqlodosCpqlodos Parameter Adduser Parameters Adduser Runtime Errors Setlicense Parameter Setlicense Runtime Errors Perl Scripting Using Perl with the XML Scripting InterfaceXML Enhancements XML script modification Opening an SSL Connection Sending the XML Header and Script Body Perl Scripting 259 User Guide Integrated Lights-Out Hponcfg Hponcfg Online Configuration UtilityHponcfg Supported Operating Systems Hponcfg Requirements Hponcfg Installation and Usage Linux Server Installation Windows Server Installation Using Hponcfg Hponcfg Command Line Parameters Hponcfg Usage Model Obtaining an Entire Configuration Sample adduser.xml input file Creating a User Account Hponcfg Online Configuration Utility Page Remote Insight Command Language Ribcl and ProLiant BL p-Class Servers Overview of the Remote Insight Board Command Language XML Header Ribcl Sample Scripts Ribcl General GuidelinesData Types String Response DefinitionsSpecific String Boolean String Ribcl Ribcl Runtime ErrorsRibcl Parameter Login Parameters LoginLogin Runtime Errors Userinfo Userinfo Runtime ErrorUserinfo Parameter Adduser Parameters Adduser Remote Insight Command Language Adduser Runtime Errors Deleteuser Deleteuser Runtime ErrorsDeleteuser Parameter Getuser Getuser Runtime ErrorsGetuser Parameter Getuser Return Messages Moduser Moduser Parameters Moduser Runtime Errors Getallusers Getallusers Runtime ErrorGetallusers Parameters Getallusers Return Messages Getalluserinfo Getalluserinfo Runtime ErrorsGetalluserinfo Parameters Getalluserinfo Return Messages Ribinfo Ribinfo Runtime Errors ResetribResetrib Parameters Resetrib Runtime Errors Getnetworksettings Parameters GetnetworksettingsGetnetworksettings Runtime Errors Getnetworksettings Return Messages Dhcpwinsserver VALUE=Y Regwinsserver VALUE=Y Modnetworksettings Modnetworksettings /RIBINFO Login Ribcl Modnetworksettings Parameters User Guide Integrated Lights-Out Modnetworksettings Runtime Errors GetglobalsettingsGetglobalsettings Parameters Getglobalsettings Runtime Errors ModglobalsettingsGetglobalsettings Return Messages Modglobalsettings Parameters User Guide Integrated Lights-Out Remote Insight Command Language Modglobalsettings Runtime Errors GetsnmpimsettingsGetsnmpimsettings Parameters Getsnmpimsettings Runtime Errors Modsnmpimsettings Parameters Modsnmpimsettings Modsnmpimsettings Runtime Errors Cleareventlog Cleareventlog Runtime ErrorsCleareventlog Parameters Updateribfirmware Parameters UpdateribfirmwareUpdateribfirmware Runtime Errors Getfwversion Getfwversion Runtime ErrorsGetfwversion Parameters Getfwversion Return Messages Hotkeyconfig Parameters Hotkeyconfig License Hotkeyconfig Runtime Errors License Parameters License Runtime Errors Dirinfo Runtime Errors GetdirconfigDirinfo Dirinfo Parameters Getdirconfig Runtime Errors Getdirconfig ParametersGetdirconfig Return Messages Moddirconfig Parameters Moddirconfig Rackinfo Moddirconfig Runtime Errors Modbladerack Rackinfo Runtime ErrorsRackinfo Parameters Modbladerack Parameters Modbladerack Runtime Errors GetdiagportsettingsGetdiagportsettings Parameters Getdiagportsettings Runtime Errors Getdiagportsettings Return Messages ModdiagportsettingsModdiagportsettings Parameters Gettopology Moddiagportsettings Runtime Errors Gettopology Parameters ServerinfoGettopology Return Message Serverinfo Runtime Errors GethostpowerstatusServerinfo Parameter Gethostpowerstatus Parameters SethostpowerGethostpowerstatus Runtime Errors Gethostpowerstatus Return Messages Sethostpower Parameters ResetserverSethostpower Runtime Errors Resetserver Errors Resetserver ParametersPresspwrbtn Presspwrbtn Parameters Holdpwrbtn Runtime Errors Presspwrbtn Runtime ErrorsHoldpwrbtn Holdpwrbtn Parameters Coldbootserver Parameters ColdbootserverColdbootserver Runtime Errors Warmbootserver Parameters WarmbootserverWarmbootserver Runtime Errors Getuidstatus Getuidstatus Parameters UidcontrolGetuidstatus Response Insertvirtualmedia Uidcontrol ErrorsUidcontrol Parameters Insertvirtualmedia Parameters Insertvirtualfloppy Runtime Errors Ejectvirtualmedia Ejectvirtualmedia Runtime ErrorsEjectvirtualmedia Parameters Getvmstatus Getvmstatus Runtime ErrorsGetvmstatus Parameters Getvmstatus Return Messages Setvmstatus Parameters Setvmstatus Setvmstatus Runtime Errors ILO Parameters Table ILO Parameters Global Settings ILO Parameters 333 SNMP/Insight Manager Settings ILO Parameters 335 ILO Status Server Name Server Status ParametersServer ID User Administration Parameters Administer User Accounts PasswordRemote Console Access Virtual Power and Reset Enable Lights-Out Functionality Idle Connection Timeout MinutesEnable iLO Rbsu Pass-Through Configuration Remote Console Port Configuration Require Login for iLO RbsuShow iLO During Post Remote Console Data Encryption Web Server Non-SSL Port Terminal Services PortWeb Server SSL Port Virtual Media Port Serial Command Line Interface Speed bits/second Serial Command Line Interface StatusMinimum Password Length Network Settings Parameters Shared Network Port Enable NICTransceiver Speed Autoselect Speed Registering with DNS Server Registering with Wins ServerPing Gateway on Startup ILO IP Address ILO Subsystem Name ILO Gateway IP AddressDomain Name Dhcp Server Enable iLO Snmp Alerts SNMP/Insight Manager Settings ParametersEnable Snmp Pass-Through Snmp Alert Destinations Insight Manager Web Agent URL ILO Advanced License Activation SettingsLevel of Data Returned ILO Advanced Pack License Key Enclosure Name Rack NameBay Name Bay Enable Automatic Power On Power SourceEnable Rack Alert Logging IML Directory Settings Parameters Enable Local User Accounts Enable Directory AuthenticationLOM Object Password Directory Server Address Click Test Settings Testing Directory SettingsClick Start Test HP Management Core Ldap OID Classes and Attributes Directory Services SchemaCore Classes Core Attributes HpqTarget Core Class DefinitionsHpqRole HpqPolicy Core Attribute DefinitionsHpqPolicyDN HpqRoleMembership HpqTargetMembership HpqRoleIPRestrictionDefaultHpqRoleIPRestrictions Directory Services Schema 357 HpqRoleTimeRestriction Lights-Out Management Attributes Lights-Out Management Classes Lights-Out Management Attribute Definitions Lights-Out Management Class DefinitionsHpqLOMv100 HpqLOMRightRemoteConsole HpqLOMRightLoginHpqLOMRightVirtualMedia HpqLOMRightLocalUserAdmin HpqLOMRightServerResetHpqLOMRightConfigureSettings Page Minimum Requirements Troubleshooting iLO ILO Post LED Indicators Troubleshooting iLO 365 FEH Code Consistency Check Explanation Event Log Entries Troubleshooting iLO 367 User Guide Integrated Lights-Out Troubleshooting iLO 369 Hardware and Software Link-Related Issues MS-DOS Error Codes Hardware Login IssuesSoftware ILO Management Port Not Accessible by Name Login Name and Password Not AcceptedDirectory User Premature Logout Inability to Access the Login ILO Rbsu Unavailable after iLO and Server Reset Inability to Connect to iLO after Changing Network Settings Inability to Access iLO Using TelnetInability to Connect to the iLO Diagnostic Port Inability to Connect to the iLO Processor through the NIC Firewall Issues Proxy Server Issues Troubleshooting Alert and Trap Problems Authentication Code Error Message ILO Security Override Switch Local USB Mouse and Linux Troubleshooting Mouse Problems Remote Console Mouse Control Issue Mouse Issue Using SuSE Linux Emulating a PS/2 Keyboard in a Headless Server Environment Troubleshooting Remote Console ProblemsLinux Remote Console User Guide Integrated Lights-Out Remote Console Text Window not Updating Properly Remote Console Turns Grey or Black Troubleshooting SSH and Telnet ProblemsInitial PuTTY Input Slow PuTTY Client Unresponsive with Shared Network Port Terminal Services Button Is Not Working Troubleshooting Terminal Services ProblemsTerminal Services Proxy Stops Responding SSH Text Support from a Remote Conosle Session General Guidelines Troubleshooting Video and Monitor ProblemsTelnet Displays Incorrectly in DOS Video Applications not Displaying in the Remote Console Troubleshooting Miscellaneous Problems Troubleshooting Virtual Media ProblemsVirtual Drive Listing Virtual Media Applet has a Red X and Will Not Display Shared Instances Cookie Sharing Between Browser Instances and iLOCookie Order Behavior Troubleshooting iLO 389 Displaying the Current Session Cookie Preventing Cookie-Related User Issues ILO Network Flash Recovery Inability to Upgrade iLO FirmwareDiagnostic Steps Incorrect Time or Date of the Entries in the Event Log Flash Recovery Process ROMPaq ILO Does Not Respond to SSL Requests Testing SSL Request New Certificate Resetting iLO Server Name Still Present after Erase Utility is Executed Troubleshooting a Remote Host HP Contact Information Technical SupportBefore You Contact HP User Guide Integrated Lights-Out Acronyms and Abbreviations DAV ILO JVM MTU RDP SSL Page Index LAN Index Uidcontrol