This document describes how to install ozone. 

Environment variables
---------------------

There are a number of environment variables that control ozone 
runtime properties. On Linux (bash) you may set variables via:

	export <variable>=<value>

on windows this is done via
	
	set <variable>=<value>


- OZONE_HOME :
The home directory of your ozone installation. This variable must be set

- PATH :
The PATH variable is not ozone specific but helps you starting the ozone
server and tools. Add <OZONE_HOME>/bin to your PATH.

Running the ozone server
------------------------

1. Initialize database directory.

A database directory holds all files of an ozone database. To initialize an
empty database start the ozone install tool:

	ozoneInst -d<data_directory>

To see all possible parameters of ozoneInst type 'ozoneInst -h'.

2. Start the server.

	ozone -d<data_directory> -u<username>

You will get some status information and after the initialisation ozone is up
and running. You can setup as many databases and you can run as many servers
as you need on one system. To define users and to do other administration
things use the admin tool:

	ozoneAdmin

To see all possible commands and parameters of ozoneAdmin type 'ozoneAdmin -h'.


Trying out the ozone samples
----------------------------

IMPORTANT NOTE: the VM of the ozone server must be able to access the class
   files of the application. To run the ozone samples, you may add "." to
   your CLASSPATH and start the ozone server INSIDE THE SAMPLE DIRECTORY.
   
1. Start the server.

Open a new console. Change directory to <OZONE_HOME>/samples/simple. Install
a new database via 'ozoneInst -d<db_dir>'. Start the server via 
'ozone -d<db_dir> -u<username>'.

2. Start the Client.

Open a new console. Change directory to <OZONE_HOME>/samples/simple. Build
the client via '../../build.[sh|bat]' or 'make'. Start the client via
'ojvm Client'.

That's it!