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\Lenovo\DSA). Use the lnvgy_utl_dsa_dsalxxx-10.x_portable_platform.exe command.

To run this command on a system running Linux, use lnvgy_utl_dsa_dsalxxx-10.x_portable_platform.bin.

If no options are specified, this command collects and saves information in a compressed XML file in the installation_directory\Lenovo_Support\ on Windows systems or/var/log/Lenovo_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) Web site 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 Web site 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.

--cmmuserid:password@hostip:[port]

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

-doutput_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%/Lenovo_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 by 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.

-idata_file

Reads input from the specified file instead of collecting data from the local server. The command is valid only when the file is generated by running DSA, and the file is with xml extension or xml.gz extension.

-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.

-rdata_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 by Out-Of-Band mode. In this mode, portable DSA collects FFDC log from CMM/IMM. Currently only FFDC from CMM is available.

-t [ftp(sftp)://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, but the password of the FTP server cannot contain special characters include ~!@#$%^&*()_+-=.

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.

-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 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_arch32|64

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

--update_mmachine_type

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

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

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

-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-esxiuser_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\Lenovo_Support\ on Windows systems or /var/log/Lenovo_Support on Linux systems.

   lnvgy_utl_dsa_lnvgy_utl_dsa_dsalxxx-10.x_portable_platform.exe

   lnvgy_utl_dsa_lnvgy_utl_dsa_dsalxxx-10.x_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:\Lenovo_Support\ and then saves the data in HTML and text format.

   lnvgy_utl_dsa_dsalxxx-10.x_portable_platform.exe -i input

   lnvgy_utl_dsa_dsalxxx-10.x_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:\Lenovo_Support\ and then saves the data in default output directory in HTML and text format.

   lnvgy_utl_dsa_dsalxxx-10.x_portable_platform.exe -v -text -i input

   lnvgy_utl_dsa_dsalxxx-10.x_portable_platform -v -text -i system1.xml.gz