Dell Online Diagnostics Version 2.
Notes and Cautions NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates potential damage to hardware or loss of data if instructions are not followed. ____________________ Information in this publication is subject to change without notice. © 2010 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.
Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . What’s New in this Release . . . . . . . . . . . . . . . . Supported Operating Systems . . . . . . . . . . . . . . . 2 . . . . . . . . . . . . . . . . . . . 7 . . . . . 9 . . . . . . . . . . . . . . . . . . . . . 9 Things to Remember . . . . . . . . . . . . . . . . . . . . 9 Setup and Diagnostic Requirements . . . . . . . . . . 10 Managed System Requirements . . . . . . . . . . 10 . . . . . . . . . . . . . 10 .
Diagnostics Interface . Diagnostic Selection . . . . . . . . . . . . . . . 18 . . . . . . . . . . . . . . . . 18 Diagnostic Information Using the Command Line Interface Primary CLI Commands . . . . . . . . . . . . 23 . . . . . . . . . . . . . . 23 Aborting Online Diagnostics in CLI Mode Using . . . . . . . . . . . . . . Scripting With the CLI 4 . . . . . 25 . . . . . . . . . . . . . . . 25 Running Dell Online Diagnostics in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . .
1 Introduction Dell Online Diagnostics, a stand-alone suite of diagnostic programs or test modules, allows you to run diagnostic tests on Dell systems in a production environment, and helps you ensure maximum uptime of your Dell systems. Online Diagnostics allows you to run diagnostic tests on chassis and storage components such as hard drives, physical memory, and network interface cards (NICs.
Devices Supported by Online Diagnostics Online Diagnostics provide diagnostics for the following hardware devices: • CD drives • DVD drives • CD-RW/DVD combination drives • Diskette drives • Hard drives • NICs • Internal modems • SCSI controllers • RAID controllers • Fibre Channel Controllers • Dell Remote Access Controllers (DRAC 4 and DRAC 5) • USB controllers • SAS controllers NOTE: For more information see “Diagnostics for RAID Controllers, SAS Controllers, SCSI Controllers, and
Diagnostics Features Online Diagnostics offers the following features: • Discovering Devices This feature enables Online Diagnostics to enumerate and discover all testable devices on your Dell system. Enumeration occurs when the application is launched. If your system hardware has changed, restart the application to re-enumerate the devices on the system.
• Number of Passes This feature enables you to run the selected tests for a specified number of iterations. The minimum value is 1 and the maximum is 20. NOTE: In the CLI mode, Online Diagnostics allows for a maximum number of 999 passes. • Run Time This feature allows you to specify the duration (in minutes) for which a diagnostic test should run. This feature is available only in the CLI version of Online Diagnostics.
2 Setting Up Dell Online Diagnostics This section describes the process for setting up Dell Online Diagnostics. Before You Begin • Read the setup requirements and ensure that your system meets or exceeds the minimum requirements. • Read the Online Diagnostics readme file provided with this application. The readme contains the latest information about Online Diagnostics in addition to information about known issues.
Setup and Diagnostic Requirements Online Diagnostics must be set up on each managed system to run diagnostics locally. Managed System Requirements • A minimum of 256 MB RAM • A minimum of 40 MB free space on the system drive (C: on Windows or / opt on Linux.) • A supported operating system installed on your Dell system. See "Supported Operating Systems.
Table 2-1. Device Dependencies Device Operating System Dependency Default Behavior (if dependency is not met) Intel NIC Microsoft Windows Intel PROSet management Intel vendor network agent or Intel PROSet utility tests are not available. for Microsoft Device Manager. These are installed as an option when Intel Driver is installed. You can download Intel Driver from the Dell Support website at support.dell.com. For Drivers & Downloads, this appears under the Network category of the selected product.
Table 2-1. Device Dependencies (continued) Device Operating System USB Controllers Red Hat usbutils package (version 0.11 Diagnostic tests for Enterprise or above.) USB devices will not Linux and be available. SUSE Linux Enterprise Server All supported devices Red Hat Enterprise Linux and SUSE Linux Enterprise Server pciutils package (version 2.1.11 or above.) Broadcom NIC Microsoft Windows Broadcom Advanced If BACS is not present, Controller Suite (BACS).
Table 2-1. Device Dependencies (continued) Device Operating System Dependency Emulex Fibre Channel Controller Linux operating 1. HBAnywhere utility from system Emulex. To download this utility, access the Emulex website at www.emulex.com. Click Downloads Dell. Click the adapter model number. Click Linux from the Current Drivers section and download the Applications Kit. Default Behavior (if dependency is not met) Fibre Channel Controllers are not enumerated and diagnostics tests will not be available.
NOTE: On Windows Server 2008 (Core) operating systems, Dell Online Diagnostics functions only if Microsoft Visual C++ 2005 Redistributable Package (x86) is installed. The Visual C++ Redistributable Package is available at the Microsoft website www.microsoft.com. NOTE: Ensure that you accept the End-User License Agreement (EULA) while installing Online Diagnostics.
NOTE: On Windows Server 2008 R2 edition or later, a user with administrator privileges will not be able to directly run the Dell Online Diagnostics application. To run Online Diagnostics application, click Start Programs Online Diagnostics 2.x.y and right click the Online Diagnostic GUI or the Online Diagnostic CLI and select Run as administrator. NOTE: To uninstall Online Diagnostics, click Start Programs Online Diagnostics 2.x.yUninstall or run the uninst.
NOTE: To uninstall the application, run uninstall.sh. This file is located in the installation directory. The Online Diagnostics GUI, which is a 32-bit application, does not function on Red Hat Enterprise Linux (x86_64) systems if Compatibility Arch Support packages are missing. Your Red Hat Enterprise Linux (x86_64) system may display the following message when you try launching Online Diagnostics: Compatibility Arch Support package(s) [gtk, pango, and redhat-artwork] is not installed on this system.
Using Dell Online Diagnostics 3 Dell Online Diagnostics can be accessed in two ways: from a graphical user interface (GUI) and from a command line interface (CLI). This section describes both the interfaces. Using the GUI When you launch Online Diagnostics in the GUI mode, the splash screen appears indicating the progress of device-discovery, until enumeration is complete. The splash screen also provides important information related to running Online Diagnostics.
• Save Results: Use this option to save the test result details. The test result details are saved to an HTML file (results.html), which is contained in an archive file. You can specify any name for this archive file, for example, results.zip. You can use this option only after all the tests that are running are complete. When contacting technical support for any system or device problem, you can save the result details and send the file to technical support.
The following table describes the icons in the Select Test(s) to Run pane. Indicates a device. Indicates a device with a non-critical error or associated warning. Indicates a test. Indicates a test with a non-critical error or warning associated. A test warning message is displayed on mouseover. Select All: Click this button to select all the devices and tests displayed in the Select Test(s) to Run pane.
Diagnostic Information Use this section to view the system configuration and operational status information. In addition, you can run selected tests and view the results of these tests. Configuration Use this tab to view the operational status of the detected devices and their configuration details. To view the configuration details for a device, select the device from the Select Test(s) to Run pane.
Tests Selected Use this tab to run the tests you selected in the Select Test(s) to Run pane. This tab contains the following sections: • Diagnostic Tests Selected: This list box displays all the tests selected in the Select Test(s) to Run pane. • Diagnostic Options: Use this section of the Tests Selected tab to run the selected tests. This section contains the following controls: Run Tests Starts the selected tests. You can run multiple tests at the same time.
• Total Pass: Indicates the total number of passes that you specified to run if you selected the Number of Passes option for the test. • Status: Indicates the current status of a test. Double-click on a test item to view details that include device name, device description, device location, test name, and test description. The following text indicators specify the test status: Completed Specifies that the test has completed. Suspended Specifies that the test was suspended.
Result Use this tab to view the results of the tests executed along with a brief description about the outcome of each test. The Result column in this tab briefly describes the test outcome. In addition, you can double-click anywhere in the row to view the corresponding result message. For example, if a test failed, the Result column will display the problem encountered and any actions you must take. Right-click to bring up the Delete/Delete All Completed menu.
• pediags --show [device|test|all] [] [] [fmt=lst|tbl|xml] Displays the list of device classes, tests, or both device classes and tests. The default option is all. The option displays both device classes and tests. You can specify index options and choose the format in which you want the output to be displayed. The parameters should follow the particular order in which they are listed above. Format options must always be the last parameter.
• pediags --run time= x (where x is the number of minutes you want the test to run.) This command allows you to run a diagnostic test for a specified duration. For example, pediags scsidevdiag --run device-index=1 test-index=1 time=30 runs the diagnostic test whose index is 1 on the SCSI device whose device-index is 1 for 30 minutes. Tests stop executing after they complete 72 hours or 999 passes, whichever occurs first. NOTE: Runtime of the passes parameter is limited to 3 days (72 hours).
In many cases, the CLI allows a user with a very well-defined task in mind to retrieve information about the system rapidly. You can redirect the diagnostic output to a file using the operating system’s redirection feature. You can also use the exit codes explained in the following table when writing scripts. 0 The test has a passed result. 1 The test has a warning result. 2 The test has a failed result. 3 The application failed because of dependency issues or runtime issues.
Running Dell Online Diagnostics in GUI Mode 4 This section provides step-by-step instructions on running Dell Online Diagnostics in graphical user interface (GUI) mode. Running Diagnostic Tests To run diagnostic tests, perform the following steps: 1 Launch the application. 2 In the Diagnostic Selection section on the left, select the appropriate option from the Selection Options drop-down menu.
4 Click the Status tab to monitor the status of the test execution. • To abort a running test, right-click the test and select Abort. Select Abort All to stop all the queued tests. • To suspend a running test, right-click the test and select Suspend. • To resume a suspended test, right-click the test and select Resume. The icons in the Result column indicate the status of each test. • The In Progress icon ( executed.
Configuring the Test Execution Settings You can configure the test execution setting to use a faster algorithm to conduct the test. Perform the following steps: 1 Select the tests you want to run in the Diagnostic Selection section. 2 Click the Tests Selected tab in the Diagnostic Information section. All the selected tests are displayed. 3 Select the Quick Test check box in the Diagnostic Options section at the bottom. If this option is available for one of the selected tests, the test is run in this mode.
Running Dell Online Diagnostics in GUI Mode
5 Supported Devices This section lists the devices that can be tested using Dell Online Diagnostics. Diagnostics for Tape Drives, Autoloaders, and Libraries NOTE: Install Dell-qualified device drivers to run diagnostic tests on tape drives, tape autoloaders, and tape libraries. See the documentation that accompanied your device. The latest device drivers are available at the Dell Support website at support.dell.com.
NOTE: Online Diagnostics enumerates and displays the diagnostic tests for the hard drives that are connected to SAS 5/iR (Adapter and Integrated), SAS 5/i Integrated, and SAS 6/iR, S100, S300, H200 (Adapter, Integrated, and Modular) controllers. However, diagnostic tests for these controllers themselves are unavailable.
• Firmware version number required for a particular controller NOTE: For the list of firmware, BIOS, and driver versions for supported RAID Controllers, see the Dell Systems Software Support Matrix for OpenManage 6.3. To access the Dell Systems Software Support Matrix, on the Dell support website at support.dell.com/manuals, click Software Systems Management Dell OpenManage Releases.
Supported Devices
A Appendix Table A-1. Additional Device Information for Storage Diagnostics Parameter Description Total Moves Total number of AutoLoader moves. Drive Loads Number of loads to the drive from magazines and mail slot. Mailslot Exports Number of times a cartridge was exported from the system. Mailslot Imports Number of times a cartridge was imported into the system. Magazine Moves Number of moves between storage slots.
Table A-1. Additional Device Information for Storage Diagnostics (continued) Parameter Description Last Clean Number of hours since the Last-clean was done. Clean Required Set to Yes if cleaning-required condition exists. Replace Cleaning Tape Set to Yes if cleaning tape needs replacement. Number of Drive Cleans Drive cleaning cycle count. Number of Tape Cleans Number of cleaning sessions per cartridge. Power On Hours (POH) Amount of time a tape drive has been turned on.
Table A-1. Additional Device Information for Storage Diagnostics (continued) Parameter Description Media Type: Total COH for specified media type. total time in COH Sense codes Various codes and parameter are listed. For example, (List of latest four Sense Sense Key, Additional Sense Code, and Additional Codes) Sense Code Qualifier. Lifetime Meters of Tape Processed Cumulative physical length of tape that has been written over its lifetime.
Table A-1. Additional Device Information for Storage Diagnostics (continued) Parameter Description Firmware Version Firmware version at the time the command terminated with Check Condition status. MMH Since Last Clean Media Motion hours since Last Successful Cleaning at the time the command terminated with Check Condition status. Opcode Operation Code at the time the command terminated with Check Condition status.
