Working With CLI Command Results. Dell OpenManage Server Administrator Version 8.4
Add to My manuals187 Pages
advertisement
9
Working With CLI Command Results
Server Administrator Command Line Interface (CLI) users can use the command output in various ways. This chapter explains how to save command output to a file and how to select a format for the command results that fits different objectives. The following table displays the systems on which omreport commands are applicable.
Table 223. System Availability For The omreport Command
Command Level 1 omreport
Command Level 2 modularenclosure servermodule mainsystem system chassis
Applicable To
Blade systems
Blade systems
Blade systems
Rack and Tower systems
Rack and Tower systems
Output Options For Command Results
CLI command output displays to standard output on the system in a command window, in an X-terminal, or on a screen, depending on the type of the operating system.
You can redirect command results to a file instead of displaying them to standard output. Saving command output to a file allows you to use the command output for later analysis or comparison.
Whether you display command results to standard output or have the command results written to a file, you can format the results.
The format you select determines the way the command output is displayed and the way the command output is written to a file.
Controlling command output display
Each operating system provides a means of controlling the way that command results display to standard output. The following is a useful command for ensuring that command results do not scroll by before you can view them. The same command syntax works for the Microsoft Windows command prompt, the Red Hat Enterprise Linux terminal, and the SUSE Linux Enterprise Server terminal. To display command output with control over scrolling, type the CLI command and append the pipe symbol followed by more. For example, type: omreport system summary | more or omreport servermodule summary | more
The multiscreen system summary displays the first screen. When you want to see the next screen of command output, press the spacebar.
183
Writing Command Output To A File
When redirecting command results to a file, you can specify a filename (and a directory path if necessary) to which you want to write the command result. When specifying the path to which you want to write the file, use the appropriate syntax for the operating system.
You can save command results in two ways. You can overwrite any file that has the same name as the output file you specify, or you can keep adding results of commands to a file of the same name.
Saving Command Results To A File That Is Overwritten
Use the -outc option when you want to overwrite data stored in previously written files. For example, at 11:00 A.M. you capture fan probe RPM readings for fan probe 0 on the system and write the results to a file called fans.txt
. You type: omreport chassis fans index=0 -outc fans.txt
or omreport mainsystem fans index=0 -outc fans.txt
Partial results written to the file are:
Table 224. Partial Results
Index
Status
Probe Name
Reading
Minimum Warning Threshold
Maximum Warning Threshold
Minimum Failure Threshold
Maximum Failure Threshold
: 0
: OK
: System Board Fan 1 RPM
: 2380RPM
: 600RPM
: 5700RPM
: 500RPM
: 6000RPM
Four hours later, you repeat the command. You have no interest in the 11:00 A.M. snapshot as written to fans.txt
. You type the same command: omreport chassis fans index=0 -outc fans.txt
or omreport mainsystem fans index=0 -outc fans.txt
The 3:00 P.M. data overwrites the 11:00 A.M. data in the fans.txt file.
Fans.txt
now reads as follows:
Table 225. Result
Index
Status
Probe Name
Reading
Minimum Warning Threshold
Maximum Warning Threshold
Minimum Failure Threshold
: 0
: OK
: System Board Fan 1 RPM
: 3001RPM
: 700RPM
: 5500RPM
: 500RPM
184
Maximum Failure Threshold : 6000RPM
You cannot refer to the previous command results to compare the earlier fan probe 0 output with the present output because in using the -outc option, you overwrote the fans.txt
file.
Append command results to an existing file
Use the -outa option when you want to append new command results to data stored in a previously written file. For example, at
11:00 A.M. you capture fan probe RPM readings for fan probe 0 on the system and write the results to a file called fans.txt
. To compare these results with output for the same probe obtained four hours later, you can use the -outa command to append the new output to fans.txt
.
Type: omreport chassis fans index=0 -outa fans.txt
or omreport mainsystem fans index=0 -outa fans.txt
Fans.txt now reads as follows:
Table 226. Append command results to an existing file
Index
Status
Probe Name
Reading
Minimum Warning
Threshold
Maximum Warning
Threshold
Minimum Failure
Threshold
Maximum Failure
Threshold
: 0
: OK
: System Board Fan 1 RPM
: 2380RPM
: 600RPM
: 5700RPM
: 500RPM
: 6000RPM
Index
Status
Probe Name
Reading
Minimum Warning
Threshold
Maximum Warning
Threshold
Minimum Failure
Threshold
Maximum Failure
Threshold
: 0
: OK
: System Board Fan 1 RPM
: 3622RPM
: 900RPM
: 3500RPM
: 500RPM
: 6000RPM
You can use a text editor to insert the time that each block of data was captured. In comparing the two snapshots for fan probe 0, you can see that the second report shows several changes. The reading of fan RPM has increased by 621 RPM but is still within
185
normal range. Someone has raised the minimum warning threshold by 200 RPM and has decreased the maximum warning threshold by 2000 RPM.
Selecting A Format For The CLI Command Output
You can specify a format for the CLI command results. The format determines how the command output is displayed. If the command results are directed to a file, the format is captured by the file to which you write the command results.
The available formats include:
• List (lst)
• Semicolon-separated values (ssv)
• Table (tbl)
• Custom delimited format (cdv)
The syntax for the formatting option is:
<command> -fmt <format option>
For example, type: omreport system summary -fmt tbl or omreport servermodule summary -fmt tbl where -fmt tbl specifies table format.
You can combine the formatting option with the option to direct output to a file. For example, type: omreport system summary -fmt tbl -outa summary.txt
or omreport servermodule summary -fmt tbl -outa summary.txt
where -fmt tbl specifies table format and -outa specifies that you append the command results to a file named summary.txt .
List (lst)
The default format is lst or list format. Use this format when you want to optimize output for simple readability. You need to specify a format for the command output only if you want a format other than the lst format.
To see the following example command output in lst format, type: omreport system summary or omreport servermodule summary
No special formatting option is required because list format is the default display format. The network data part of the example system summary is displayed as follows:
--------------
Network Data
--------------
Network Interface 0
IP Address : 143.166.152.108
Subnet Mask : 255.255.255.0
Default Gateway : 143.166.152.1
MAC Address : 00-02-b3-23-d2-ca
186
Table (tbl)
Use the tbl or table formatting option to have the data formatted in table rows and columns. To see the following example command output in table format, type: omreport system summary -fmt tbl or omreport servermodule summary -fmt tbl
The example output displays as follows:
------------------------------
Network Interface 0
------------------------------
| ATTRIBUTE | VALUE
| IP Address | 143.166.152.108
| Subnet Mask | 255.255.255.0
| Default Gateway | 143.166.152.1
| MAC Address | 00-02-b3-23-d2-ca
Semicolon-Separated Values (ssv)
Use the ssv formatting option to deliver output formatted in semicolon-separated value format. This format also allows you to import the command output results into a spreadsheet program such as Microsoft Excel, or into a database program. To see the following example command output in semicolon-separated value format, type: omreport system summary -fmt ssv or omreport servermodule summary -fmt ssv
The example output displays as follows:
------------------------------
Network Data
------------------------------
Network Interface 0
IP Address;143.166.152.108
Subnet Mask;255.255.255.0
Default Gateway;143.166.152.1
MAC Address;00-02-b3-23-d2-ca
Custom delimited format (cdv)
Use the cdv formatting option to report exported data in custom delimited format. You can specify this option with any omreport command. For example, to generate a system summary in custom delimited format, type: omreport system summary -fmt cdv or omreport servermodule summary -fmt cdv
You can also set preferences for the custom delimited format with the omconfig command. The valid values for delimiters are: exclamation, semicolon, at, hash, dollar, percent, caret, asterisk, tilde, question, colon, comma, and pipe.
The following example shows how to set the delimiter for separating data fields to asterisk: omconfig preferences cdvformat delimiter=asterisk
187
advertisement
Related manuals
advertisement
Table of contents
- 3 Dell OpenManage Server Administrator Version 8.4 Command Line Interface Guide
- 9 Introduction
- 9 What is new in this release
- 10 Accessing the windows command prompt to run CLI commands
- 10 Primary CLI Commands
- 11 CLI error checking and error messages
- 11 Success Messages
- 11 Failure Messages
- 12 Scripting And Comparing Using CLI
- 12 Command syntax overview
- 14 Using The omhelp Command
- 14 Example Help Commands
- 16 omreport: Viewing System Status Using The Instrumentation Service
- 16 Conventions for parameter tables
- 16 Command summary of the omreport command
- 21 Help With The omreport Command
- 21 omreport modularenclosure
- 22 omreport about
- 22 Omreport Chassis Or Omreport Mainsystem Commands
- 23 Chassis management
- 23 Omreport chassis acswitch or omreport mainsystem acswitch
- 24 Omreport Chassis Batteries Or Omreport Mainsystem Batteries
- 24 Omreport Chassis Bios Or Omreport Mainsystem Bios
- 24 Omreport chassis biossetup or omreport mainsystem biossetup
- 25 BIOS setup groups
- 25 Omreport Chassis Currents Or Omreport Mainsystem Currents
- 25 Omreport chassis fans or omreport mainsystem fans
- 26 Omreport Chassis Firmware Or Omreport Mainsystem Firmware
- 26 Omreport Chassis Frontpanel Or Omreport Mainsystem Frontpanel
- 26 Omreport Chassis Fru Or Omreport Mainsystem Fru
- 26 Omreport chassis hwperformance or omreport mainsystem hwperformance
- 27 Omreport Chassis Info Or Omreport Mainsystem Info
- 27 Omreport Chassis Intrusion
- 28 Omreport Chassis Leds Or Omreport Mainsystem Leds
- 28 Omreport Chassis Memory Or Omreport Mainsystem Memory
- 30 Omreport chassis nics or omreport mainsystem nics
- 31 Omreport Chassis Ports Or omreport Mainsystem Ports
- 31 Omreport Chassis Processors Or Omreport Mainsystem Processors
- 33 Omreport chassis pwrmanagement or omreport mainsystem pwrmanagement
- 34 Omreport chassis pwrmonitoring or omreport mainsystem pwrmonitoring
- 36 Omreport chassis pwrsupplies or omreport mainsystem pwrsupplies
- 36 Omreport Chassis Remoteaccess Or Omreport Mainsystem Remoteaccess
- 37 Omreport Chassis Removableflashmedia Or Omreport Mainsystem Removableflashmedia
- 37 Omreport Chassis Slots Or Omreport Mainsystem Slots
- 38 Omreport chassis temps or Omreport mainsystem temps
- 38 Omreport Chassis Volts Or Omreport Mainsystem Volts
- 38 Omreport Licenses
- 39 Omreport System Commands Or Omreport Servermodule Commands
- 39 Omreport System Or Omreport Servermodule
- 39 Commands for viewing logs
- 40 Omreport System Alertaction Or Omreport Servermodule Alertaction
- 41 Omreport System Assetinfo Or Omreport Servermodule Assetinfo
- 42 Omreport system events or omreport servermodule events
- 42 Omreport System Events Type Or Omreport Servermodule Events Type
- 43 Omreport System snmptrapdest Or Omreport Servermodule snmptrapdest
- 43 Omreport System Operatingsystem Or Omreport Servermodule Operatingsystem
- 44 Omreport System Pedestinations Or Omreport Servermodule Pedestinations
- 45 Omreport System Platformevents Or Omreport Servermodule Platformevents
- 45 Omreport System Recovery Or Omreport Servermodule Recovery
- 45 Omreport System Shutdown Or Omreport Servermodule Shutdown
- 45 Omreport System Summary Or Omreport Servermodule Summary
- 50 Omreport System Thrmshutdown Or Omreport Servermodule Thrmshutdown
- 50 Omreport System Version Or Omreport Servermodule Version
- 51 Omreport Preferences Commands
- 51 Omreport Preferences Messages
- 51 Omreport preferences logging
- 51 Omreport preferences webserver
- 53 Omconfig: Managing Components Using The Instrumentation Service
- 53 Conventions for parameter tables
- 53 omconfig Command Summary
- 56 Help With The Omconfig Command
- 56 Omconfig About
- 57 Omconfig Chassis Or Omconfig Mainsystem
- 57 Omconfig Chassis Biossetup Or Omconfig Mainsystem Biossetup
- 72 Omconfig Chassis Currents Or Omconfig Mainsystem Currents
- 73 Omconfig Chassis Fans Or Omconfig Mainsystem Fans
- 73 Omconfig chassis frontpanel or omconfig mainsystem frontpanel
- 75 Omconfig Chassis Info Or Omconfig Mainsystem Info
- 76 Omconfig Chassis Leds Or Omconfig Mainsystem Leds
- 76 Omconfig Chassis Memorymode Or Omconfig Mainsystem Memorymode
- 77 Omconfig chassis pwrmanagement or omconfig mainsystem pwrmanagement
- 79 Omconfig Chassis Pwrmonitoring Or Omconfig Mainsystem Pwrmonitoring
- 80 Omconfig chassis remoteaccess or omconfig mainsystem remoteaccess
- 88 Omconfig Chassis Temps Or Omconfig Mainsystem Temps
- 89 Omconfig Chassis Volts Or Omconfig Mainsystem Volts
- 89 Omconfig Preferences
- 90 Omconfig Preferences Cdvformat
- 90 Omconfig Preferences Dirservice
- 90 Omconfig Preferences Messages
- 91 Omconfig Preferences Useraccess
- 91 Omconfig Preferences Logging
- 92 Omconfig preferences webserver
- 104 Omconfig System Or Omconfig Servermodule
- 104 Omconfig System Alertaction Or Omconfig Servermodule Alertaction
- 107 Commands for clearing logs
- 107 Omconfig system pedestinations or omconfig servermodule pedestinations
- 108 Omconfig system platformevents or omconfig servermodule platformevents
- 110 Omconfig system snmptraptest or omconfig servermodule snmptraptest
- 110 Omconfig System Events Or Omconfig Servermodule Events
- 112 Omconfig System Webserver Or Omconfig Servermodule Webserver
- 112 Omconfig System Recovery Or Omconfig Servermodule Recovery
- 113 Omconfig System Shutdown Or Omconfig Servermodule Shutdown
- 114 Omconfig System Thrmshutdown Or Omconfig Servermodule Thrmshutdown
- 115 Omconfig System Or Servermodule Assetinfo: Editing Cost Of Ownership Values
- 115 Adding acquisition information
- 116 Example command for adding acquisition information
- 117 Adding depreciation information
- 117 Example command for adding depreciation information
- 117 Adding extended warranty information
- 118 Example command for adding extended warranty information
- 118 Adding lease information
- 119 Example command for adding lease information
- 119 Adding maintenance information
- 119 Example command for adding maintenance information
- 120 Adding outsource information
- 120 Example command for adding outsource information
- 120 Adding owner information
- 121 Example command for adding owner information
- 121 Adding service contract information
- 121 Example command for adding service information
- 122 Adding support information
- 122 Example command for adding support information
- 123 Adding system information
- 123 Example command for adding system information
- 123 Adding warranty information
- 124 Example command for adding warranty information
- 125 Using The Storage Management Service
- 125 CLI command syntax
- 126 Syntax Of Command Elements
- 127 User Privileges For Omreport Storage And Omconfig Storage
- 128 Omreport storage commands
- 128 Omreport Physical Disk Status
- 129 omreport Virtual Disk Status
- 129 Omreport controller status
- 130 Omreport Enclosure Status
- 130 Omreport Temperature Probe Status
- 131 Omreport Fan Status
- 131 Omreport Power Supply Status
- 132 Omreport EMM Status
- 132 Omreport Enclosure Slot Occupancy Report
- 133 Omreport Battery Status
- 133 Omreport Global Information
- 133 Omreport Connector Status
- 134 Omreport Cachecade Status
- 134 Omreport PCIe SSD Status
- 134 Omreport Storage Tape
- 135 Omreport NVMe adapter
- 136 Omconfig storage commands
- 136 Omconfig Physical Disk Commands
- 137 Omconfig Blink Physical Disk
- 138 Omconfig Unblink Physical Disk
- 138 Omconfig Prepare To Remove Physical Disk
- 139 Omconfig Instant Erase Secured Physical Disk
- 139 Omconfig Cryptographic Erase Secured Physical Disk
- 140 Omconfig Initialize Physical Disk
- 140 Omconfig Offline Physical Disk
- 140 Omconfig Online Physical Disk
- 141 Omconfig Assign Global Hot Spare
- 141 Omconfig Rebuild Physical Disk
- 142 Omconfig Cancel Rebuild Physical Disk
- 142 Omconfig Cancel Replace Member
- 143 Omconfig Clear Physical Disk
- 143 Omconfig cancel clear physical disk
- 144 Omconfig Enable Device Write Cache
- 144 Omconfig Disable Device Write Cache
- 144 Omconfig Export Reliability Log
- 145 Omconfig Convert RAID To Non-RAID
- 146 Omconfig Convert Non-RAID To RAID
- 146 Omconfig Set array disk cache
- 146 Omconfig virtual disk commands
- 147 Omconfig Check Consistency
- 148 Omconfig Pause Check Consistency
- 148 Omconfig cancel check consistency
- 148 Omconfig Resume Check Consistency
- 149 Omconfig blink virtual disk
- 149 Omconfig Unblink Virtual Disk
- 149 Omconfig Initialize Virtual Disk
- 149 Omconfig Fast Initialize Virtual Disk
- 150 Omconfig Slow Initialize Virtualize Disk
- 150 Omconfig cancel initialize virtual disk
- 151 Omconfig cancel background initialize
- 151 Omconfig Assign Dedicated Hot Spare
- 151 Omconfig Delete Virtual Disk
- 152 Omconfig reconfiguring virtual disks
- 153 Omconfig Secure Virtual Disk
- 153 Omconfig Clear Virtual Disk Bad Blocks
- 153 Omconfig Change Virtual Disk Policy
- 154 Omconfig Replace Member Virtual Disk
- 154 Omconfig Rename Virtual Disk
- 155 Omconfig controller commands
- 156 Omconfig Rescan Controller
- 157 Omconfig Enable Controller Alarm
- 157 Omconfig Disable Controller Alarm
- 157 Omconfig Quiet Controller Alarm
- 157 omconfig Test Controller Alarm
- 158 Omconfig Reset Controller Configuration
- 158 omconfig Create Virtual Disk
- 164 Omconfig Set Controller Rebuild Rate
- 164 omconfig Change Controller Properties
- 165 Omconfig Discard Preserved Cache
- 165 Omconfig Create Encryption Key
- 166 Omconfig Change Encryption Key
- 166 Omconfig Delete Encryption Key
- 166 Omconfig Set Background Initialization Rate
- 166 Omconfig Set Reconstruct Rate
- 167 Omconfig Set Check Consistency Rate
- 167 Omconfig Export The Controller Log
- 167 Omconfig Import Secure Foreign Configuration
- 168 Omconfig Import Foreign Configuration
- 168 Omconfig Import Or Recover Foreign Configuration
- 168 Omconfig Clear Foreign Configuration
- 168 Omconfig physical disk power management
- 169 Omconfig set controller mode
- 169 Omconfig autoconfigure RAID-0
- 169 Omconfig Set Patrol Read Mode
- 170 Omconfig Start Patrol Read
- 170 Omconfig Stop Patrol Read
- 170 Omconfig Create Cachecade
- 171 Omconfig Enable LKM Controller
- 171 Omconfig Rekey LKM Controller
- 171 Omconfig Convert Multiple RAID To Non-RAID
- 171 Omconfig Convert Multiple Non-RAID To RAID
- 172 Omconfig Enclosure Commands
- 172 Omconfig Enable Enclosure Alarm
- 172 Omconfig Disable Enclosure Alarm
- 173 Omconfig Set Enclosure Asset Tag
- 173 Omconfig Set Enclosure Asset Name
- 173 Omconfig Set Temperature Probe Thresholds
- 174 Omconfig Reset Temperature Probe Thresholds
- 174 Omconfig Set All Temperature Probe Thresholds
- 175 Omconfig Reset All Temperature Probe Thresholds
- 175 Omconfig Blink
- 175 Omconfig Battery Commands
- 176 omconfig Start Battery Learn Cycle
- 176 Omconfig Delay Battery Learn Cycle
- 176 Omconfig Global Commands
- 177 Omconfig Global Enable Smart Thermal Shutdown
- 177 Omconfig Global Disable Smart Thermal Shutdown
- 177 Omconfig Global Rescan Controller
- 178 Omconfig Set Hot Spare Protection Policy
- 178 Omconfig global threshold for remaining rated write endurance
- 178 Omconfig Connector Commands
- 179 Omconfig Rescan Connector
- 179 Omconfig cachecade commands
- 179 Omconfig Blink Cachecade
- 180 Omconfig Unblink Cachecade
- 180 Omconfig Delete Cachecade
- 180 Omconfig Resize Cachecade
- 181 Omconfig Rename Cachecade
- 181 Omconfig NVMe adapter configuration commands
- 181 Omconfig exporting controller log
- 182 Omconfig cryptographic erase
- 183 Working With CLI Command Results
- 183 Output Options For Command Results
- 183 Controlling command output display
- 184 Writing Command Output To A File
- 184 Saving Command Results To A File That Is Overwritten
- 185 Append command results to an existing file
- 186 Selecting A Format For The CLI Command Output
- 186 List (lst)
- 187 Table (tbl)
- 187 Semicolon-Separated Values (ssv)
- 187 Custom delimited format (cdv)