Setlicense Parameter | HP Integrated Lights-Out guide

254 User Guide Integrated Lights-Out

•Blank user login name not allowed. Maximum length is 39 characters.

SET_LICENSE

This command is used to apply the iLO Advanced Pack License key to the iLO. On a ProLiant BL p-class server, this parameter is not necessary because the advanced features are activated by default.

Example:

<SET_LICENSE>

<LICENSE_KEY VALUE = "12345ABCDE12345FGHIJ12345"/> </SET_LICENSE>

SET_LICENSE Parameter

LICENSE_KEY is the text value of the iLO Advanced Pack activation key. This is a 25-byte, alphanumeric string. Do not include any hyphens or spaces in the string.

SET_LICENSE Runtime Errors

The possible SET_LICENSE error messages include:

•License key error.

•License is already active.

•User does not have correct privilege for action. CONFIG_ILO_PRIV required.

Image 254

HP Integrated Lights-Out manual Setlicense Parameter, Setlicense Runtime Errors

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 This Section Operational OverviewNew in This Version Usage Model Network Connection Overview Supported Server Operating System Software Supported Browsers Linux Browser Configuration Configuring Linux Font SizePage Configuring iLO ILO Configuration Options ILO Rbsu Browser-Based Setup Installing iLO Device Drivers Scripted Setup ILO Pre-requisite Files for Microsoft Installing or Updating the iLO Drivers for MicrosoftSelect Software and Drivers ILO Pre-Requisite Files for NetWare Installing or Updating iLO Drivers for NetWareNovell NetWare Server Driver Support Instaling or Updating iLO Linux and SuSE Drivers Red Hat Linux and SuSE Linux Server Driver SupportILO Pre-requisite Files for Red Hat and SuSE Linux Files Enabling iLO Advanced Functionality ILO Advanced License Options Activating iLO Advanced Features Using a BrowserILO Advanced Evaluation License User Guide Integrated Lights-Out ProLiant BL p-Class Configuration Activating iLO Advanced Using Scripting Static IP Bay Configuration ProLiant BL p-Class User Requirements Configuring a ProLiant BL p-Class Blade Enclosure Configuring Static IP Bay Settings User Guide Integrated Lights-Out ProLiant BL p-Class Standard Configuration Parameters ProLiant BL p-Class Advanced Configuration Parameters Enable iLO IP Address Assignment Ribcl Rackinfo Commands Modifying Static IP Bay Configuration Settings Ribcl Rackinfo Command ExamplesGetting Static IP Bay Configuration Settings Integration with Riloe II Accessory Boards Using iLO Logging in to iLO for the First Time Logging in to iLO for the First Time Using a Browser Using iLO User Guide Integrated Lights-Out Using iLO Progressive Delays for Failed Browser Login Attempts Help ILO Status System StatusStatus Summary Server Status ILO Event Log Integrated Management Log Server and iLO Diagnostics Post Diagnostic Results for the Host Server Nvram Environment Variables Listing Virtual NMI Button ILO Self-Test Results Remote Console Remote Console Option Remote Console Information Option Optimizing Performance for Graphical Remote Console Enhanced Features of the Remote ConsoleRecommended Client Settings Display Properties Remote Console Remote Console Linux SettingsRecommended Server Settings Mouse Properties Microsoft Windows NT 4.0 and Windows 2000 Settings Microsoft Windows Server 2003 Settings Remote Console Hot Keys Red Hat Linux and SuSE Linux Server SettingsNovell NetWare Settings Supported Hot Keys Single- and Dual-Cursor Modes for Graphical Remote Console Remote Console Single-Cursor Remote Console Dual-Cursor Virtual Devices Virtual Power Using iLO Virtual Media Operating System USB Support MS-DOS USB USB CD USB CD2 Select Local Floppy Drive Using iLO Virtual Media DevicesILO Virtual Floppy Click Connect Access iLO through a browser Connect Click Create Disk Image ILO Virtual CD-ROM Select Local CD-ROM Drive 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 Virtual Media Scripting Virtual Media Applet TimeoutILO Virtual Media Privilege Command Line Input Result Scripting Web Server Requirements Virtual Media Image Files CGI Helper Application Virtual Indicators Virtual Serial Port Windows EMS Console Security Information Virtual Serial Port and Linux Linux End-to-End Support AdministrationUser Administration Adding a New User Viewing or Modifying an Existing Users Settings Click View/Modify User Deleting a User Global SettingsClick Global Settings User Guide Integrated Lights-Out Network Settings Click Network Settings Using iLO ILO Diagnostic Port Configuration Parameters SNMP/Insight Manager Settings Recovering from a Failed iLO Firmware Update Enabling Snmp Alerts Click Apply Settings Generating Test Alerts Upgrade iLO Firmware Configure Insight Manager Integration Click Send firmware image Certificate Administration Licensing Directory Settings ProLiant BL p-Class Advanced Management User Guide Integrated Lights-Out Rack Settings Power Management Module Server Blade Management Module Redundant Power Management Module ILO Control of ProLiant BL p-Class Server LEDs Keyboard Definitions Insufficient Power NotificationHot-Plug Keyboard Server Post Tracking Hot-Plug Keyboard Troubleshooting Hot-Plug Keyboard Recommended Usage User Guide Integrated Lights-Out Terminal Services Pass-Through Option Terminal Services Client Requirements Windows RDP Pass-Through Service Terminal Services Pass-Through Installation Enabling the Terminal Services Pass-Through Option Windows 2000 Terminal Services Port Change Terminal Services Pass-Through Status Terminal Services Warning Message Remote Console and Terminal Services Clients Terminal Services Button Display ManagerMultifunction Adapters Terminal Services TroubleshootingComputerPropertiesRemoteRemote Desktop ViewerApplication HP ProLiant Essentials Rapid Deployment Pack IntegrationTelnet Support Using Telnet Telnet Simple Command Set Supported Key Sequences Telnet Security ILO VT100+ Key Map Altk Altlowerj VT100+ Codes for the F-Keys Linux Codes for the F-Keys Secure Shell Using Secure ShellUsing SSH Using PuTTY ILO Supported SSH FeaturesUsing OpenSSH ILO Shared Network Port ILO Shared Network Port Requirements ILO Shared Management Port Features and Restrictions Enabling the iLO Shared Network Port Feature Select AdministrationNetwork Settings Re-enabling the Dedicated iLO Management Port Command Line Interface Select NetworkNICTCP/IP, and press the Enter key Help CLI CommandsEscape Power Remcons Vsp ExitPage General Security Guidelines Security FeaturesILO Security ILO Security Override Switch Administration Encryption User Accounts Login Security Privileges Password Guidelines Global Security Settings Certificates Securing Rbsu Page Directory Services Benefits of Directory Integration Features Supported by Directory Integration Installing Directory Services Schema Documentation Directory Services Support EDirectory Installation Prerequisites Schema Required Software Schema Installer Schema Preview Setup Directory Services 151 Management Snap-In Installer Results Directory Services for Active Directory Active Directory Installation Prerequisites 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 Members Active Directory Role Restrictions User Guide Integrated Lights-Out Time Restrictions Enforced Client IP Address or DNS Name Access Remove Active Directory Lights-Out Management Directory Services for eDirectory Snap-in Installation and Initialization 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 Installing Certificate Services Certificate ServicesIntroduction to Certificate Services Verifying Directory Services Configuring Automatic Certificate Request Certificate Services 191 Page Directory-Enabled Remote Management Introduction to Directory-Enabled Remote Management Using Bulk Import Tools Using Existing Groups Using Multiple Roles AdminUserAdminRole Server UserRole Role Time Restrictions Creating Roles to Follow Organizational StructureRestricting Roles DNS-Based Restrictions IP Address Range RestrictionsIP Address and Subnet Mask Restrictions How Directory Login Restrictions are Enforced Role Address Restrictions How User Time Restrictions are Enforced User Address Restrictions Creating Multiple Restrictions and Roles Directory-Enabled Remote Management 203 User Guide Integrated Lights-Out Lights-Out Directories Migration Utilities Introduction to Lights-Out Migration Utilities Pre-Migration Checklist Compatibility HP Lights-Out Directory Package Hpqlomig Operation Finding Management Processors Lights-Out Directories Migration Utilities 209 Enter your Login NamePassword and click Find Upgrading Firmware on Management Processors Lights-Out Directories Migration Utilities 211 Select either Use Network Address or Create Name Using Index Naming Management Processors Configuring Directories Click Update Directory Browse Setting Up Management Processors for Directories Click Configure Hpqlomgc Operation Management processor directory settings are updated Launching Hpqlomgc Using Application LaunchFirmware version is validated and updated if necessary Directory is updated Lights-Out Directories Migration Utilities 219 Hpqlomgc Command Language Iloconfig Page Insight Manager 7 Integration Integrating iLO with Insight Manager Functional Overview Identification and Association Links StatusQueries Configuring Identification of iLO Receiving Snmp Alerts in Insight Manager Insight Manager 7 Integration 227 Port Matching Insight Manager 7 Integration 229 User Guide Integrated Lights-Out ProLiant BL p-Class Rack Visualization User Guide Integrated Lights-Out Systems Insight Manager Integration Integrating iLO with Systems Insight Manager Systems Insight Manager Functional Overview System Insight Manager Identification and Association System Insight Manager Status System Insight Manager Systems Lists Configuring System Insight Manager Identification of iLOSystem Insight Manager Links Receiving Snmp Alerts in Systems Insight Manager System Insight Manager Port Matching Systems Insight Manager Integration 239 Page Group Administration and iLO Scripting Lights-Out Configuration Utility \PROGRAM FILES\INSIGHT MANAGER\HP\SYTEMS Query Definition in Insight Manager Select Management Processor and click OK Application Launch Using Insight Manager Create a Customized List Create a Custom CommandClick ToolsCustom CommandsNew Custom Command Create a Task Click either Schedule or Run Now Batch Processing Using the Lights-Out Configuration Utility Lights-Out Configuration Utility Parameters Cpqlocfg Lights-Out DOS Utility Overview of the Lights-Out DOS Utility Cpqlodos General Guidelines Command Line ArgumentsCpqlodos Recommended Usage Lights-Out DOS Utility 251 Cpqlodos Parameter Ribcl XML Commands for CpqlodosCpqlodos Runtime Error Adduser Runtime Errors Adduser Parameters Setlicense Runtime Errors Setlicense Parameter XML Enhancements Using Perl with the XML Scripting InterfacePerl Scripting XML script modification Opening an SSL Connection Sending the XML Header and Script Body Perl Scripting 259 User Guide Integrated Lights-Out Hponcfg Supported Operating Systems Hponcfg Online Configuration UtilityHponcfg Hponcfg Installation and Usage Hponcfg Requirements Windows Server Installation Linux Server Installation Hponcfg Command Line Parameters Using Hponcfg Obtaining an Entire Configuration Hponcfg Usage Model Creating a User Account Sample adduser.xml input file Hponcfg Online Configuration Utility Page Remote Insight Command Language Overview of the Remote Insight Board Command Language Ribcl and ProLiant BL p-Class Servers Data Types Ribcl Sample Scripts Ribcl General GuidelinesXML Header Specific String Response DefinitionsString Boolean String Ribcl Parameter Ribcl Runtime ErrorsRibcl Login Runtime Errors LoginLogin Parameters Userinfo Parameter Userinfo Runtime ErrorUserinfo Adduser Adduser Parameters Remote Insight Command Language Adduser Runtime Errors Deleteuser Parameter Deleteuser Runtime ErrorsDeleteuser Getuser Parameter Getuser Runtime ErrorsGetuser Moduser Getuser Return Messages Moduser Parameters Moduser Runtime Errors Getallusers Parameters Getallusers Runtime ErrorGetallusers Getallusers Return Messages Getalluserinfo Parameters Getalluserinfo Runtime ErrorsGetalluserinfo Ribinfo Getalluserinfo Return Messages Resetrib Parameters ResetribRibinfo Runtime Errors Resetrib Runtime Errors Getnetworksettings Runtime Errors GetnetworksettingsGetnetworksettings Parameters Getnetworksettings Return Messages Modnetworksettings Dhcpwinsserver VALUE=Y Regwinsserver VALUE=Y Modnetworksettings /RIBINFO Login Ribcl Modnetworksettings Parameters User Guide Integrated Lights-Out Getglobalsettings Parameters GetglobalsettingsModnetworksettings Runtime Errors Getglobalsettings Return Messages ModglobalsettingsGetglobalsettings Runtime Errors Modglobalsettings Parameters User Guide Integrated Lights-Out Remote Insight Command Language Getsnmpimsettings Parameters GetsnmpimsettingsModglobalsettings Runtime Errors Getsnmpimsettings Runtime Errors Modsnmpimsettings Modsnmpimsettings Parameters Modsnmpimsettings Runtime Errors Cleareventlog Parameters Cleareventlog Runtime ErrorsCleareventlog Updateribfirmware Runtime Errors UpdateribfirmwareUpdateribfirmware Parameters Getfwversion Parameters Getfwversion Runtime ErrorsGetfwversion Getfwversion Return Messages Hotkeyconfig Hotkeyconfig Parameters Hotkeyconfig Runtime Errors License License Runtime Errors License Parameters Dirinfo GetdirconfigDirinfo Runtime Errors Dirinfo Parameters Getdirconfig Return Messages Getdirconfig ParametersGetdirconfig Runtime Errors Moddirconfig Moddirconfig Parameters Moddirconfig Runtime Errors Rackinfo Rackinfo Parameters Rackinfo Runtime ErrorsModbladerack Modbladerack Parameters Getdiagportsettings Parameters GetdiagportsettingsModbladerack Runtime Errors Getdiagportsettings Runtime Errors Moddiagportsettings Parameters ModdiagportsettingsGetdiagportsettings Return Messages Moddiagportsettings Runtime Errors Gettopology Gettopology Return Message ServerinfoGettopology Parameters Serverinfo Parameter GethostpowerstatusServerinfo Runtime Errors Gethostpowerstatus Runtime Errors SethostpowerGethostpowerstatus Parameters Gethostpowerstatus Return Messages Sethostpower Runtime Errors ResetserverSethostpower Parameters Presspwrbtn Resetserver ParametersResetserver Errors Presspwrbtn Parameters Holdpwrbtn Presspwrbtn Runtime ErrorsHoldpwrbtn Runtime Errors Holdpwrbtn Parameters Coldbootserver Runtime Errors ColdbootserverColdbootserver Parameters Warmbootserver Runtime Errors WarmbootserverWarmbootserver Parameters Getuidstatus Getuidstatus Response UidcontrolGetuidstatus Parameters Uidcontrol Parameters Uidcontrol ErrorsInsertvirtualmedia Insertvirtualmedia Parameters Insertvirtualfloppy Runtime Errors Ejectvirtualmedia Parameters Ejectvirtualmedia Runtime ErrorsEjectvirtualmedia Getvmstatus Parameters Getvmstatus Runtime ErrorsGetvmstatus Getvmstatus Return Messages Setvmstatus Setvmstatus Parameters Setvmstatus Runtime Errors ILO Parameters ILO Parameters Table Global Settings ILO Parameters 333 SNMP/Insight Manager Settings ILO Parameters 335 ILO Status Server ID Server Status ParametersServer Name User Administration Parameters Remote Console Access PasswordAdminister User Accounts Virtual Power and Reset Enable iLO Rbsu Idle Connection Timeout MinutesEnable Lights-Out Functionality Pass-Through Configuration Show iLO During Post Require Login for iLO RbsuRemote Console Port Configuration Remote Console Data Encryption Web Server SSL Port Terminal Services PortWeb Server Non-SSL Port Virtual Media Port Minimum Password Length Serial Command Line Interface StatusSerial Command Line Interface Speed bits/second Network Settings Parameters Transceiver Speed Autoselect Enable NICShared Network Port Speed Ping Gateway on Startup Registering with Wins ServerRegistering with DNS Server ILO IP Address Domain Name ILO Gateway IP AddressILO Subsystem Name Dhcp Server Enable Snmp Pass-Through SNMP/Insight Manager Settings ParametersEnable iLO Snmp Alerts Snmp Alert Destinations Level of Data Returned ILO Advanced License Activation SettingsInsight Manager Web Agent URL ILO Advanced Pack License Key Bay Name Rack NameEnclosure Name Bay Enable Rack Alert Logging IML Power SourceEnable Automatic Power On Directory Settings Parameters LOM Object Password Enable Directory AuthenticationEnable Local User Accounts Directory Server Address Click Start Test Testing Directory SettingsClick Test Settings Core Classes Directory Services SchemaHP Management Core Ldap OID Classes and Attributes Core Attributes HpqRole Core Class DefinitionsHpqTarget HpqPolicyDN Core Attribute DefinitionsHpqPolicy HpqRoleMembership HpqRoleIPRestrictions HpqRoleIPRestrictionDefaultHpqTargetMembership HpqRoleTimeRestriction Directory Services Schema 357 Lights-Out Management Classes Lights-Out Management Attributes HpqLOMv100 Lights-Out Management Class DefinitionsLights-Out Management Attribute Definitions HpqLOMRightVirtualMedia HpqLOMRightLoginHpqLOMRightRemoteConsole HpqLOMRightConfigureSettings HpqLOMRightServerResetHpqLOMRightLocalUserAdmin Page Troubleshooting iLO Minimum Requirements ILO Post LED Indicators Troubleshooting iLO 365 Event Log Entries FEH Code Consistency Check Explanation Troubleshooting iLO 367 User Guide Integrated Lights-Out Troubleshooting iLO 369 MS-DOS Error Codes Hardware and Software Link-Related Issues Software Login IssuesHardware Directory User Premature Logout Login Name and Password Not AcceptedILO Management Port Not Accessible by Name ILO Rbsu Unavailable after iLO and Server Reset Inability to Access the Login Inability to Connect to the iLO Diagnostic Port Inability to Access iLO Using TelnetInability to Connect to iLO after Changing Network Settings Inability to Connect to the iLO Processor through the NIC Firewall Issues Troubleshooting Alert and Trap Problems Proxy Server Issues ILO Security Override Switch Authentication Code Error Message Troubleshooting Mouse Problems Local USB Mouse and Linux Mouse Issue Using SuSE Linux Remote Console Mouse Control Issue Linux Remote Console Troubleshooting Remote Console ProblemsEmulating a PS/2 Keyboard in a Headless Server Environment User Guide Integrated Lights-Out Remote Console Text Window not Updating Properly Initial PuTTY Input Slow Troubleshooting SSH and Telnet ProblemsRemote Console Turns Grey or Black PuTTY Client Unresponsive with Shared Network Port Terminal Services Proxy Stops Responding Troubleshooting Terminal Services ProblemsTerminal Services Button Is Not Working SSH Text Support from a Remote Conosle Session Telnet Displays Incorrectly in DOS Troubleshooting Video and Monitor ProblemsGeneral Guidelines Video Applications not Displaying in the Remote Console Virtual Drive Listing Troubleshooting Virtual Media ProblemsTroubleshooting Miscellaneous Problems Virtual Media Applet has a Red X and Will Not Display Cookie Order Behavior Cookie Sharing Between Browser Instances and iLOShared Instances Troubleshooting iLO 389 Preventing Cookie-Related User Issues Displaying the Current Session Cookie Diagnostic Steps Inability to Upgrade iLO FirmwareILO Network Flash Recovery Incorrect Time or Date of the Entries in the Event Log Flash Recovery Process ROMPaq Testing SSL ILO Does Not Respond to SSL Requests Resetting iLO Request New Certificate Troubleshooting a Remote Host Server Name Still Present after Erase Utility is Executed Before You Contact HP Technical SupportHP Contact Information User Guide Integrated Lights-Out Acronyms and Abbreviations DAV ILO JVM MTU RDP SSL Page Index LAN Index Uidcontrol