File Name: dsa_installable_readme.txt ****************************************************************** | | | IBM(R) Dynamic System Analysis (DSA) Installable Edition, | | Version 3.02 | | | | (C) Copyright International Business Machines Corporation | | 2004, 2009. 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. | | | | Updated 1 Apr. 2010 | ****************************************************************** CONTENTS -------- 1.0 Overview 1.1 Product overview 1.2 Prerequisites for systems running Linux 1.3 Compatibility with ServeRAID Manager 1.4 Compatibility with Network Virtual Teaming software 1.5 Compatibility with Service Processors 1.6 Compatibility with Some System 2.0 Installing Dynamic System Analysis 2.1 Performing an attended DSA installation 2.2 Performing an unattended DSA installation 3.0 Uninstalling Dynamic System Analysis 4.0 Running Dynamic System Analysis 4.1 Running DSA from the Start menu 4.2 Running DSA from a command prompt 5.0 Using DSA command-line options 5.1 Sending DSA output to IBM xSeries Service and Support 5.2 Using DSA with UpdateXpress 5.3 Running DSA Diagnostics 6.0 Accessing and viewing DSA output 6.1 Naming convention used for output files and directories 6.2 Viewing a compressed collection file 6.3 HTML files created by DSA 7.0 Sending DSA output to IBM xSeries Service and Support 7.1 Sending DSA output via ftp 7.2 Sending DSA output via HTTPS 8.0 Collecting Remote System info via VMWare ESXi 3i 9.0 Collecting IPMI event of remote system 10.0 Using DSA with UpdateXpress 11.0 Known problems and workarounds 12.0 Support Web sites 13.0 Notices 14.0 Third-party license terms and conditions, notices and information 14.1 zlib software 14.2 boost software 1.0 OVERVIEW ------------- This readme file provides information about IBM Dynamic System Analysis (DSA) Installable Edition, version 3.0. 1.1 Product overview --------------------- IBM DSA Installable Edition 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. This software can be used while the operating system is running. DSA collects information about the following aspects of a system: o System configuration o Installed packages o Kernel Modules o Network interfaces and settings o Performance data and details for running processes 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 (BIOS) information o Drive Health Information o ServeRAID configuration o LSI RAID & Controller configuration o Event logs for the operating system, ServeRAID controllers, and service processors Additionally, DSA creates a merged log that includes events from all collected logs. DSA also can compare the firmware configurations on a server to those from UpdateXpress. For more information, see "5.2 Using DSA with UpdateXpress." The system information is collected into a compressed XML file that can be sent to IBM Service. Additionally, you can view the system information through optionally generated HTML Web pages. For more information, see "6.0 ACCESSING AND VIEWING DSA OUTPUT." If you want to run DSA without installing it, use DSA Portable Edition, which is designed to fit on removable media such as a CD or USB key. Server support list: X206m (8485, 8490) X236 (8841) X260/x3800 (8865, 8866) X306m (8849, 8491, 1887) X336 (8837) X336 (1879) X346 (8840, 1880) X366/x3850 (8863, 8864, 7362, 7365) X460/x3950 (8872, 8878, 7363, 7366) X3200 (4362, 4363) X3200M2(4367, 4368) X3200M3(7327, 7328) X3250 (4364, 4365, 4366) X3250M2(4190, 4191, 4194) X3250M3(4251, 4252) X3350 (4192, 4193) X3400/x3500 (7973, 7974, 7975, 7976, 7977) X3450(7948, 7949, 4197) X3455(7940, 7984, 4197, 7941, 7986) X3400M2(7836, 7837) X3500M2(7839) X3550 (7978, 1913) X3550 M2 (7946, 4198) X3650 (7979, 1914) X3650 M2 (7947, 4199) X3655 (7985, 7943) X3755 (8877, 7163) X3850M2 Single node (7141, 7144, 7233, 7234) X3950M2 Single node (7141, 7233) X3950M2 Dual node (7141, 7233) X3950M2 3~4 Node (7141, 7233) iDataplex dx320(6388) iDataplex dx340(7831, 7832, 7834) iDataplex dx360(7833) iDataplex dx360M2(6380, 7321, 7322 ) Smart Business (9233) Lotus Foundations Server (9234) Z40 (9228) M40 (6218, 9236) M50 (9229, 9230) HS12(8014, 8028, 1916) HS20 (8843, 1883) HS21 (8853, 1885) HS21 (7995) HS21 XM(1915) LS20 (8850) LS21/LS41 (7971, 7972) LS22/LS42 (7901, 7902) HS22(7870, 1936, 7809) The following system support requires update packs: (See instructions on --chkupd and --update in this document) HS22V (7871,1949) x3550M3 (7944,4254) x3650M3 (7945,4255) x3400M3 (7378,7379) x3500M3 (7839) dx360M3 (6391) Operation System support list: [Windows 2008 family] Windows Server 2008 R2 (64bit) Windows Server 2008 GA/SP1 (32 and 64bit) (Including the Windows Core Server installation mode) Windows Small Business Server 2008 (64 bit) Windows Essential Business Server 2008 (64-bit) Windows Hyper-V Server Windows Vista Business GA/SP1 (32 and 64 bit.) Windows HPC Server 2008 (64-bit) [Older Windows family] Windows Server 2003 GA/SP1 (32 bit and 64 bit) Windows Server 2003 R2 (32 bit and 64 bit) Windows Small Business Server 2003 R2 Windows XP GA-SP3 (32 bit and 64 bit) [SUSE] SuSE Linux Enterprise Server (SLES) 9.0 GA-SP3 (32 bit and 64 bit) SuSE Linux Enterprise Server (SLES) 10 GA-SP3 (32 bit and 64 bit) SuSE Linux Enterprise Server (SLES) 10 with Xen GA-SP3 (32 bit and 64 bit) SuSE Linux Enterprise Server (SLES) 11 (32 bit and 64 bit) SuSE Linux Enterprise Server (SLES) 11 with Xen (32 bit and 64 bit) SuSE Linux Enterprise Real Time 10 (32bit and 64bit) [RedHat] RedHat Enterprise Linux 5 GA-U4 (32 bit and 64 bit) RedHat Enterprise Linux 5 GA-U4 with Xen (32 bit and 64 bit) RedHat Enterprise Linux Real Time 5.1 (32bit and 64bit) RedHat Enterprise Linux 4 GA-U6 (32 bit and 64 bit) RedHat Enterprise Linux 3 GA-U9 (32 bit and 64 bit) [VMware] VMWare ESX Server 4.0 VMware ESX Server 3.x (Up to 3.5) VMWare ESXi 4.0 VMware ESXi 3.5 U2 or later Note: RHEL3 32bit build is used for use on VMware ESX Server 3.x console. RHEL5 64bit build is used for use on VMWare ESX Server 4.x console. 1.2 Prerequisites for systems running Linux --------------------------------------------------- Installation of DSA requires 30MB of disk space. DSA requires above 250MB of available memory during the data collection process. The amount of memory required for this process depends on the size of the logs being collected from the system. To view the information that is collected by DSA, you must use Internet Explorer 6.0 SP 1 or later, Mozilla 1.4.0 or greater, or Firefox 1.04 or greater In order to display the DSA data, 30 to 100MB of available memory is required. The amount of memory required depends on the size of the logs being viewed. In order to collect SCSI & USB device information, including diagnostics, the "sg" driver must be loaded. Run "lsmod" and verify that "sg" is loaded before running DSA. If it is not loaded, run "modprobe sg". In order to collect Broadcom(TM) Ethernet firmware levels, the Broadcom(TM) NetXtreme Gigabit Ethernet Drivers must be installed. The tg3 driver provided by default in current Linux distributions does not export this information. These drivers are available for download from the IBM Support website at: http://www.ibm.com/support In order to collect LSI Logic(TM) 1020/1030 SCSI Controller & RAID information, the "mptctl" driver must be loaded. Run "lsmod" and verify that "mptctl" is loaded before running DSA. If it is not loaded, run "modprobe mptctl". In order to collect Emulex HBA information, emulex driver and utility (corekit) must be installed. Run "lsmod" and verify that "lpfc" and "lpfcdfc" is loaded before running DSA. In order to collect Service Processor logs, configuration, and environmental data the appropriate Service Processor driver must be installed. These drivers are available from the IBM Support website. DSA requires libcurl to be installed in order transfer data collections to the IBM Support site via FTP. Use of the UpdateXpress comparison analysis feature requires that an Internet connection be available for the system on which the analysis is performed. Notes: o The UpdateXpress comparison analysis feature will only support System Firmware comparisons including BIOS, Diagnostics, and Service Processor. Device drivers will not be compared in this release, due to limitations with UpdateXpress. It is strongly recommended to have the appropriate service processor device drivers installed and running before running DSA. This provides access to additional problem determination information including the hardware event logs. For a machine equipped with a Baseboard Management Controller (BMC) the appropriate drivers are the IPMI device driver and mapping layer. If the machine has a Remote Supervisor Adapter II (RSA II) please use the Remote Supervisor Adapter Daemon. For all supported service processors including the older Remote Supervisor Adapter (RSA) or Integrated Systems Management Processor please refer to the IBM Support site for suitable downloads: http://www-304.ibm.com/jct01004c/systems/support/supportsite.wss/brandmain?brandind=5000008 In order to collect ServeRAID info of ServeRAID controller 7t,8i,8k-l,8k,8s on Redhat5 and Sles11 OS, user need to insall libstdc++.so.5 on Redhat5 and Sles11 platform. Notes: Since ServeRAID tool - arcconf is 32bit, user needs to install libstdc++.so.5 32bit on Redhat5 and Sles11 64bit platform. 1.3 Compatibility with ServeRAID Manager ----------------------------------------- DSA can collect ServeRAID log information from ServeRAID Manager 6.10 and later versions. DSA cannot collect information from the following ServeRAID controllers unless ServeRAID Manager is installed: o ServeRAID-7t SATA RAID o ServeRAID-8i o ServeRAID-8k o ServeRAID-8k-l o ServeRAID-8s 1.4 Compatibility with Network Virtual Teaming software ----------------------------------------- DSA Installable Edition is supported for use with the following Network Virtual Teaming software: o Linux Bonding versions 2.4.1, 2.6.0, & 2.6.1 1.5 Compatibility with Service Processors ------------------------------------------ Environmental data is available from servers which have an Integrated Management Module (IMM), Remote Supervisor Adapter 2 (RSA2) , Remote Supervisor Adapter (RSA) or Integrated System Management Processor (ISMP) . In all cases appropriate support software must be loaded and running. 1.6 Compatibility with Some System ------------------------------------------ The following machine types have not been fully verified by IBM test for complete DSA operation . All major functions have been tested and confirmed as available. iDataplex(6388,7831,7832,7834, 7833)and x3450(7948,7949,4197). 2.0 INSTALLING DYNAMIC SYSTEM ANALYSIS --------------------------------------- DSA Installable Edition is installed on one or more supported servers. It can be installed directly on a supporting server using the installable package. Note: DSA Installable Edition for Linux doesn't execute on a VMFS folder. Use Installable Edition for Red Hat Enterprise Linux 5 x64 build on VMWare ESX Server 4.x. Use Installable Edition for Red Hat Enterprise Linux 3 x86 build on VMWare ESX Server 3.x. DSA only excutes on the VMWare service console and it doesn't support execution on any guest operating system on virtual machines. 2.1 Performing an attended DSA installation -------------------------------------------- Complete the following steps to perform an attended installation of DSA Installable Edition on a system running Linux. These steps are for a typical installation. Note: User should log in as "root" in order to execute DSA. 1. Download the DSA Installable Edition rpm file. 2. Install the DSA Installable Edition rpm using the following commandline: rpm -ivh .rpm 3. The install will proceed and place the package in the /opt/IBM/DSA directory. Note: If a previous version of DSA is already installed, a message will be displayed indicating a conflict. You will need to uninstall the previous version in order to upgrade to DSA 3.0. 3.0 UNINSTALLING DYNAMIC SYSTEM ANALYSIS ----------------------------------------- Complete the following steps to perform an uninstallation of DSA. 1. Open a linux command shell. 2. Uninstall the DSA Installable Edition rpm using the following commandline: rpm -e 3. The uninstall will proceed and remove the package from the /opt/IBM/DSA directory. 4.0 RUNNING DYNAMIC SYSTEM ANALYSIS ------------------------------------ DSA Installable Edition can be run from a linux shell prompt. 4.1 Running DSA from Linux -------------------------------------- The DSA executable file is collectall. It is installed in the following directory: /opt/IBM/DSA Complete the following steps to run DSA from a linux shell: 1. Change to the /opt/IBM/DSA directory. 2. Type ./collectall 3. (Optional) Type DSA command-line options after the executable file name. For more information, see "6.0 USING DSA COMMAND-LINE OPTIONS." DSA will begin collection. When DSA is completed, collectall exits. For information about the DSA results, see "7.0 ACCESSING AND VIEWING DSA OUTPUT." If you ran DSA without any options, DSA collects information into one compressed XML file that can be sent to IBM Service. For information about sending the file to IBM Service, see "6.1 Sending DSA output to IBM Service and Support." 5.0 USING DSA COMMAND-LINE OPTIONS ----------------------------------- The command-line syntax in this document uses the following conventions: o Options are shown with a hyphen (-). o Options are shown as lowercase, but are not case-sensitive. o Variables are shown in angle brackets. DSA has the following command-line options: Options: -?, -h Display help for DSA command-line options. -b Run in batch mode. -c Create directory specified by -d option. -d Place DSA output files in the specified directory rather than in the default location, which is C:\IBM_Support. -diags Execute all non-destructive diagnostic tests. -f Collect the full ISMP log. -i Read input from rather than collecting data from the local server. -ipmilan Collect IPMI log via Out-Of-Band mode. -l Display license and exit. -t Transfer collected data to IBM Service & Support. -ux Compare the installed and latest version of firmware levels. -v Create HTML output files. -vmwesxi <[userid]:[password]@[IP]:[port]> Retrieve system information from the remote target system loaded with VMWare Embedded Hypervisor. -text Create TEXT output files. -x Do not create a compressed XML file. -r Run the CIM difference engine comparing the collected or specified (via -i) data to this file. -dumpxml Write the DSA .xml.gz file after each plugin runs. -upload Upload DSA output to SRSP and ISP by ecc common client C++ API . NO SUPPORT FOR PPC. -ibmid User provides his/her IBM Identifier. Work with -upload. --chkupd Detect if there are available DSA updates on internet. --update Acquire available DSA updates from internet. Note: All options must be separated with one or more spaces. For example, to run DSA and generate HTML output files that can be viewed with a browser: ./collectall -v To run DSA, and create HTML output files in the directory /usr/foo/DSA_Output, run this command: ./collectall -v -c -d /usr/foo/DSA_Output 5.1 Sending DSA output to IBM xSeries Service and Support ---------------------------------------------------------- Use the -t option to send the collected data to IBM xSeries Service and Support. DSA uses File Transfer Protocol (FTP) to transfer the compressed XML output file to IBM Service. For example, the following command collects data and sends it to IBM Service: ./collectall -t If you already have a compressed XML output file from DSA that you want to send to IBM Service, run DSA from a command prompt and use the -i option with the -t option. The -i option requires that you specify a fully qualified path name to the compressed XML output file from DSA. For example, the following command sends the specified output file to IBM Service: ./collectall.exe -t -i /var/log/IBM_Support/.xml.gz where is the name of a compressed XML file that was previously created by DSA. For example, an output file could be named 86865RZ_23D0600_20041004-190308.xml.gz. 5.2 Using DSA with UpdateXpress -------------------------------- Use the -ux option to Compare the installed and latest version of firmware levels. Internet access is required. When you do so, DSA compares the device driver and firmware configurations on the server to those that were extracted from the eCC Repository. When the -v option is used to create HTML files, you can view the results of the comparison from the DSA home page. To do so, click "UpdateXpress Comparison" in the Analysis category in the left pane of the DSA home page. For more information about the DSA home page, see "7.3 HTML files created by DSA." 5.3 Running DSA Diagnostics --------------------------- Use the -diags option to execute diagnostics during the DSA collection process. This option will execute all of the non-destructive diagnostic tests that are included with DSA. An additional command-line utility, rtdcli, is included with DSA Installable Edition that provides more control over the execution of the diagnostic tests. rtdcli has the following command-line options: rtdcli [-options] commands: run - Runs all tests tests - Lists installed tests devices - Lists devices and associated tests help - Displays this message options: -d - Specifies a device for the "run" commmand -t - Specifies a test for the "run" commmand -x - Enables the execution of destructive tests Note: Device and test names that contain spaces must be enclosed in parenthesis. Example: rtdcli devices -d "DVD-ROM 0" 6.0 ACCESSING AND VIEWING DSA OUTPUT ------------------------------------- By default, DSA output is created in the /var/log/IBM_Support directory. Use the -d option to specify a different output directory. When DSA is run from a command prompt with no command-line options, it creates only a compressed XML file in the IBM_Support directory. When DSA is run with the -v option, it creates a subdirectory that contains HTML files that you can view with a Web browser. 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 that it creates: __-