Previous Common Configuration Properties Next

Persistence Properties

The properties on the Persistence tab determine how and where the Service data is stored persistently.

Storage Write Interval

This property specifies the delay (in seconds) between saving object state changes within a server and writing this information to persistent storage. This option is a performance optimization feature as it can be used to prevent the Service from making a lot of small updates to the persistent store.

A value of zero indicates no delay (changes are written immediately to the persistent store). Increasing the write interval may improve performance when the data held by a service is changing rapidly.

Property Name

DB.WriteInterval

Property Type

STATIC

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Storage Write Batch Size

The Storage Write Batch Size option specifies the maximum number of updates that will be buffered before the data is written to persistent storage. This option is a performance optimization feature.

A value of zero indicates that the updates are not buffered but are written immediately to the data store. Increasing the property value may improve performance when the data held by a Service is changing rapidly.

The effect of setting both the Storage Write Interval and the Storage Write Batch Size to values greater than zero is that of batched timed writes.

Property Name

DB.WriteBatch

Property Type

STATIC

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

JDBC Auto-create tables

If this property is checked (true), the Service will check for the presence of the JDBC tables required for persistent storage and automatically create the tables if they are not present.

The default value for this property is true.

Property Name

DB.JDBC.AutoCreate

Property Type

FIXED

Data Type

BOOLEAN

Accessibility

READ-WRITE

Mandatory

NO

JDBC Handler

The class name of the custom plug-in which will implement the JDBC ExceptionHandler interface.

The ExceptionHandler interface allows the customising of how an SQL exception will be handled. The interface is specified as follows:

public interface ExceptionHandler
{
   public static final int OK = 0;
   public static final int REPEAT = -1;
   public static final int FATAL = -2;
   
   public int handleException (java.sql.SQLException ex);
}

This operation should return a status indicating how an SQL exception should be handled. Possible return values are:

OK

The program should continue as normal.

REPEAT

The database operation should be re-tried immediately.

FATAL

The program should terminate.

A return value greater than 0 (zero) means that the database operation should be re-tried after the returned interval (in milliseconds).

Property Name

DB.JDBC.Handler

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

NO

JDBC Database Type

The JDBC Database Type option specifies the available, underlying relational database type. Select from one of the following supported databases:

The default persistence option is hsqldb, which is installed with the OpenFusion CORBA Services distribution and will run with no additional configuration.

Property Name

DB.JDBC.Type

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

YES

JDBC URL

The JDBC URL option sets the location of the JDBC data source. The format of the URL depends on the type of data source being used.

Oracle

jdbc:oracle:thin:<data_source_name>

Where <data_source_name> is the name of the JDBC data source.

Sybase

jdbc:sybase:Tds:<data_source_name>

Where <data_source_name> is the name of the JDBC data source.

Informix

jdbc:informix-sqli:<data_source_name>

Where <data_source_name> is the name of the JDBC data source.

SQL Server

jdbc:odbc:<data_source_name>

Where <data_source_name> is the name of the JDBC data source.

hsqldb

There are three ways in which hsqldb can be run, each requiring a different URL format.

jbbc:hsqldb:<database>

Where <database> is the path to the hsqldb database. The default database location is a subdirectory of the Service directory, as follows:

jdbc:hsqldb:<install_path>/domains/<domain>/<node>/

<service>/data/hsqldb

Where:

<install_path> is the OpenFusion installation directory.

<domain> is the name of the domain.

<node> is the name of the node.

<service> is the name of the OpenFusion Service.

This default location can be changed if required.

jdbc:hsqldb:.

jdbc:hsqldb:hsql://<host>:<port>

Where:

<host> is the name of the remote machine.

<port> is the port used to connect to hsqldb on the host machine. This is optional but will be required if the host machine runs more than one hsqldb server.

Property Name

DB.JDBC.URL

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

YES

JDBC Driver

This is the class name of the JDBC driver used. A default driver based upon the type of database chosen will be used when this field is left blank, so it is not normally necessary to set this field.

Property Name

DB.JBDC.Driver

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

NO

JDBC Logging

Whether JDBC calls will be logged or not.

Property Name

DB.JDBC.Logging

Property Type

DYNAMIC

Data Type

BOOLEAN

Accessibility

READ/WRITE

Mandatory

NO

JDBC User

Your Database Administrator will provide the user name for use in the JDBC User option.The default user is sa (the hsqldb system administrator user).

This user must have create rights on the database.

Property Name

DB.JDBC.User

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

YES

JDBC Password

Your Database Administrator will provide the password for use in the JDBC Password option. The default password is blank (none is required for the default user, sa, in hsqldb).

Property Name

DB.JDBC.Password

Property Type

FIXED

Data Type

PASSWORD

Accessibility

READ/WRITE

Mandatory

NO

Server Persistent ID

A unique identifier (UUID) associated with a specific server. Persistent storage databases use this ID to indicate which server persistent data belongs to. This allows different processes to share persistent data.

Property Name

SID

Property Type

FIXED

Data Type

UUID

Accessibility

READ/WRITE

Mandatory

NO



Previous Common Configuration Properties Next