Dell Command Line Interface User manual

Type
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!
are trademarks of Advanced Micro Devices, Inc.; VESA is a registered trademark of Video Electronic Standards Association; UNIX is a registered
trademark of The Open Group in the United States and other countries; OS/2 is a registered trademark of International Business Machines Corporation.
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
4 Contents
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
6 Contents
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
8 Contents
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
Contents 11
9 Working With CLI Command Results . . . . . . . . . . . . . . . 187
Output Options for Command Results . . . . . . . . . . . . . . . . . . . . . 187
Controlling Command Output Display
. . . . . . . . . . . . . . . . . . . 187
Writing Command Output to a File
. . . . . . . . . . . . . . . . . . . . 187
Selecting a Format for Your CLI Command Output
. . . . . . . . . . . . 189
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Index
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
12 Contents
Introduction 13
Introduction
Whether you are using the graphical user interface (GUI) or the command line interface (CLI),
Dell
â„¢ OpenManageâ„¢ Server Administrator performs essential systems management tasks.
The reporting and viewing features allow retrieval of overall health status for systems on your network.
At the component level, you can view information about the voltages, temperatures, current, fan
RPM, memory functioning, and many other critical component details. You see a detailed account of
many relevant cost of ownership (COO) facts about your system in summary view. Version
information for BIOS, firmware, operating system, and all installed software is easy to retrieve.
Configuration features allow the Server Administrator to perform essential tasks described in detail
in the following sections.
NOTE: You can use the CLI instead of the Server Administrator home page, and turn the Server Administrator
Web server off if you have security concerns. The CLI does not use the Web server. Use the omconfig system
webserver action=stop command to turn off the Web server. The Web server starts automatically after a
reboot, so this command must be issued every time a system starts up. See "omconfig system webserver" for
more information.
What's New for Version 5.2
• Added support for Dell PowerEdge
â„¢
2970 system
• Added support for Microsoft
®
Windows Server
®
2003 family (x86) (SP2 with Web, Standard, and
Enterprise editions)
• Added support for Microsoft Windows Server 2003 family (x86_64) (SP2 with Standard, and
Enterprise editions)
• Added support for Microsoft Windows
®
Unified Data Storage Server 2003 (x86_64)
• Added support for Microsoft Windows Server 2003 R2, Datacenter x64 Edition
• Added support for Red Hat
®
Enterprise Linux
®
Version 5 (x86) and (x86_64) systems
• Added support for NIS, Kerberos, LDAP, and Winbind authentication protocols for Linux
operating systems
• Added information on features of Intel
®
and AMD
â„¢
processors in the
Processor Information
page
• Added a new command in
Storage
Management
:
importrecoverforeignconfig
• Added a new
omconfig preferences snmp setting
command to configure SNMP Set
Operations
NOTE: SNMP Set Operations are disabled by default in Server Administrator.
14 Introduction
Using CLI Commands from Windows Command Prompts
If you are running the Windows operating system, use the 32-bit command prompt to issue a Server
Administrator CLI command. You can access the 32-bit command prompt by clicking the Start button
and pointing to Programs→ Accessories→ Command Prompt shortcut, or by clicking the Start button and
selecting Run, then typing cmd.exe in the Run dialog box.
Do not type command into the Run dialog box to launch a command line window; this activates the
MS-DOS
®
emulator command.com, which has environment variable limitations that can cause subtle
problems with the CLI.
Primary CLI Commands
The commands that carry out the functions of Server Administrator are:
•
omconfig
•
omhelp
•
omreport
The omconfig command writes values that you assign to an object's properties. You can specify values for
warning thresholds on components or prescribe what action your system is to take when a certain
warning or failure event occurs. You can also use the omconfig command to assign specific values to your
system's asset information parameters, such as the purchase price of the system, the system's asset tag, or
the system's location.
The omhelp command displays short text help for CLI commands. The shorthand equivalent of omhelp
is the command for which you want help followed by -?. For example, to display help for the omreport
command, type one of the following commands:
omhelp omreport
omreport -?
The omreport command produces reports of your system’s management information.
NOTE: For an overall summary of CLI commands, type omhelp.
Introduction 15
Table 1-1 lists the primary CLI commands used by Server Administrator. This guide contains a section
for each primary command.
NOTE: omupdate commands are no longer supported in Server Administrator and are replaced by Dell Update
Package or Server Update Utility commands. To update the different components, download the Dell Update Package
and run <package name> /s [/f]. See the Dell Update Packages for Microsoft Windows Operating Systems User’s Guide,
the Dell Update Packages for Red Hat Enterprise Linux User’s Guide, or the Server Update Utility User’s Guide for more
information on corresponding CLI syntax.
Additional useful topics about the CLI include:
• Working With CLI Command Results
• Glossary
CLI Error Checking and Error Messages
The CLI checks your commands for correct syntax when you enter them. If you enter a command and the
command is executed successfully, a message displays, stating that your command has been successful.
Success Messages
For a successful omreport command, data about the component displays. When data for the component
displays, your command is successful.
The following omconfig command examples show valid CLI commands and their success messages:
Command:
omconfig chassis temps index=0 warnthresh=default
Message:
Temperature probe warning threshold value(s) set successfully.
Command:
omconfig chassis biossetup attribute=speaker setting=on
Table 1-1. CLI Commands and Sections in This Guide
Primary CLI
Command
Section Title Related Sections
omconfig omconfig: Managing Components Using the
Instrumentation Service
omconfig system assetinfo: Editing
Cost of Ownership Values
omhelp omhelp: Getting Help With CLI Commands
omreport omreport: Viewing System Status Using
the Instrumentation Service
omreport rac: Viewing Remote Access
Controller Components
16 Introduction
Message:
BIOS setup configured successfully.
Command:
omconfig system assetinfo info=depreciation duration=6
Message:
Asset information set successfully.
Failure Messages
CLI failure messages provide reasons why some commands do not succeed. Some common reasons why
commands fail include syntax errors and components that are not present. Many error messages provide
syntax information that you can use to execute the command successfully.
If you try to execute a command for a component or feature that is not present in your system
configuration, the error message states that the component is not present.
Command:
omreport chassis currents
Example message:
Error! No current probes found on this system.
Command:
omconfig chassis volts index=3 minwarnthresh=3.3000
Example message:
Error! Number with up to 3 digits after decimal point expected, read
3.3000
The value given by the command specifies more than 3 digits after the
decimal point. A valid minimum warning threshold value for volts
contains up to 3 digits after the decimal point.
Ty p e :
omconfig chassis volts index=3 minwarnthresh=3.300
When you enter the revised command with three decimal points, you receive another error message:
Error! This voltage probe min warning threshold must be between
11.400 and 12.480.
Revised command:
omconfig chassis volts index=3 minwarnthresh=11.500
Message:
Voltage probe warning threshold(s) set successfully.
Introduction 17
Scripting and Comparing With the CLI
The Server Administrator CLI allows administrators to write batch programs or scripts to be executed by
the operating system. For an enterprise with many systems, an administrator could write a configuration
script that specified the warning thresholds for each major component of a system and also specified a
set of actions that the administrator wants each system to take in case of a warning or failure event. In
the most critical cases, the administrator could write a script so that the system shuts down to prevent
damage. The administrator could then distribute and execute the script to many managed systems at the
same time. Such a scenario facilitates configuring any number of new systems acquired by a company
and makes implementation of new system administration policies easier across many existing systems
that require reconfiguration.
A similar scenario could be used to populate a large number of newly acquired systems with detailed asset
information. Much of the information would be the same, such as the manufacturer or lessor of the system,
whether support for the system is outsourced, name of the system's insurance company, method of
depreciation, and so on. Any variable that is common to all systems could be scripted, sent to all managed
systems, and executed. Asset information that is unique to a system could be scripted as a group and sent
to that managed node for execution. For example, a script could specify values for all unique variables
such as owner, primary user phone number, asset tag, and so on. Scripts to populate unique values would
set all unique variables at once rather than one by one through the system's command line.
In many cases, the CLI allows a user with a very well-defined task in mind to retrieve information about
the system rapidly. If a user wants to review a comprehensive summary of all system components and
save that summary information to a file for comparison with later system states, the CLI is ideal.
Using CLI commands, administrators can write batch programs or scripts to execute at specific times.
When these programs execute, they can capture reports on components of interest, such as fan RPMs
during periods of high system usage compared with the same measurements at times of lowest system
usage. Command results can be routed to a file for later analysis. Reports can help administrators gain
information that can be used to adjust usage patterns, to justify purchasing new system resources, or to
focus on the health of a problem component.
Command Syntax Overview
Commands vary in complexity. The simplest command has only command level 1. The omhelp
command is a simple command. When you type omhelp, a list of the main CLI commands is displayed.
The next level of complexity includes commands that contain command levels 1 and 2. All of the about
commands are examples of command level 2 complexity. The omconfig about and omreport about
commands cause a very brief summary to display. The summary shows version information for the
systems management software installed on your system; for example, Server Administrator 1.x.
Some commands have command level 1 and command level 2 and one name=value pair. Consider the
following example command that instructs Server Administrator for more details about the environment
for Server Administrator:
omreport about details=true
18 Introduction
Command level 1 is omreport, command level 2 is about, and the name=value pair is
details=true.
Many commands use command level 1, command level 2, and command level 3, but do not require any
parameters (name=value pairs). Most omreport commands are of this type. For example:
omreport system alertaction
causes a list of alert actions that are configured for components on your system to be displayed.
The most complex commands have all three command levels and can have multiple name=value
pairs. An example of two name=value pairs:
omconfig system assetinfo info=depreciation duration=3
An example of nine name=value pairs:
omconfig system assetinfo info=acquisition
purchasecost=
<n> waybill=<n> installdate=<
mmddyy
> purchasedate=
<
mmddyy
> ponum=<n> signauth=<
text
>
expensed=<
yes | no
> costcenter=<
text
>
In each section, command syntax and other information about commands is formatted with any of the
following fields that apply:
command level 1 command level 2 command level 3 name=value pair 1 name=value pair 2
omhelp: Getting Help With CLI Commands 19
omhelp: Getting Help With CLI Commands
The omhelp command and its equivalent, <command> -?, accesses the CLI's detailed help text
interface. You can get help at several levels of detail.
Each fully qualified CLI command may have a variable number of distinct parts: the command
(command level 1), one or more subcommands (command level 2 and command level 3, if present),
and one or more name=value pair(s).
By appending -? (space-dash-question mark) to any command, you can get help on the command.
Example Help Commands
When you type omconfig -?, you get general help about the omconfig command. The help at
this level lists the available subcommands for omconfig:
•about
•preferences
• chassis
• system
When you type omconfig system -?, CLI help lists all of the subcommands that are available
for omconfig system:
• alertaction
• alertlog
• assetinfo
• cmdlog
• esmlog
•events
• recovery
• shutdown
• thrmshutdown
• webserver
Figure 2-1 shows the levels of help for a command.
20 omhelp: Getting Help With CLI Commands
Figure 2-1. Different Levels of Help for a Command
You can also parse the omconfig system assetinfo command as follows:
<command level 1 command level 2 command level 3> <name=value pair 1>
[name=value pair 2]
where command levels 1, 2, and 3 are represented by omconfig system assetinfo, name=value pair 1 is
represented by info=depreciation, and name=value pair 2 is represented by method=straightline.
To set your depreciation method to straight line, type:
omconfig system assetinfo info=depreciation method=straightline
The CLI responds with the following message:
Asset information set successfully.
When you type omconfig system assetinfo -?, the help that displays provides information
about assigning values for the name and option fields. Partial results for the request omconfig system
assetinfo -? are as follows:
assetinfo Set asset information.
For one info value, specify one or more optional parameter(s). Table 2-1 displays the optional parameters
for info=acquisition:
Table 2-1. Optional Parameters
Info Value Optional parameters
Info=acquisition purchasecost=<num>
waybill=<num>
installdate=<mmddyy>
purchasedate=<mmddyy>
ponum=<num>
signauth=<text>
expensed=<yes|no>
costcenter=<text>
info=depreciation
method=<text>
duration=<num>
percent=<percent>
unit=<months|years|unknown>
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150
  • Page 151 151
  • Page 152 152
  • Page 153 153
  • Page 154 154
  • Page 155 155
  • Page 156 156
  • Page 157 157
  • Page 158 158
  • Page 159 159
  • Page 160 160
  • Page 161 161
  • Page 162 162
  • Page 163 163
  • Page 164 164
  • Page 165 165
  • Page 166 166
  • Page 167 167
  • Page 168 168
  • Page 169 169
  • Page 170 170
  • Page 171 171
  • Page 172 172
  • Page 173 173
  • Page 174 174
  • Page 175 175
  • Page 176 176
  • Page 177 177
  • Page 178 178
  • Page 179 179
  • Page 180 180
  • Page 181 181
  • Page 182 182
  • Page 183 183
  • Page 184 184
  • Page 185 185
  • Page 186 186
  • Page 187 187
  • Page 188 188
  • Page 189 189
  • Page 190 190
  • Page 191 191
  • Page 192 192
  • Page 193 193
  • Page 194 194
  • Page 195 195
  • Page 196 196
  • Page 197 197
  • Page 198 198
  • Page 199 199
  • Page 200 200
  • Page 201 201
  • Page 202 202
  • Page 203 203
  • Page 204 204
  • Page 205 205
  • Page 206 206
  • Page 207 207
  • Page 208 208
  • Page 209 209
  • Page 210 210
  • Page 211 211
  • Page 212 212
  • Page 213 213
  • Page 214 214
  • Page 215 215
  • Page 216 216
  • Page 217 217
  • Page 218 218
  • Page 219 219
  • Page 220 220
  • Page 221 221
  • Page 222 222
  • Page 223 223
  • Page 224 224
  • Page 225 225
  • Page 226 226

Dell Command Line Interface User manual

Type
User manual

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI