CalDAVClients
Open-Xchange Calendar synchronization with CalDAV
This site describes how the Open-Xchange server can be accessed via its CalDAV interface after the server has been configured as described in Caldav_carddav_Bundles. Depending on the used client software, different steps are necessary. Other clients may be configured similarly, but are not officially supported.
Mac OS X iCal / Calendar
Available since Open-Xchange Server v6.20.1
Depending on the used Mac OS X version, slightly different steps are necessary.
Mac OS X iCal (for version 10.6 Snow Leopard)
|
Mac OS X iCal (for version 10.7 Lion) / Mac OS X Calendar (for version 10.8 Mountain Lion)
|
PLEASE NOTE: For our product Open-Xchange Advanced Server Edition and Server Edition for UCS it isn't necessary to use "dav".
Debug Options
You can enable a Debug Menu inside the iCal application which gives you access to advanced debugging and logging options. Please notice that some of these options may increase the size of the log files of your system and/or could also log sensitive data like passwords if enabled. Keep also in mind that any setting changed here will remain active until the setting itself will be reverted or changed again which means that disabling the Debug Menu itself is not sufficient to reset any debug settings to their defaults. All settings are case sensitive.
Open a terminal window (Applications > Utilities > Terminal) and issue the following command for
- enabling the Debug Menu in iCal:
defaults write com.apple.iCal IncludeDebugMenu 1
- disabling the Debug Menu in iCal:
defaults write com.apple.iCal IncludeDebugMenu 0
Mac OS X 10.6 Snow Leopard lacks the ability to enable the logging of all CalDAV HTTP activities to the systems log (/var/log/system.log) via a Debug Menu option in iCal. To enable this in Mac OS X 10.6 iCal proceed as follows:
- enabling CalDAV HTTP activity logging in Mac OS X 10.6:
defaults write com.apple.iCal LogHTTPActivity yes
- disabling CalDAV HTTP activity logging in Mac OS X 10.6:
defaults write com.apple.iCal LogHTTPActivity no
PLEASE NOTE:: The debug menu is not available in Mac OS X 10.8.
iOS Calendar
Available since Open-Xchange Server v6.22
The iOS Calendar application on the iPhone, iPod or iPad can be configured as follows.
|
PLEASE NOTE: For our product Open-Xchange Advanced Server Edition and Server Edition for UCS it isn't necessary to use "dav".
Thunderbird/Lightning
Available since Open-Xchange Server v6.20.7
The steps below describe how to setup the Mozilla Thunderbird client with the Lightning Add-on.
Prerequisites
Please ensure that the following preconditions are met before continuing:
- Latest versions of the Mozilla Thunderbird E-Mail client and the Lightning Add-on (check https://addons.mozilla.org/thunderbird/addon/lightning/ and http://www.mozilla.org/thunderbird/ for details)
- In the Mozilla Thunderbird client, an E-Mail account for the user's Open-Xchange mailbox needs to be setup before configuring the CalDAV access
Discover the CalDAV URL of your Calendar Folders
In contrast to some other clients, Thunderbird/Lightning is not able to discover all the available calendar collections automatically. Instead, each calendar folder needs to be added seperately in the client. To do so, one needs to know the CalDAV URLs of the calendar folder that should be synchronized with the client. This URL is displayed in the properties-page in the Groupware web-interface.
| |
|
Add a Calendar in Thunderbird/Lightning
As already mentioned, each Calendar folder that should be sychronized has to be added separately in the client. The following steps show how to add a Calendar in Thunderbird/Lightning. Before starting, ensure that the client is connected to the network and the server can be accessed.
| |
| |
| |
| |
| |
|
Debug Options
In case of synchronization problems, the built-in error console of Mozilla Thunderbird may provide valuable information. The error console can be opened via "Tools" -> "Error Console". To increase the loglevel of the Lightning Add-on, open the config editor by selecting "Tools" -> "Options..." -> "Advanced" -> "Config Editor..." and set the properties "calendar.debug.log" and "calendar.debug.log.verbose" to "true".
General Limitations
Please consider the following known limitations for the CalDAV interface:
Reminders
- While the iCalendar standard allows to set appointment reminders past due an appointment's start-date, the OX server is not able to save such alarm times and discards them.
- Multiple reminders in an event are not supported by the OX server and are discarded.
- Only reminders of type "DISPLAY" are supported by the OX server, reminders of other iCal types are discarded.
- When dismissing reminders of recurring appointments in the Mozilla Lightning client, the reminder is removed from the whole recurring appointment object, since it's not possible to determine to which occurrence the dismiss action belongs to.
Unsupported Properties
- The "URL" property for iCal resources is not supported by the OX server and is discarded.
- Importing or exporting file attachments (property "ATTACH") is not supported via the CalDAV interface.
Private Appointments
- Appointments classified as "private" are exported by the server with the "CLASS" property set to "PRIVATE".
- iCal events with the "CLASS" property set to either "CONFIDENTIAL" or "PRIVATE" are treated in the same way by the server and are imported as "private" appointments.
- Since "private" appointments with participants are not supported by the server, saving such an appointment results in the participants being removed implicitly during import.
Tasks
- Only simple tasks (no participants, no recurrence) are supported.
- Only the properties "DTSTART", "DUE", "CATEGORIES", "SUMMARY", "PRIORITY", "DESCRIPTION", "VALARM", "STATUS", "PERCENT-COMPLETE" and "COMPLETED" are synchronized, other ones are discarded by the server.