$Header: /cvsroot/myorgbook/unstable/docs/install.txt,v 1.7 2003/10/19 19:43:36 mik3 Exp $

MyOrgBook  Version 2.7

While every attempt has been made to ensure MyOrgBook's installation is the
same as other PHP/MySQL applications, this file is provided for your use in
double checking the setup and configuration.

1. Required Applications:
	- PHP 4.1 or higer
	- MySQL or any other AdoDB supported Database
	- Apache or a similar webserver
To check if you have these applications installed and correctly configured to work with each other follow the following steps:
	1. Create a file called test.php
	2. Edit the file and put the following line in it: <? phpinfo(); ?>
	3. Upload the file to your webserver
	4. Fire up your browser and load the file on your webserver.
	5. Browse to the content and find Apache and MySql, if you can see the versions it's ok.

2. Install Myorgbook
	1. Download MyOrgbook (as you are reading this, I suppose you did that :-)
	2. Unzip/tar whatever (as you are reading this, I suppose you did that :-)
	3. Open the file inc/conf.inc.php in your favorite editor
	4. Change $MyEmail value to your e-mail address (ie $MyEmail = "mik3@users,sourceforge.net";) this is important, errors and feedback from users are directed to this address.
	5. Change $MyName in to something usefull (ie $MyName = "CEO STFU Corp.") users get e-mail with your name.
	6. If you are using any other database then MySQL change $db = NewADOConnection('mysql') to reflect your database
	7. Change the settings of your database. $db->Connect("localhost", "DBUser", "DBPassword", "myorgbook"); Localhost is the host where MySQL is running, DBUser is the username needed to login, DBPassword the password associated with username, myorgbook represents the databasename. Example: $db->Connect("database5.yahoo.com", "linda123", "AudiTT", "dbLinda123");
	8. Create the table structure.
		1. If you have access to phpMyAdmin
			1. Create database (when needed)
			2. Use option under "Run SQL query/queries on database ..." called "Location of the textfile:", press browse button, find createdb.txt
		2. Console
			1. start mysql
			2. login
			3. select database (USE ...)
			4. run createdb.txt (source /path/to/createdb.txt)
	8. remove upgrade directory
	9. In order for the reminders to work you'll have to setup a cron entry for every hour.
		- Example for vixie cron:
			1. Check with 'crontab -l' if you have already cron entries.
			2. If you have crontab entries 'crontab -e' and add the following line. Otherwise make a file with the following line:
				1 * * * * wget -q http://www.domain.com/myorgbook/EmailTaskReminders.php -O /dev/null
			   This bacically says run every hour at the first minute of the hour.
			3. If you had crontab entries, you're done. Otherwise 'crontab <filename>'  and you're done.
		If you do not have access to a shell or don't have cron access.... Try pseudocron (http://www.bitfolge.de/?l=en&s=pseudocron)
		If you do not want reminders you can remove them from the template (Templates/ManageTask.tpl)
	11. Make an account with the same e-mail address as used in $MyEmail, this account will have administrator rights (Caps make a difference!)

3. Upgrade MyOrgbook
	1. Determine which version you have running
	2. Delete all files, and upload new version, adjust conf.inc.php
	3. copy the approriate upgrade script to the main MyOrgBook directory (upgrade_2.7.php if you're upgrading from 2.6 or 2.5.x)
	4. run those scripts
	5. delete copied scripts and upgrade directory
	6. Done (you might want to check out changes.txt)
