Z-Push PDA’s and Smartphones Synchronize PDF Configuration Manual
Introduction The Z-Push software allows users with PDA’s and Smartphones to synchronize their email, contacts, calendar items and tasks directly with a Zarafa server over UMTS, GPRS, WiFi or GSM data connections. The following devices are native supported by Z-Push: ? PocketPc 2002 and 2003 ? Windows Mobile 5 and 6 ? Nokia E-series ? Sony Ericsson P990, W950 and M600 ? All other ActiveSync compatible devices The devices can be synchronised because the Z-Push module emulates an MS Exchange server on the server side, allowing users to synchronize without installing specialized synchronisation software on their devices.
Security You can use the SSL feature of the PDA only when you have setup SSL on your server and your server has an acceptable certificate. This means that you either need an official SSL certificate from a commercial certificate authority, or you need to install the certificate on your PDA. Installing SSL certificates is beyond the scope of this document, but many HOWTO’s can be found on the internet. Installation Download the latest Z-Push software on the following website: To Install Z-Push, simply untar the Z-Push tar to your webroot, e.g. with The -C option is the destination where the files need to be installed. In the following overview you’ll see the default webroot directories of where your distribution lets the Apache webserver search for files.
Distribution Default webroot SuSE /srv/www/htdocs RedHat and clones (eg Fedora, CentOS) /var/www/html Debian and Ubuntu /var/www This documents continues the the /var/www directory as example.Now, edit the config.php file in the directory to reflect your local system. For MAPI use with Zarafa, you needn’t change any settings and should work as-is. Make sure that the ‘state’ directory is writeable for your webserver process, so either change the owner of the ‘state’ directory to the UID of your apache process, or make the directory world writeable: chmod 777 /var/www/z-push/state You can also relax the permisions a bit, and correct the user and/or group of the directory, so only Apache can write in the directory: chmod 755 /var/www/z-push/state chown www-data.www-data /var/www/z-push/state The user and group name of Apache will differ per Linux distribution. Below you will find a table with an overview of the correct username and groupname for Apache: Distribution Apache username Groupname SuSE wwwrun www RedHat and clones (eg Fedora, CentOS) apache apache Debian and Ubuntu www-data www-data Now, you must configure Apache to redirect the URL ‘Microsoft-Server-ActiveSync’ to the index.php file in the z-push directory.
This can be done by adding the line: Alias /Microsoft-Server-ActiveSync /var/www/z-push/index.php to your httpd.conf file. Make sure that you are adding the line to the correct part of your Apache configuration, taking care of virtual hosts and other Apache configurations. 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. In steps: 1. Open ActiveSync and select ‘set up your device to sync with it’ 2. Type your server address (without http or other URL parts) 3. Specify your username and password, you must specify a domain but it is not used within Using Z-Push via SSL To synchronise your PDA or Smartphone remote via SSL, you will need SSL support on your Apache webserver. By default the PDA only support SSL certificates that are signed by the following Certified Authorities (CA): • VeriSign • Cybertrust • Thawte • Entrust • GlobalSign • Equifax To buy an official certificate from one of these vendors cost around between 200 and 2000 euro.
With Cacert certificates you still need to install the CA certificate on the PDA. If the server certificate doesn’t match with the server name or the CA certificate isn’t installed, the remote synchronisation cannot be established. Generate official SSL certificate To get an official SSL certificate you first need to create Certificate Signing Requests (CSR). To generate a CSR file, you will first need to create private RSA key. This private key should be kept absolutely personal. openssl genrsa -out host.key 1024 chmod 400 host.key openssl req -new -nodes -key host.key -out host.csr When prompted for the x509 Common Name attribute information, enter the fully qualified hostname the certificate will be used on. The e-mail address will likely be used by the CA to contact you. Leave any subsequent attributes blank, unless the CA requests something be set in them. The csr file must be submitted to a CA. The CA will finally return the certificate. Save the certificate in the file host.crt. To see how you can enable your SSL certificate in your Apache, please see “Configure Apache with SSL”
Download Z-Push PDA’s and Smartphones Synchronize PDF Configuration Manual
Others Search:
z-push ubuntuComments
Leave a Reply