[cvs] [Wiki] changed: ActiveSync
Michael Rubinsky
mrubinsk at horde.org
Thu Jun 10 22:59:15 UTC 2010
mrubinsk Thu, 10 Jun 2010 18:59:15 -0400
Modified page: http://wiki.horde.org/ActiveSync
New Revision: 1.67
Change log: update language to reflect a less-experimental vibe...
@@ -1,9 +1,9 @@
[[toc]]
+ ActiveSync
-Horde 4 has support for allowing Horde to sync with mobile devices
using the mobile device's support for Microsoft Exchange/!ActiveSync.
Horde's !ActiveSync implementations is based on the Z-Push library
(http://z-push.sourceforge.net) for handling !ActiveSync protocol
communication.
+Horde 4 has support for allowing Horde to sync with mobile devices
using the mobile device's support for Microsoft Exchange/!ActiveSync.
The code that Horde's !ActiveSync implementation uses for handling the
protocol communication is based in part on the Z-Push library
(http://z-push.sourceforge.net).
++ Bugs
@@ -15,15 +15,15 @@
++ Description
The Horde !ActiveSync implementation provides over the air
synchronization of email, contacts, and calendar data to devices such
as the iPhone/iPod Touch, Android and any other system supporting
!ActiveSync. This implementation supports Microsoft !ActiveSync
protocol versions up to 2.5 - the version implemented by Microsoft
Exchange 2003.
-++ Trying it out
+++ Configuration
-The !ActiveSync code has been merged into git master, but is not
active by default. You should be aware that this code is still
considered experimental. While it mostly works for us in our tests, on
our test devices, there may still be bugs. It may work, it might not,
or it might make your iPod grow legs and run for higher ground. You
have been warned.
+!ActiveSync support is not active by default, and should still be
considered experimental. The code base is fairly stable, but there are
still devices on which it has not been tested yet. It may work, it
might not, or it might make your iPod grow legs and run for higher
ground. You have been warned. If you have used a device with Horde's
!ActiveSync support that is not listed below, please feel free to let
us know how it went.
-To activate the server, you need to enable it in Horde's
configuration, on the !ActiveSync tab. There are two possible state
drivers, a file based driver based on Z-Push's //diff// backend, and a
Horde_History based driver that is orders of magnitude more efficient
for synching with Horde. The file based state driver is included as a
state driver for those using the Horde_ActiveSync library as a
solution for other groupware backends. You should use the History
driver with Horde. You will need to create the SQL tables that the
driver uses using the //horde/scripts/sql/horde_activesync.sql//
creation script.
+To activate the server, you need to enable it in Horde's
configuration, on the !ActiveSync tab. You will also need to create
the SQL tables that horde uses using the
//horde/scripts/sql/horde_activesync.sql// creation script.
-You will also need to configure your webserver to redirect the URL
Microsoft-Server-ActiveSync to your horde/rpc.php file. How you do
this depends on your webserver and it's configuration. For Apache,
something like:
+Next, you will need to configure your webserver to redirect the URL
Microsoft-Server-ActiveSync to your horde/rpc.php file. How you do
this depends on your webserver and it's configuration. For Apache,
something like:
<code>
Alias /Microsoft-Server-ActiveSync /var/www/html/horde/rpc.php
</code>
@@ -51,13 +51,13 @@
|| Windows Mobile Device || 6.1 || ? || ? || Contacts reported to work. ||
|| Windows Mobile Emulator || 6.5 || Yes || Yes || Contacts,
Calendars (with proper support for recurring events and exceptions),
and Tasks. ||
|| Nokia E90 || !MfE 3.0 || ? || ? || Contacts verified to work ||
-**IMPORTANT NOTE** There have been reports that some devices running
Android 2.1 DO have support for provisioning, however there have been
reports of major issues with regards to the unlock password screen.
Evidently, once a password is set it looks like it's impossible to
remove it. I have tested both the 2.1 SDK emulator as well as the
Motorola Droid (NOT the Milestone) and these still do NOT support
provisioning. This issue might be limited to the Milestone device.
That being said if you plan on having users with Android 2.1 devices,
do NOT enable provisioning unless you are willing to deal with this
issue.
+**IMPORTANT NOTE** There have been reports that some devices running
Android 2.1 DO have support for provisioning, however there have been
reports of major issues with regards to the unlock password screen.
Evidently, once a password is set it looks like it's impossible to
remove it. I have tested both the 2.1 SDK emulator as well as the
Motorola Droid (NOT the Milestone) and these still do NOT support
provisioning as of version 2.1. This issue might be limited to the
Milestone device. That being said if you plan on having users with
Android 2.1 devices, do NOT enable provisioning unless you are willing
to deal with this issue.
+++ Setting up the device
-It's beyond the scope of this page to go into detail for each
individual device. In general, you will need to create a new account
on your device. The account type should be something like //Microsoft
Exchange// or //!ActiveSync//. Some devices use //Corporate//. You
will need to enter your normal Horde username and password in the
appropriate fields. In the field for the server address, you should
enter the **root** of the webserver or virtual host that hosts Horde.
For example, if you host horde at http://host.example.com/horde then
you should enter http://host.example.com. You can ignore any reference
to a //domain// entry.
+It's beyond the scope of this page to go into detail for each
individual device. In general, you will need to create a new account
on the device. The account type should be something like //Microsoft
Exchange// or //!ActiveSync//. Some devices use //Corporate//. You
will need to enter your normal Horde username and password in the
appropriate fields. In the field for the server address, you should
enter the **root** of the webserver or virtual host that hosts Horde.
For example, if you host horde at http://host.example.com/horde then
you should enter http://host.example.com. You can ignore any reference
to a //domain// entry.
A special note for the iPhone/iPod (and possibly others) - if you do
not use a SSL enabled site you may receive errors about not being able
to find the !ActiveSync server. If this happens, just continue, or
save, or whatever your option is to continue. On the iPhone, after
everything is completely set up, you must go back into the account
settings and disable SSL.
After the connection particulars are entered, you should choose to
enable the folders that you want sync'd. Contacts, Calendar and Tasks
are supported, but your device also needs to support the requested
folders.
@@ -77,9 +77,11 @@
++ What to do if you have problems (or How to help us debug your issue)
**If you are not even able to get past the initial setup page on
your phone**: you should first check to be sure you do not have SSL
enabled on the phone when you're server is not serving SSL. The
iPhone/iPod will not let you turn this off until after you save the
configuration, so you must continue through all the errors and go back
into the settings to disable SSL. You should also make sure that you
have not enabled Provisioning support if your phone does not support it.
-**If the configuration went well, but you are not seeing any
contacts/calendar items appear on the device:** Some clients require a
manual refresh or folder selection after setup when not using the
"Automatic Discovery" facility of Exchange. With !TouchDown, for
example, after setup you must select the folders you want sync'd under
the Advanced settings tab. If you can't figure out this issue, we will
be happy to try to help work it out, but you should be able to
check/provide us with the following:
+**If the configuration went well, but you are not seeing any
contacts/calendar items appear on the device:** Some clients require a
manual refresh or folder selection after setup when not using the
"Automatic Discovery" facility of Exchange. With !TouchDown, for
example, after setup you must select the folders you want sync'd under
the Advanced settings tab.
+
+If all else fails and you can't figure out the issue, we will be
happy to try to help you work it out, but you should be able to
check/provide us with the following:
* Check the web server error logs and see if there are any PHP
errors being logged.
* Configure Horde to send !ActiveSync log messages to a separate
logfile. This is configured on the !ActiveSync tab of Horde's
configuration screen.
* If you are able to, it would also be useful to run a wireshark
session to capture the network communication.
More information about the cvs
mailing list