How to collect IBM DSA log from Linux, ESXi and Windows

Dynamic System Analysis (DSA) is a tool from IBM which collects software and hardware information from a server running IBM Hardware. If you open a ticket with IBM support, they will ask for DSA log from the server in question.

From IBM website:

IBM DSA Portable 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.

DSA collects information about the following aspects of a system:

  • System configuration
  • Installed packages
  • Kernel Modules
  • Network interfaces and settings
  • Performance data and details for running processes
  • Hardware inventory, including PCI & USB information
  • IBM LightPath(TM) status
  • Service Processor status and configuration
  • Vital product data, firmware, and basic input/output system
    (BIOS) information
  • Drive Health Information
  • ServeRAID configuration
  • LSI RAID & Controller configuration
  • Event logs for the operating system, ServeRAID controllers,
    and service processors

To collect DSA logs from a server running Linux, Windows, ESXi and ESX

  • Download the portable DSA
  • Run the utility as root or Administrator
  • Collect the output that looks like 7915AC1_XXXXXXXX_20160316-062400.xml.gz
  • Send it to IBM
  • There is no utility for ESXi but you can run the command from Linux or Windows with the --vmware-esxi user:password@ip-address options.

Collecting DSA logs on Linux
Download the DSA portable version for your Linux distribution.

# export https_proxy=http://proxy.example.com:8080
# wget https://delivery04.dhe.ibm.com/sar/CMA/XSA/04nj9/1/ibm_utl_dsa_dsyte1d-9.61_portable_rhel6_x86-64.bin

Make it executable

chmod +x ibm_utl_dsa_dsyte1d-9.61_portable_rhel6_x86-64.bin

You need to run it as root. If you run it as a normal user, it will complain.

Failed to save log into logfile
Failed to save log into logfile
This system is not supported by this version of DSA. You might need to download an update for DSA  to support this system.
Use the -? or -h parameter for more information about downloading updates.
Do you want to proceed anyway (function may be limited)? (Y/N)y
Logging level set to Status
Copying Schema...
ERROR: You must be logged in with Administrator / root privileges in order to run DSA.

This is what a successful run looks like:

# ./ibm_utl_dsa_dsyte1d-9.61_portable_rhel6_x86-64.bin
IBM Dynamic System Analysis
(C) Copyright IBM Corp. 2004-2014.  All Rights Reserved.
This Program is licensed under the terms of the agreement available by invoking
this utility with the -l option.  By extracting, copying, accessing, or using
the Program, you agree to the terms of this agreement.  If you do not agree to
the terms, please remove the software and return it to IBM or the reseller
from whom you acquired the software for a refund, if any.

Extracting...
Executing...


Logging level set to Status
Copying Schema...
Dynamic System Analysis Version 9.61.E1D

(C) Copyright IBM Corp. 2004-2014. All Rights Reserved.

Running DSA IMM plug-ins pass 1.
   IMM: Integrated Management Module Collector
Running DSA collector plug-ins pass 1.
Running DSA IPMI plug-ins pass 1.
   libinstalledapps: Installed Application Collector
   libfileloader: File Loader
   libdisplayinfo: Display Information Collector
   libnvsmilog: NVIDIA SMI Log Collector
.
.  TRUNCATED
.
Running DSA analyzer plug-ins pass 2.
   liblpanal: Light Path Analysis
Adding DSA log entries to XML file.
Writing XML data to file /var/log/IBM_Support/7915AC1_XXXXXX_20160316-062400.xml.gz

DSA capture completed successfully.

Please press ANY key to continue ...
#

The default location for the output is /var/log/IBM_Support/

# ll /var/log/IBM_Support/
total 1976
-rw-r--r-- 1 root root 1621687 Mar 16 06:24 7915AC1_XXXXX_20160316-062400.xml.gz
-rw-r--r-- 1 root root   92724 Mar 16 06:21 asu_20160316062047.702000+360.log
-rw-r--r-- 1 root root    1254 Mar 16 06:22 cdc_interface.log
drwxr-xr-x 2 root root    4096 Mar 16 06:24 DsaDebugLog
-rw-r--r-- 1 root root    1540 Mar 16 06:45 dsasep.log
-rw-r--r-- 1 root root  294581 Mar 16 06:22 usblancfg.log

Provide the xml.gz file to IBM unless otherwise asked for other files.

To send the output to a different location say /tmp

# ./ibm_utl_dsa_dsyte1d-9.61_portable_rhel6_x86-64.bin  -d /tmp
.. Skipping to the end

Adding DSA log entries to XML file.
Writing XML data to file /tmp/7915AC1_XXXXX_20160316-065200.xml.gz

DSA capture completed successfully.

Please press ANY key to continue ...

Create HTML output files

 # ./ibm_utl_dsa_dsyte1d-9.61_portable_rhel6_x86-64.bin -v  -d /tmp
 .
 .
 .
 Adding DSA log entries to XML file.
Writing XML data to file /tmp/7915AC1_XXXXX_20160316-071100.xml.gz
Writing HTML files to directory /tmp/7915AC1_XXXXX_20160316-071100

Collecting DSA logs on Classic ESX 4
For Classic ESX 4 which has a Service Console based on Linux, the procedure is the same as Linux. You just need to download the portable version for ESX 4.

Collecting DSA logs from ESXi from a remote Linux machine
To collect DSA logs for an ESXi host, run the utility from a Linux machine which has ssh access to the ESXi host. If you have special characters in the password, enclose it within single quotes.

# ./ibm_utl_dsa_dsyte1d-9.61_portable_rhel6_x86-64.bin 
     --vmware-esxi root:'Password!'@esxi.example.com
IBM Dynamic System Analysis
(C) Copyright IBM Corp. 2004-2014.  All Rights Reserved.
This Program is licensed under the terms of the agreement available by invoking
this utility with the -l option.  By extracting, copying, accessing, or using
the Program, you agree to the terms of this agreement.  If you do not agree to
the terms, please remove the software and return it to IBM or the reseller
from whom you acquired the software for a refund, if any.

Extracting...
Executing...


Logging level set to Status
Copying Schema...
Dynamic System Analysis Version 9.61.E1D

(C) Copyright IBM Corp. 2004-2014. All Rights Reserved.


VMWare ESXi Status: Established a connection between the client and esxi.example.com.


*****Runing VMware ESXi : root/brocade namespace*****
Running DSA vmware plug-ins pass 1.
Running DSA vmware plug-ins pass 2.

*****Runing VMware ESXi : root/interop namespace*****
.
. TRUNCATED
.
*****Runing VMware ESXi : mlnx/cimv2 namespace*****
Running DSA vmware plug-ins pass 1.
Running DSA vmware plug-ins pass 2.
Adding DSA log entries to XML file.
Writing XML data to file /var/log/IBM_Support/7945AC1_XXXXX_20160317-062500.xml.gz
Writing HTML files to directory /var/log/IBM_Support/7945AC1_XXXXX_20160317-062500

DSA capture completed successfully.

Please press ANY key to continue ...

#

The output will be available at /var/log/IBM_Support/.

Collecting DSA logs from ESXi from a remote Windows machine
To collect DSA logs from a server running ESXi, run the utility from Windows with the --vmware-esxi option. You need to run it with a user with Administrator privilege.

  • Download portable utility for Windows
  • Open cmd
  • cd to the directory where the command is downloaded
  • Run the command with –vmware-esxi option
    c:ibm_utl_dsa_dsyte1d-9.61_portable_windows_x86-64.exe --vmware-esxi root:'Password!'@esxi.example.com
  • If the password contains special characters, enclose it within single quotes.
  • The output will be saved in C:IBM_Support
  • To send the output to a different location add -d c:DSA_LOGS

Collecting DSA logs on Windows
– Download portable utility for Windows
– Open cmd
– cd to the directory where the command is downloaded
– Run the command with --vmware-esxi option
c:ibm_utl_dsa_dsyte1d-9.61_portable_windows_x86-64.exe
– The output will be saved in C:IBM_Support
– To send the output to a different location add -d c:DSA_LOGS
– As in Linux, the Windows machine should be able to ssh to the ESXi host.

Lets take a look at some of the screenshots from the html output from an IBM X series running ESXi 5.

System Overview

IBM DSA System Overview

Hardware Inventory

IBM DSA Hardware Inventory

Installed Applications

IBM DSA Installed Applications

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s