z-push/EL-6/z-push-README.FEDORA.package

Using Z-Push
============


Setting up your PocketPC
------------------------

This is simply a case of adding an 'exchange server' to your activesync
server list, specifying the IP address of the Z-Push apache server,
disabling SSL, unless you have already setup SSL on your Apache server,
setting the correct username & password (the domain is ignored, you can
simply specify 'domain' or some other random string), and then going
through the standard activesync settings.

Once you have done this, you should be able to synchronise your PocketPC
simply by clicking the 'Sync' button in ActiveSync on your PocketPC.


Troubleshooting
---------------

Most problems will be caused by incorrect Apache settings. To test whether
your Apache setup is working correctly, you can simply type the Z-Push URL
in your browser, to see if apache is correctly redirecting your request to
z-push. You can simply use:

http://<serverip>/Microsoft-Server-ActiveSync

If correctly configured, you should see a username/password request, and
when you specify a valid username & password, you should see a string like

"Your device requested the Z-Push URL without the required GET parameters"

If not, then check your PHP and Apache settings.

If you have other synchronisation problems, you can create the file
'debug.txt' in the root directory of z-push, which should also be either
world-writable or writeable to the apache webserver user:

touch /var/lib/z-push/debug.txt
chmod 777 /var/lib/z-push/debug.txt

or

touch /var/lib/z-push/debug.txt
chown apache:apache /var/lib/z-push/debug.txt

The debug.txt file will then collect debug information from your
synchronisation.


Documentation
-------------

Further information can be found in the Zarafa Z-Push configuration manual
http://download.zarafa.com/zarafa/release/docs/z-push_installation_manual.en.pdf
and at the homepage of Z-Push, http://z-push.sourceforge.net.
Revision:	1.1
Committed:	Sun Jun 12 22:42:40 2011 UTC (23 months, 1 week ago) by robert
Branch:	MAIN
CVS Tags:	z-push-1_5_7-1_el6, z-push-1_5_8-1_el6, z-push-1_5_6-1_el6, z-push-1_5_3-1_el6, z-push-1_5_10-1_el6, z-push-1_5_5-1_el6, z-push-1_5_4-1_el6
Log Message:	Inital import of z-push into RPM Fusion
Line	File contents
1	Using Z-Push
2	============
3
4
5	Setting up your PocketPC
6	------------------------
7
8	This is simply a case of adding an 'exchange server' to your activesync
9	server list, specifying the IP address of the Z-Push apache server,
10	disabling SSL, unless you have already setup SSL on your Apache server,
11	setting the correct username & password (the domain is ignored, you can
12	simply specify 'domain' or some other random string), and then going
13	through the standard activesync settings.
14
15	Once you have done this, you should be able to synchronise your PocketPC
16	simply by clicking the 'Sync' button in ActiveSync on your PocketPC.
17
18
19	Troubleshooting
20	---------------
21
22	Most problems will be caused by incorrect Apache settings. To test whether
23	your Apache setup is working correctly, you can simply type the Z-Push URL
24	in your browser, to see if apache is correctly redirecting your request to
25	z-push. You can simply use:
26
27	http://<serverip>/Microsoft-Server-ActiveSync
28
29	If correctly configured, you should see a username/password request, and
30	when you specify a valid username & password, you should see a string like
31
32	"Your device requested the Z-Push URL without the required GET parameters"
33
34	If not, then check your PHP and Apache settings.
35
36	If you have other synchronisation problems, you can create the file
37	'debug.txt' in the root directory of z-push, which should also be either
38	world-writable or writeable to the apache webserver user:
39
40	touch /var/lib/z-push/debug.txt
41	chmod 777 /var/lib/z-push/debug.txt
42
43	or
44
45	touch /var/lib/z-push/debug.txt
46	chown apache:apache /var/lib/z-push/debug.txt
47
48	The debug.txt file will then collect debug information from your
49	synchronisation.
50
51
52	Documentation
53	-------------
54
55	Further information can be found in the Zarafa Z-Push configuration manual
56	http://download.zarafa.com/zarafa/release/docs/z-push_installation_manual.en.pdf
57	and at the homepage of Z-Push, http://z-push.sourceforge.net.