Server Tracing Using the BO_trace.ini File in XI3.1

Top of Form 1

Symptom

In XI3.1 the process for creating server traces using the BO_trace.ini has changed slightly when compared to earlier releases

Reproducing the Issue

Environment:

BusinessObjects Enterprise Server 3.1

Windows Server 2003

Resolution

To activate and configure tracing using the BO_trace.ini file, please follow these steps:

1. Copy the BO_Trace.ini file from “C:\Program Files\Business Objects\BusinessObjects Enterprise 12.0\win32_x86\scripts” folder or the equivalent folder

2. Paste this file into “C:\Program Files\Business Objects\BusinessObjects Enterprise 12.0\win32_x86” folder or the equivalent folder

3. Open the copied BO_Trace.ini file from step 2 and uncomment the required lines under the "Trace Syntax and Setting" section which involves removal of the preceding "//" in the required lines.

4. To generate server traces, modify the server tracing parameters to below values.active = true;importance = '==';alert = true;severity = 'E';keep = true;size = 100000;Note: The level of tracing can be increased by changing some of the above parameter values. Please refer to the XI3.1 "BusinessObjects Enterprise Administrator's Guide" where detailed

explanation of tracing syntax and parameters is given. A high level summary is also available in BO_trace.ini file that resides in the default location specified in step#1.

5. Make a copy of this modified BO_trace.ini file and rename it to “<PROCESSNAME>_trace.ini” where PROCESSNAME is the process you wanted the traces to be enabled. You can generate traces for all processes this way. For eg: Name it as WIReportServer_trace.ini for WebI report processing server. To generate an additional trace for deski report processing server, copy the same file and name it fcproc_trace.ini.

6. Traces are generated in the “C:\Program Files\Business Objects\BusinessObjects Enterprise 12.0\win32_x86” folder by default. However you can change the location where the logs are to be written by using log_dir option in the BO_trace.ini. To do this, just add the below line to the existing <PROCESSNAME>_trace.ini files. Note the forward slash while specifying the directory structure. log_dir = "C:/BOX_trace_log";

7. The settings specified in the _trace.ini file override whatever is specified for server tracing in the CMC command line. Your configuration should take affect within a minute of saving the BO_trace.ini file and there is no need to restart services for tracing to take affect.

8. Note: To deactivate bo tracing, just change the line active = true; to active = false; in all the _trace.ini files in win32_x86 folder.

9.Keywords

10. XI3.1 bo tracing BO_trace.ini server tracing

11.

12. Header Data

Released on 25.11.2008 13:16:13 by James Terry (I817754)

Current Release Status

Released to Customer

Target Release Status

Released to Customer

Responsible Shiva Vishnubatla ( I818221 )

Category How To

Application Area

BOJ-BIP-ADM

Product Version

BOBJ ENTERPRISE XI 3.1

References

Type

Category

IDTitle

Business Objects Incident

Document Source

002007974700009632852008

R3.1 bo trace.ini