
PostgresForest 4.0 README
=========================

Copyright 2006 NTTDATA Corp., Ltd.


Introduction
------------

	PosgresForest enables to build a PostgreSQL cluster system with replication
	and/or partitioning facilities by enhancing the PostgreSQL JDBC driver.


Package
-------

	This package includes:

	  LICENSE          - PostgresForest license
	  bin/             - templates of several shell scripts
	  build.sh         - build script
	  common.conf      - shared routines for the build/install scripts
   	  docs/            - several documentations
	  env.conf         - build configuration file
	  examples/        - some examples for PostgresForest application
	  install.sh       - install script
	  lib/             - PostgresForest/3rd party libraries
	  setup.sh         - template for database cluster setup/initialize script
	  share/           - JDBC/PostgresForest drivers
	  src/             - all source code.


Requirements
------------

	PostgresForest 4.0 requires:

	  - PostgreSQL 8.1.x (8.1.5 or later)
	  - Red Hat Enterprise Linux 4
	  - Sun j2sdk 1.4.x/1.5.x


Install
-------

	1.) Edit `env.conf' to fit your environment.

		% vi env.conf

	2.) Run `build.sh' script to build the pl/java and scripts.

		% sh build.sh

	3.) Run `install.sh' as root.

		% su
		Password:
		# sh install.sh

Setup
-----

	Run `${FOREST_ROOT}/bin/forest_initdb' to create the database cluster,
	and install some functions used by PostgresForest.


For more information
--------------------

	Latest version is available at http://sourceforge.net/projects/postgresforest.

	If you have any comments or questions, feel free to mail <osdquery@nttdata.co.jp>


EOF

