Scripting, command line, and utility options | HP 232664-006

Scripting, command line, and utility options

In this section
Overview of the Lights-Out DOS utility	110
Lights-Out directories migration utilities	113
Lights-Out Configuration Utility	125
Using Perl with the XML scripting interface	129
HPONCFG	133
Remote Insight command language	138

Overview of the Lights-Out DOS utility

CPQLODOS is a command line utility that is a part of the SmartStart Scripting Toolkit. It is intended to be an initial configuration program to set up only those essential RILOE II settings necessary to allow one of the other full-featured configuration methods. Because of this limited usage model, it processes only a small subset of the RILOE II scripting language.

NOTE: CPQLODOS is a DOS-only tool that requires MS-DOS® 6.0 or higher. Lights-Out scripting is not supported on Linux operating systems or when using the Novell NetWare Client.

CPQLODOS enables you to configure features exposed through F8 startup or the graphical user interface. This utility is not intended for continued administration. The RIBCL should be used to administer user rights and network functionality on the server.

CPQLODOS general guidelines

An opening command opens a database. The database remains open until the matching closing command is sent. All changes made within a single command block are applied simultaneously when the database is closed. Any errors within the block cause the enclosed changes to be discarded.

An example of an opening command and its matching closing command are:

<USER_INFO> </USER_INFO>

In all examples, the opening and closing commands are displayed.

Command line arguments

All of the commands are grouped by functionality. All commands that manipulate user information are grouped together. Grouping commands allow the firmware to view the data to be manipulated as a block of information, similar to a text document, allowing for multithreaded access to the different kinds of information.

The following table lists the arguments recognized by CPQLODOS.

Command line argument	Description

/HELP or /?	Displays simple help messages.

Scripting, command line, and utility options 110

Image 110

HP 232664-006 Scripting, command line, and utility options, Overview of the Lights-Out DOS utility, Command line arguments

Contents

HP Remote Insight Lights-Out Edition II User Guide Audience assumptions Contents Systems Insight Manager integration Directory servicesRiloe II security Directory-enabled remote management 103 Scripting, command line, and utility options 110 Troubleshooting the Riloe 173 Regulatory compliance notices 195 Directory Services schema 187Technical support 194 Acronyms and abbreviations 199 Index 202 New in this release Riloe II kit contentsOperational overview Virtual Power Button cable 4-pin Installing the Riloe Preparing to install Riloe Remote Insight cable configuration Keyboard/mouse adapter cable configuration Installing Riloe II in the server Installing Internal Cables Installing a Remote Insight cable 16-pin Connecting external cables to RiloeInstalling a Virtual Power Button cable 4-pin Installing a Remote Insight cable 30-pin Keyboard/mouse adapter cable connection Headless server deployment Monitor cable connection AC power adapter connection LAN cable connection Powering up the server Remote setup Configuring the RiloeConfiguration options ROM-Based Setup Utility F8 Microsoft device driver support Installing Riloe II device driversSmartStart setup of Riloe Novell NetWare device driver support Disabling DNS/DHCP Linux device driver support Configuring the Riloe II Using the Riloe Accessing Riloe II for the first time Using the Riloe II User configurations and settings Features of the RiloeManaging the user and configuration settings of the Riloe Adding authorized users Click User Settings on the Administration tabClick Restore User Information Modifying an existing users profile Network settings Click Network Settings in the Administration tab Parameter Default value Definition Global settings Administration Click Global Settings External power connector to the operating system agent Snmp alerts and settings Riloe Generating Test Alerts Click Apply Snmp SettingsSnmp Pass-through Status Disabling Alerts Two-Factor Authentication Settings Security Settings Riloe II firmware updates Using the Remote Console Local Cursor Using Enhanced Features of the Remote ConsoleRemote Console Information Option Refresh Recommended server settings Recommended client settingsRemote Console Linux settings Microsoft Windows 2000 settings Red Hat Linux and Suse Linux server settings Microsoft Windows Server 2003 settingsMicrosoft Windows NT 4.0 and Windows 2000 settings Novell NetWare settings Supported hot keys Windows EMS console Video replays of previous server Reset SequencesClick Reset Sequences on the Remote Console tab Terminal Services pass-through option Terminal Services Client requirements Windows 2000 Terminal Services port change Windows RDP Pass-Through serviceTerminal Services pass-through installation Terminal Services warning message Enabling the Terminal Services Pass-Through optionTerminal Services Pass-Through status FileImport Terminal Services button display Remote Console and Terminal Services clientsTroubleshooting Terminal Services ComputerPropertiesRemoteRemote Desktop Using virtual devices ManagementSystem ToolsEvent ViewerApplication Virtual power Virtual media Click Connect Riloe II Virtual FloppySelect Local Media Drive Virtual Floppy operating systems notes MS-DOS Uploading a diskette image to the remote server Virtual Floppy screenMounting USB Virtual Media Floppy in Linux Changing Virtual Floppy drive settings Submit Changes Copying files on the host server to the Virtual Floppy drive Diskette Image Utility Using the Riloe II Using the Riloe II Riloe II Virtual CD-ROM Select Local CD-ROM Drive Virtual Media CD-ROM operating system notes Click Create Disk Image Creating Riloe II disk image filesMounting USB Virtual Media CD-ROM in Linux Cancel Resetting the Riloe II to the factory default settingsVirtual Media applet timeout Riloe II Virtual Media privilege Pocket PC access with Riloe Getting help Using the Riloe II Using the Riloe II Using the Riloe II General security guidelines Password guidelinesRiloe II security Encryption Setting up local user accounts Two-factor authenticationSetting up two-factor authentication for the first time Click View/Modify Click Add a certificate Click View/Modify Two-factor authentication user certificatesSetting up directory user accounts Two-factor authentication login Introduction to certificate services Certificates Configuring Automatic Certificate Request Installing certificate servicesVerifying directory services Select FinishCloseOK Securing Rbsu Systems Insight Manager functional overview Systems Insight Manager integrationIntegrating Riloe II with Systems Insight Manager Systems Insight Manager links Systems Insight Manager identification and associationSystems Insight Manager status Configuring Systems Insight Manager identification Systems Insight Manager systems lists Receiving Snmp alerts in Systems Insight Manager Systems Insight Manager port matching Systems Insight Manager integration Benefits of directory integration Directory servicesOverview of directory integration How directory integration works Schema-freeHP Extended schema Schema-free scripted setup Setup for Schema-free directory integrationSchema-free browser-based setup Active Directory preparation Better Login Flexibility Schema-free HPLOMIG-based setup Schema-free setup optionsMinimum Login Flexibility Maximum Login Flexibility Setting up directory services Setting up HP schema directory integrationFeatures supported by HP schema directory integration Directory services support Schema required software Setup Schema installerSchema Preview Directory services Active Directory installation prerequisites Management snap-in installerDirectory services for Active Directory Results Directory services preparation for Active Directory Snap-in installation and initialization for Active Directory NewHPObject Directory services Directory services objects Active Directory snap-ins Active Directory role restrictions Directory services Active Directory Lights-Out management Snap-in installation and initialization for eDirectory Directory services for eDirectoryEDirectory installation prerequisites Directory services Directory services Directory Services objects for eDirectory Role managed devices Members Time restrictions Enforced client IP address or DNS name accessEDirectory Role Restrictions Lights-Out Management Directory settings User login using directory services Name or multi-host DNS name. If an IP address is Group administration Click Test Directory Settings Directory tests Using existing groups Directory-enabled remote managementIntroduction to directory-enabled remote management Creating roles to follow organizational structure Using multiple roles Role time restrictions How directory login restrictions are enforcedRestricting roles Role address restrictions How user time restrictions are enforced User restrictionsUser address restrictions Creating multiple restrictions and roles Using bulk import tools Directory-enabled remote management Overview of the Lights-Out DOS utility Scripting, command line, and utility optionsCommand line arguments Cpqlodos general guidelines Ribcl XML Commands for Cpqlodos Virtfloppy Cpqlodos parameter Cpqlodos runtime errorAdduser runtime errors Adduser parameters Compatibility Pre-migration checklistLights-Out directories migration utilities Finding management processors HP Lights-Out directory packageHpqlomig operation 16.100.225.20RILOEII1.20RILOE2DBuserpasswordDefault Schema Upgrading firmware on management processors Selecting a directory access method Naming management processors Configuring directories when HP Extended schema is selected Scripting, command line, and utility options Setting up management processors for directories Hpqlomgc operation Management processor directory settings are updated Launching Hpqlomgc using application launchFirmware version is validated and updated if necessary Directory is updated Hpqlomgc command language RILOE2CONFIG Lights-Out Configuration Utility RILOE2CONFIG Create a task Create a custom commandCreate a customized list Click QueriesDevice Application Launch using Systems Insight ManagerQuery definition in Systems Insight Manager Select Management Processor and click OK Batch processing using the Lights-Out Configuration Utility Lights-Out Configuration Utility parameters Using Perl with the XML scripting interface XML enhancements Opening an SSL connection Sending the XML header and script body Readloop Scripting, command line, and utility options Hponcfg supported operating systems Hponcfg requirements Windows server installation Installing HponcfgUsing Hponcfg Linux server installation Using Hponcfg on Linux servers Hponcfg command line parameters Using Hponcfg on Windows servers Obtaining an entire configuration Obtaining a specific configuration Ribcl sample scripts Ribcl general guidelines Remote Insight command languageSetting a configuration Response definitions XML headerData types Login parameters LoginRibcl runtime errors Ribcl Userinfo Login runtime errorsUserinfo runtime error Adduser Adduser parameters Deleteuser Adduser runtime errorsDeleteuser runtime errors Deleteuser parameter Getuser parameter Getuser runtime errorsGetuser Getuser return messages Moduser Moduser Parameters Moduser runtime errors Getallusers Getallusers parameters Getallusers runtime errorsGetalluserinfo Getallusers return messages Getalluserinfo parameters Getalluserinfo runtime errorsRibinfo Getalluserinfo return messages Resetrib Getnetworksettings Getnetworksettings Return Messages Getnetworksettings ParametersGetnetworksettings Runtime Errors Modnetworksettings Modnetworksettings Parameters Scripting, command line, and utility options Getglobalsettings parameters GetglobalsettingsModnetworksettings Runtime Errors Getglobalsettings runtime errors Modglobalsettings Modglobalsettings parameters Scripting, command line, and utility options Cleareventlog Runtime Errors UpdateribfirmwareModglobalsettings runtime errors Cleareventlog Getfwversion Hotkeyconfig Hotkeyconfig parameters Getdirconfig Dirinfo Getdirconfig runtime errors Getdirconfig return messages Moddirconfig Dirinfo Login Ribcl Moddirconfig parameters Resetserver Serverinfo Insertvirtualfloppy Resetserver parametersInsertvirtualfloppy Runtime Errors Ejectvirtualfloppy Copyvirtualfloppy Getvfstatus Getvfstatus Parameters Getvfstatus Runtime ErrorsSetvfstatus Getvfstatus Return Messages Gethostpowerstatus Sethostpower Getvpbcablestatus Getallcablesstatus GettwofactorsettingsGetallcablesstatus Runtime Errors Getallcablesstatus Parameters Gettwofactorsettings runtime errors ModtwofactorsettingsGettwofactorsettings parameters Gettwofactorsettings return messages Example of enabling Two-Factor Authentication Importing a CA and a user certificate example Modtwofactorsettings parameters Modtwofactorsettings runtime errors Supported hardware and software Troubleshooting the RiloeSupported client operating systems and browsers Server PCI Slot and Cable Matrix USB PCI Network connection problems Inability to connect to the board through the NIC Web browser not connecting to the Riloe II IP address Alert and trap problemsNetWare initialization errors Accessing System Partition Utilities Miscellaneous problemsNetWare error message table Inability to reboot the server Switch settings SW3 to force ROM upgrade Inability to upgrade the Riloe II firmwareInterpreting LED indicators Incorrect time or date of entries in the event log Resetting the Riloe II to Factory Default Settings Login name and password problemsRemote Console mouse control issue Virtual Floppy media applet is unresponsive Additional information on the state of the host server Troubleshooting the host serverVideo Problems Information logs Integrated Management Log Event Log Entries Not connect to the specified IP address Subsystem Failure Codes Directory Services errors Restarting the host server Invalid credentials Directory Server timeoutDirectory Server connect failed Invalid Directory Server address or port Directory Services schema HP Management Core Ldap OID classes and attributes HpqTarget Core attributesCore class definitions HpqRole HpqPolicyDN HpqRoleIPRestrictionDefaultCore attribute definitions HpqRoleMembership HpqRoleTimeRestriction HpqRoleIPRestrictions Lights-Out Management class definitions Lights-Out Management classesLights-Out Management attributes HpqLOMv100 HpqLOMRightRemoteConsole HpqLOMRightLoginLights-Out Management attribute definitions HpqLOMRightVirtualMedia HpqLOMRightConfigureSettings HpqLOMRightServerResetHpqLOMRightLocalUserAdmin HP contact information Technical supportBefore you contact HP Class a equipment Regulatory compliance noticesFederal Communications Commission notice Class B equipment Modifications Canadian notice Avis CanadienEuropean Union regulatory notice Class a equipment Italy France Bsmi notice Japanese notice Acronyms and abbreviations ILO IML Ribcl Index 77, 78, 81, 83, 85, 92, 99, 106, 114 16, 20, 21 Index