Previous | Common Configuration Properties | Next |
The properties on the Persistence tab determine how and where the Service data is stored persistently.
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.
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.
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.
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:
A return value greater than 0 (zero) means that the database operation should be re-tried after the returned interval (in milliseconds).
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.
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.
jdbc:oracle:thin:<data_source_name>
Where <data_source_name> is the name of the JDBC data source.
jdbc:sybase:Tds:<data_source_name>
Where <data_source_name> is the name of the JDBC data source.
jdbc:informix-sqli:<data_source_name>
Where <data_source_name> is the name of the JDBC data source.
Where <data_source_name> is the name of the JDBC data source.
There are three ways in which hsqldb can be run, each requiring a different URL format.
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>/
<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:hsql://<host>:<port>
<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.
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.
Whether JDBC calls will be logged or not.
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.
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).
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.
Previous | Common Configuration Properties | Next |