SASDIAG Diagnostic Utility for the IBM SAS HBA Controller for Linux NOTE TO SERVICE - Reference RETAIN N/A (C) Copyright International Business Machines Corporation 1999, 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Note: Before using this information and the product it supports, read the general information in "Notices and trademarks" in this document. CONTENTS ________ 1.0 Overview 2.0 Installation and setup instructions 3.0 Configuration information 4.0 Unattended mode 5.0 Web information and support phone Number 6.0 Notices and trademarks 7.0 Disclaimer 1.0 Overview _____________ 1.1 SASDIAG Diagnostic Utility for the IBM SAS HBA Controller for Linux This Diagnostic verifies the target hardware. The various tests include: - Valid Device - BIOS & FW test - PCI Configuration Space test - MPT Configuration Page test - Persistent Configuration Page test - firmware activity test - Valid Topology tests - Current System Topology vs Golden Topology test - R/W buffer tests - IR volume tests - Firmware Download Boot All output is generated to a user specified log file. If the user does not specify a log file name, the logs be written to the default filename, "datalog.log". If a file of the same name already exists, a separator will be inserted at the end of the file and the new test data will be appended. A basic status will be displayed on the screen. 1.2 Limitations - If you are using this utility with Red Hat Enterprise Linux 3, you must be running Update 4 or later. 1.3 Problem(s) fixed: - See change history for more details. 1.4. Level of Recommendations and Prerequisites for the update: - none 1.5 Dependencies - One blank diskette or USB key. 1.6 Update Contents - The following files are associated with this update: o ibm_utl_mptsas_sasdiag-3.08_linux_noarch.zip - Zip file for creating the SAS Diagnostic test for the IBM SAS Controller for Linux o ibm_utl_mptsas_sasdiag-3.08_linux_noarch.chg - Change history 2.0 Installation and setup instructions ________________________________________ To create a diskette use the following procedure: 1. Open the zip file with an application that supports this type of compression. 2. Insert the applicable media into an internal or USB floppy drive or CD drive, or use a USB key. 3. Extract the file to the media or USB key Requirements 1. The utility is invokable from a shell, a shell script, or a perl script. 3.0 Configuration information ______________________________ Usage: sasdiag [Options] Options Description -o Output Level - Each display level includes all previous levels of output Level 0: DEFAULT. No output logged, only error code is return Level 1: Output test error messages Level 2: Output individual test status Level 3: Output test warning messages Level 4: Output test information messages Level 5: Output register hex dump information -r Hex value to enable or disable specific tests - Default is 0xff which runs all tests except IR Volume test and Firmware Download Boot test. 0x001 = Enable Valid Device, BIOS & Firmware test 0x002 = Enable PCI Configuration Space test 0x004 = Enable MPT Configuration Page test 0x008 = Enable Persistent Configuration Page test 0x010 = Enable Firmware activity test 0x020 = Enable Valid Topology test 0x040 = Enable Golden Topology test 0x080 = Enable Read/Write Buffer test 0x100 = Enable IR Volume test 0x200 = Enable Firmware Download Boot test The hex values are additive, as in the following examples. Example: -r22 runs PCI Configuration Space test and Valid Topology test Example: -r0x200 runs Firmware Download Boot test -p Specify a single controller to test. Use the PCI Bus/Dev/Function value to specify the controller Example: -p0x01 0x0A 0x00 test the controller at Bus 0x01 Device 0x0A and Function 0x00 -f Specify output logfile filename. If this is not specified the default filename, "datalog.log", will be used. -g Specify Current topology filename. Current topology will be saved in the specified file. -m Execution Mode Selection - Default is 0. 0 - Exit on first failure. 1 - Do not exit on failures. 4.0 Unattended Mode ____________________ N/A 5.0 Web information and support phone number _____________________________________________ 5.1 IBM Support Web Site: http://www.ibm.com/support/. You can receive hardware service through IBM Services or through your IBM reseller, if your reseller is authorized by IBM to provide warranty service. See http://www.ibm.com/planetwide/ for support telephone numbers, or in the U.S. and Canada, call 1-800-IBM-SERV (1-800-426-7378). In the U.S. and Canada, hardware service and support is available 24 hours a day, 7 days a week. In the U.K., these services are available Monday through Friday, from 9 a.m. to 6 p.m. 5.2 IBM eserver xSeries Web Site: http://www.ibm.com/eserver/xseries 5.3 If you have any questions about this update, or problems applying the update, go to the following Help Center World Telephone Numbers and URL: http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html. 6.0 Notices and trademarks ___________________________ 6.1 The following terms are trademarks of the IBM Corporation in the United States, or other countries or both: * IBM Other company, product, and service names may be trademarks or service marks of others. 7.0 Disclaimer _______________ 7.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. .