File Name: dsa_preboot_readme.txt ****************************************************************** IBM(R) Preboot Dynamic System Analysis (DSA) Version 9.41 (C) Copyright International Business Machines Corporation 2004, 2013. 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 under "NOTICES" in this document. This readme file is provided only in English. You can obtain the latest version of the readme file from the IBM Support Web site. ****************************************************************** CONTENTS -------- 1.0 Overview 1.1 Product overview 1.2 Prerequisites for running Preboot DSA 1.3 Compatibility with ServeRAID 2.0 Running Dynamic System Analysis 3.0 Using the DSA Main Menu 4.0 Using the DSA Interactive Menu 5.0 Using the DSA Graphical User Interface 6.0 Accessing and viewing DSA output 6.1 Naming convention used for output files and directories 6.2 HTML files created by DSA 7.0 Sending DSA output to IBM xSeries Service and Support 8.0 Known problems and workarounds 9.0 Support Web sites 1.0 OVERVIEW ------------- This readme file provides information about IBM Preboot Dynamic System Analysis (pDSA). 1.1 Product overview --------------------- IBM Preboot DSA is a system information collection and analysis tool that is used by IBM xSeries(R) Service and Support personnel to aid in the diagnosis of system problems. DSA collects information about the following aspects of a system: o System configuration o Network interfaces and settings o Hardware inventory, including PCI & USB information o IBM LightPath(TM) status o Service Processor status and configuration o Vital product data, firmware, and basic input/output system o (BIOS) information o Drive Health Information o ServeRAID configuration o LSI RAID & Controller configuration o Scalability/RXE Ports configuration o Emulex Fibre Channel configuration o QLogic Fibre Channel & iSCSI Adapter configuration o LSI InternalRaid Adapter configuration o LSI MegaRaid Adpater configuration o Event logs for ServeRAID controllers and service processors o Logs of correctable and uncorrectable error NVRAM o VMware ESXi EH Information o GoVault Tape Drive information o Disk Management information o MAX5 Memory Expansion Unit DSA can also provide diagnostics for the following system components (if they are installed on the system): o Network, BroadCom NetXtreme II(5703,5708,5709,5714 and 5722 NIC) o Optical devices (CD-ROM, DVD-ROM) o Tape Drives (SCSI) o Remote Supervisor Adapter o Base Board Management Controller o Memory o CPU o Check-point panel test o Hard Drive test Additionally, DSA creates a merged log that includes events from all collected logs. All collected information can be output as a compressed XML file that can be sent to IBM Service. You can customize the FTP to transfer. You can also view the information locally through a generated text report file. The generated HTML pages may be copied to removable media and viewed from a web browser. Server support list: x3100 M4 (2582) x3200 M2 (4367, 4368) x3200 M3 (7327, 7328) x3250 M2 (7657, 4190, 4191, 4194) x3250 M3 (4251, 4252, 4261) x3250 M4 (2583) x3300 M4 (7382) x3400 M2 (7836, 7837) x3400 M3 (7378, 7379) x3500 M2 (7839) x3500 M3 (7380) x3500 M4 (7383) x3530 M4 (7160) x3550 M2 (7946, 4198) x3550 M3 (7944, 4254) x3550 M4 (7914, 7383) x3620 M3 (7376) x3630 M3 (7377) x3630 M4 (7158, 7519) x3650 M2 (7947, 4199) x3650 M3 (7945, 4255, 5454) x3650 M4 (7915) x3690 X5 (7147, 7148, 7149, 7192) x3750 M4 (8722, 8733) x3755 M3 (7164) x3850 X5 (7143, 7145, 7146, 7191) x3950 X5 (7143, 7145, 7146,7191) iDataplex dx360 M2 (7321, 7323) iDataplex dx360 M3 (6391) iDataplex dx360 M4 (7912, 7913, 7918, 7919) Smart Analytics System (7949) HS22 (7870, 1936, 7809, 1911) HS22V (7871, 1949) HS23 (7875, 1929) HS23E (8038, 8039) HX5 (1909, 1910, 7872, 7873) Flex System x240 Compute Node (8737, 8738, 7863) Flex System x220 Compute Node (7906, 2585) Flex System x440 Compute Node (7917, 2584) xc360 M4 (5455) x3250 M5 (5458) Supported Server Options o Ethernet adapter Broadcom 1Gb Ethernet CFFh Expansion Card Broadcom 10Gb Ethernet CFFh Expansion Card for IBM BladeCenter Broadcom Netextreme II Ethernet Expansion Card (CIOv) for IBM BladeCenter 2/4 Port Ethernet Expansion Card (CFFh) for IBM BladeCenter NetXtreme II 1000 Express Quad port Ethernet Adapter NetXtreme II 1000 Express Dual Port Ethernet Adapter Broadcom 10Gb BaseT dual port NIC Broadcom Dualrunner/ Quad-Runner NetXtreme I Broadcom 1Gb 4 port Mezz Card Tier 1 Emulex 10GbE vNIC w/ BE3 Chipset Emulex 2-Port 10Gb Multi-function IO Adapter (CFFh) for IBM BladeCenter (vNIC) Emulex 10Gb 4 port Mezz card with FCoE/iSCSI key for System X Tier 1 Emulex 2+2 10Gb (CFFh) for IBM BladeCenter (vNIC) Emulex Dual Port 10GbE SFP+ Embedded Adapter Emulex Virtual Fabric Adapter II for HS23 iSCSI and FCoE upgrade IBM NetXtreme II 1000 Express Ethernet Adapter Intel 10GB SFP+ NIC Intel X540-T2 Dual Port 10GBase-T Adapter for IBM System x o Fibre Channel adapter Emulex 4G FC exp. card Emulex 4G SFF FC exp. Emulex 4Gb/s FC PCI Express HBA (lpe11000/lpe11002) Emulex 4Gb/s FC PCI-X 2.0 HBA (lp11000/lp11002) Emulex 8Gb FC Single-port HBA for IBM System x Emulex 8Gb FC Dual-port HBA for IBM System x Emulex 10Gb/s Fibre Channel over Ethernet Dual Channel Converged Network Adapter Emulex PCI-e Gen2.0 Dual Port 10Gb NIC Emulex 2-Port 10Gb Multi-function IO Adapter Emulex 16Gb FC Single/Dual-port HBA Emulex 8Gb FC Mezz card QLogic 4G/8G FC CFF exp. card QLogic 4G/8G SFF FC exp. card QLogic 2-Gbps Fibre Channel HBA QLogic 4G and 8G FC single port HBA QLogic 4G and 8G FC dual port HBA QLogic iSCSI PCIe HBA QLogic iSCSI PCIe dual port HBA Qlogic 10Gb FCoE Dual Port Qlogic 10GbE CFFh DC Qlogic 8Gb FC 2 port mezz card Tie 1 for IBM Flex System QLogic Dual Port 10GbE SFP+ Embedded Adapter for IBM System x Qlogic 8200 Dual Port 10GbE SFP+ Adapter Brocade 4 Gb FC Single-port HBA Brocade 4 Gb FC Dual-port HBA Brocade 8Gb FC Single-port HBA Brocade 8Gb FC Dual-port HBA Brocade 10Gb CNA Brocade 10Gb Dual-port CNA Brocade 2-port 10Gb Converged Network Adapter Brocade 16Gb FC 2 port Mezz Card Tier 2 Brocade 16Gb FC Single/Dual-port HBA IBM SAS HBA controller LSI 1068 SAS HBA o Network adapter IBM 10 GbE PCIe SR Server Adapter IBM NetXtreme II 10 GigE Express Fiber SR Adapter Intel PRO/1000 PT Dual Port Server Adapter (no diagnostic support) Intel PRO/1000 PT Quad Port Server Adapter (no diagnostic support) Intel PRO/1000 PF Server Adapter (no diagnostic support) Intel QuadPort Ethernet Server Adapter (no diagnostic support) CFFh Intel Ethernet Adapter (no diagnostic support) Intel 10GB SFP+ NIC Intel X540-T2 Dual Port 10GBase-T Adapter for IBM System x Intel x520 Dual Port 10GbE SFP+ Embedded Adapter o RAID adapter Adaptec IBM ServeRAID 6i + Adaptec IBM ServeRAID 7k Adaptec IBM ServeRAID 7t Adaptec IBM ServeRAID 8i, 8k, 8k-l and 8s LSI MR 10is LSI IR 1078, 1064, 1064e and 1068e LSI MegaRAID 8480 LSI ServeRAID MR 10i, 10ie, 10is, 10k and 10m LSI ServeRAID M1015, M5014, M5015 and M5025 LSI ServeRAID M1110, M1115, M5016, M5110, M5110e, M5120 and M5115 LSI ServeRAID H1110, H1135 LSI ServeRAID M1100 Upgrade, M5100 Upgrade LSI ServeRAID B5015 LSI RAID 0//10 FDE SAS-2 6GB LSI ServeRAID C105 Shikra, IBM Flex System Storage Mezzanine Expansion (SME) o Tape drive IBM DDS5 36/72 SCSI IBM DDS5 36/72 USB IBM DDS5 36/72 SATA IBM DDS6 80/160 USB IBM LTO2 HH 200/400 SCSI IBM LTO2 FH 200/400 SCSI IBM LTO3 HH 400/800 SAS IBM LTO3 FH 400/800 SCSI IBM LTO4 HH 400/800 SAS IBM LTO5 HH 400/800 SAS IBM VS160 tape drive IBM GoVault tape drive IBM RDX 160/320/500 GB External/Internal USB 3.0 Drive o Daughter card cKVM Daughter Card for IBM BladeCenter LSI BR10i, BR10ie, BR10il o BPE-4 o GPU nVIDIA Quadro (4000, 5000, 6000, 600) nVIDIA Tesla (M2090, M2090update, X2090, X2090Update) nVIDIA "Gemini" Kepler GPU (K10) 1.2 Prerequisites for running Preboot DSA ---------------------------------------------------- Preboot DSA requires: o A minimum of 1GB of system memory. o A USB interface or an optical drive capable of reading the Bootable media. 1.3 Compatibility with ServeRAID Manager Logs ----------------------------------------- Preboot DSA will collect configuration data from the following ServeRAID controllers on supported server models. However, ServeRAID Manager logs will not be collected. o ServeRAID 4,5,6,7k o ServeRAID-7t SATA RAID o ServeRAID-8i, 8k and 8k-l 2.0 RUNNING DYNAMIC SYSTEM ANALYSIS ------------------------------------ Complete the following steps to run Preboot DSA. For Embedded Preboot DSA: 1. If the server is running, turn off the server and all attached devices. 2. Turn on all attached devices; then, turn on the server. 3. When the prompt F2 for Dynamic System Analysis (DSA) appears, press F2. If you have set both a power-on password and an administrator password, you must type the administrator password to run the diagnostic programs. 4. A standalone memory diagnostic environment will load. Select the appropriate tests to run or select exit to DSA to exit the standalone memory diagnostic. 5. From the DSA main screen, select the "gui" or "cmd" options to enter the graphical user interface or the DSA interactive menu respectively. 6. Follow the on screen directions to select the device and tests to launch. For ISO-based Preboot DSA: 1. Record ISO image to appropriate recordable media. 2. If the server is running, turn off the server and all attached devices. 3. Turn on all attached devices; then, turn on the server. 4. Boot the machine using the DSA Bootable Edition media. 5. A standalone memory diagnostic environment will load. Select the appropriate tests to run or select exit to DSA to exit the standalone memory diagnostic. 6. From the DSA main screen, select the "gui" or "cmd" options to enter the graphical user interface or the DSA interactive menu respectively. 7. Follow the on screen directions to select the devices and tests to launch. For more information on using the interactive menu, see "4.0 USING THE DSA INTERACTIVE MENU." DSA collects information into a compressed XML file that can be sent to IBM Service. For information about sending the file to IBM Service, see "7.0 SENDING DSA OUTPUT TO IBM XSERIES SERVICE AND SUPPORT." DSA also collects information in ASCII text and HTML report files, For information about viewing the collected data see "6.0 ACCESSING AND VIEWING DSA OUTPUT." NOTE: 1. ONCE THE STANDALONE MEMORY DIAGNOSTIC GETS ANY ERROR THE STANDALONE MEMORY DIAGNOSTIC EXITS EXECUTION IMMEDIATELY. 2. THE STANDALONE MEMORY DIAGNOSTIC ONLY PASSES LAST TEST RESULT TO DSA NO MATTER HOW MANY LOOPS HAVE BEEN RUN. 3. ONCE THE STANDALONE MEMORY DIAGNOSTIC ENVIRONMENT HAS BEEN EXITED THE STANDALONE MEMORY DIAGNOSTIC ENVIRONMENT CANNOT BE RE-ENTERED WITHOUT A SYSTEM REBOOT. 3.0 Using the DSA Main Menu ---------------------------- The preboot DSA main menu has the following options: For Embedded Preboot DSA: Commands: gui - Enter Graphical User Interface (GUI) screen for diagnostic tests and DSA functionality. cmd - Enter Command Line Interface (CLI) for diagnostic tests and DSA functionality. exit - Quit program. Note: This will eject the CD (if booted from CD) and reboot the system. help - Display this help message. After the system is booted with the image created by Bootable Media Creator (BoMC), there are 2 options: CLI and GUI mode. User may choose the mode by using their mouse. Choosing CLI, user will be led to the interactive menu. Choosing GUI, user will be led to the Graphic User Interface. 4.0 USING THE DSA INTERACTIVE MENU ----------------------------------- The DSA Interactive menu has the following options: IBM DSA Interactive. 1 - Data Collection. 2 - Diagnostics. 3 - Features on Demand (FoD). 4 - Copy Collected System Information to Local Media. 5 - Send Collected System Information to IBM Server or Customized FTP server. Q - Quit and back to main menu. Enter Number: On entering number "1" Data Collection: 1 - Collect System Information. 2 - View Collected Results. (Note: To exit viewer, type :q or ZZ then press enter) Q - Quit to previous menu. On entering number "2" Diagnostics: 1 - Execute Diagnostic Test. 2 - View Diagnostic Results. Q - Quit to previous menu On entering number "3" Features on Demand (FoD): 1 - FoD Feature(s) on IMM. 2 - FoD Feature(s) on CMM. 3 - Fod Feature(s) on IOM/Switch. Q - Quit to previous menu. NOTE: FOR REMOTE ACCESS VIA SOL (SERIAL OVER LAN), COMMAND LINE INTERFACE IS THE ONLY INTERFACE SUPPORTED. 5.0 Using the DSA Graphical User Interface ------------------------------------------ The following features can be accessed via the GUI: o System Inventory - Show detailed information about your system. o Diagnostic - Run diagnostic tests on system components. o Collect Logs and Transfer - Collect, copy and send the system information to IBM for analysis. o Help - Display the DSA readme file (Includes open source statements). o Exit - Quit the utility. 6.0 ACCESSING AND VIEWING DSA OUTPUT ------------------------------------- When DSA is run, it creates a compressed XML file, an ASCII text report file, and a set of HTML report files. The text report file can be viewed from the DSA interactive menu using the "view" command. To view collected data via the GUI, select the System Information button on the main page and choose a category of data to view. The compressed XML and HTML report files can be copied to removable media for remote viewing using the "copy" command on the DSA main menu. Regarding CPU information, the information of physical processors is shown under: - Hardware Inventory -> Processor The information for logical processors is shown under: - Hardware Inventory -> Other Devices NOTE: With hyper-threading turned on there will be more logical processors shown than physical processors. 6.1 Naming convention used for output files and directories ----------------------------------------------------------- DSA uses the following naming convention for compressed XML files and for subdirectories and reports that it creates: __-