###################################################################### DELL(TM) POWEREDGE(TM) DIAGNOSTICS VERSION 2.9 README ###################################################################### NOTE: This readme provides information about Dell PowerEdge Diagnostics version 2.9. This file contains updated information for your "Dell PowerEdge Diagnostics User's Guide". You can access the "Dell PowerEdge Diagnostics User's Guide" from the "\docs\" directory ("/docs/" on Linux), when you install the Dell PowerEdge Diagnostics product. For the latest version of this readme documentation, see the Dell Support website at "support.dell.com". ###################################################################### TABLE OF CONTENTS ###################################################################### This file contains the following sections: * Criticality * Minimum Requirements * Release Highlights * Setup * Installation/Uninstallation Requirements * User Notes * Known Issues ###################################################################### CRITICALITY ###################################################################### 3 - Optional ###################################################################### MINIMUM REQUIREMENTS ###################################################################### This section provides information about the minimum requirements for using PowerEdge Diagnostics. ====================================================================== SUPPORTED SYSTEMS ====================================================================== The following Dell PowerEdge systems are supported: * SC420, SC430, SC1420, SC1425, SC1430, SC1435, SC440, 600SC, 1600SC, 650, 1650, 1655MC, 2600, 2650, 4600, 6600, 6650, 700, 750, 1750, 800, 830, 840, 850, 860, 1800, 1850, 1855MC, 2800, 2850, 6800, 6850, 1900, 1950, 1955, 2900, 2950, 6950, 2970 ====================================================================== SUPPORTED OPERATING SYSTEMS ====================================================================== * Microsoft(R) Windows(R) 2000 Server and Advanced Server with SP 4 * Microsoft Windows Server(R) x64 2003 R2 with SP2 (32-bit and 64-bit extensions) (Standard, Enterprise and Datacenter editions), Microsoft Windows Server 2003 SP2 (Web Edition), Microsoft Windows Storage Server 2003 x64 R2 (includes Express, Standard, Workgroup, and Enterprise editions), Microsoft Windows Server 2003 SBS R2 (Standard and Premium editions), and Microsoft Windows Unified Data Storage Server 2003 Gold (Standard and Enterprise x64 Editions) * Red Hat(R) Enterprise Linux(R) AS, ES, WS (version 4) Gold (x86 and x86_64) * Red Hat Enterprise Linux Server (version 5), (x86 and x86_64) * SUSE(R) LINUX Enterprise Server 9 SP2 and SP3 (x86_64) * SUSE LINUX Enterprise Server 10 Gold (x86_64) ====================================================================== DIAGNOSTIC REQUIREMENTS ====================================================================== * For a complete list of diagnostics requirements, see the "Dell PowerEdge Diagnostics User's Guide." ###################################################################### RELEASE HIGHLIGHTS ###################################################################### * Added support for these languages - German, French, Spanish, Japanese and Simplified Chinese. Korean and Traditional Chinese operating systems are supported with English user interface. * Added support for new tape devices - Dell PowerVault LTO-3 - 060 and Dell PowerVault LTO-4 - 120 (internal only). * Enhanced SAS PHY Integrity test. ###################################################################### SETUP ###################################################################### * On Enterprise Linux operating systems (Red Hat or SUSE), unzip the tar.gz file to a desired location. The extracted files contain an install script (install.sh) and some Red Hat Package Manager (RPM) packages. Install the RPM packages using install.sh. srvadmin-hapi component fails to install if your system does not have the minimum version of OpenIPMI required by srvadmin-hapi. If IPMI is supported on your system, install OpenIPMI from the System Management CD (by running ./srvadmin-openipmi.sh from srvadmin/linux/supportscripts directory). You can also download OpenIPMI from the Dell Support Website "support.dell.com". All the files needed to run PowerEdge Diagnostics are extracted to the default installation directory, /opt/dell/pediags. In the pediags directory, run startDiags.sh from an X session to launch the GUI application. To uninstall the application, run uninstall.sh found in the install directory. WARNING: Installing srvadmin-hapi or srvadmin-omilcore separately (using rpm command) fails on all PowerEdge SC platforms. Some SC platforms like SC420, SC430, and SC1420 do not support IPMI. Memory and Dell Remote Access Controller version 5 (DRAC 5) diagnostics are unavailable on those systems. * On Windows operating systems, launch the "exe" package downloaded from the Dell Support Website "support.dell.com" or from the "Dell PowerEdge Service and Diagnostic Utilities" CD. Choose a directory where you want the extracted files to reside. You can run the GUI from Windows Start menu." * To run the application in CLI mode while using both Microsoft Windows and Red Hat Enterprise Linux operating systems, run pediags from /oldiags/bin in the installation directory. Additionally, on Windows operating systems click Start -> Programs -> PowerEdge Diagnostics 2.9 -> PowerEdge Diagnostics CLI to launch the CLI console. ###################################################################### INSTALLATION/UNINSTALLATION REQUIREMENTS ###################################################################### * The PowerEdge 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 PowerEdge Diagnostics: "Compatibility Arch Support package(s) [gtk, pango, and redhat-artwork] is not installed on this system. For details on installing the package(s) please refer to the README file." To resolve the issue, perform the following actions: 1. Run Red Hat Package Management Utility ("redhat-config-packages") 2. Select the "Compatibility Arch support" checkbox in the "Package Management" window and click "Details". 3. A new window ("Compatibility Arch Support Details") is displayed. 4. Make sure the following packages are selected for installation from the new window and click "Close": gtk, pango, and redhat-artwork. 5. Click the "Update" button in the "Package Management" window. * Installation of Dell PowerEdge Diagnostics requires a minimum free space of 40 MB on your system drive (C: on Windows or /opt on Linux). * Uninstallation of Dell PowerEdge Diagnostics requires a minimum free space of 40 KB on your system drive. ###################################################################### USER NOTES ###################################################################### This section provides information to help enhance your experience with PowerEdge Diagnostics in particular implementations and environments. * For a complete list of hardware devices that PowerEdge Diagnostics supports, see the "Dell PowerEdge Diagnostics User's Guide." * CD/DVD tests are not supported on Virtual CD devices. * You need Administrator privileges on your operating system to run diagnostics tests using PowerEdge Diagnostics. * Do not extract and copy this application to another directory for execution purposes. Running this application on a read-only file system is also not supported. * PowerEdge Diagnostics is designed to diagnose problems on individual systems. Problems that occur on the network level are not addressed unless the problem resides with a NIC on a single system. * The hard drive diagnostics are designed to run as low-priority background tasks to limit the effect of their activity on other hard-drive I/O activity. It is recommended that you limit drive activity while you are running the hard-drive diagnostics. The diagnostics may run slowly or even stop when other hard-drive I/O activity is running simultaneously. The diagnostics resume when the hard-drive I/O activity decreases. * PowerEdge Diagnostics runs concurrently with all the other applications that are running on the system being tested. As a result, additional system load occurs and could impact system and application performance. If you are running critical applications that require rapid response or consume significant system resources, take appropriate precautions before running diagnostics. Close all non-essential applications and run diagnostics only during non-peak hours of system use. * Running multiple instances of PowerEdge Diagnostics is not supported. * Ensure that only Dell-supported USB devices are present in your system before running PowerEdge Diagnostics. Disconnect any unsupported devices, if they are present. See the "PowerEdge Diagnostics User's Guide" for a complete list of supported devices. * An OHCI Controller limits the amount of power supplied to a bus- -powered hub. If the bus-powered hub has a large number of devices attached to it, the OHCI Controller does not configure them for usage and declares the particular hub as unknown. As a result, your operating system too does not detect the over current condition and reports the hub as an unknown device. An EHCI controller, however, provides sufficient power to such a hub and in doing so it gets information about the over current condition. The operating system detects the over current condition and reports it properly.(DF68933) * On unsupported configurations, the memory device status is not shown, and the Memory Status Test is unavailable. ====================================================================== NOTES FOR RAID CONTROLLERS ====================================================================== * It is strongly recommended that you maintain the latest versions of the RAID controller driver and firmware. Otherwise, unpredictable application behavior may occur. Install Dell-qualified device drivers and firmware to run diagnostics on RAID controllers and RAID-attached hard drives. See the documentation that accompanied your device for more information, or access the latest drivers and firmware from the Dell Support website at "support.dell.com". The "PowerEdge Diagnostics User's Guide" contains a list of the latest drivers and firmware versions for RAID Controllers. * PowerEdge Diagnostics does not support Adaptec SCSI HostRaid 0 or 1. * PERC 4/IM requires Dell OpenManage Array Manager, Dell OpenManage Server Administrator Storage Management Service, or RAID storage Manager to be installed for diagnostics to function. * PowerEdge Diagnostics does not support CERC SATA 2s (RAID mode). ====================================================================== NOTES FOR TAPE DRIVES, AUTOLOADERS, AND LIBRARIES ====================================================================== * Install Dell-qualified device drivers to run diagnostics on tape drives, tape autoloaders, and tape libraries. See the documentation that accompanied your device for more information, or access the latest drivers from the Dell Support website at "support.dell.com". * Do not run diagnostics simultaneously on multiple tape devices. In addition, do not run diagnostic tests simultaneously with the SCSI communication tests. For example, if you run diagnostic tests simultaneously for a PowerVault 122T autoloader and a VS80 tape drive, one of the tests may fail with the following message: "The DLL required to run the diagnostic is currently being used by another device. Retry the diagnostic after ensuring that the DLL is not being used by other devices." * Ensure that all tape backup services are stopped before executing tape diagnostics. Having tape backup services running while executing tape diagnostics may cause unpredictable behavior. The device may show unknown status when enumerated. * Tape Changer Slot-to-Slot Test is not supported in PowerVault-122T. * Tape Changer Eject Test is not supported in VS80 and VS160 tape devices. * PowerEdge Diagnostics lists several attributes for each tape drive. The attributes and their definitions are defined as follows: - PowerOnHours (POH): Number of hours the tape drive has been powered on. - TapeMotionHours (TMH): Number of hours the tape has been in use. - LastClean (LC): Time (in hours) since the last cleaning. - CleanReq (CR): Whether cleaning is required for the tape drive. - NumberofCleans (NOC): Number of cleans performed on the tape drive. - LoadCount (LoC): Number of times the tape media has been loaded or unloaded in the tape drive. * For Tape Libraries, PowerEdge Diagnostics requires drives inside the library to be daisy chained with the changer. Any other configuration of tape libraries is not supported and may result in unexpected behavior of the application. (DF110615,DF110616) * In PowerVault ML6000, Tape Changer Eject Test will not consider an IE slot as a home slot. The media may not be ejected back to the IE slot from which the drive was loaded. * The following table lists the attributes for each tape drive ("S" is the abbreviation for "Supported"): --------------------------------------------------------- TAPE |POH| TMH | LC | CR | NOC | LoC | DEVICE | | | | | | | ------------------------|-------------------------------| PowerVault-100T-DDS4 | S | S | S | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-100T-DAT72 | S | S | S | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-110T-LTO1 | S | S | S | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-110T-LTO2 | S | NA | NA | S | NA | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-110T-DLT1 | S | S | S | S | NA | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-110T-DLT-VS80| S | S | NA | S | NA | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-110T-SDLT320 | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-110T-SDLT220 | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-110T-DLTVS160| S | S | NA | S | NA | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-122T-SDLT320 | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-122T-DLT-VS80| S | S | NA | S | NA | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-132T-LTO2 | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-132T-LTO | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-132T-SDLT320 | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-136T-SDLT320 | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-136T-SDLT | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| PowerVault-136T-LTO2 | S | S | NA | S | S | S | ------------------------|---|-----|----|----|-----|-----| * Behavior of tape changer robotic movement tests Slot-to-Slot, Slot-to-Drive, Slot-to-IE): -----------|----------|-----------|------------|-------------|----------| Slots |Drives | IE |Slot to Slot|Slot to Drive|Slot to IE| -----------|----------|-----------|------------|-------------|----------| All empty |All empty |All empty |"All Slots |"All Slots |"All Slots| | | | Empty" | Empty" | Empty" | -----------|----------|-----------|------------|-------------|----------| All empty |All empty |Some empty | Pass | Pass | Pass | | |Some full | | | | -----------|----------|-----------|------------|-------------|----------| All empty |All empty |All Full | Pass | Pass |"All IE | | | | | | Full" | -----------|----------|-----------|------------|-------------|----------| All empty |Some empty|All empty |"All Slots | Pass |"All Slots| |Some full | |Empty" | | Empty" | -----------|----------|-----------|------------|-------------|----------| All empty |Some empty|Some empty | Pass | Pass | Pass | |Some full |Some full | | | | -----------|----------|-----------|------------|-------------|----------| All empty |Some empty|All Full | Pass | Pass |"All IE | |Some full | | | | Full" | -----------|----------|-----------|------------|-------------|----------| All empty |All Full |All empty |"All Slots | Pass |"All Slots| | | | Empty" | | Empty" | -----------|----------|-----------|------------|-------------|----------| All empty |All Full |Some empty | Pass |"All Drives | Pass | | |Some full | | Full" | | -----------|----------|-----------|------------|-------------|----------| All empty |All Full |All Full | Pass |"All Drives |"All IE | | | | | Full" | Full" | -----------|----------|-----------|------------|-------------|----------| Some empty |All empty |All empty | Pass | Pass | Pass | Some full | | | | | | -----------|----------|-----------|------------|-------------|----------| Some empty |All empty |Some empty | Pass | Pass | Pass | Some full | |Some full | | | | -----------|----------|-----------|------------|-------------|----------| Some empty |All empty |All Full | Pass |Pass |"All IE | Some full | | | | | Full" | -----------|----------|-----------|------------|-------------|----------| Some empty |Some empty|All empty | Pass | Pass | Pass | Some full |Some full | | | | | -----------|----------|-----------|------------|-------------|----------| Some empty |Some empty|Some empty | Pass |Pass | Pass | Some full |Some full |Some full | | | | -----------|----------|-----------|------------|-------------|----------| Some empty |Some empty|All Full | Pass | Pass |"All IE | Some full |Some full | | | | Full" | -----------|----------|-----------|------------|-------------|----------| Some empty |All Full |All empty | Pass |"All Drives | Pass | Some full | | | | Full" | | -----------|----------|-----------|------------|-------------|----------| Some empty |All Full |Some empty | Pass |"All Drives | Pass | Some full | |Some full | | Full" | | -----------|----------|-----------|------------|-------------|----------| Some empty |All Full |All Full | Pass |"All Drives |"All IE | Some full | | | | Full" | Full" | -----------|----------|-----------|------------|-------------|----------| All Full |All empty |All empty | Pass | Pass | Pass | -----------|----------|-----------|------------|-------------|----------| All Full |All empty |Some empty | Pass | Pass |"All Slots| | |Some full | | | Full" | -----------|----------|-----------|------------|-------------|----------| All Full |All empty |All Full |"All Slots | Pass |"All IE | | | | Full" | | Full" | -----------|----------|-----------|------------|-------------|----------| All Full |Some empty|All empty | Pass | Pass | Pass | |Some full | | | | | -----------|----------|-----------|------------|-------------|----------| All Full |Some empty|Some empty | Pass | Pass |"All Slots| |Some full |Some full | | | Full" | -----------|----------|-----------|------------|-------------|----------| All Full |Some empty|All Full |"All Slots |"All Slots |"All IE | |Some full | | Full" | Full" | Full" | -----------|----------|-----------|------------|-------------|----------| All Full |All Full |All empty | Pass |"All Drives | Pass | | | | | Full" | | -----------|----------|-----------|------------|-------------|----------| All Full |All Full |Some empty | Pass |"All Drives |"All Slots| | |Some full | | Full" | Full" | -----------|----------|-----------|------------|-------------|----------| All Full |All Full |All Full |"All Slots |"All Drives |"All IE | | | | Full" | Full" | Full" | -----------|----------|-----------|------------|-------------|----------| ====================================================================== NOTES FOR INTEL NETWORK INTERFACE CARDS (NICs) ====================================================================== * Supported adapters and tests for Intel NIC diagnostics on Windows: --------------------------|--------|--------|------|---------|-----|--------| |EEPROM|PHY |MAC | FIFO |Interrupt| Link|Control | |Test |Loopback|Loopback| Test |Test | Test|Register| Adapter | |Test |Test | | | |Test | -------------------|------|--------|--------|------|---------|-----|--------| PRO/1000 MF | | | | | | | | Server Adapter |Yes |Yes |Yes |Yes |Yes |No |Yes | -------------------|------|--------|--------|------|---------|-----|--------| PRO/1000 MT | | | | | | | | Server Adapter |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------------------|------|--------|--------|------|---------|-----|--------| Intel PRO/1000 MT | | | | | | | | Dual Port | | | | | | | | Sever Adapter |Yes |Yes |No |Yes |Yes |Yes |Yes | --------------------------|--------|--------|------|---------|-----|--------| Intel PRO/100s | | | | | | | | Server Adapter |Yes |Yes |Yes |No |No |Yes |Yes | -------------------|------|--------|--------|------|---------|-----|--------| Intel PRO/1000 XT | | | | | | | | Network Connection |Yes |Yes |No |Yes |Yes |Yes |Yes | -------------------|------|--------|--------|------|---------|-----|--------| Intel PRO/1000 | | | | | | | | CT Network | | | | | | | | Connection |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------------------|------|--------|--------|------|---------|-----|--------| Intel PRO/1000 MT |Yes |Yes |Yes |Yes |Yes |Yes |Yes | Network Connection | | | | | | | | -------------------|------|--------|--------|------|---------|-----|--------| Intel PRO/1000 MT | | | | | | | | Dual Port Network | | | | | | | | Connection |Yes |Yes |No |Yes |Yes |Yes |Yes | -------------------|------|--------|--------|------|---------|-----|--------| Intel PRO/1000 MB | | | | | | | | Dual Port Network | | | | | | | | Connection |Yes |Yes |No |Yes |Yes |Yes |Yes | -------------------|------|--------|--------|------|---------|-----|--------| Note: With Intel PROSet Utility for Microsoft Device Manager, on Windows Operating Systems, the MAC Loopback and PHY Loopback tests are available as one Loopback test. ====================================================================== NOTES FOR BROADCOM NETWORK INTERFACE CARDS (NICs) ====================================================================== * Supported adapters and tests for Broadcom NIC diagnostics on Windows: -------|--------|--------|------|--------|----|---------|--------|--------|----|----| Adapter|Register|MII |EEPROM|Internal|CPU |Interrupt|MAC |PHY |LED |ASF | Test |Test |Register|Test |Memory |Test| Test |Loopback|Loopback|Test|Test| | |Test | |Test | | |Test |Test | | | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5700 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |No | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5701 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |No | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5703 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5703s |Yes |No |Yes |Yes |Yes |Yes |Yes |No |Yes |Yes | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5704 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5751 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5721 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5708c |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes |No | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| 5708s |Yes |No |Yes |Yes |Yes |Yes |Yes |Yes |Yes |No | -------|--------|--------|------|--------|----|---------|--------|--------|----|----| * Supported adapters and tests for Broadcom NIC diagnostics on Linux: -------|--------|--------|------|--------|---------|--------|--------|----| Adapter|Control |MII |EEPROM|Internal|Interrupt|MAC |PHY |LED | Test |Register|Register|Test |Memory | Test |Loopback|Loopback|Test| |Test |Test | |Test | |Test |Test | | -------|--------|--------|------|--------|---------|--------|--------|----| 5700 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| 5701 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| 5703 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| 5703s |Yes |No |Yes |Yes |Yes |Yes |No |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| 5704 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| 5751 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| 5721 |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| 5708c |Yes |Yes |Yes |Yes |Yes |Yes |Yes |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| 5708s |Yes |No |Yes |Yes |Yes |Yes |No |Yes | -------|--------|--------|------|--------|---------|--------|--------|----| ###################################################################### KNOWN ISSUES ###################################################################### The following sub-sections list the known issues with this release of PowerEdge Diagnostics. ---------------------------------------------------------------------- ISSUES FOR ALL OPERATING SYSTEMS ---------------------------------------------------------------------- * Do not update the NIC drivers when you run tests. The tests may produce unexpected results. * If you disable a network adapter and then enable it, or if you run diagnostics and restart PowerEdge Diagnostics, the NICs may not be available in the "Select Test(s) to Run" tree. It takes approximately 30 seconds for the adapter to return to an active state. If you start PowerEdge Diagnostics immediately after one of these situations, the diagnostic tests will not be listed. The workaround is to wait approximately 30 seconds before you start PowerEdge Diagnostics. * You may get unexpected results on disconnecting the USB cable while you are running a diskette test on a USB diskette drive. On systems running Red Hat Enterprise Linux products, the operating system may stop responding. On systems running Windows, the test may never complete. * Running multiple NIC diagnostics together may result in failure of the NIC Communication Test. If you encounter this error condition, select and run NIC diagnostic tests on one NIC at a time to obtain accurate results. * You need to start a fresh session of PowerEdge Diagnostics after installing the Dell components required by PowerEdge Diagnostics, to take advantage of the new installation. * Diagnostics service may enumerate PERC 3/Di controller and attached disks although Dell OpenManage Server Administrator Storage Management Service is uninstalled from the Managed Node. It is recommended that you install the Server Administrator Storage Management Service before running diagnostics on PERC 3/Di. * Running diagnostic tests on unsupported tape devices on PowerEdge systems might produce unexpected or erroneous results. See the Dell Support website at "support.dell.com" for a list of supported tape drives for Dell servers. * The Virtual Media test will not pass if the POST Results test is executed prior to it. This is due to the POST Result test disconnecting all open RAC sessions. * In the Command Line Interface (CLI), if you abort a diagnostic test, the test results may not appear in some scenarios. * The Disk Self Test may fail if you remove the hard disk while the test is running. The test may fail the first time it is run after re-inserting the disk. Ignore this failure and run the test again. * When you run diagnostic tests or enumerate with "racadm racreset" command on a DRAC5 simultaneously, the device may not be enumerated or the test might fail in CLI/GUI. Wait until DRAC5 is reset and enumerate or run the tests again. * When Picker is loaded with a media and Tape Device Self-Test is run on an auto-loader (Dell PowerVault 124T), a warning message may appear: "The tape device appears to have encountered an error while running its built-in self test, switch the tape device-off and on and try the test again. If this error persists, it indicates a hardware problem." Unload the Picker and run the test again. (DF114161) * When a defective media is inserted in a LTO4 drive, the following message is displayed in English, "Incompatible or corrupt media in the drive or media not present. Load a compatible media and run the test again”. For non-English systems it displays the following message,"Media is not present in the drive or incompatible media. Load a compatible cartridge before running this test." ---------------------------------------------------------------------- ISSUES FOR WINDOWS OPERATING SYSTEMS ---------------------------------------------------------------------- * After running PowerEdge Diagnostics, the following errors are logged in the Event Viewer System Log by the Removable Storage Service. "Type: Error, Source: DCOM" "Type: Error, Source: Removable Storage Service" These entries are logged because PowerEdge Diagnostics stops the Removable Storage Service to scan the system for tape devices on which diagnostics are to be performed. After performing the scan, the Removable Storage Service restarts. * Do not use special characters in the folder path while installing PowerEdge Diagnostics. CLI commands do not work if the application install path contains special characters like '#' or '%'. * If you start the PowerEdge Diagnostics immediately after installing any driver, the tests may not be available in the "Select Test(s) to Run" tree. It takes some time for the driver to get installed completely. Wait for sometime before you start PowerEdge Diagnostics. * If the floppy media is ejected while executing diagnostic tests on a USB floppy drive, you may not be able to stop the drive, using the "Safely Remove Hardware" feature from the Windows system tray. * On Windows 2003 Small Business Server with bus powered devices having multiple USB CD and Floppy drives, an extra device (without tests) may be shown. If supported, connect external power supply to this hub. Allow sufficient time for the operating system to detect all hot-plugged USB devices and launch the PowerEdge Diagnostics GUI. (DF66461) * RAC Virtual Media test fails with an error message "Unable to find Virtual Floppy," on Windows operating systems installed on PowerEdge Systems running DRAC5. This error situation occurs only when the operating system is rebooted after the floppy drive is virtualized from another system. (DF72396) * When the Usbhub.sys driver (File version: 5.0.2195.6689, timestamp: June 18, 2006) for Windows 2000 Advanced Server SP4 detects an Over Current condition at a hub port, as an Over Current protection policy, the driver issues a removal request to that device. All device information belonging to that device is released in the Kernel. If USB Over Current Alert test is run at this time, it passes without displaying a warning message, as the Usbhub.sys driver clears the Over Current condition before the test is executed. (DF72902) * When there are a large number of handles open - due to services like Microsoft Exchange, IIS, SQL, Telnet, FTP, Windows and Internet Name Service running simultaneously on Windows Small Business Server 2003 - and when diagnostic tests are queued multiple times, PowerEdge Diagnostics may terminate unexpectedly. * On Windows 2000 Server with an Autoloader/library is connected, PowerEdge Diagnostics may trigger an Administrator Alert saying "Configuration for device Changer0 failed. See the event log for more details.". In the event log Removable Storage service logs an error event with a message "Unable to auto-configure library unit Changer0. The current setup of the library unit does not support automatic configuration. You will either have to modify the current setup of the library to adhere to automatic configuration guidelines (if possible) or manually configure the device.". This behavior occurs because RSM can only auto-configure a robotic library when certain conditions are true which are documented in the Microsoft knowledge base article http://support.microsoft.com/kb/q248800/. To avoid getting these messages, follow the resolution steps mentioned in the Microsoft knowledge base (DF100337). * When Broadcom diagnostics tests are run on NetXtreme II card, this message may appear: "DIAG Client for NetExtreme II GigE". Install the required driver from either the "Dell PowerEdge Service and Diagnostic Utilities CD" or from the Dell Support website at support.dell.com. (DF112642) * Tape diagnostics are not supported when tape device/library is connected to an LSI20320 controller on systems running Windows Server 2003 SP1 and SP2 (x86 & x86_64). The tape device may report "This device cannot start" and no tests are available. * When LUN Based Library/Autoloader tape device is connected to Adaptec 39320A Card, tape drive media test and self test will take longer time to complete if the driver version for Adaptec 39320A Card is below 7.0.0.4(DF96195) * You cannot launch the User's Guide through the application, when the application is installed in a folder with double-byte characters (Japanese or Simplified Chinese) in the path and Mozilla or Firefox is the default browser. You can manually open the User's Guide available at "/docs//Users_Guide_HTML/index.htm". * On Japanese or Chinese Microsoft Windows operating systems, the device description of external USB devices may contain junk characters. If it is a non-Dell device, Dell recommends that the device be disconnected before you start PowerEdge Diagnostics. ---------------------------------------------------------------------- ISSUES FOR ENTERPRISE LINUX OPERATING SYSTEMS ---------------------------------------------------------------------- * Running the CD/DVD Read Exerciser test on corrupt CD media or on a faulty drive may cause the test to run for a longer duration, and PowerEdge Diagnostics may appear to hang. Terminate PowerEdge Diagnostics and try running the test again in the Quick Test mode. * The Intel NIC description may have some extra trailing characters on the Diagnostics selection page on systems running the Red Hat Enterprise Linux operating system. This does not impact the NIC functionality. * Intel Offline test fails when the network services are stopped, if the adapter is not configured for Wake-on-LAN (WOL) or Manageability; and the PHY is powered off. Since the test powers on the PHY and enables WOL, the test passes next time onwards. * Connecting or removing USB or CD/DVD devices from Red Hat Enterprise Linux systems, while the enumeration is in progress, may cause the system to hang. (141704) * The PowerEdge Diagnostics GUI may behave unpredictably when it is run from an ssh-client on Red Hat Enterprise Linux version 4. To resolve the issue, use ssh with -Y option ("Enable Trusted X11 forwarding") when running the GUI. (141497) * When you run a SCSI Communication test, on a channel that has an LTO3 tape drive connected to it and perform a backup simultaneously using 'tar commands', the backup operation may fail. Ensure that backup or restore operations are not in progress before running the SCSI Communication test. * When the Yosemite backup software is installed on a system that has a tape changer, SCSI Communication tests and tape tests may fail. Ensure that the Yosemite backup software service is stopped before running these tests. * The Tape Self Test writes to and advances the tape media during execution. Manual erase operations using the Linux command "mt -f /dev/stX erase", if executed immediately after the Tape Self Test execution, will fail with an I/O error. To avoid this error condition always rewind the tape media after running the Tape Self Test. * When a non-root user uses "su" to become superuser (root), some tests may not work in the CLI, when the pediags command is run. Users should use "su -" to become the super user to run the pediags command. * On Red Hat Enterprise Linux version 4, when SELinux (Security Enhanced Linux) is enabled and you run network diagnostics on console - some warning messages appear indicating a violation of policy. * Multiple USB devices, when connected to a deep hierarchy of bus powered USB Hubs, cause the Linux USB device driver sub-system to become unresponsive. This prevents PowerEdge Diagnostics from launching in the GUI mode. Perform the following corrective measures if you are faced with this error situation: * Disconnect the top-level hub connected to the system, * Connect external power supply if supported, to this hub * Disconnect all the devices from the hub * Reconnect the hub to the server * Reconnect the devices on server ports (if available) and to other higher level hub ports having external power supply, if required. (DF63458,DF68416) * POST Result test will not available on systems running on Linux operating systems and having an IDE Virtual CD Drive with ide-cd driver module. Refer the PSQN No. F25CF0642DD7B211E030030ABD6273EA for the workaround. * On Red Hat Enterprise Linux version 4, after a system reboot, when pediags is run from CLI on a SCSI device it may print messages like, "Attached scsi generic sg0 at scsi0, channel 0, id 0, lun 0, type 0 Attached scsi generic sg0 at scsi0, channel 0, id 1, lun 0, type 0" These messages are informational and should be ignored.(DF135848) ###################################################################### Information in this document is subject to change without notice. (C) 2007 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", "PowerEdge", "Dell OpenManage", and "PowerVault" are trademarks of Dell Inc.; "Microsoft", "Windows Server", and "Windows" are registered trademarks of Microsoft Corporation; "Intel" is a registered trademark of Intel Corporation; "SUSE" is a registered trademark of Novell, Inc. in the United States and other countries; "Red Hat" is a registered trademark of Red Hat Inc. 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. June 2007 ###################################################################### The software contained in the PowerEdge Diagnostics is an aggregate of third-party programs as well as Dell programs. Use of the software is subject to designated license terms. All software that is designated as "under the terms of the GNU GPL" may be copied, distributed, and/or modified in accordance with the terms and conditions of the GNU General Public License, Version 2, June 1991. All software that is designated as "under the terms of the GNU LGPL" (or "Lesser GPL") may be copied, distributed, and/or modified in accordance with the terms and conditions of the GNU Lesser General Public License, Version 2.1, February 1999.Under these GNU licenses, you are also entitled to obtain the corresponding source files by contacting Dell at 1-800-WWW-DELL. Refer to SKU 420-3178 when making such a request. You may be charged a nominal fee for the physical act of transferring a copy. Some portions of this program may have been compiled and linked using GCC version 3.2.3 Copyright (C) Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. Some portions of this program may have been compiled and linked using GCJ version 3.4.2 Copyright (C) Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. Some portions of this program may have been compiled and linked using GCJ version 3.4.3 Copyright (C) Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. Portions of this program were created using NSIS version 2.22 Copyright (C) 1999-2006 Nullsoft, Inc. Portions of this program were created using Xerces: Copyright (C) 1999-2000 The Apache Software Foundation. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. The end-user documentation included with the redistribution, if any, must include the following acknowledgment: "This product includes software developed by the Apache Software Foundation (http://www.apache.org/)." Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear. 4. The names "Xerces" and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact apache@apache.org. 5. Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without prior written permission of the Apache Software Foundation. THIS SOFTWARE IS PROVIDED ''AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This software consists of voluntary contributions made by many individuals on behalf of the Apache Software Foundation and was originally based on software copyright (c) 1999, International Business Machines, Inc., http://www.ibm.com. For more information on the Apache Software Foundation, please see http://www.apache.org/. ====================================================================== GNU GENERAL PUBLIC LICENSE Version 2, June 1991 ====================================================================== Copyright (C) 1989, 1991 Free Software Foundation, Inc.59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ====================================================================== The MIT License ====================================================================== Copyright (c) 2005 Dell Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ====================================================================== GNU LIBRARY GENERAL PUBLIC LICENSE Version 2, June 1991 ====================================================================== Copyright (C) 1991 Free Software Foundation, Inc. 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. [This is the first released version of the library GPL. It is numbered 2 because it goes with version 2 of the ordinary GPL.] Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This license, the Library General Public License, applies to some specially designated Free Software Foundation software, and to any other libraries whose authors decide to use it. You can use it for your libraries, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library, or if you modify it. For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we gave you. You must make sure that they, too, receive or can get the source code. If you link a program with the library, you must provide complete object files to the recipients so that they can relink them with the library, after making changes to the library and recompiling it. And you must show them these terms so they know their rights. Our method of protecting your rights has two steps: (1) copyright the library, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the library. Also, for each distributor's protection, we want to make certain that everyone understands that there is no warranty for this free library. If the library is modified by someone else and passed on, we want its recipients to know that what they have is not the original version, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that companies distributing free software will individually obtain patent licenses, thus in effect transforming the program into proprietary software. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. Most GNU software, including some libraries, is covered by the ordinary GNU General Public License, which was designed for utility programs. This license, the GNU Library General Public License, applies to certain designated libraries. This license is quite different from the ordinary one; be sure to read it in full, and don't assume that anything in it is the same as in the ordinary license. The reason we have a separate public license for some libraries is that they blur the distinction we usually make between modifying or adding to a program and simply using it. Linking a program with a library, without changing the library, is in some sense simply using the library, and is analogous to running a utility program or application program. However, in a textual and legal sense, the linked executable is a combined work, a derivative of the original library, and the ordinary General Public License treats it as such. Because of this blurred distinction, using the ordinary General Public License for libraries did not effectively promote software sharing, because most developers did not use the libraries. We concluded that weaker conditions might promote sharing better. However, unrestricted linking of non-free programs would deprive the users of those programs of all benefit from the free status of the libraries themselves. This Library General Public License is intended to permit developers of non-free programs to use free libraries, while preserving your freedom as a user of such programs to change the free libraries that are incorporated in them. (We have not seen how to achieve this as regards changes in header files, but we have achieved it as regards changes in the actual functions of the Library.) The hope is that this will lead to faster development of free libraries. The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between a "work based on the library" and a "work that uses the library". The former contains code derived from the library, while the latter only works together with the library. Note that it is possible for a library to be covered by the ordinary General Public License rather than by this special one. GNU LIBRARY GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License Agreement applies to any software library which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Library General Public License (also called "this License"). Each licensee is addressed as "you". A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables. The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term "modification".) "Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library. Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what the Library does and what the program that uses the Library does. 1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with the Library. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) The modified work must itself be a software library. b) You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change. c) You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License. d) If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that, in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its purpose remains meaningful. (For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Library. In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices. Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to all subsequent copies and derivative works made from that copy. This option is useful when you wish to copy part of the code of the Library into a program that is not a library. 4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange. If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not compelled to copy the source along with the object code. 5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License. However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables. When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law. If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative work. (Executables containing this object code plus portions of the Library will still fall under Section 6.) Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself. 6. As an exception to the Sections above, you may also compile or link a "work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications. You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you must do one of these things: a) Accompany the work with the complete corresponding machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application to use the modified definitions.) b) Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in Subsection 6a, above, for a charge no more than the cost of performing this distribution. c) If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the above specified materials from the same place. d) Verify that the user has already received a copy of these materials or that you have already sent this user a copy. For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable that you distribute. 7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities. This must be distributed under the terms of the Sections above. b) Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Library or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it. 10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all. For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Library. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply, and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 13. The Free Software Foundation may publish revised and/or new versions of the Library General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation. 14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS