Collecting problem report data for Process Federation Server

Edit online
Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15
Use IBM® Support Assistant Data Collector to quickly collect diagnostic files, such as log, configuration, and trace files for troubleshooting Process Federation Server problems on your own, or submitting problem reports to IBM.

Before you begin

The IBM Support Assistant Data Collector for Process Federation Server is not installed by default. You must download the data collector from the following website: IBM Support Assistant Data Collector for WebSphere® Liberty Profile External link opens a new window or tab.

About this task

You run IBM Support Assistant Data Collector for WebSphere Liberty Profile in console mode. The data that is collected contains the Process Federation Server-specific data that runs in the Liberty profile. When you set up the data collector, you record your responses to the console prompts in a response file. You can then use the response file to run the same collection script and generate reports silently as many times as required.

Procedure

To run the data collector, complete the following steps:

  1. Ensure that your Java™ environment is configured correctly:
    1. Verify that your Java runtime environment is at level 1.5 or higher.
    2. Verify that the location of the Java runtime environment is included in your PATH environment setting. If the location is not included in your path, set the JAVA_HOME variable to point to the Java runtime environment.
      • For Windows operating systemFor example, if you have a Java Development Kit installed at C:\jre1.5, use the command: 
        SET JAVA_HOME=C:\jre1.5
      • For Linux operating systemFor UNIX operating systemFor example, if you are using the bash shell and you have a Java Development Kit installed at /opt/jre15, use the command: 
        export JAVA_HOME=/opt/jre15
  2. Start the script from a command window.
    1. Go to the directory where you downloaded the IBM Support Assistant Data Collector to.
    2. Run the following command:
      • For Windows operating systemisadc.bat
      • For Linux operating systemFor UNIX operating systemisadc.sh
        Tip: Ensure that the script is executable file. If necessary, use the following command to change the file permissions: chmod 755 isadc.sh
    The IBM Support Assistant Data Collector starts in console mode.
  3. Create a response file.
    • For Windows operating systemisadc.bat -record response.txt
    • For Linux operating systemFor UNIX operating systemisadc.sh -record response.txt
    You can specify your own file name for response.txt.

    Answer the console prompts as appropriate for your environment.

  4. Run the tool using a response file.
    • For Windows operating systemisadc.bat response.txt
    • For Linux operating systemFor UNIX operating systemisadc.sh response.txt

    The response file is a plain text file. You can edit it to modify values. For example, you can use the file on another computer after adjusting the response file values to reflect settings for the local computer.

    Remember that sensitive information, such as user names and passwords, might be stored in the response file. Manage the file carefully, to prevent unauthorized access to important information.

    Some data collection sessions require interaction with the user, and thus are not suitable for the silent collection option. For example, IBM Support might ask you to reproduce a problem during data collection, in order to collect log and trace files. In this case, silent collection cannot record and reproduce all steps.

  5. Stop the data collector by typing the quit option in console mode.