| This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation. |
Difference between revisions of "Z-push"
(→Manual) |
(→Debugging) |
||
| Line 95: | Line 95: | ||
Sometimes it can happen that an item is not synced to the device. | Sometimes it can happen that an item is not synced to the device. | ||
| − | Then you | + | Then you can add a file (call the file "debug.txt") to the /modules/z-push folder and make sure that it is writable for Apache. |
| + | This log will be filled with debugging information when you sync. | ||
| − | + | Please check the errors in the "debug.txt" file, if you cannot solve the problems by yourself then please create a support ticket for the problem and attach the log to the ticket. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
Revision as of 11:05, 23 May 2013
Contents
Overview
This module can be used to synchronize Emails, Contacts, Tasks and Calendars to a mobile device/tablet.
Dependencies
Apache modules
Some apache modules cannot be enabled because Z-Push is NOT working when they are enabled.
- mod_pagespeed (source: http://z-push.sourceforge.net/phpbb/viewtopic.php?f=2&t=2286&p=8480&hilit=pagespeed#p8480)
Requirements
Installation
IMPORTANT NOTE: remember to replace the z-push files again when you are upgrading Group-Office if you installed Group-Office manually! Debian packages will do this automatically for you from now on. But you need to perform step 5 manually (this can not be automated due to licensing issues with z-push).
Automatic
To install the z-push module automatically, you can use the script that is provided with the "Sync" module. (install.sh)
The script is located in the "modules/sync/z-push" folder.
Manual
ActiveSync support does not work out of the box. To add support of ActiveSync take the following steps (Step 1 to 5 can be done with modules/sync/z-push2/install.sh too):
1. Download z-push from http://zarafa-deutschland.de/z-push-download/final/1.5/. We used version 1.5.2 (But it's probably best to take the latest stable 1.x version of z-push).
2. Unpack the archive and put it in the "modules" directory of Group-Office.
3. rename the folder to "z-push"
4. Copy the file backend/GObackend.php from modules/sync/z-push/ to modules/z-push/backend/
5. Copy config.php from modules/sync/z-push/ to modules/z-push/
6. Now, you must configure Apache to redirect the URL 'Microsoft-Server-ActiveSync' to the index.php file in the modules/z-push/ directory.
This can be done by adding the line:
Alias /Microsoft-Server-ActiveSync /path/to/groupoffice/modules/z-push/index.php
Don't use a symlink, this won't work.
7. Restart apache2 and configure your mobile device with the servername, username and password and you should be in sync!
CGI mode
By default z-push only works when PHP is loaded as an Apache module. If you use PHP in CGI mode you'll have to follow this workaround:
You can also try to create a .htaccess file in the Group-Office root dir and add the following lines to it:
Options +FollowSymLinks
RewriteEngine On
RewriteRule /Microsoft-Server-ActiveSync(.*) modules/z-push/index.php$1 [E=ACTIVESYNC:true,E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
In some versionw of PHP the apache_request_header() function doesn't exist and the following needs to be added to modules/z-push/compat.php at the end of the file just before: ?>
if (!function_exists('apache_request_headers')) {
function apache_request_headers() {
$header = array();
$header['Ms-Asprotocolversion'] = $_SERVER['HTTP_MS_ASPROTOCOLVERSION'];
$header['X-Ms-Policykey'] = $_SERVER['HTTP_X_MS_POLICYKEY'];
$header['User-Agent'] = $_SERVER['HTTP_USER_AGENT'];
return $header;
}
list($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW']) = explode(':' , base64_decode(substr($_SERVER['REDIRECT_HTTP_AUTHORIZATION'], 6)));
}
Uninstall
Remove the z-push folder from the modules directory of Group-Office.
User Manual
- LINK TO USERMANUAL
Additional Notes
For debugging change modules/z-push/config.php:
define('LOGLEVEL', LOGLEVEL_ALL);
A log will be generated in /home/groupoffice/log/
Debugging
Sometimes it can happen that an item is not synced to the device.
Then you can add a file (call the file "debug.txt") to the /modules/z-push folder and make sure that it is writable for Apache. This log will be filled with debugging information when you sync.
Please check the errors in the "debug.txt" file, if you cannot solve the problems by yourself then please create a support ticket for the problem and attach the log to the ticket.
