Defining System Properties

This section provides an overview of the xdo.cfg file and discusses how to:

  • Set system temp directory.

  • Set application server or process scheduler domain-specific xdo.cfg file.

BI Publisher system properties settings are defined in the xdo.cfg file. The default xdo.cfg file is located in the $PS_HOME/appserver directory, which is shared by all application server and process scheduler domains by default.

Note: In PeopleTools 8.4x, the xdo.cfg file is used to define all types of properties (system and non-system). In PeopleTools 8.50 and later releases the file should be used for system properties and fonts only. The result is unpredictable if the same property is defined in xdo.cfg and other levels.

This is an example of the xdo.cfg file:

<config version="1.0.0" xmlns="http://xmlns.oracle.com/oxp/config/">

    <properties>
        <!-- System level properties -->
        <property name="xslt-xdoparser">true</property> 
        <property name="xslt-scalable">true</property>
        <property name="system-cachepage-size">50</property>
        <property name="system-temp-dir"></property>
    </properties>


    <!--<fonts>-->
        <!--<font family="3 of 9 Barcode" style="normal" weight="normal">-->
            <!--<truetype path="C:\WINNT\Fonts\3of9.ttf" />-->
        <!--</font>-->
    <!--</fonts>-->

</config>

See Report Designer's Guide for Oracle Business Intelligence Publisher, “Introduction to Designing Reports,” About Setting Run-Time Properties.”

By default, the system-temp-dir property is not set. This property must be set to point to a temp folder on the server. Note that temporary files created in that directory could grow very large in size depending on the size of your reports, so you need to choose yoursystem-temp-dir for optimum system performance.

You can also specify an application server or process scheduler domain-specific xdo.cfg file. To do this, you need to change the application server or process scheduler configuration file to update theJavaVM Options -Dxdo.ConfigFile setting. For example, to specify a separate xdo.cfg file for the application server domain P8538041, change the [PS_CFG_HOME]/appserv/P8538041/psappsrv.cfg file as indicated in the following code samples and put the new xdo.cfg into the [PS_CFG_HOME]/appserv/P8538041directory.

Original line in psappsrv.cfg:

JavaVM Options=-Xrs -Dxdo.ConfigFile=%PS_HOME%/appserv/xdo.cfg

New line in psappsrv.cfg: 

JavaVM Options=-Xrs -Dxdo.ConfigFile==%PS_CFG_HOME%/appserv/P8538041/xdo.cfg

In the preceding code sample, P8538041 is the application server domain name.

If you change the content of xdo.cfg, you don't need to restart the application server or the process scheduler domain that uses it. It refreshes automatically the next time you run it. But if you change the application server or process scheduler configuration file, you need to restart the affected domain.