[Wiki] changed: ActiveSync

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.


-- 
To unsubscribe, mail: [email protected]