IT Services



Nexus Calendars in Thunderbird using Davmail and Lightning


Contents



1. Introduction

Calendaring is an integral feature of the Nexus system. If you want to use calendaring in clients other than Microsoft Outlook, Entourage or Internet Explorer then you will need to perform further setup and configuration procedures. One method is to use Davmail and this document outlines how to use this program inconjunction with Mozilla Thunderbird, and its calendaring plugin Lightning, to access your Nexus account.

Davmail is an Exchange gateway allowing users to connect to Exchange via an alternate email/calendar client. It is available for Windows, Mac and Linux operating systems. This particular guide has been written using Ubuntu 9.04, Thunderbird 2.0.0.x and Lightning 0.9. It has also been tested on the beta version of Thunderbird 3 and Lightning 1.0pre.

Mozilla Lightning is an add-on for Thunderbird which adds calendaring capabilities to it.

This guide assumes that you are starting with a clean OS, with nothing but the standard security packages that come through the update manager.

Please note: You will not be able to share your calendar directly through this method.



2. Installation and configuration



2.1. Installing Davmail

To install Davmail go to: http://sourceforge.net/projects/davmail/files/

If you're using Ubuntu or another Debian based Linux distribution, you'll want the file that ends in .deb. Click on it, then Open the file. It will pop up the installation box; click on Install Package. This will create a link in Applications -- > Internet --> Davmail



2.2. Configuring Davmail

Open up Davmail and it will prompt you for settings, and also put the Davmail icon (a yellow filled circle with a white lightning bolt inside it) in your system notification area. If it doesn't prompt you for settings, right-click on the Davmail icon and go to [Settings]. The options should look like this:

OWA (Exchange) URL: https://davmail.nexus.ox.ac.uk/owa

Exchange Protocol:

Figure davmail.jpg [Exchange Protocol settings]

Davmail needs to be running on your system before starting any email/calendaring client. We suggest that it is automatically started at system boot time. In Ubuntu add to System > Preferences > Startup applications

Also see Alerts

N.B. In some newer versions of Ubuntu, within the Default Unity desktop for instance, there is no system tray to launch Davmail. It may be necessary for you to manually edit your Davmail properties file to configure the correct URL and Exchange protocol settings. The settings probably looks something like this:

davmail.enableEws=true

davmail.url=https\://davmail.nexus.ox.ac.uk/owa

Alternatively, you can configure the Unity desktop to display the notification area.



2.3. Installing Mozilla Thunderbird and Lightning

At the command line, type:

sudo apt-get install thunderbird xul-ext-lightning

This will create a link in Applications --> Internet --> Mozilla Thunderbird Mail/News



2.4. Configuring Thunderbird for Nexus email

You can do this by following the Thunderbird set up instructions.



2.5. Configuring Thunderbird with the calendar

You cannot share calendars through this; however, if you have already set up shared calendars using Outlook, then you can view other people's calendars by setting up a new one, and inserting their primary email address instead (but see below Alerts).

Lightning also allows the import of .ics calendar data so it's also an option for importing data from an existing calendar to Nexus.



2.6. Configuring Thunderbird with GAL (Address lookup)

When typing emails now, it will automatically try and do a lookup on a name in the address field. (It may ask you for your password the first time; you can choose to let it remember the password.)



3. Problems/Questions

Tasks
  • If you use thunderbird+lightning+davmail and make tasks, then any other thunderbird+lightning+davmail installation of yours will see them too.
  • If you use Outlook and create tasks, then later go and use thunderbird+lightning+davmail then it will not see the tasks which you created in thunderbird.
So if a user is only using thunderbird as a solution, then tasks do work.
GAL Lookup
A search will not display more than 100 results due to a limitation with OWA, which cannot be changed.
Alerts
Make sure "show reminders" is unselected when loading someone else's calendar, otherwise you'll get back-dated reminders for everything in their calendar. If you do this by accident it will probably lock up Thunderbird; force quit, open again, go straight to calendar, right-click on the offending calendar and change the settings to stop showing alerts.
I get an authentication error when I try to import my calendar
Check that you are using the secure https method in the URL to access the system.
Thunderbird cannot find my calendars
You have to start Davmail before starting Thunderbird, otherwise it doesn't find the calendars (it shows events, suggesting that it caches them somewhere). If you start Thunderbird before Davmail, the Nexus calendars are marked with an alert icon and their tooltip says "The calendar [name] is momentarily unavailable." Reloading them (right-click -> "Reload remote calendars") doesn't work, you have to restart Thunderbird.
Private calendar events
Some clients do not fully support private items and your private items may be revealed to those you share your calendar with. Please see the "How private are my private calendar entries?" entry in the Nexus FAQ for more details.