The Address Book Reloaded 3.0 - INSTALL FILE

=============
Requirements:                               
=============

PHP
    Webserver with PHP 4.1 or 5 support, 
    SAFE MODE operation possible.
    php4-mbstring or php5-mbstring (UTF-8)
    php4-gd or php5-gd (Image scaling and thumbnail generation)
    php4-session or php5-session
    Recommended:
    php4-curl or php5-curl (for Map-O-Rama Maps geocoding interface)
MySQL
    MySQL (>=4.1 version ) up and running
    (MySQL 4.0.x see http://sourceforge.net/forum/forum.php?thread_id=1545900&forum_id=590643)

Safe Mode:
    Symbolic link to mysqldump in safemode exec directory if backup download 
    is desired.

Backup:
    mysqldump must be accessible through the exec() command.
    Otherwise please use phpmyadmin or manual backup from the shell.

Support Forums:
http://sourceforge.net/forum/forum.php?forum_id=590643

=============
Installation:                               
=============

Option 1:
1. Copy all files to server
2. Copy config.php.template to config.php on your server
   [Optional: change DB user, password, table prefix etc.]
2a. Plugins will load config.template.php by default. To customize plugins
    copy config.template.php to config.php and make changes for each plugin 
    in the plugin directory.
3. Grant access to the DB user for the database
	mysqladmin -u root -p create tab2
	mysql -u root -p -e 'GRANT ALL ON tab2.* TO tab2 IDENTIFIED BY r3loaded'
    DO NOT USE SPACES in passwords, prefixes, database names, tablenames! 
4. Open http://myserver.com/tab2/install.php in your browser and follow the instructions.

Option 2:
	This option speeds up future upgrades to a few minutes work if you have SSH 
    shell access to the server.

Requirements:
	You have SSH shell access to a server on a UNIX based system where you 
	want to install the system (See Using SSH authorized keys below).
	Recommended for Windows to Linux install: Cygwin installed (+ openssl package)	
	
Steps (The DB specified in deploy-config (MYSQL_DB_NAME) will be OVERWRITTEN):
1. cp deploy-config.template to deploy-config
2. Edit deploy-config (set install paths and hostnames)
3. Run ./deploy.sh -t (install testserver) or ./deploy.sh -q (install HOT server)
4. copy install.php to your server
5. Continue @ Option 1 Step 2

Windows see:
http://php.net/manual/en/install.windows.extensions.php 

Support Forums:
http://sourceforge.net/forum/forum.php?forum_id=590643

========
UPGRADE:
========

BACKUP FIRST or be sorry:
	Make a backup of your DB and your old version of TAB !!!!!
	mysqldump -u root -p TABDATABASENAME >myTABBackup.sql
    ... or use phpmyadmin.

WARNING: TAB 1.04e upgrades to 3.0 are not possible. They must be first upgraded 
to 2.0x with the 2.0x codebase 
(e.g. http://sourceforge.net/project/showfiles.php?group_id=172286&package_id=197021&release_id=454116). 

MAJOR CHANGE:
    After the upgrade all user accounts are linked to address records.
    Login names change to the email address of the user.
    If possible please assign an email address to every USER without email 
    before the upgrade.

2.x to 3.x and later UPGRADE:
    THIS IS A MAJOR UPGRADE! Read carefully! 
    1. Rename your old installation directory.
    2. Copy the new 3.0 codebase to the server.
    3. Copy your old mugshots directory to your new installation directory.
    4. CREATE a new config.php: Copy config.php.template to config.php on your 
       server and transfer the DB passwords from your old config to the new one 
       and change any new options you need.
    5. Run upgrade.php (after having a backup of your DB!!)

FUTURE VERSIONS: 3.0 to any newer or newer use the following
	1. copy the files to your server
	   (or use your deploy-config and ./deploy -t OR -q -- see INSTALL)
	2. Open in your browser: upgrade.php
	3. compare and edit config.php and config.php.template to check for new 
       options and 

Support Forums:
http://sourceforge.net/forum/forum.php?forum_id=590643

======
HINTS:
======

Using SSH authorized keys:
Generate an ssh paswordless login identity:
#> ssh-keygen -t rsa
Install the identity on the remote host:
#> cat ~/.ssh/*.pub | ssh user@remote-system 'cat>>.ssh/authorized_keys'
See also:
http://www.puddingonline.com/~dave/publications/SSH-with-Keys-HOWTO/document/html/SSH-with-Keys-HOWTO-4.html
