File based Configuration

The file based configuration is the prefered way of configuration.

In the system configuration file ibo-config.xml global properties for Signsoft intelliBO are set. That includes the configuration of data sources and transaction control as well as of logging or the cache.

Note that global properties substitutes all over configuration settings.

Use of the configuration file

If you would like to use Signsoft intelliBO with a system configuration file, you can name it ibo-config.xml and put it somethere in your CALSSPATH. Signsoft intelliBO then automatically parses the CLASSPATH and scannes it for the first occurrence of a file with the name ibo-config.xml .

You can get the configured PersistenceManagerFactory using:

PersistenceManagerFactory pmf = new PersistenceManagerFactoryImpl();

Alternatively to the automatic search, you can specify your own configuration file:

In a standard enviroment you get the configured PersistenceManagerFactory using:

PersistenceManagerFactoryImpl pmfImpl
  = new PersistenceManagerFactoryImpl("/my-ibo-config.xml");

If you use Signsoft intelliBO in an enterprise enviroment, you can specify your own configuration file, too. Please configure the name of the configuration file within the Resource Adapter configuration (ra.xml):

<connector>
  ...
  <resourceadapter>
    ...
    <config-property>
      <config-property-name>Configuration</config-property-name>
      <config-property-type>java.lang.String</config-property-type>
      <config-property-value>/my-ibo-config.xml</config-property-value>
    </config-property>
  </resourceadapter>
</connector>

Overview ibo-config.xml

In the ibo-config.xml file all configuration options are placed under the following XML root element:

<?xml version="1.0" encoding="UTF-8"?>
<ibo>
  <entry key="version" value="4.0"/>

  <!-- pre-register persistence-capable classes -->
  <node name="classes-pc">... </node>

  <!-- setup security provider -->
  <node name="security-provider">... </node>

  <!-- environment setup for PersistenceManagerFactory and PersistenceManager-->
  <node name="enviroment">... </node>

  <!-- query setup -->
  <node name="query">... </node>

  <!-- resource entry setup -->
  <node name="resource-entry">... </node>

  <!-- cache setup - see chapter "Cache" in user guide -->
  <cache>...</cache>

  <!-- logging setup (only until Signsoft intelliBO version 4.1) see chapter "Logging" in unser guide-->
  <logging>...</logging>
</ibo>

For the cache and logging settings please refer to the chapters "Cache" or "Logging" in the user guide.