INSTALL.txt

/**
 * @package segue.install
 * 
 * @copyright Copyright © 2005, Middlebury College
 * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License (GPL)
 *
 * @version $Id: INSTALL.txt,v 1.3 2008/03/03 20:30:16 adamfranco Exp $
 */

------Segue Installation-------

Dependencies:
	- a MySQL database
	- imagemagick

PHP Configuration requirements:
	--with-mysql or --with-postgresql depending on your database
	--with-zlib
	
	(options needed for changing the language of the UI, unneeded for English-only usage)
	--with-gettext
	
	(options needed for usage statistics graph generation)
	--with-gd
	--enable-gd-native-ttf Or one of the other TTF-enabling options.
	
	(options needed for PDO database access system and prepared-statement support)
	--with-pdo-mysql or --with-pdo-postgresql depending on your database
	You will also need to install the appropriate driver - installed with $ pecl install pdo; pecl install pdo_mysql if you use --with-pdo-mysql=shared. 
	Enabling the PDO extension and driver for your database will enable Segue to 
	make use of prepared statements, significantly enhancing performance. Segue 
	will operate fine without PDO however, and this support can be added at a later 
	time with no database changes needed.
	

Setting up Segue:
	1) Create a MySQL or PostgreSQL database for Segue to use.
		A) create the database
		B) give a database user full permission to that database.

	2) Create your database config
		A) copy 
				segue/config/database_default.conf.php
			to
				segue/config/database.conf.php
	
		B) Modify your database config and change the database connection entry 
		   in the config to reflect the database that you just created.
		 
		C) If you enabled PDO support in PHP you can uncomment the 'Harmoni_Db'
		   database setup lines in the database config.
	
	3) Create your Image Processor config
		A) copy 
				segue/config/imageprocessor_default.conf.php
			to
				segue/config/imageprocessor.conf.php
	
		B) Modify the 'imagemagick_path' property in the Image Processor config 
			to be the location in which ImageMagick is installed
		 
	4) (Optional) Set up LDAP authentication
		A) copy 
				segue/config/authentication_default.conf.php
			to
				segue/config/authentication.conf.php
		
		B) comment-in and modify the LDAP authentication piece in
				segue/config/authentication.conf
			to fit your envirnment.
	
	5) Go to Segue in your browser. The default administrator account is:
			Username: jadministrator
			Password: password
		Use the Segue Admin tools to create a new admin account and delete
		the default one.