OX6:OXtender for Business Mobility Installation Guide
OXtender for Business Mobility
Description
The OXtender for Business Mobility is an extension to the Open-Xchange Server enabling Exchange ActiveSync capabilities. ActiveSync is a widespread proprietary protocol developed by Microsoft which allows mobile devices to communicate with groupware servers or desktop computers. Client-side implementations of ActiveSync are available for Windows Mobile, Apple iPhone, Symbian, BlackBerry and Android devices. The protocol covers a very large amount of business smartphones and handheld computers. Since Open-Xchange is able to communicate through native ActiveSync, there are no third party clients required on compatible devices. Integration to the native applications of the specific device is more seamless than with any other synchronization technology. ActiveSync supports synchronization of E-Mail, appointments, contacts and tasks by polling, manual sync or push.
Components
With the OXtender for Business Mobility, Open-Xchange also introduces the Universal Synchronization Module (USM). This module provides a framework for synchronization protocols such as Exchange ActiveSync (EAS) or other services building on this foundation. USM acts as a layer between the Open-Xchange HTTP API and the synchronization protocol. It handles synchronization specific tasks like conflict management. The synchronization stack (USM) and protocol implementation (EAS) are shipped as OSGi bundles and run as a plug-in of an Open-Xchange instance.
Component Overview
Requirements
Since the OXtender for Business Mobility is a server plug-in based on the OSGi Framework it can be added to an existing Open-Xchange installation very easily. Open-Xchange Server 6.10 or later is required to operate this extension. The OXtender for Business Mobility uses the resources and services offered by the Open-Xchange server, no additional software or configuration is required.
Download
Installation
After downloading the packages, they can be installed using the operating systems package manager. For example:
dpkg -i open-xchange-usm_6.10.0.0-2_all.deb
This will extract the package and configure the integration to the Open-Xchange server.
Configuration
Open-Xchange configuration
The configuration for USM and the EAS protocol can be found here:
/opt/open-xchange/etc/groupware/usm.properties
The default configuration is sufficient for most installation. Documentation about the configuration parameters can be found inside the configuration file. After the installation is complete, the Open-Xchange groupware needs to be restarted, after that USM and EAS services are available.
Apache Configuration
Mobile devices supporting ActiveSync use a special URL to communicate with the ActiveSync enabled server. This URL needs to be forwarded to the Open-Xchange ActiveSync servlet. When using Apache 2 and mod_proxy_ajp, this servlet can simply be added to the webservers configuration:
ProxyPass /Microsoft-Server-ActiveSync ajp://127.0.0.1:8009/Microsoft-Server-ActiveSync stickysession=JSESSIONID
The example assumes that the Open-Xchange server is running on the same machine like the webserver. Please refer the Open-Xchange administrator documentation for more information about Apache configuration.