DSA command

Description

To run this command on a system running Windows, change to the directory where Dynamic System Analysis was installed (for example, C:\Program Files\IBM\DSA). Use the ibm_utl_dsa_v.r.m_portable_platform.exe command.

To run this command on a system running Linux, use ibm_utl_dsa_v.r.m_portable_platform.

If no options are specified, this command collects and saves information in a compressed XML file in the installation_directory\IBM_Support\ on Windows systems or/var/log/IBM_Support on Linux systems. This file contains the collected data and the consolidated property specification documents from each collector that collects data. The file is named mtm_serialnumber_datetime.xml.gz, where mtm is the machine type and model number of the local system, serialnumber is the serial number of the local system, and datetime is the date and time that data was collected. If Dynamic System Analysis cannot obtain a valid machine type, model number, or serial number of the system, any resultant output file and subdirectory will use the string "Unknown" in place of these values.

For more information about the standard of CIM-XML specifications, see the Distributed Web-Based Enterprise Management (WBEM) website at www.dmtf.org/standards/wbem/.

Commands and options

-b

Runs in batch (unattended) mode. When this option is specified, user-interactive prompts are not displayed.

--chkupd --proxy-address=ip_address --proxy-port=portnum --proxy-user=userid --proxy-password=password

Checks the IBM website for available System Enablement Packs (SEPs). You can add support for new devices by downloading and installing new SEPs. This function is available for Online Dynamic System Analysis only.

–proxy-address=

The IP address of the proxy server used to connect to the Internet.

–proxy-port=

The port number on the proxy server.

–proxy-user=

The username to connect to the proxy server.

–proxy-password=

The password for the proxy-user.

--cmm userid:password@hostip:[port]

This option is used to collect CMM data via Out-of Band mode.

-d output_directory

Specifies the fully-qualified or relative directory where the data files are to be placed (for example: /tmp/DSA or c:\temp\DSA for Windows). If the specified directory does not exist, it will be created. By default, files are placed in %SystemDrive%/IBM_Support.

-diags

Runs all nondestructive diagnostics tests for the applicable devices.

The nondestructive diagnostic tests include:

• Optical drive tests, including verify media, read error, and drive self test
• Tape drive tests, including tape presence, tape alert, tape load, and tape self test

--disable-imm-lan

Disables the USB Over LAN interface after running DSA.

-dumpxml

Saves the compressed CIM-XML file to disk after each collector plug-in runs.

Tips:

• This option significantly slows down the collection process and is intended only for debugging purposes.
• This option cannot be used with the -x and -i options.

-f

Collects the full ISMP service processor log.

--ffdc

This option is used to collect IMM FFDC log via In-Band mode for all nodes.

-? | -h

Displays information about this command, including syntax and option descriptions.

-html output_directory

Specifies the fully-qualified or relative directory where the HTML data files are to be placed (for example: /tmp/DSA or c:\temp\DSA for Windows)

Tips:

• If you do not specify this option, the set of HTML data files is saved in the outputdir\mtm_serialnumber_datetime directory, whereoutputdir is the output directory specified by the -d option, mtm is the machine type and model of the local system, serialnumber is the serial number of local system, and datetime is the date and time when data was collected.
• If you do not specify the -c option, the specified output directory must exist on the local system.

-i data_file

Reads input from the specified file instead of collecting data from the local server.

-ibmid

Allows you to specify your IBM Identifier, for use with the -upload option.

--ipmi-lan user_id:password@ip_address[:port

Collects IPMI event log on the specified remote server using out-of-band mode.

-l

Displays the license text.

--no-imm-lan

This option is used to skip DSA data collection for IMM when running DSA, USB Over LAN state is kept unchanged.

-r data_file[ data_file...]

Compares current system information against one or more specified system information files, in compressed CIM-XML format. Use fully-qualified file names (for example, /tmp/compfile.xml.gz or c:\temp\DSA\compfile.xml.gz). Separate multiple file names using a space.

Tip:

• If you specify the -r option, you must also specify the -v option, which creates output in HTML format.
• If the -i option is also specified, this command compares the data files specified with the -r option to the current data file specified by the -i option instead of collecting the current system information.

-remote-ffdc

CMM FFDC support

--remote-ffdc [user_id:password@port]

This option is used to collect FFDC log via Out-Of-Band mode. In this mode, portable DSA collects FFDC log from CMM/IMM. Currently only FFDC from CMM is available.

-t [user_id:password@ip_address[:port] /path/]

Transfers the inventory data file to the specified system using the specified File Transfer Protocol (FTP). Specify the system using these arguments:

user_id:password

The credentials needed to access the FTP server.

ip_address

The IP address or host name of the FTP server.

port

The port number to use to access of the FTP server.

path

The directory on the FTP server in which you want to copy the inventory data files.

Tip: If you specify this option with no arguments, the data file is transferred to the testcase.boulder.ibm.com/eserver/toibm/xseries/ FTP server by default.

-text

Creates output in ASCII text format.

Collected data is placed in the output directory in a single text file named mtm_serialnumber_datetime.txt, where mtm is the machine type and model number of the local system, serialnumber is the serial number of the local system, and datetime is the date and time that data was collected. Data is grouped in to high-level categories (for example, system overview, network settings, and installed application). Related system information for the high-level categories is categorized further and printed into several tables that contain properties and their value.

--update --proxy-address=ip_address --proxy-port=portnum --proxy-user=userid --proxy-password=password

Checks for available System Update Packs on the IBM support site, and downloads them if they are available. System Update Packs allow you to add support for systems that have been released since the most recent release of Dynamic System Analysis. This function is available for Online Dynamic System Analysis only.

–proxy-address=

The IP address of the proxy server used to connect to the Internet.

–proxy-port=

The port number on the proxy server.

–proxy-user=

The username to connect to the proxy server.

–proxy-password=

The password for the proxy-user.

--update_arch 32|64

Used with --chkupd or --update options to specify the architecture.

--update_m machine_type

Used with --chkupd or --update options to specify the machine type to update.

--update_os windows|rhel4|rhel4|rhel5|sles9|sles10|sles11|vmware3.5|vmware4.0

Used with --chkupd or --update options to specify the operating system.

-upload [IBMid:id]

Sends inventory data to the Electronic Services web portal for use in proactive support functions such as My Systems and My Notifications. The data is sent using HTTPS.

The IBM ID is the ID that is authorized to view the inventory data sent using the Electronic Services web portal page. If you specify this option with no IBM ID, the data is sent, but you will not be able to access it using the Electronic Services web portal.

-ux [--proxy-address=address] [--proxy-port=port] [--proxy-user=user_ID] [--proxy_password=password

Compares the installed firmware levels with the latest version of firmware levels.

Important: The local system must have Internet access.

-v

Creates output in HTML format.

Collected data is categorized and placed in a set of HTML files (for example, system_overview.html for system-overview information, net.html for network settings information, and installedapp.html for installed-application information). In each HTML file, related system information is categorized further and printed into several tables that contain properties and their value.

This option also creates an index.html file from which you can view all system information. When you display this file in a web browser, the left pane contains links for each category of information, and the right pane displays the related information.

--vmware-esxi user_id:password@ip_address[:port]

Collect system information from the specified remote system running VMware ESXi.

Tip: This option cannot be used with the --ipmi-lan, -r, -diags, and -f options.

-x

Does not create output in the compressed CIM-XML format.

Tips:

• This command creates output in the compressed CIM-XML format by default.
• If you specify the -x option, you must specify either the -v or -text options.

Examples

1. Collect data in a compressed CIM-XML output

   This example illustrates how to collect data in a compressed CIM-XML file in the installation_directory\IBM_Support\ on Windows systems or /var/log/IBM_Support on Linux systems.

   ibm_utl_dsa_v.r.m_portable_platform.exe

   ibm_utl_dsa_v.r.m_portable_platform.bin

2. View previously collected data

   This example illustrates how to import an existing data file named system1.xml.gz in the default output directory C:\IBM_Support\ and then saves the data in HTML and text format.

   ibm_utl_dsa_v.r.m_portable_platform.exe -i input

   ibm_utl_dsa_v.r.m_portable_platform -i system1.xml.gz

3. Convert collected data into HTML and text output

   This example illustrates how to import an existing data file named system1.xml.gz in the default output directory C:\IBM_Support\ and then saves the data in default output directory in HTML and text format.

   ibm_utl_dsa_v.r.m_portable_platform.exe -v -text -i input

   ibm_utl_dsa_v.r.m_portable_platform -v -text -i system1.xml.gz