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 Dell OpenManage are trademarks of Dell Inc.; Microsoft, Windows,
MS-DOS, and Windows NT are registered trademarks and Windows Server is a trademark of Microsoft Corporation; SUSE is a registered
trademark of Novell, Inc. in the United States and other countries; Red Hat is a registered trademarks of Red Hat, Inc.; Intel, Pentium, and Xeon are registered trademarks and Itanium and Intel386 are trademarks of Intel Corporation; VESA is a registered trademark of V ideo 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.
omreport system
Commands for Viewing Logs
omreport system alertaction
omreport system assetinfo
omreport system events
omreport system operatingsystem
omreport system pedestinations
omreport system platformevents
omreport system recovery
omreport system shutdown
omreport system summary
omreport system thrmshutdown
omreport system version
omconfig system alertaction
Commands for Clearing Logs
omconfig system pedestinations
omconfig system platformevents
omconfig system events
omconfig system webserver
omconfig system recovery
omconfig system shutdown
omconfig system thrmshutdown
omreport Global Information (Smart Thermal Shutdown Status)
omreport Battery Status
omreport Connector Status
omreport Enclosure Status
omreport Temperature Probe Status
omreport Fan Status
omreport Power Supply Status
omreport EMM Status
omreport Array Disk Status
omreport Virtual Disk Status
omconfig Global Commands
omconfig Global Enable Smart Thermal Shutdown
omconfig Global Disable Smart Thermal Shutdown
omconfig Global Rescan Controller
omconfig Controller Commands
omconfig Rescan Controller
omconfig Global Rescan Controller
omconfig Enable Controller Alarm
omconfig Disable Controller Alarm
omconfig Quiet Controller Alarm
omconfig Test Controller Alarm
omconfig Reset Controller Configuration
omconfig Create Virtual Disk
omconfig Set Controller Rebuild Rate
omconfig Set Background Initialization Rate
omconfig Set Reconstruct Rate
omconfig Set Check Consistency Rate
omconfig Export the Controller Log
omconfig Import Foreign Configuration
omconfig Unblink Array Disk
omconfig Prepare to Remove Array Disk
omconfig Initialize Array Disk
omconfig Offline Array Disk
omconfig Offline Array Disk
omconfig Online Array Disk
omconfig Assign Global Hot Spare
omconfig Unassign Global Hot Spare
omconfig Rebuild Array Disk
omconfig Cancel Rebuild Array Disk
omconfig Remove Dead Segments
omconfig Enable Enclosure Alarm
omconfig Disable Enclosure Alarm
omconfig Enable Smart Thermal Shutdown
omconfig Disable Smart Thermal Shutdown
omconfig Set Enclosure Asset Tag
omconfig Set Enclosure Asset Name
omconfig Set Temperature Probe Thresholds
omconfig Reset Temperature Probe Thresholds
omconfig Set All Temperature Probe Thresholds
omconfig Reset All Temperature Probe Thresholds
omconfig Blink
Whether you are using the graphical user interface (GUI) or the command line interface (CLI),
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. You can also run diagnostic tests on system components.
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.0
•Added support for SUSE® LINUX Enterprise Server (version 9), SP3 for Intel® Extended Memory
64 Technology (Intel EM64T)
•Added support for the following RAID controllers: PERC 5/i Adapter, PERC 5/i Integrated, and
SAS 5/iR Integrated
•Added support for the following Dell™ PowerEdge™ systems: 1900, 1950, 1955, 2900, and 2950
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.
Introduction13
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
•
omdiag
•
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 omdiag command runs diagnostic tests against system hardware to isolate problems.
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.
Table 1-1 lists the primary CLI commands used by Server Administrator. This guide contains a section
for each primary command.
Table 1-1. CLI Commands and Sections in This Guide
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
Systems User’s Guide, the Dell Update Packages for Red Hat
Utility User’s Guide for more information on corresponding CLI syntax.
®
Enterprise Linux User’s Guide, or the Server Update
®
Windows Operating
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.
omconfig system assetinfo info=depreciation duration=6
Message:
Asset information set successfully.
Introduction15
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.
Voltage probe warning threshold(s) set successfully.
16Introduction
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
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, omdiag about, and
omreport about commands all 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.
omhelp, a list of the main CLI commands is displayed.
Introduction17
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
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=
<
mmddyy
> ponum=<n> signauth=<
expensed=<
<n> waybill=<n> installdate=<
text
>
yes | no
> costcenter=<
text
mmddyy
> purchasedate=
>
In each section, command syntax and other information about commands is formatted with any of the
following fields that apply:
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
omhelp: Getting Help With CLI Commands19
Figure 2-1 shows the levels of help for a command.
Figure 2-1. Different Levels of Help for a Command
You can also parse the omconfig system assetinfo command as follows:
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:
The omdiag command allows you to test chassis and storage components such as hard drives,
physical memory, communications and printer ports, Network Interface Controllers (NICs), CMOS,
and more.
Most tests described in this section take less than one minute. Some tests can take longer depending
on the device being tested. You cannot abort tests you start through the command line interface.
NOTICE: If you run omdiag commands from more than one console when the DSM SA Connection Service
(for systems running Microsoft
Enterprise Server and Red Hat® Enterprise Linux) is not running, then the test in the first console will run to
completion, but the test(s) in the subsequent console(s) may exit with a "Test was interrupted" message.
NOTE: You can abort a Diagnostic Service test run through the CLI by using the Diagnostic Status window in
the Server Administrator GUI. Click the Diagnostics tab, click Status, and click Abort to stop the currently
running test or click Abort All to stop the currently running test and all queued tests.
NOTE: You cannot use <Ctrl-C> to cancel a CLI session from the console. However, tests started from the CLI
can be aborted using the "Abort" link in the "Diagnostic Status" page in the GUI.
NOTE: If the secure port server is not running when you type an omdiag command, there will be a noticeable
delay before the command executes because the system must check the hardware to determine the
diagnostic information to display.
NOTE: On systems running the Microsoft Windows operating system, the enumeration process requires that
the Windows Management Instrumentation (WMI) services be running.
®
Windows®) or dsm_om_connsvc (for systems running
SUSE® LINUX
Table 3-1 is a high-level summary of the omdiag command. The columns titled "Command level 2"
and "Command level 3" list the major arguments that can be used with omdiag. The "Use" column
provides a very general statement about the actions that can be performed using omdiag. More
details about syntax and use of the command appear later in this section.
Runs Serial Attached SCSI (SAS), SAS RAID
controller, and attached device tests.
Runs the SCSI controller and attached tape and
hard drive tests.
Runs a test for no more than the specified
number of minutes <minutes>.
Uses a faster algorithm to conduct a specific test
if one is available.
Stops the tests if an error is encountered.
Specifies the device on which to run the test.
Use the omdiag about command to learn the product name and version number of the systems
management application installed on your system. The following is an example output from the omdiag about command:
Product name : Dell OpenManage Server Administrator
Version: 5.
x.x
Copyright: Copyright (C) Dell Inc.
1995-2006. All rights reserved.
Company: Dell Inc.
omdiag: Using the Diagnostic Service25
omdiag about details=true
Use the omdiag about details=true command to see information about all of the
Server Administrator programs that are installed. The following is an example output from the
omdiag about details=true command:
Product name : Dell OpenManage Server Administrator
Version: 5.
Copyright: Copyright (C) Dell Inc.
Company: Dell Inc.
Contains: Instrumentation Service 5.
x.x
1995-2006. All rights reserved.
x.x
Storage Management Service 3.x.
Diagnostic Service 3.x.
Sun JRE - OEM Installed Version 1.x.
Secure Port Server 1.x.
Core Service 1.x.
Instrumentation Service Integration Layer 1.x.
Storage Management Service Integration Layer 1.x.
Server Administrator 5.x.
x
x
x
x
x
x
x
x
omdiag chassis
Use the omdiag chassis commands to perform tests on nonstorage components of a system, such as the
memory, NICs, PCI, and ports.
NOTE: When you issue CLI commands to a server module in a modular system, chassis refers only to the
server module.
omdiag chassis -?
Use the omdiag chassis -? command to see a list of all chassis components on the system.
26omdiag: Using the Diagnostic Service
omdiag chassis cmos
Use the omdiag chassis cmos command to test the system configuration information in the
CMOS settings. The following test is performed:
•Checksum Test — Performs a checksum test on the CMOS memory to determine if any bytes are
corrupt. This test scans the CMOS memory and calculates the checksum of the bytes read from the
checksum range. The calculated result is compared with the results stored in the CMOS memory. If
they match, the test succeeds; otherwise, the test logs errors.
omdiag chassis memory
Use the omdiag chassis memory command to test the system's RAM. The following test is performed:
NOTE: Shut down all other programs before running this test.
NOTE: Sufficient swap-space (temporary storage space used during a move or reconfiguration) is needed to
support the demands of the memory test.
NOTE: This test checks only memory seen by the operating system on systems that have redundant memory
support (spare bank or mirroring).
•Pattern Test — Checks your system’s memory by using a data patterns test. These patterns test the
memory's storage integrity and its ability to store data accurately. This test writes a pattern to each byte
in the memory and reads the pattern back. This verifies that the data paths, error-correction circuits,
and the memory devices themselves are working correctly.
omdiag chassis modem
Use the omdiag chassis modem command to run tests on all modems.
NOTE: This test runs on analog communication lines (regular telephone lines) and will not test a cable or Digital
Subscriber Link (DSL) modem. Currently, a test is not provided for testing cable or DSL modems; you can, however,
test cable or DSL Internet connections. To test an Internet connection that uses a cable or DSL modem, you must
use the network test.
NOTE: Shut down all other programs before running this test. If other programs use the modem, the test does not
run and you see "Cannot Run" in the Results window.
omdiag: Using the Diagnostic Service27
•Modem Test — Sends a series of AT command set commands to your modem to see if it is working.
The AT command set is a series of industry-standard instructions for the modem to perform.
NOTE: The correct modem drivers, when required, should be installed for the modem diagnostic tests to run
and provide the best results. For systems running Red Hat Enterprise Linux, in some cases, the "setserial"
command can be used to configure the modems without drivers.
The modem test performs the following tests:
–Hayes Basic Command Test— Uses the Hayes basic command set to exercise and diagnose the
functionality of the modem. The Hayes basic commands are written to the modem and the result
codes are verified and displayed either textually or numerically. Only important commands that
are common across different modems are used during this test.
–Hayes Extended Command Test — Uses the extended command group of the Hayes command
set to exercise and diagnose the functionality of the modem. The Hayes extended commands are
written to the modem and the result codes are verified and displayed either textually or
numerically. Only important commands that are common across different modems are used
during this test.
–S-Registers Test — Uses the selected range of S-Registers to exercise and diagnose the
functionality of the modem. The test saves the current S-register values, sets a new value, verifies
that the new value can be read and is correct, and restores the original value. The result codes are
verified and displayed either textually or numerically.
NOTE: In cases where the Windows registry with modem drivers is corrupted due to bad installs/uninstalls,
the modem diagnostic might give unexpected results.
•Broadcom Modem Test — Used for both external (for example, connected to a serial port) and internal
modems (for example, connected to a PCI slot).
The Broadcom Modem test performs the following tests:
NOTE: The following tests are not supported on systems running a Red Hat Enterprise Linux operating system.
–Broadcom Modem Dialtone Detection Test — Verifies the correct operation of the codec, DAA,
and control logic on the Broadcom V.92 56K modem. This is accomplished by detecting the
presence of a dial tone on the telephone line. A telephone line must be attached to the modem for
this test to pass. If a dialtone is not detected, a warning is reported.
–Broadcom Modem Loopback Test — Instructs the Broadcom V.92 56K modem to perform a
standard local analog loopback test. A test pattern is looped back and checked by the modem. The
test fails if the modem reports any errors during the test.
–Broadcom Modem AT Command Test — Verifies the correct operation of the AT command
microprocessor and associated control functions on the Broadcom V.92 56K modem. A series of
ATcommands are issued and the responses are checked for correctness. Each command must
correctly return "OK" or an error is reported.
28omdiag: Using the Diagnostic Service
omdiag chassis network
Use the omdiag chassis network command to test the NIC. Three main categories of diagnostic tests
available are:
•
Generic Network Diagnostic Tests
•
Broadcom NIC Diagnostic Tests
•
Intel® NIC Diagnostic Tests
Generic Network Diagnostic Tests
The following two tests are available on all Dell™ supported NICs:
–NIC Communication Test — Checks whether the NIC under test is physically connected (wired)
to the network. It also checks whether the NIC has a valid IP address.
NOTE: The network team test is only available on systems running a supported Microsoft Windows
operating system.
–NIC Team Test — Checks whether the NIC under test is in team mode. NIC teaming is one
method for providing high availability and fault tolerance in systems.
Broadcom NIC Diagnostic Tests
The following tests are available on Dell supported Broadcom NICs:
–BRCMNetwork Control Registers Test — Tests most of the internal registers on the chip. Each
chip contains many internal registers. Each register can contain some read-only bits and some
read/write bits. This diagnostic tests read-only bits that cannot be overwritten, and tests if
read/write bits can be written properly.
–BRCMNetwork MII Registers Test — Tests most MII registers on the chip. Each chip contains
many MII registers. Each MII register may contain some read-only bits and some read/write bits.
This diagnostic tests read-only bits that cannot be overwritten, and tests if read/write bits can be
written properly.
–BRCMNetwork EEPROM Test — Tests the EEPROM checksum of the bootstrap record and the
configuration block on the chip.
–BRCMNetwork Internal Memory Test — Tests most of the internal memory of the chip. Each chip
contains a certain amount of on-chip memory to support on-chip processor operations.
–BRCMNetwork Interrupt Test — Tests the interrupt capability of the chip by verifying that the
NDIS driver is able to receive interrupts from the NIC.
–BRCMNetwork MAC Loop–back Test — Verifies that the NDIS driver is able to send and receive
packets from the NIC. It issues IOCTL (Input Output Controls) to request driver setup
(MAC layer loop back) in hardware.
–BRCMNetwork PHY Loop–back Test — Verifies that the NDIS driver is able to send and receive
packets from the NIC. It issues IOCTL (Input Output Controls) to request driver setup
(PHY layer loop back) in hardware.
omdiag: Using the Diagnostic Service29
–BRCMNetwork On Chip CPU Test — Tests the internal processor(s) on the chip. The test will
halt all on-chip processors, download an executable binary to the processor memory, and execute
the program.
–BRCMNetwork LED Test — Blinks the LEDs on the NIC.
–BRCMNetwork ASF Test — Tests various processor event registers and SMBus control registers.
Exercises ASF related hardware on the chip.
Intel NIC Diagnostic Tests
The following tests are available on Dell supported Intel NICs:
NOTE: For systems that have a PCI-E Intel Network Interface Controller (NIC), Intel PROSet Utility for
Microsoft Device Manager is required for the Intel network adapter diagnostics on systems running a
Microsoft Windows operating system. If you have a PCI-X Intel NIC, you may install either the Intel PROSet for
Microsoft Device Manager or the Intel PROSet management agent to enable Intel network adapter
diagnostics. If you have any other Dell-supported Intel NIC, you should install the Intel PROSet management
agent. If these requirements are not met, the Intel vendor tests will not be available (only the default network
diagnostics are available). You can access the Intel PROSet for Microsoft Device Manager from either the
Dell PowerEdge™ Service and Diagnostic Utilities CD or from the Dell Support website at support.dell.com.
NOTE: The following tests are only available on systems running a supported Microsoft Windows
operating system.
–Intel FIFO Registers Test — Tests FIFO memory on the adapter by writing and reading patterns
to and from the FIFO memory.
–Intel Control Registers Test — Checks for any conflicts in the I/O address and tests the
accessibility of the registers. This test includes all General Registers, Receive Registers, and
Transmit Registers. It does not test the EEPROM Control/Data Register.
–Intel EEPROM Test — Verifies the integrity of data read from the EEPROM. This test completes a
write and read from the EEPROM and then compares the results for consistency.
–Intel Interrupt Test — Uses the Interrupt registers to confirm that all NIC Interrupts work.
–Intel MAC Loopback Test — Tests the NIC’s ability to send and receive packets by sending packets to
itself. This test uses the MAC Loopback mode.
NOTE: The Intel MAC Loopback Test is not supported on the Intel PRO/1000 MF and the Intel PRO/1000 MT
DP network cards.
–Intel PHY Loopback Test — Tests the NIC’s ability to send and receive packets by sending packets
to itself. This test uses the PHY Loopback mode. Not all NICs support PHY Loopback.
–Intel Link Test — Checks the network connection, and the NICs send and receive functionality by
sending 1000 proprietary packets out on the network and retrieving those same packets.
30omdiag: Using the Diagnostic Service
Loading...
+ 218 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.