INSTALLATION INTRODUCTION
############################################################

This is a simple set of scripts. Which do a lot to accomplish
what others might consider to be relativly simple tasks.

I'm calling this package eZ Build SVN : ezbuildsvn

What it does:

buildsvn.sh
- Get svn trunk source code
- Prepare source code for use (build source code)
- Package source code for transmission over the internet / archival
- Post source code packages (Usefull for creating your own mirror of the eZ publish svn trunk builds)

buildsvndemo.sh
- All that buildsvn.sh does
- Install eZ publish trunk code as online demo web site
-- Configure demo site using previuosly prepared / customized : site.ini & .htaccess (files wich require customization)

I wrote this package of scripts using the /bin/sh shell script interpreter.
Against the direction of a number of people who suggested perl, python or php 
as the languages I should use to write this package. I chose sh!

I chose sh because it is, stable, reliable, installed on just about every 
unix like operating system on the planet.  

Meaning that this package will be compatable with your system, out of the box. 
It made it harder to write the script using a low level language like sh, but 
the rewards (compatibilty/stablity) are well worth it

Installation Steps
############################################################

Step 1: Unpack the ezbuildsvn.tar.gz package 
        Doesn't matter where you unpack the package (grin) really.
        tar -zxf ezbuildsvn.tar.gz

Step 2: Change directories into ezbuildsvn
        cd ezbuildsvn;

Step 3: Prepare / Edit the buildsvn.sh | buildsvndemo.sh scripts to set the variious variables 
	which are different on your system. Specificly these ...


buildsvn.sh
	REPOSITORY='http://pubsvn.ez.no/ezcommunity2/ezcommunity/trunk/';
	PACKAGE_DESTINATION_DIR='/home/web/ezcommunity.net/html/download/svn_builds/';

	SVN='/usr/bin/svn --force';

buildsvndemo.sh
	DEMO_WEBDOCS_DIRECTORY="/home/web/ezcommunity/demo.ezpublish23";

	ONLINE_DEMO_DB_NAME="ezpublish23_svn_trunk_demo";
	ONLINE_DEMO_DB_USER="demo23svn";
	ONLINE_DEMO_DB_PASS="demo23svn";

Step 4: Prepare / Edit the site.ini and .htaccess files located in ezbuildsvn/examples/
	These must be customized in order for the online demo to run properly.


Step 5: Usage / Run the scripts
	Here's where things get gritty. Depending on what you want is which scripts you will use.


	buildsvn.sh
    	  If you just want to build a tar.gz package of the current svn trunk, then you want to use: buildsvn.sh

	Usage:   ./buildsvn.sh [Verbose] (SVN_Method)
	 - Verbose (1 - Verbose, 0 - Quiet)
         - SVN_Method (1 - checkout, 0 - export)

        Default is always 0
	
        Example: ./buildsvn.sh 0 0


	buildsvndemo.sh
	  If you want to host a demo web site using the eZ publish 2.3 trunk, then you want to use: buildsvndemo.sh 

        Usage:   ./buildsvn.sh [Verbose] (SVN_Method)
         - Verbose (1 - Verbose, 0 - Quiet)
         - SVN_Method (1 - checkout, 0 - export)

        Default for these script arguments will be 0

        Example: ./buildsvn.sh 0 0

        You can use both of them too!
        - I use cron to run buildsvn.sh to build downloadable packages for our developers.
        - I use cron to run buildsvndemo.sh to build / rebuild our svn trunk online demo for our users.

Step 6: (Optinal) Setup Cron for the scripts to run on a schedual.
	If you use the cron examples, you must customize the crontab entries 
	to match the installation directory paths used on your system.

        Crontab Entries (from example/crontab.txt)

        MAILTO=root@localhost
        52 0,12,23 * * * /home/build/buildsvndemo.sh 1 0 >> /home/demo.ezpublish23/ezbuildsvn/logs/buildsvndemo_cron.log;

        MAILTO=root@localhost
        52 0,12,23 * * * /home/build/buildsvn.sh 1 0 >> /home/demo.ezpublish23/ezbuildsvn/logs/buildsvn_cron.log;

        Use the command ` crontab -l ` to list your existing crontab entries
        Use the command ` crontab -e ` to edit your existing crontab file

        Use the commands (bellow) to load the example cron configuration into your existing cron configuration.
	crontab -l > doc/my_existing_crontab.txt; 
        cat doc/my_existing_crontab.txt >> doc/my_new_crontab.txt;
	cat doc/crontab.txt >> doc/my_new_crontab.txt;
	crontab my_new_crontab.txt;

Note 1:	Administrator Account : User
	
	User Site:  http://ezpublish.demo.ezcommunity.net/
	Admin Site: http://my.ezpublish.demo.ezcommunity.net/

	Online Demo Administrator Account
	User: admin
	Password: publish 


(Example) .htaccess
############################################################
See example/.htaccess
Must copy the example/.htaccess into the root of your eZ publish 2 installation (webdocs,html,docs,www dir)


(Example) site.ini
############################################################
See example/site.ini

Must copy the example/site.ini into the root of your eZ publish 2 installation (webdocs,html,docs,www dir)

Support
############################################################
Still Having Problems? Refer your inquiries to one of these sources of eZ publish 2 support.

eZ publish 2 Community Support : http://ezcommunity.net/

eZ publish 2 Support / Development : http://brookinsconsulting.com/

Check doc/BUGS for a match of the description of the issue and our solution / background information about the issue.

