Dell Command Line Interface User manual

www.dell.com | support.dell.com
Dell™ OpenManage™
Server Administrator
Version 5.2
Command Line Interface
User's Guide

Notes and Notices
NOTE: A NOTE indicates important information that helps you make better use of your computer.
NOTICE: A NOTICE indicates either potential damage to hardware or loss of data and tells you how to avoid the problem.
____________________
Information in this document is subject to change without notice.
© 2006 Dell Inc. All rights reserved.
Reproduction in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.
Trademarks used in this text: Dell, the DELL logo, PowerEdge, and OpenManage are trademarks of Dell Inc.; Microsoft, Windows,
Windows Server, MS-DOS, and Windows NT are registered trademarks of Microsoft Corporation; SUSE is a registered trademark of Novell,
Inc. in the United States and other countries; Red Hat and Red Hat Enterprise Linux are registered trademarks of Red Hat, Inc.; Intel, Pentium,
and Itanium are registered trademarks and Intel386 is a trademark of Intel Corporation; AMD, AMD Opteron, AMD-V, and AMD PowerNow!
aretrademarksofAdvancedMicroDevices,Inc.;VESAisaregisteredtrademarkofVideoElectronicStandardsAssociation;UNIXisaregistered
trademarkofTheOpenGroupintheUnitedStatesandothercountries;OS/2isaregisteredtrademarkofInternational BusinessMachinesCorporation.
Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names or their products.
Dell Inc. disclaims any proprietary interest in trademarks and trade names other than its own.
December 2006

Contents 3
Contents
1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
What's New for Version 5.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Using CLI Commands from Windows Command Prompts. . . . . . . . . . . . 14
Primary CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
CLI Error Checking and Error Messages. . . . . . . . . . . . . . . . . . . . . 15
Success Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Failure Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Scripting and Comparing With the CLI . . . . . . . . . . . . . . . . . . . . . 17
Command Syntax Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2 omhelp: Getting Help With CLI Commands . . . . . . . . . . . . 19
Example Help Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3 omreport: Viewing System Status Using the
Instrumentation Service . . . . . . . . . . . . . . . . . . . . . . . . 21
Conventions for Parameter Tables. . . . . . . . . . . . . . . . . . . . . . . . 21
omreport Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Help With the omreport Command. . . . . . . . . . . . . . . . . . . . . . . . 25
omreport about . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
omreport chassis Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 26
omreport chassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
omreport chassis acswitch . . . . . . . . . . . . . . . . . . . . . . . . . 26
omreport chassis batteries . . . . . . . . . . . . . . . . . . . . . . . . . 27
omreport chassis bios . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
omreport chassis biossetup . . . . . . . . . . . . . . . . . . . . . . . . 27
omreport chassis bmc . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
omreport chassis currents . . . . . . . . . . . . . . . . . . . . . . . . . 30
omreport chassis fans . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

4Contents
omreport chassis fancontrol . . . . . . . . . . . . . . . . . . . . . . . . 30
omreport chassis firmware . . . . . . . . . . . . . . . . . . . . . . . . . 31
omreport chassis frontpanel . . . . . . . . . . . . . . . . . . . . . . . . 31
omreport chassis fru . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
omreport chassis info. . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
omreport chassis intrusion . . . . . . . . . . . . . . . . . . . . . . . . . 32
omreport chassis leds . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
omreport chassis memory . . . . . . . . . . . . . . . . . . . . . . . . . 33
omreport chassis nics . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
omreport chassis ports . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
omreport chassis processors. . . . . . . . . . . . . . . . . . . . . . . . 35
omreport chassis pwrsupplies . . . . . . . . . . . . . . . . . . . . . . . 37
omreport chassis remoteaccess . . . . . . . . . . . . . . . . . . . . . . 37
omreport chassis slots . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
omreport chassis temps . . . . . . . . . . . . . . . . . . . . . . . . . . 38
omreport chassis volts . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
omreport system Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
omreport system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Commands for Viewing Logs . . . . . . . . . . . . . . . . . . . . . . . . 39
omreport system alertaction . . . . . . . . . . . . . . . . . . . . . . . . 40
omreport system assetinfo . . . . . . . . . . . . . . . . . . . . . . . . . 41
omreport system events . . . . . . . . . . . . . . . . . . . . . . . . . . 41
omreport system operatingsystem . . . . . . . . . . . . . . . . . . . . . 43
omreport system pedestinations . . . . . . . . . . . . . . . . . . . . . . 43
omreport system platformevents . . . . . . . . . . . . . . . . . . . . . . 44
omreport system recovery . . . . . . . . . . . . . . . . . . . . . . . . . 44
omreport system shutdown . . . . . . . . . . . . . . . . . . . . . . . . . 44
omreport system summary . . . . . . . . . . . . . . . . . . . . . . . . . 44
omreport system thrmshutdown . . . . . . . . . . . . . . . . . . . . . . 48
omreport system version . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4 omconfig: Managing Components Using the
Instrumentation Service . . . . . . . . . . . . . . . . . . . . . . . . 51
Conventions for Parameter Tables. . . . . . . . . . . . . . . . . . . . . . . . 51
omconfig Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Help With the omconfig Command . . . . . . . . . . . . . . . . . . . . . . . 54
omconfig about. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Contents 5
omconfig chassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
omconfig chassis biossetup . . . . . . . . . . . . . . . . . . . . . . . . 56
omconfig chassis bmc . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
omconfig chassis currents . . . . . . . . . . . . . . . . . . . . . . . . . 70
omconfig chassis fans . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
omconfig chassis fancontrol . . . . . . . . . . . . . . . . . . . . . . . . 72
omconfig chassis frontpanel . . . . . . . . . . . . . . . . . . . . . . . . 72
omconfig chassis info. . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
omconfig chassis leds . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
omconfig chassis memorymode . . . . . . . . . . . . . . . . . . . . . . 74
omconfig chassis remoteaccess . . . . . . . . . . . . . . . . . . . . . . 75
omconfig chassis temps . . . . . . . . . . . . . . . . . . . . . . . . . . 84
omconfig chassis volts . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
omconfig preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
omconfig preferences cdvformat. . . . . . . . . . . . . . . . . . . . . . 86
omconfig preferences dirservice. . . . . . . . . . . . . . . . . . . . . . 86
omconfig preferences snmp . . . . . . . . . . . . . . . . . . . . . . . . 87
omconfig preferences useraccess . . . . . . . . . . . . . . . . . . . . . 88
omconfig system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
omconfig system alertaction . . . . . . . . . . . . . . . . . . . . . . . . 89
Commands for Clearing Logs . . . . . . . . . . . . . . . . . . . . . . . . 92
omconfig system pedestinations . . . . . . . . . . . . . . . . . . . . . . 92
omconfig system platformevents . . . . . . . . . . . . . . . . . . . . . . 93
omconfig system events . . . . . . . . . . . . . . . . . . . . . . . . . . 95
omconfig system webserver . . . . . . . . . . . . . . . . . . . . . . . . 96
omconfig system recovery . . . . . . . . . . . . . . . . . . . . . . . . . 97
omconfig system shutdown. . . . . . . . . . . . . . . . . . . . . . . . . 97
omconfig system thrmshutdown . . . . . . . . . . . . . . . . . . . . . . 98
5 omconfig system assetinfo: Editing Cost of
Ownership Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
omconfig System Asset Info Overview . . . . . . . . . . . . . . . . . . . . 101
User Level Required for Adding Asset Information. . . . . . . . . . . . 101
Adding Acquisition Information . . . . . . . . . . . . . . . . . . . . . . . . 101
Example Commands for Adding Acquisition Information . . . . . . . . 102

6Contents
Adding Depreciation Information . . . . . . . . . . . . . . . . . . . . . . . 103
Example Commands for Adding Depreciation Information. . . . . . . . 103
Adding Extended Warranty Information . . . . . . . . . . . . . . . . . . . . 104
Example Command for Adding Extended Warranty Information . . . . . 104
Adding Lease Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Example Command for Adding Lease Information . . . . . . . . . . . . 105
Adding Maintenance Information . . . . . . . . . . . . . . . . . . . . . . . 106
Example Command for Adding Maintenance Information . . . . . . . . 106
Adding Outsource Information. . . . . . . . . . . . . . . . . . . . . . . . . 107
Example Command for Adding Outsource Information. . . . . . . . . . 107
Adding Owner Information. . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Example Command for Adding Owner Information. . . . . . . . . . . . 108
Adding Service Contract Information . . . . . . . . . . . . . . . . . . . . . 109
Example Command for Adding Service Information . . . . . . . . . . . 109
Adding Support Information . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Example Command for Adding Support Information . . . . . . . . . . . 110
Adding System Information . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Example Command for Adding System Information . . . . . . . . . . . 111
Adding Warranty Information . . . . . . . . . . . . . . . . . . . . . . . . . 112
Example Command for Adding Warranty Information . . . . . . . . . . 112
6 omreport rac: Viewing Remote Access Controller
Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Conventions for Parameter Tables. . . . . . . . . . . . . . . . . . . . . . . 113
omreport rac Command Summary . . . . . . . . . . . . . . . . . . . . . . . 113
Help With the omreport rac Command . . . . . . . . . . . . . . . . . . . . 114
omreport rac authentication . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Example Command for omreport rac authentication. . . . . . . . . . . 115
omreport rac dialinusers. . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
omreport rac dialoutusers . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
omreport rac network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Contents 7
omreport rac modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
omreport rac remote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
omreport rac snmptraps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
omreport rac users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
omreport rac viewcertificate . . . . . . . . . . . . . . . . . . . . . . . . . 117
7 omconfig rac: Managing the Remote
Access Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Conventions for Parameter Tables. . . . . . . . . . . . . . . . . . . . . . . 119
omconfig rac Command Summary . . . . . . . . . . . . . . . . . . . . . . . 119
Help With the omconfig rac Command . . . . . . . . . . . . . . . . . . . . 121
omconfig rac authentication. . . . . . . . . . . . . . . . . . . . . . . . . . 121
Local Operating System Authentication . . . . . . . . . . . . . . . . . 121
Example Command for omconfig rac authentication. . . . . . . . . . . 122
omconfig rac dialinusers . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Example Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
omconfig rac dialoutusers . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Example Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
omconfig rac generatecert . . . . . . . . . . . . . . . . . . . . . . . . . . 124
omconfig rac modem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
omconfig rac network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Example Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
omconfig rac snmptraps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Example Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
omconfig rac remote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Example Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
omconfig rac rmdialinuser. . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Example Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
omconfig rac rmdialoutuser . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Example Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

8Contents
omconfig rac rmsnmptrap . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Example Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
omconfig rac rmuser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Example Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
omconfig rac reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
omconfig rac uploadcert. . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
omconfig rac users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Example Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
8 Using the Storage Management Service . . . . . . . . . . . . 135
CLI Command Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Syntax for Required, Optional, and Variable Command Elements . . . . . . 136
User Privileges for omreport storage and omconfig storage . . . . . . . . . 137
omreport Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
omreport Storage Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
omreport Controller Status . . . . . . . . . . . . . . . . . . . . . . . . 138
omreport Global Information (Smart Thermal Shutdown Status) . . . . 139
omreport Battery Status . . . . . . . . . . . . . . . . . . . . . . . . . 139
omreport Connector Status. . . . . . . . . . . . . . . . . . . . . . . . 139
omreport Enclosure Status . . . . . . . . . . . . . . . . . . . . . . . . 140
omreport Temperature Probe Status . . . . . . . . . . . . . . . . . . . 140
omreport Fan Status . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
omreport Power Supply Status . . . . . . . . . . . . . . . . . . . . . . 142
omreport EMM Status . . . . . . . . . . . . . . . . . . . . . . . . . . 142
omreport Physical Disk Status . . . . . . . . . . . . . . . . . . . . . . 143
omreport Virtual Disk Status . . . . . . . . . . . . . . . . . . . . . . . 144
omconfig Global Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 144
omconfig Global Enable Smart Thermal Shutdown . . . . . . . . . . . 144
omconfig Global Disable Smart Thermal Shutdown . . . . . . . . . . . 145
omconfig Global Rescan Controller. . . . . . . . . . . . . . . . . . . . 145
omconfig Controller Commands . . . . . . . . . . . . . . . . . . . . . . . . 146
omconfig Rescan Controller . . . . . . . . . . . . . . . . . . . . . . . 147
omconfig Global Rescan Controller. . . . . . . . . . . . . . . . . . . . 147

Contents 9
omconfig Enable Controller Alarm . . . . . . . . . . . . . . . . . . . . 148
omconfig Disable Controller Alarm . . . . . . . . . . . . . . . . . . . . 148
omconfig Quiet Controller Alarm . . . . . . . . . . . . . . . . . . . . . 148
omconfig Test Controller Alarm. . . . . . . . . . . . . . . . . . . . . . 149
omconfig Reset Controller Configuration. . . . . . . . . . . . . . . . . 149
omconfig Create Virtual Disk . . . . . . . . . . . . . . . . . . . . . . . 150
omconfig Set Controller Rebuild Rate . . . . . . . . . . . . . . . . . . 154
omconfig Set Background Initialization Rate. . . . . . . . . . . . . . . 154
omconfig Set Reconstruct Rate . . . . . . . . . . . . . . . . . . . . . 155
omconfig Set Check Consistency Rate . . . . . . . . . . . . . . . . . . 155
omconfig Export the Controller Log. . . . . . . . . . . . . . . . . . . . 155
omconfig Import Foreign Configuration . . . . . . . . . . . . . . . . . 156
omconfig Import/Recover Foreign Configuration. . . . . . . . . . . . . 156
omconfig Clear Foreign Configuration . . . . . . . . . . . . . . . . . . 157
omconfig Set Patrol Read Mode . . . . . . . . . . . . . . . . . . . . . 157
omconfig Start Patrol Read . . . . . . . . . . . . . . . . . . . . . . . . 157
omconfig Stop Patrol Read . . . . . . . . . . . . . . . . . . . . . . . . 158
omconfig Virtual Disk Commands . . . . . . . . . . . . . . . . . . . . . . . 158
omconfig Blink Virtual Disk . . . . . . . . . . . . . . . . . . . . . . . . 159
omconfig Unblink Virtual Disk . . . . . . . . . . . . . . . . . . . . . . 159
omconfig Initialize Virtual Disk . . . . . . . . . . . . . . . . . . . . . . 160
omconfig Cancel Initialize Virtual Disk . . . . . . . . . . . . . . . . . . 160
omconfig Fast Initialize Virtual Disk . . . . . . . . . . . . . . . . . . . 160
omconfig Slow Initialize Virtualize Disk . . . . . . . . . . . . . . . . . 161
omconfig Cancel Background Initialize . . . . . . . . . . . . . . . . . 161
omconfig Restore Dead Segments . . . . . . . . . . . . . . . . . . . . 162
omconfig Split Mirror . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
omconfig Unmirror . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
omconfig Assign Dedicated Hot Spare . . . . . . . . . . . . . . . . . . 163
omconfig Unassign Dedicated Hot Spare . . . . . . . . . . . . . . . . 164
omconfig Check Consistency . . . . . . . . . . . . . . . . . . . . . . . 164
omconfig Cancel Check Consistency. . . . . . . . . . . . . . . . . . . 165
omconfig Pause Check Consistency . . . . . . . . . . . . . . . . . . . 165
omconfig Resume Check Consistency . . . . . . . . . . . . . . . . . . 165
omconfig Delete Virtual Disk . . . . . . . . . . . . . . . . . . . . . . . 166
omconfig Format Virtual Disk . . . . . . . . . . . . . . . . . . . . . . . 166
omconfig Reconfiguring Virtual Disks . . . . . . . . . . . . . . . . . . 166
omconfig Change Virtual Disk Policy . . . . . . . . . . . . . . . . . . . 167
omconfig Rename Virtual Disk . . . . . . . . . . . . . . . . . . . . . . 167

10 Contents
omconfig Physical Disk Commands . . . . . . . . . . . . . . . . . . . . . . 168
omconfig Blink Physical Disk . . . . . . . . . . . . . . . . . . . . . . . 168
omconfig Unblink Physical Disk. . . . . . . . . . . . . . . . . . . . . . 169
omconfig Prepare to Remove Physical Disk . . . . . . . . . . . . . . . 170
omconfig Initialize Physical Disk . . . . . . . . . . . . . . . . . . . . . 170
omconfig Offline Physical Disk . . . . . . . . . . . . . . . . . . . . . . 171
omconfig Offline Physical Disk . . . . . . . . . . . . . . . . . . . . . . 171
omconfig Online Physical Disk . . . . . . . . . . . . . . . . . . . . . . 172
omconfig Assign Global Hot Spare . . . . . . . . . . . . . . . . . . . . 172
omconfig Unassign Global Hot Spare . . . . . . . . . . . . . . . . . . 173
omconfig Rebuild Physical Disk. . . . . . . . . . . . . . . . . . . . . . 174
omconfig Cancel Rebuild Physical Disk . . . . . . . . . . . . . . . . . 174
omconfig Remove Dead Segments . . . . . . . . . . . . . . . . . . . . 175
omconfig Clear Physical Disk . . . . . . . . . . . . . . . . . . . . . . . 175
omconfig Cancel Clear Physical Disk. . . . . . . . . . . . . . . . . . . 176
omconfig Battery Commands . . . . . . . . . . . . . . . . . . . . . . . . . 177
omconfig Recondition Battery . . . . . . . . . . . . . . . . . . . . . . 177
omconfig Start Battery Learn Cycle . . . . . . . . . . . . . . . . . . . 177
omconfig Delay Battery Learn Cycle . . . . . . . . . . . . . . . . . . . 178
omconfig Connector Commands. . . . . . . . . . . . . . . . . . . . . . . . 178
omconfig Rescan Connector . . . . . . . . . . . . . . . . . . . . . . . 178
omconfig Enclosure Commands . . . . . . . . . . . . . . . . . . . . . . . . 179
omconfig Enable Enclosure Alarm . . . . . . . . . . . . . . . . . . . . 180
omconfig Disable Enclosure Alarm . . . . . . . . . . . . . . . . . . . . 180
omconfig Enable Smart Thermal Shutdown . . . . . . . . . . . . . . . 181
omconfig Disable Smart Thermal Shutdown . . . . . . . . . . . . . . . 181
omconfig Set Enclosure Asset Tag . . . . . . . . . . . . . . . . . . . . 181
omconfig Set Enclosure Asset Name. . . . . . . . . . . . . . . . . . . 181
omconfig Set Temperature Probe Thresholds . . . . . . . . . . . . . . 182
omconfig Reset Temperature Probe Thresholds . . . . . . . . . . . . . 183
omconfig Set All Temperature Probe Thresholds . . . . . . . . . . . . 183
omconfig Reset All Temperature Probe Thresholds . . . . . . . . . . . 184
omconfig Blink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184