PurifyPlus data collector available through IBM Support Assistant

Prerequisites

Installation Instructions

Using ISA collector

Details: Rational PurifyPlus General Collector - Windows

Prerequisites

IBM Support Assistant V4.0 Workbench or higher

http://www.ibm.com/software/support/isa/

Back to top

Installation Instructions

You'll need to install the Rational PurifyPlus 7.0 add-on for IBM Support Assistant. To do so :

1. Start IBM Support Assistant
2. Select Update > Find new > Product Add-ons from the menu.
3. Expand Rational
4. Select Rational PurifyPlus 7.0 and click Next.
5. Click Next again.
6. Select I accept the terms in the license agreements and click Next.
7. Click Finish.
8. Click Finish again and click Yes to restart ISA.

1. Start IBM Support Assistant
2. Select Update > Find Updates to Add-ons from the menu.
3. Select Rational PurifyPlus 7.0 and click Next.
4. Select I accept the terms in the license agreements and click Next.
5. Click Finish.
6. Click Finish again and click Yes to restart ISA.

Back to top

Once ISA is started with Rational PurifyPlus 7.0 add-on installed, click on Analyze Problem. Expand Rational PurifyPlus 7.0 , and you should see a list of data collectors. Select the collector and click on Add. This will add the collector to the Collector Queue to be run. See below.



Click on Collect All to start the collection.

If you have multiple products added, each of these collectors will run in sequence per the Collector Queue. You can click on View Details to get more information on the progress of each of these collectors. More information can be found in the ISA product help system at Help > Help Contents.

For a more in-depth understanding of the various methods of deploying the IBM Support Assistant collectors see: Collecting diagnostic information using the IBM Support Assistant.

Back to top

Rational PurifyPlus General Problem - Windows
Use this collector to automatically gather information for PurifyPlus 7.0 - Windows issues.

What information will be collected?

The collector will :

• Collects collector tool execution & system inventory information.
• Collect problem description (user input)
  • Optionally collects the instrumented program.
  • Collects any files (in a folder) that the user chooses to provide.
• Collect system information.
  • Windows commands executed: systemInfo, mem, tasklist /v , sc query , set
  • Registry information : HKEY_CURRENT_USER , and HKEY_LOCAL_MACHINE\SOFTWARE
• If this is not an installation issue and PurifyPlus is found on the system:
  • Collects PurifyPlus version information.
  • Collects PurifyPlus filters and default .ini settings.
  • Calculates the cache location based on the instrumented program specified. It then collects cache information as a result of executing emode.exe against the cache directory.
  • Collects the instrumented program's .ini and .log files.
  • If the application is "A Java app" it will optionally run "PurifyMD -locate -diagnose -log".

To check what has been collected, extract the .zip file that is created when the collector completes.

Walk thru for "Rational PurifyPlus General Problem - Windows"

The collector will first inform you what it is going to collect. Click OK, to proceed .


Problem Description Panels
Here you can describe the problem and share information about how you are running PurifyPlus. There are 3 panels used to collect information and a fourth panel that allows you to verify your input. A validation is run for each panel to ensure the option selected is valid, or that the file or folder specified exists.

Panel 1: General Problem Description
Select the appropriate values that match your problem. If you specify "Other", please use the "Describe the error details" text area to fill in additional details. Click OK to continue.


Panel 2: Instrumented Program
Select the application that is problematic with Purify, Quantiy or PureCoverage and provide the associated output file. Both of these are required. This value is used to calculate the cache directory. Click OK to continue.


Panel 3: Optional files
If you have additional files that you would like to provide for the support team, place them in a folder and specify that folder in this panel. Click OK to continue.



Verify Input:
Ensure that all input provided is correct.
• If all inputs is correct, click Correct to run the data collection.
• If not, select Not Correct and the collector will go back to Panel 1 (with values pre-populated).
  

• Click OK to run PurifyMD
• Click Skip to skip PurifyMD

When the collector is completed, it will request feedback about ISA. Select Yes, to provide feedback. Select No to continue.

You'll also be provided with data upload options. This will allow you to send the collected data to IBM or another location via FTP or HTTPS.

IMPORTANT: To upload information to IBM, you'll need to have a PMR number. This is obtained when you work with our support team. If you do not have a PMR number, but do have support contract, you can leverage the Software Support page to open a service request and included the collected data with the service request.
IBM Service Request Page: https://www.ibm.com/support/servicerequest/

The upload options are:

• Send the Logs to IBM using secure transfer (HTTPS). You'll need an PMR number to transfer the data to IBM. This sends the collected data to IBM Support team through the HTTPS protocol.
• FTP the Logs to IBM Support (unencrypted). You'll need an PMR number to transfer the data to IBM. This sends the collected data to IBM Support team through the FTP protocol. This is a less secure option.
• FTP the Logs to a Different Location (unencrypted) This allows you to send the collected data to another location via FTP. You'll need to provide the target FTP location and appropriate authentication to access it.
• Do Not FTP the Logs. Do nothing.

When the collector completes, the .zip file is created at the location specified in Output File name. You can use any unzip tool to extract the files to examine the content of collected data.