Log files

Rational® Publishing Engine has two methods for viewing process information, which you can use to identify issues. The first method is through the Console view logs, which display the human readable information about Rational Publishing Engine processes. The second method is through the log files, which contains a detailed list of changes made to the file system. Log files for both the core and user interface processes can be used by IBM Support to help you troubleshoot issues.

Console view

The Console view provides short summaries of Rational Publishing Engine processes as they occur. For example, when you start the Rational Publishing Engine Document Studio, the Console view might display informational messages like

CRRPE0321I RPE License - License OK, valid for 300 more days.
CRRPE0282I RPE Document Studio started

To open the Console view, click Window > Show View > Console.

Changing the Console view character limit

In Rational Publishing Engine 1.1.1.2 and later, you can control the size of the log information kept in the console view. By default, the maximum size is set to 100000 characters.

To change the Console view character limit:

  1. Open the rpe-launcher.ini or rpe-studio.ini file.
  2. Locate the com.ibm.rational.rpe.console.limit parameter.
  3. Increase or decrease the value.
    • If the value is smaller than 100000 or not set at all, no limit is set for the logs in the Console view.
    • If the value is greater than 100000, a maximum limit size character is set in the Console view.
  4. Save the changes.

User interface logs

The log files store a history of user interface related issues that occur while using Rational Publishing Engine Document Studio and Rational Publishing Engine Launcher.

The log files can be found in the default workspace directories for Document Studio and Launcher:
  • C:\Documents and Settings\user\Application Data\IBM\Rational\RPE_date\Studio\workspace\.metadata
  • C:\Documents and Settings\user\Application Data\IBM\Rational\RPE_date\Launcher\workspace\.metadata

Setting the core debug mode preference

When running in Core Debug mode, detailed information about the current element, conditions checked, and current data source context are included in the log files. You can use the log file for your reference or send it to IBM Software Support for additional help.

You can activate code debug mode in either Rational Publishing Engine Launcher or Document Studio. To activate code debug mode in both, you must perform these steps in both applications.

To activate core debug mode:
  1. Click Window > Preferences.
  2. Expand RPE.
  3. Click Engine Preferences.
  4. In RPE core debug mode, click Yes.
  5. Click OK to save.

Debug mode selection in the Engine preferences

Core log files

The logging is controlled in the %RPE_HOME%\config\log4j.properties file.

Note: The system variable RPE_HOME must be defined to read the logging configuration. The default output of the log file is RPE\RPE.log in the user home folder: C:\Documents and Settings\user\temp\RPE\RPE.log.

Feedback