Conventions for Parameter TablesDell OpenManage™ Server Administrator Version 1.4 Command Line Interface User's Guide
Conventions for Parameter Tables
Help With the omreport Command
The omreport command allows you to see detailed information about your system components. You can retrieve summaries for many system components at one time, or you can get details about a specific component. This chapter shows you how to get reports with the level of detail that you want.
Commands documented in this chapter vary in whether they define the fields that appear in the results of a particular omreport command. Fields are defined only if they have a special or less familiar use.
As with all other components, you can use omreport to view component status, and omconfig to manage a component. For information on how to configure components for management, see "omconfig: Managing Components Using the Instrumentation Service."
Often you can use omreport commands to get information you need to execute an omconfig command. For example, if you want to edit the minimum temperature for a warning event on a temperature probe, you need to know the index of the probe you want to configure. You can use omreport chassis temps to display a list of probes and their indexes.
When listing the parameters that a command can take, the parameters are listed in alphabetical order instead of the order in which they appear in the command line interface.
The symbol |, often called pipe, is the logical exclusive or operator. For example, enable | disable means that you can enable or disable the component or feature, but you cannot simultaneously enable and disable the component or feature.
 |
NOTE: Although this chapter lists all possible omreport commands, the commands available on your system depend on your system configuration. The results that display for the omreport command vary from one system to another. Data displays for installed components only. |
|
NOTE: When a system includes an external chassis, the displayed results vary by operating system. For Red Hat Linux systems, omreport commands display external chassis information in a separate section after the main chassis information. On Microsoft® Windows® systems, data about the external chassis does not appear in omreport output. Use Array Manager to get information about an external chassis attached to a Windows system; for instructions, see the Dell OpenManage Array Manager User's Guide. |
Table 4-1 is a high-level summary of the omreport command. The column titled "Command level 1" shows the omreport command at its most general. "Command level 2" shows the major objects or components that you can view using omreport (about, chassis, storage, system, and rac). "Command level 3" lists the specific objects and components for which you can view reports. "User privilege required" refers to the type of privilege you need to perform the command, where U=User, P=Power User, and A=Administrator. "Use" is a very general statement about the actions that can be performed using omreport. More details about syntax and use of the command appear later in this section.
Table 4-1 shows the omreport commands available for about, system, and main system chassis. For information about viewing storage components, see "omreport: Using the Storage Reports."
Table 4-1. omreport Command Level 1, Level 2, and Level 3
Use the omreport -? command to get a list of the available commands for omreport.
Use omreport <command level 2> -? to get help on the level 2 commands about, chassis, and system. The following information on omreport system -? applies equally to getting help for the omreport chassis command.
To see a list of valid commands for omreport system, type:
omreport system -? | more
Use the omreport about command to learn the product name and version number of the systems management application installed on your system. The following is example output from the omreport about command:
: Server Administrator |
For even more details about the environment for Server Administrator, type:
omreport about details=true
Server Administrator includes a number of services, each of which has a version number of its own. The Contains field reports version numbers for the services as well as other useful details. The output below is an example, and can change depending on your configuration and the version of Server Administrator that is installed on your system:
Use omreport chassis commands to view details for the entire chassis or for a particular component.
omreport chassis
Server Administrator displays a general status for your main system chassis components.
|
NOTE: The omreport chassis command does not list the health status of the Diagnostics Service. To view the health of the Diagnostics Service, see the Properties page for the Main System Chassis object on the Server Administrator home page. |
|
NOTE: When you issue CLI commands to a server module in a modular system, chassis refers only to the server module. |
|
NOTE: As with all output shown in this guide, the following output is an example and may vary depending on your system configuration. |
Use the omreport chassis acswitch command if your system has redundant power supplies that are configured in a failover arrangement. When you type:
omreport chassis acswitch
Server Administrator displays the following output:
Server Administrator reports values for the Redundancy Status and Redundancy Mode fields.
Use the omreport chassis bios command to view current BIOS information. When you type:
omreport chassis bios
Server Administrator displays a summary of your system's BIOS information.
Use the omreport chassis biossetup command to view BIOS setup parameters that are normally available only during system boot.
omreport chassis biossetup
The output from this command lists each of the available attributes and the current setting for each. Table 4-2 shows the possible settings for each parameter and whether the parameter requires the force = true option.
Table 4-2. BIOS Setup Properties
Use the omreport chassis currents command to view current (amperage) probe status and settings. When you type:
omreport chassis currents index=n
the index parameter is optional. If you do not specify the index, Server Administrator displays a summary of status, readings, and thresholds set for all current probes present on your system. If you specify the index, Server Administrator displays a summary for a specific current probe.
Use the omreport chassis fans command to view fan probe status and settings. When you type:
omreport chassis fans index=n
the index parameter is optional. If you do not specify the index, Server Administrator displays a summary of status, readings, and thresholds set for any fan probes that might be present on your system. If you specify the index, Server Administrator displays a summary for a specific fan probe.
Use the omreport chassis fancontrol command to see how fan speed is set on your system. Fan speed can be set to optimize speed for cooling or for quiet operation. Table 4-3 shows the available settings.
Table 4-3. Fan Control Settings
|
Name=value pair |
Description |
|---|---|
Use the omreport chassis firmware command to view current firmware properties. When you type:
omreport chassis firmware
Server Administrator displays a summary of your system's firmware properties.
Use the omreport chassis info command to see a summary of installed component versions. When you type:
omreport chassis info index=n
the index parameter specifies a chassis number and is optional. If you do not specify the index, Server Administrator displays summary chassis information for each chassis. If you specify the index, Server Administrator displays summary information for a specific chassis.
Depending on your configuration, output may resemble the following example:
If you run this command on a Dell™ PowerEdge™ 1655MC system, the following additional information displays:
Use the omreport chassis intrusion command to find out whether the cover to your system is open. Server Administrator tracks chassis intrusion events because intrusions may indicate an attempt to steal a system component, or to perform unauthorized maintenance on the system. Type:
omreport chassis intrusion
A message that resembles the following may display:
Use the omreport chassis leds command to find out whether clear hard drive fault is supported and what severity level lights up the LED. Type:
omreport chassis leds index=n
The index parameter is optional. If you do not specify the index, Server Administrator displays a summary of LED information for chassis 0. If you specify the index, Server Administrator displays a summary for a specific chassis.
The following is example output:
Use omreport chassis memory to see details for each memory module slot in your system. If your system supports redundant memory, this command also displays the status, state, and type of memory redundancy implemented on your system. Type:
omreport chassis memory index=n
The index parameter is optional. If you do not specify the index, Server Administrator displays information for all memory on your system. If you specify the index, Server Administrator displays a summary for a specific memory module.
Output for an occupied memory slot may resemble the following:
An unoccupied memory slot still has a connector name. Output for an unoccupied memory slot may resemble the following:
If your system supports redundant memory, the redundancy output may resemble the following:
Memory Redundancy |
|
Use the omreport chassis nics command to view NIC properties. Type:
omreport chassis nics index=n
The index parameter is optional. If you do not specify the index, Server Administrator displays properties about all NICS on your system. If you specify the index, Server Administrator displays properties for a specific NIC.
Values display for the following fields: Index (number of the NIC card), IP address, Vendor, Description, and Connection Status.
Use the omreport chassis ports command to view properties of your system's parallel and serial ports.
Values display for the following fields: Port Type, External Name, Base I/O Address, IRQ Level, Connector Type, and Maximum Speed.
Port Type is the detailed type of each system port, from the more general serial, parallel, and USB ports to the names of ports by device type connected to it, for example, pointing device or keyboard.
External Name is the name of the port, such as serial or parallel, USB, mouse, keyboard, and so on.
Base I/O Address is the starting I/O address expressed in hexidecimal.
IRQ Level is a hardware interrupt on a system. The hardware interrupt signals the system's CPU that an event has started or ended in a peripheral component such as a modem or printer. When communicated over a peripheral component interconnect card, the IRQ level is a standard way to identify the type of device that is sending the interrupt request.
Connector Type refers to the type of plug or cable and plug that connects two devices together, in this case, the type of connector that attaches an external device to a system. There are many connector types, each designed to connect a different device type to a system. Examples include DB-9 Male, AT, Access Bus, PS/2, and so on.
Maximum Speed is the port speed. Port speed refers to the data transmission rate of an input/output channel, measured in numbers of bits per second. Serial ports have an average speed of 115 Kbps and USB ports have an average speed of 12 Kbps.
Use this command to view power button settings. If the power button override is present on your system, you can see whether power button override is enabled or not.
Use the omreport chassis processors command to view properties of your system's processors.
Values display for the following fields: Connector Name, Manufacturer, Processor Family, Processor Version, Maximum Speed, Current Speed, External Clock Speed, Processor Upgrade, and State.
Connector Name refers to the name or number of the device that occupies the processor slot in the system.
Manufacturer is the business entity that sells the processor.
Processor Family refers to the type of processor made by a manufacturer such as Intel® Itanium™ or Pentium® III.
Processor Version refers to the model and stepping number of the processor.
Maximum Speed is the highest expected transmission speed that the processor can achieve in millions of cycles per second (megahertz or MHz).
Current Speed is the actual processor speed in MHz at system boot time.
External Clock Speed is the speed of the processor's external clock in MHz.
Processor Upgrade describes the upgrade socket or device for the processor. Options include upgrade device type unknown, there is no upgrade device type, upgrade device is on a daughter board, is in a ZIF socket, is a replacement, is in a LIF socket, is a Slot 1 processor, is a Slot 2 processor, and is a pin 370 processor.
State refers to whether the processor slot is enabled or disabled.
To learn the cache properties for a processor on a given connector, type:
omreport chassis processors index=n
The index parameter is optional. If you do not specify the index, Server Administrator displays properties for all processors. If you specify the index, Server Administrator displays properties for a specific processor.
The following fields are defined for a cache present on a particular microprocessor. If the cache is internal to the processor, the fields do not appear in the cache report:
Status reports whether a specific cache on the processor is enabled or disabled.
Level refers to primary or secondary cache. Primary-level cache is a memory bank built into the processor. Secondary-level cache is a staging area that feeds the primary cache. A secondary-level cache may be built into the processor or reside in a memory chip set outside the processor. The internal processor cache is referred to as a Level 1 (or L1). L2 cache is the external cache in a system with an Intel Pentium processor, and it is the second level of cache that is accessed. The names L1 and L2 are not indicative of where the cache is physically located (internal or external), but describe which cache is accessed first (L1, therefore internal).
Speed refers to the rate that the cache can forward data from main memory to the processor.
Max Size is the maximum amount of memory that the cache can hold in KB.
Installed Size is the actual size of the cache.
Type indicates whether the cache is primary or secondary.
Location is the location of the cache on the processor or on a chip set outside the processor.
A Write Policy describes how the cache deals with a write cycle. In a write-back policy, the cache acts like a buffer. When the processor starts a write cycle the cache receives the data and stops the cycle. The cache then writes the data back to main memory when the system bus is available.
In a write-through policy, the processor writes through the cache to main memory. The write cycle does not complete until the data is stored into main memory.
Associativity refers to the way main memory content is stored on the cache.
For example, line 0 of any page in memory must be stored in line 0 of cache memory.
Cache Device Supported Type is the type of static random access memory (SRAM) that the device can support.
Cache Device Current Type is the type of the currently installed SRAM that the cache is supporting.
External Socket Name Silk Screen Name is the name printed on the system board next to the socket.
Error Correction Type identifies the type of error checking and correction (ECC) that this memory can perform. Examples are single-bit ECC or multibit ECC.
This report shows cache information for each cache present on the microprocessor.
Use the omreport chassis pwrsupplies command to view properties of your system's power supplies. Type:
omreport chassis pwrsupplies index=n
The index parameter is optional. If you do not specify the index, Server Administrator displays properties for all power supplies in your system. If you specify the index, Server Administrator displays properties for a specific processor.
For each power supply in the system, values display for the following fields: Status, Location, Type, Max Wattage, and Online Status.
Use the omreport chassis slots command to view properties of your system's power supplies. Type:
omreport chassis slots index=n
The index parameter is optional. If you do not specify the index, Server Administrator displays properties for all of the slots in your system. If you specify the index, Server Administrator displays properties for a specific slot.
For each power supply in the system, values display for the following fields: Index, Slot ID, Adapter, and Data Bus Width.
Index is the number of the slot in the system.
Slot ID is the silk screen name printed on your system's motherboard next to the slot. Alphanumeric text uniquely identifies each slot in the system.
Adapter refers to the name and or type of the card that fits into the slot, for example, a storage array controller, SCSI adapter, or HBA.
Data bus width is the width, in bits, of the information pathway between the components of a system. Data bus width range is 16 to 64 bits.
Use the omreport chassis temps command to view properties of your system's temperature probes. When you type:
omreport chassis temps index=n
The index parameter is optional. If you do not specify the index, Server Administrator displays a summary of status, readings, and thresholds set for any temperature probes that might be present on your system. If you specify the index, Server Administrator displays a summary for a specific temperature probe.
Use the omreport chassis volts command to view properties of your system's voltage probes. When you type:
omreport chassis volts index=n
The index parameter is optional. If you do not specify the index, Server Administrator displays a summary of status, readings, and thresholds set for any voltage probes that might be present on your system. If you specify the index, Server Administrator displays a summary for a specific voltage probe.
Use the omreport system commands to view logs, to see how shutdown actions are configured, and to view threshold values, cost of ownership information, and information about how recovery actions are configured.
Use the omreport system command to see a general status for your system components. When you specify a level 3 command, such as omreport system shutdown, you can get detailed information for one system component rather than the high level status that you get with omreport system. Type:
omreport system
If your system has both a main system chassis and at least one direct attached storage device, Server Administrator may display a summary that resembles the following example.
|
NOTE: As with all output shown in this guide, the following output is an example and may vary depending on your system configuration. |
You can use the omreport system command to view logs: the alert log, the command log, the hardware, or ESM, log, and the POST log.
To view the contents of the alert log, type:
omreport system alertlog
To view the contents of the command log, type:
omreport system cmdlog
To view the contents of the ESM log, type:
omreport system esmlog
To view the contents of the POST log, type:
omreport system postlog
When you type omreport system esmlog, the Embedded Systems Management (ESM) report displays. The first line of the report reflects the overall health of the system hardware. For example, Health: OK means that less than 80 percent of the space allotted for the esmlog is occupied with messages. If 80 percent or more of the allotted space for the esmlog is occupied, the following caution appears:
Health: Non-Critical
If a caution appears, resolve all warning and critical severity conditions, and then clear the log.
Use this command to see a summary of alert actions that have been configured for warning and failure events on your system components. Alert actions determine how Server Administrator responds when a component has a warning or failure event.
The omreport system alertaction command is useful for viewing which alert actions have been specified for components. To set an alert action for a component, you must use the omconfig system alertaction command. See "omconfig: Managing Components Using the Instrumentation Service."
You can view alert action properties for the following components and the events:
Use this command to see cost of ownership data for the system, such as acquisition, depreciation, and warranty information. To set any of these fields, you must use the omconfig system assetinfo command. See "omconfig: Managing Components Using the Instrumentation Service."
Use the omreport system events command to view the current enabled or disabled SNMP traps. This command displays a summary of each component in your system for which events can be generated. For each component, the report shows which severities are set to be reported and which severities are set not to be reported. The following is example output for a few components:
omreport system events
Current SNMP Trap Configuration
-----------
System
-----------
Settings
Enable : Informational, Warning and Critical
Disable: None
---------------
Power Supplies
----------------
Settings
Enable : Informational, Warning and Critical
Disable: None
-----------
Fans
-----------
Settings
Enable : Critical
Disable: Informational and Warning
The full report lists the settings for all components in your system for which events can be generated.
To view the status for components of a specific type, use the omreport system events type=<component name> command. This command displays a summary of each component in your system for which events can be generated. Table 4-4 shows the events displayed for various component types.
|
NOTE: Some component types may be unavailable on your system. |
Table 4-4. System Events by Component Type
|
Name=value pair |
Description |
|---|---|
omreport system events type=fans
The following is example output:
-----------
Fans
-----------
Settings
Enable: Critical
Disable: Informational and Warning
Use the omreport system operatingsystem command to display operating system information.
Use the omreport system recovery command to see whether there is an action configured for a hung operating system. You can also view the number of seconds that must elapse before an operating system is considered to be hung.
Use the omreport system shutdown command to view any pending shutdown actions for your system. If properties for shutdown are configured, executing this command displays them.
Use the omreport system summary command to view a comprehensive summary of software and hardware components currently installed on your system.
omreport system summary
the output that appears in your CLI window depends on the systems management software, operating system, and hardware components and options that are installed on your system. The following partial command results are unique and may not resemble the results for your system's hardware and software configuration:
System Summary | |
The system summary hardware information includes data values for installed components of the following types that are present in your system:
If you run this command on a PowerEdge 1655MC system, the following additional information displays:
The following are listed for each processor in the system:
The following details are listed for each memory board or module in the system (for example, the system board or the memory module in a given slot number):
The following details are listed for each NIC in the system:
The following details are listed for each storage enclosure attached to the system:
Use the omreport system thrmshutdown command to view which properties, if any, have been configured for a thermal shutdown action.
The three properties that display for thermal shutdown are disabled, warning, or failure. If the CLI displays the following message, the thermal shutdown feature has been disabled:
Thermal protect shutdown severity: disabled
If the system is configured to shutdown when a temperature probe detects a warning or failure event, one of the following messages displays:
Thermal protect shutdown severity: warning
Thermal protect shutdown severity: failure
Use the omreport system version command to list the version numbers of the BIOS, firmware, systems management software, and operating system that are installed on your system. The command also tells you whether the listed component can be updated from the Server Administrator omupdate commands. Most BIOS and firmware can be updated from Server Administrator; some drivers can also be updated.
omreport system version
the output that appears in your CLI window depends on the version of the BIOS, RAID controllers, and firmware installed on your system. The following partial command results are unique and may not resemble the results for your system's configuration:
Version Report
---------------------
Main System Chassis
---------------------
Name : BIOS
Version : A01
Updateable : Yes
Name : Embedded System Management Controller
Version : 5.21
Updateable : Yes
Name : Primary Backplane
Version : 5.35
Updateable : Yes
---------------
PERC Firmware
---------------
Name : DELL PERC 2/Si Firmware
Version : 2.7.0.3552
Updateable : Yes
-------------
PERC Driver
-------------
Name : Dell PERC 2/Si RAID Controller Driver
Version : 2.7.1.4944
Updateable : Yes