Zimbra Connector for Apple iSync 5.0 (Rev October 2008)
Table of Contents Previous Next

Zimbra Connector for Apple iSync

Zimbra Connector for Apple iSync
When the Zimbra Connector for Apple® iSync is installed, you can use Apple Address Book, iCal, and Microsoft® Entourage® to access the Zimbra Collaboration Suite server and synchronize data to and from the Mac.
Note: Calendar syncing integration with Entourage is only supported for OS X 10.4. Calendar syncing integration on OS X 10.5 or later is handled with CalDAV.
The Zimbra Connector for Apple iSync only supports Microsoft Office 2004 Entourage for Mac, version 11.2.3. This is the first version of Microsoft Office for Mac in which Entourage supports Mac Sync Services, the same service used by the iCal and Address Book applications for data synchronization.
The Zimbra Connector for Apple iSync plug-in uses the standard Apple package installer. It takes only a few minutes for users to install the Zimbra Connector for Apple iSync on their computers, establish the connections to the Zimbra server and set up a synchronization schedule.
Before you begin
The Zimbra Connector for Apple iSync works on Apple computers running OS X 10.4.1 or later.
Note: Recommended OS is 10.4.6 or later.
Before you synchronize your calendars and address books, you should backup your Apple’s iCal and Address book data. If synchronization should fail, you can use these files to restore your Mac information.
Steps to configure the Connector for Apple iSync
Zimbra Connector for Apple iSync is configured from System Preferences.
After the Zimbra Connector for Apple iSync is installed, open System Preferences; click Zimbra from the Other row. The Zimbra dialog opens.
Select the Account tab. Enter the following information:
Description. Enter a name to identify this account.
Server. Enter the Zimbra server domain name (DNS).
Server port. Enter the port number for the server. In most cases, for non-secured connections, the default is 80 and, for secured connections the default is 443. Your configuration can be different.
Check Use Secure Sockets Layer to establish a secure connection to the port, if required.
Your Zimbra account user name and password.
After the account information is entered, the user is authenticated with the Zimbra server. When authentication is complete, Authenticated displays in the lower right of the dialog.
Click the Sync tab to set up your synchronization schedule and select folders to sync.
From the Synchronize list select the sync schedule: Manually, Every Hour, Every Day, or Every Week. If you select Manually, synchronization happens only when you come back to this dialog and click Sync Now. If you select one of the other options, contacts and calendars sync automatically.
Either or both Contacts and Calendars can be selected to sync. For Calendars, you can select All or Selected. When Selected is checked, you choose which calendars you want to sync with the Zimbra server.
Note: If you are using Leopard, you will have the option to select CalDAV for Calendars. If selected, the Zimbra Connector for Apple iSync will automatically create a CalDAV account in iCal that's connected to the user's Zimbra account. Subsequently, all event syncing is done through CalDAV, rather than Apple iSync.
Note: If you are using Leopard and you have already set up a CalDAV account, you will need to delete this account before you are able to change your Calendars Sync option to All or Selected.
Note: Calendars you subscribe to from either the Zimbra Web Client and in iCal are not included when the calendars are synchronized.
Click Sync Now to synchronize with your Zimbra Address Book and Calendars. If your Address Books and Calendars have a large number of entries, initial synchronization can take some time.
Before the address books or calendars are synced, you receive notification about how many files will be added, modified or deleted. Click OK to continue.
Various Sync Alert dialogs may be displayed asking if you would like to delete all contacts/calendars from your account on the Zimbra server before syncing. If you check that box, the information is deleted on the Zimbra server. If you do not check the box, you merge the two lists. Duplicate contacts are not deleted.
Using the Advanced Tab
The Advanced tab is used to enable Entourage integration, data change notification, and to configure the number of sync logs to save. Configuring these is optional. From the Advanced tab, you can also re-synchronize the information between the Zimbra server and the Mac.
If you use Entourage, check Entourage integration to correctly sync the Entourage calendar to the Zimbra primary calendar. The Zimbra primary calendar is the first calendar created for your Zimbra account. On the Zimbra Web Client it is named Calendar.
Check Show data change alert to be notified before any data changes are made to your Zimbra account.
Resetting your data
If you haven’t been maintaining a sync between the data in Zimbra Address Books and Calendars with the data in your Mac Address Book and Calendars, you may want to refresh your content from the account that you think is the most up to date to the other account. To do this, click Reset Sync Data and select the direction to update information from.
Important: Reset Sync Data will remove all sync history for your account on your computer. Depending on what type of reset sync is selected, data may be deleted in your Zimbra account or on this Mac. The sync will behave as though your account has never been synced before.
Click Reset Sync Data on the Advanced tab.
Replace data in mailbox with data from this machine. This deletes all address books and calendars from your Zimbra account, and replaces them with your Mac Address Book and Calendars.
Merge data in mailbox with data from this machine. This compares the address books and calendars data from your Zimbra account with the Address Book and Calendars from your Mac. Any new contacts or meetings will be synced.
Replace data on this machine with data from mailbox. This deletes your Mac Address Book and Calendars, and replaces them with the Address Book and calendars from your Zimbra account.
Click OK. An iSync sync alert shows the number of contacts that will be added and the number of contacts that will be deleted. You can cancel sync at this point and no data is changed.
To continue, click Allow. If you selected to delete data in your Zimbra account, the Zimbra iSync Connector dialog displays a request to update your Zimbra server. Click OK. The data has been synced between your two accounts.
Resolving Sync Problems
In the event that your address books and calendars are unable to sync between your Zimbra account and your Mac data, you will need to run iSync Reset Sync History. This resets the sync history for all account maintained on that Mac. This does not delete data stored on the Mac, but the next time you sync with any accounts, the Mac behaves as if this was the first time the information is being synced.
On the Mac, open the iSync Preferences dialog and click Reset Sync History.
Go to your System Preferences>Zimbra and on the Sync tab click Sync Now to synchronize with your Zimbra Address Book and Calendars. As this is an initial sync, if you have a large number of entries in your calendars and address books, this can take some time.
General Usage Notes
The information being synchronized is compared and conflicts are found, the Conflict Resolver pane displays the number of items in conflict and lets you review and select which version is correct.
If the server is down or your Mac is turned off, the scheduled sync does not happen. The data will sync on the next scheduled time.
Every hour — For example 5:01
Every day — 1 a.m.
Every week — Monday, the hour and minutes are wild carded.
Zimbra accounts can have multiple address books. On the Mac, only one Apple Address Book is available. When performing an initial sync, every address book in a Zimbra account is synced to the Apple Address Book. When new contacts are added to the Apple Address Book and synced back to the Zimbra server, the new contacts are added to the Zimbra Contacts address book.
If a meeting is modified in iCal to change attendees, this information is synced on the Zimbra server. Attendees are not automatically notified.
If the Zimbra Connector for Apple iSync is not able to create a sync session, a message is displayed. You will need to restart the SyncService’s engine. This problem is due to a bug in Apple’s iSync and we are working with Apple to resolve this issue.
You can restart the SyncService’s engine in one of three ways:
Go to Macintosh HD - Applications - Utilities.
Start up Terminal.
Type killall SyncServer syncuid.
Go to the Preferences>Other>Zimbra, Sync tab and click Sync Now.
Zimbra, Inc.
Copyright © Zimbra, Inc. 2008. All rights reserved.
The Zimbra logo and logo type are trademarks of Zimbra, Inc. All other trademarks are the property of their respective owners.

Zimbra Connector for Apple iSync 5.0 (Rev October 2008)
Copyright © 2008 Zimbra Inc.