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.