Troubleshooting and support - Operational Decision Manager


Troubleshooting and support


Identifying problems

Troubleshooting is the process of finding and eliminating the cause of a problem. The first steps for identifying a problem include recording the symptoms, re-creating the problem, and eliminating potential causes.

Recording the symptoms

When you get an error message in ODM, make sure that you record this message. You might also receive multiple error messages that look similar, but have subtle differences. By recording the details of each one you can learn more about where your problem exists.

You can get error messages in the following sources:

Re-creating the problem

To reproduce the problem, try to identify the steps that your performed. If you have a consistently repeatable test case, you can have an easier time determining what solutions are necessary.

You can ask yourself the following questions:

Eliminating possible causes

You can narrow the scope of your problem by eliminating components that are not causing the problem. Consult the information that comes with ODM and other available resources to help you with your elimination process.



Troubleshooting and support resources

Various resources are available to help you get support or troubleshoot the problems that you might have with ODM.

Troubleshooting information includes technotes, known limitations and problem resolution. You can also find useful information on the forums, blogs, and communities dedicated to ODM, as well as in ODM documentation and training.

If this information is not sufficient and if it does not help solving your problem, you can contact IBM Support, and open service requests or PMRs if necessary.

The following resources provide additional troubleshooting or support information:



Collecting data using the IBM Support Assistant Data Collector

The IBM Support Assistant Data Collector is an automated way to provide information to the support team for initial diagnosis of your problem.

You can run the Data Collector to gather the necessary data for identifying a problem in ODM or in a component of ODM.

The diagnostic data that you collect, and the sources from which you collect that data, depend on the type of problem. A base set of information is required for diagnosing and resolving a product-level or component-level problem.

Run the Data Collector using the web user interface or the command line, and then send the collected data to IBM Support.



Running the Data Collector from the web interface

The IBM Support Assistant Data Collector is an automated way to provide information to the support team for initial diagnosis of your problem.

Before you begin

Make sure that you have Java™ version 1.6 or later installed to run the tool in the web interface. You use the IBM Support Assistant Data Collector to gather the necessary data for identifying a problem in ODM or in a component of ODM.

The diagnostic data that you collect, and the sources from which you collect that data, depend on the type of problem. A base set of information is required for diagnosing and resolving a product-level or component-level problem. For specific symptoms, you might need to collect additional problem-specific data.

You can run the IBM Support Assistant Data Collector using the web user interface or the command line.

To run the Data Collector from the web interface:

  1. Click Start > All Programs > IBM > package_group > Help and Support > Collect Data for Problem Analysis.

    package_group refers to the package group specified in IBM Installation Manager during installation. The default package group is ODM.

    You can also navigate to <InstallDir>/shared/isadc/, and double-click index.html to open it in a browser. If you are prompted for permission to run the Java Applet, agree to execute the application, or grant the appropriate permission to allow the Java Applet to run.

  2. Expand ODM and the component for which you want to collect data, select the collection type, and then click Start.

  3. If prompted to select a installation directory or workspace, click Browse to select it, click Accept, and then click OK to continue.
  4. Optional: To transfer the collected data or upload it to a server, click one of the following options and fill in the required parameters:

    • Transfer to IBM (via FTP or HTTPS)
    • Transfer to another server via FTP

  5. If you do not want to transfer the data now, click Dot Not Transfer.

Results

The tool generates an archive that contains the collected data, in <USER_HOME>/.isadc/. You can also find the logs of the execution of the Data Collector.



Running the Data Collector from the command line

You can run the IBM Support Assistant Data Collector using the command-line console mode.

Before you begin

Make sure that you have Java™ version 1.5 or later installed.

In command-line console mode, there are no selection lists or entry fields for user input. The available choices are presented as numbered lists and you enter the number of your selection.

You can also record a response file to automate headless or unattended collections.

  1. If it is not already done, set the JAVA_HOME environment variable to the path of your JDK 1.5 (or later) installation, or add it to your PATH variable.
  2. Navigate to <InstallDir>/shared/isadc/, and run the following script:

    • Windows: isadc.bat
    • UNIX: isadc.sh

  3. Follow the instructions displayed in the command-line console.