Activating the trace for the Cognos components

Trace data for the IBM® Cognos® components BI server, Data Manager, and Framework Manager is useful when troubleshooting IBM Rational® Insight issues for these components.
About this task
To enable the logging of trace data:
  1. Stop the Rational Insight server.
  2. Navigate to the [cognos_installation_directory]/configuration directory.
  3. Back up the IPF configuration file for the IBM Cognos component. To see a list of the component files and the information captured in the files, see the Related reference link at the bottom of this page.
  4. Edit the configuration file:
    1. Locate the appender element.
    2. Make sure the LogServer port and protocol is correct, as set by the user in Cognos Configuration Tool. The appender needs no changes is the defaults are being used: 9362 for the LogServer port and "Enable TCP" (False =>UDP) for the protocol.
    3. Within the appender element, locate the param subelement.
    4. If you are using the IPF trace for a system deployed to anything other than Apache Tomcat, change the file parameter from the relative path (../logs/) to an absolute path.
  5. Rename the ipfcomponentclientconfig.xml.sample file to ipfclientconfig.xml. component is a variable that can be changed to the appropriate component name, for example, ipfFMclientconfig.xml.sample is for traces for the Framework Manager component.
  6. Restart the Rational Insight server.
Results
Logging is reconfigured to use the ipfcomponentclientconfig.xml. To disable logging, reverse the changes.

Feedback