This chapter describes how to configure Apple and Lightning clients to communicate with Oracle Communications Calendar Server.
Users need to be provisioned in Directory Server. For information on provisioning users, see "Overview of Provisioning Calendar Server". For information on how Calendar Server works with Directory Server, see Calendar Server Concepts.
Obtain the following information on your Calendar Server deployment:
application server host name and port where Calendar Server is installed
user identifier (email address or uid@domain)
This section contains the following tasks:
To configure Apple Calendar:
Choose Internet Accounts from the Mac System Preferences menu.
Click Add(+), then click Add Other Account.
Click Add a calDav Account.
Change the Account type to Manual.
Enter your user name, password, and server address, then click Create.
The calendar appears in the left-hand column of the Calendar app.
You can now use the Calendar app.
To configure Apple iPhone:
Navigate to the Mail, Contacts, and Calendar settings menu.
Select Add Account.
Select Other.
Select Add CalDAV Account.
Enter your Server address, User Name, and Password.
Tap Next.
The client indicates "Verifying CalDAV account", then "Account verified."
You can now use the Calendar application.
These instructions assume that you have already installed at least Thunderbird 3.1.x on your client machine.
To configure Lightning 1.0 beta 2:
Download Lightning 1.0 beta2 to your client machine from the Lightning Calendar web site at:
http://www.mozilla.org/projects/calendar/releases/lightning1.0b2.html
Download, but do not execute, the appropriate binary for your client platform. If the downloaded file is a zip file, unzip it.
Create a Thunderbird profile as follows:
In Mozilla Thunderbird, choose Add Ons or Extensions from the Tools menu, depending on the version of Thunderbird.
Click the Install button.
A file chooser is displayed.
Navigate to the previously downloaded (and perhaps unzipped) .XPI file, select it, and click OK.
In the Software Installation dialog box, click Install Now.
Click Restart Thunderbird.
Click Calendar in the Events and Tasks menu item at the top of the Thunderbird UI.
From the File menu, choose New, then Calendar.
If this selection is grayed out, you might need first to open the default calendar in Thunderbird.
Choose On the Network.
Choose CalDAV.
Enter the URL of the calendar, for example:
https://example.com/dav/home/jsmith@example.com/calendar/
Enter your name, choose a color scheme, choose to set alarms or not, and select your email address.
Enter your user name and password for the CalDAV server.
A confirmation dialog box informs you that your calendar has been created.
Click Finish.
The new calendar appears in the listing of calendars on the left side of the Thunderbird UI.
These instructions assume that you have already installed at least Mozilla Thunderbird 2.0.0.x on your client machine.
To configure Lightning 1.0 beta:
Download Lightning 1.0 beta 1 to your client machine from the Lightning Calendar web site at:
http://www.mozilla.org/projects/calendar/lightning/download.html
Download, but do not execute, the appropriate binary for your client platform.
If the downloaded file is a zip file, unzip it.
Create a Thunderbird profile as follows:
In Mozilla Thunderbird, choose Add Ons or Extensions from the Tools menu, depending on the version of Thunderbird.
Click the Install button.
A file chooser is displayed.
Navigate to the previously downloaded (and perhaps unzipped) .XPI file, select it, and click OK.
In the Software Installation dialog box, click Install Now.
Click Restart Thunderbird.
Click the Calendar icon in the lower left corner of the Thunderbird UI.
From the File menu, choose New then Calendar.
If this selection is grayed out, you might need first to open the default calendar in Thunderbird.
Choose On the Network.
Choose CalDAV.
Enter the URL of the calendar, for example:
http://example.com:3080/dav/home/jsmith@example.com/calendar/
In this example, the default URI of / was used during initial configuration.
The general format is:
http://Application_Server_host:Application_Server_port/baseuri/dav/home/email_address/calendar/
Enter your name, choose a color scheme, choose to set alarms or not, and select your email address.
Enter your user name and password for the CalDAV server.
A confirmation dialog box informs you that your calendar has been created.
Click Finish.
The new calendar appears in the listing of calendars on the left side of the Thunderbird UI.
Lightning 1.0 has CalDAV scheduling capability but it is turned off by default. Turn on the following configuration preferences for CalDAV scheduling to work by using the Config Editor.
calendar.itip.notify
calendar.caldav.sched.enabled
Windows: From the Tools menu, selection Options, then Advanced, then Config Editor.
UNIX: From the Edit menu, select Preferences, Advanced, then General.
These instructions assume that you have already installed at least Mozilla Thunderbird 2.0.0.x on your client machine.
To configure Lightning 0.9:
Download Lightning 0.9 to your client machine from the Lightning Calendar web site at:
http://www.mozilla.org/projects/calendar/releases/lightning0.9.html
Download, but do not execute, the appropriate binary for your client platform.
If the downloaded file is a zip file, unzip it.
Create a Thunderbird profile as follows:
In Mozilla Thunderbird, choose Add Ons or Extensions from the Tools menu, depending on the version of Thunderbird.
Click the Install button.
A file chooser is displayed.
Navigate to the previously downloaded (and perhaps unzipped) .XPI file, select it, and click OK.
In the Software Installation dialog box, click Install Now.
Click Restart Thunderbird.
Click the Calendar icon in the lower left corner of the Thunderbird UI.
From the File menu, choose New then Calendar.
If this selection is grayed out, you might need first to open the default calendar in Thunderbird.
Choose On the Network.
Choose CalDAV.
Enter the URL of the calendar, for example:
http://example.com:3080/dav/home/jsmith@example.com/calendar/
In this example, the default URI of / was used during initial configuration.
The general format is:
http://Application_Server_host/Application_Server_port/baseuri/dav/home/email_address/calendar/
Enter your name, choose a color scheme, choose to set alarms or not, and select your email address.
Enter your user name and password for the CalDAV server.
A confirmation dialog box informs you that your calendar has been created.
Click Finish.
The new calendar appears in the listing of calendars on the left side of the Thunderbird UI.
Lightning 0.9 has CalDAV scheduling capability but it is turned off by default. Turn on the following configuration preferences for CalDAV scheduling to work by using the Config Editor.
calendar.itip.notify
calendar.caldav.sched.enabled
Windows: From the Tools menu, selection Options, then Advanced, then Config Editor.
UNIX: From the Edit menu, select Preferences, Advanced, then General.
The following steps describe how user A can access user B's calendar:
In Convergence, user B grants user A read, read/write, or owner privilege through the Share panel.
Alternately, an administrator can use the davadmin calendar command to set the calendar ACLs.
To view the newly shared calendar of user B, user A creates a new calendar or account on the calendar client.
Lightning: User A enters user B's calendar URL
Apple iCal: User A enters user B's principal URL (in the Server Option of the Apple iCal Account Creation panel)
The previous information assumes settings for valid for a production system but not for a demo server, for example:
Use of standard ports (443 or 80)
SSL is the default
Account URL follows a fixed pattern: http(s)://server_name/principals/users/username/
Demo servers usually run on non-standard port numbers and they do not always own the full namespace, leading to account URLs (actually principal URL) that look more like the following one for iCal:
http://caldav.example.com:3080/demo/dav/principals/username/
Similarly, a demo Lightning URL might resemble the following:
http://caldav.example.com:3080/demo/dav/home/username/calendar/
For information on configuring the default context URI for a Calendar Server deployment, see Calendar Server Installation and Configuration Guide.
Typing the previous kind of URL can be very tedious and error prone, especially given that the iPhone advanced configuration panel offers just a tiny text box. The following procedure simplify the configuration process, assuming that you have a mail account already configured.
From your usual desktop client, email the principal URL to yourself.
Check that the URL is valid (by using a regular browser) before sending it.
The principal URL varies across servers. It is the same that you might have configured if you are using the Apple iCal client.
Copy the URL from the iPhone Mail App.
From the iPhone Mail App, open the email.
Press and hold on the URL in the message. You should be asked whether you want to open or copy the link.
Select copy.
Navigate to the CalDAV account creation panel.
Enter the server information.
Tap on the Server field.
A Paste button should appear on top of the text field.
Press Paste.
The full URL is shown. The client accepts a full URL in the server name field.
Enter the user name and password.
Go to the User Name field. The full principal URL is replaced by the server name only, which is to be expected.
Enter your password and tap Next.
The client indicates "Verifying CalDAV account", then "Account verified."
You can now use the Calendar application.
Launch iCal.
Choose Preferences from the iCal menu and click Accounts.
To add a new account, click the Add (+) button.
Choose CalDAV from the Account type menu.
Enter your user name and password.
In Server Address, enter the principal URL, for example:
http://caldav.example.com:3080/demo/dav/principals/username/
Click Create.
You can now use the Calendar application.
For the regular server configuration, you would click the server options and enter the principal URI, for example:
http://caldav.example.com/dav/principals/username/
Download and install the Android CalDAV-Sync client to synchronize events and tasks, and the Android task app to synchronize all tasks, from the Android Apps web site at:
https://play.google.com/store/apps/details?id=org.dmfs.caldav.lib&hl=en
Note the following limitations:
When you create an event with an attachment, the event is created without the server storing the attachment.
You cannot see attachments added to events by other clients.
Apple provides the Apple Configurator to install and manage installation profiles. Enterprises might find this utility helpful to manage their end user accounts. For more information, see the Apple Configurator web page at:
https://itunes.apple.com/us/app/apple-configurator/id434433123?mt=12
This section contains the following tasks:
To export a calendar:
Open any Calendar view.
Choose Export Calendar from the File menu.
Select the calendar.
When prompted to save the file, use the iCalendar format (the default is HTML).
To import a calendar:
Open any Calendar view.
Choose Import Calendar from the File menu.
Select the exported file.
Topics in this section:
For information on troubleshooting issues with Lightning ad Apple clients, see "Troubleshooting CalDAV Clients".
If you use Connector for Microsoft Outlook to create or modify the time of an event, and later make a change to the event time by using Convergence, the event "jumps" to a new time. In some cases, the event appears to "vanish" but in reality it "jumps" to the following day. Currently, there is no workaround.
To reproduce:
Log into Convergence and create an event.
Log into Connector for Outlook and move the event.
Log into Convergence and make sure event is moved by refreshing.
Move the event again, but this time on Convergence.
The event "jumps" to a new time.