Appendix B. Installing The Ozone Back-End

Table of Contents

Ozone Database Creation
Running The Ozone Database Server
Connecting to Ozone

This appendix details the procedure for setting up an Ozone database store for the Ozone back-end. For full details about Ozone and Ozone database administration, please see the Ozone database documentation (available either by downloading the Ozone binary or source pacakges from the Ozone project pages at SourceForgeor online on the project's SourceForge documentation page)

Ozone Database Creation

Ozone database creation is managed by a command-line application which is contained in the ozone.jar file shipped with TM4J. However, TM4J does provide a "wrapper" Ant target for running this application. To create a new database simply invoke ant with the target 'ozone-install'. This target accepts three parameters as described below.

ozoneDB.dir
The directory into which the Ozone database will be installed. This defaults to "db". Relative path-names will be resolved from the directory in which the Ant task was invoked.
ozoneDB.port
The port on which the database server will listen for client connections. Any client wishing to connect to the Ozone database server using the ozonedb:remote protocol will have to specify this port number in the connection URL. See the section called “Connecting to Ozone” for more details about client connections to Ozone.
ozoneDB.adminPort
The port on which the database server will listen for administration client connections. This port is not used by standard TM4J applications. To read more about administration of the Ozone database, please see the Ozone documentation.