Enabling Cognos BI logging for Mobile server
IBM® Cognos® Mobile records activities and debugging information as well as information about user and report activity.
About this task
The type of information that is logged in the Cognos Mobile log files is determined by the logging level defined in the ipfclientconfig.xml file in the c10_location/configuration directory. The same directory contains the ipfMOBclientconfig.xml.sample file. To enable logging, you only need to rename ipfMOBclientconfig.xml.sample to ipfclientconfig.xml.
The following logging levels can be defined for Cognos Mobile:
| Logging level | Description |
|---|---|
Debug |
Provides debugging information. This logging level is typically used for debugging specific problems. |
Info |
Provides information about IBM Cognos services. |
Warn |
Indicates a suspicious occurrence that might warrant further investigation. |
Error |
Indicates a serious error condition that requires intervention. |
The level of logging that the user chooses includes all the levels below it. For example, if the user chooses Info, then warning and error messages are also written to the log file.
You can also enable logging in IBM Cognos Administration. For more information, see Setting up audit logging in IBM Cognos Administration.
Procedure
- Stop the Mobile service in IBM Cognos Configuration.
- In the c10_location/configuration directory, rename ipfMOBclientconfig.xml.sample to ipfclientconfig.xml.
- Open the ipfclientconfig.xml file, specify the logging levels that you want, and save the file.
- Start the IBM Cognos service.
Results
Depending on the logging levels specified in the ipfclientconfig.xml file, the following log files are generated in the c10_location/logs directory.
- ipf-MOB_xxxx.log
This file records Cognos Mobile audit event information. If a logging database is defined in IBM Cognos Configuration under Environment, Logging, the audit events are also logged in this database. This type of logging is enabled by default in the ipfMOBclientconfig.xml.sample file.
For information about setting up a logging database, see the IBM Cognos Business Intelligence Installation and Configuration Guide.
- ipfMOBtrace_xxxx.log
This file records Cognos Mobile trace and debug log data. The type of data captured in this file is the same as the data in the mob.log file. However, this file can be configured to a different logging level to record more or less information. This type of logging is enabled by default in the ipfMOBclientconfig.xml.sample file.
- ipfMOBperf_xxxx.log
This file records Cognos Mobile performance data. This type of logging is disabled by default in the ipfMOBclientconfig.xml.sample file.