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:
- Stop the Rational Insight
server.
- Navigate to the [cognos_installation_directory]/configuration directory.
- 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.
- Edit the configuration file:
- Locate the appender element.
- 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.
- Within the appender element,
locate the param subelement.
- 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.
- 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.
- Restart the Rational Insight
server.
Results
Logging is reconfigured to use the ipf
componentclientconfig.xml.
To disable logging, reverse the changes.