Gridbus Grid Service Broker v.3.1
----------------------------------
- How to install

1. Customized the Gridbus Broker installation using Ant
The user can customize the installation of the Gridbus Broker using an ant script which provides various settings for various
middleware and programming model support. By editing the setting.properties file, users can choose
to install modules for their requirements only rather than the entire release. 

System Requirements:
a) Ant 1.6.5 or later
b) CVS
Make sure the execution command is on your system path.

Steps:
a) Download the configuration files including 2 build files and 2 properties files
b) Download the ant contribution library and put the jar files to $ANT_HOME/lib directory
c) Export the GBB_HOME as an environment variable to set the GridbusBroker home directory
d) Run the ant script
e) The distributiion will be loaded from the sourceforge CVS and built on your machine. 

Note: You can easily change the setting.properties file to enable or disable various middlewares or
programming models supported by the Broker.

2. Install the Gridbus Broker via the zip/tar file
This option is easy and the release contains everything that the Broker supports. 

System Requirements: None

Steps:
a) Export the GBB_HOME as an environment variable to set the GridbusBroker home directory
b) Extract the zip/tar file to the GBB_HOME directory

- Installation directory structure:

The installation directory of the Gridbus Broker is structured as follows.
The build.properties, and build.xml files in the home directory 
are provided to help users build a full Gridbus Broker distribution from the 
source.

	<install-dir>
		/bin
		/docs
		/examples
		/lib
		/licenses
		/manual
		/src
		/schemas
			
- Getting started:

The first thing to do to run the Broker, after extracting the Broker zip/tar file,
is to set up the database that the Broker will use. To do this, use the following
steps:

1. Export the environment variable GBB_HOME to point to the Broker home directory.
	(For eg. if the Broker is extracted to /home/xchu, GBB_HOME=/home/xchu/gridbusbroker-m.n
	(where 'm.n' is the major.minor version number)
	
2. Run the database setup utility (setupDB.sh / setupDB.bat ) found in the bin directory, 
	from the GBB_HOME directory, i.e the Broker home directory.
	(The broker should be run from the same directory where the setupdb util was run from.
	This is because the 'setupdb' sets up the database in the directory it was run from, and
	the broker looks in the current directory for the database when running).
	
3. Run the broker using -h option to get usage information:
	bin/gbb.sh -h
	
	For more information please refer to the user manual (in the manual directory).