Installing Z-Push Backends for Horde
====================================


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

Horde		3.3.5
Kronolith	2.3.2
Turba		2.3.2
Z-Push		1.2.1

This document provide instruction for a basic installation.
For more details, refer to each software's documentation.

These extensions has been tested with MySQL 5.0 but should work 
with previous versions, as it uses very common functionnalities.


How to install
--------------

Z-Push
------

Untar the Z-Push installation archive to your system's webroot:

	tar -xvf z-push-1.2.1.tar.gz -C webroot/

	
Edit the config.php file in the extracted z-push/ folder :

	Set:	$BACKEND_PROVIDER = "BackendCombined";		at line 36

Optional : activate debugging by editing wbxml.php :

	Set:	define('WBXML_DEBUG', true);		at line 15

and creating a world-writable debug.txt file :

	touch webroot/z-push/debug.txt
	chmod 777 webroot/z-push/debug.txt

Make the state directory writable by the webserver process :

	chown www-data:www-data webroot/z-push/state
	chmod 755 webroot/z-push/state

Configure apache : modify file apache2.conf :

	Add:	# Configuration Z-Push
		Alias /Microsoft-Server-ActiveSync webroot/z-push/index.php
		php_flag magic_quotes_gpc off
		php_flag register_globals off
		php_flag magic_quotes_runtime off
		php_flag short_open_tag on

Configure Horde : modify file webroot/horde/config/nls.php :
	Modify:  $nls['defaults']['language'] = 'your_LANGUAGE';  at line 15
	and	 $nls['charsets']['your_LANGUAGE'] = 'UTF-8';    at line 124

For instance, replace 'your_LANGUAGE' by 'fr_FR' for french.


Z-Push Backends
---------------

Untar the backends archive to the z-push folder, usually webroot/z-push/backend/

Edit the kronolith.php file to set Horde relative properties:
	- Horde base installation folder,
	- Database host, name, user & password

Run the CreateDB.sql script in mysql as a user with enough privileges.

Edit and run the AddUser.sql script to add the user's phone to the mysql database.


Phone configuration
-------------------

Configure the ActiveSync parameters on your phone by refering to its documentation.
Your must specify at least the user name, the password and the server address on it.