MDaemon 11 onwards supports the use of a free SyncML client called Funambol which can be used to synchronise Calendar, Contact, Task and Notes data between a BlackBerry and your MDaemon mailbox.

In order for Funambol to successfully access MDaemon the WorldClient webmail interface needs to be available from the Internet. This is achieved by creating a port forward on your firewall or router so that incoming traffic from the Internet on the port WorldClient runs on is routed to the MDaemon machine. By default WorldClient runs on port 3000 (and 443 over SSL), but you can confirm the port at Setup -> Web & SyncML Services -> Web Server -> Run WorldClient server using this TCP port.

The steps required to configure port forwarding on most firewalls and routers are covered at http://www.portforward.com

Installing Funambol on a BlackBerry Handset:

1. To download the Funambol client onto your BlackBerry visit the appropriate URL via the BlackBerry handset web browser:

BlackBerry OS 4.2.1 to 4.6: http://my.funambol.com/bb/sync.jad
BlackBerry OS 4.7 or later: http://my.funambol.com/bb/sync2.jad

(to confirm the version of your BlackBerry OS choose Options -> About)

2. Click Download when prompted:

The BlackBerry will now download the Funambol client:

3. At the end of the download the BlackBerry will ask if you wish to grant Funambol "Trusted Application Status". Choose Yes:

4. When downloaded the Funambol client should automatically start (if it doesn't it can usually be located in the Applications folder on the BlackBerry). Click on the BlackBerry Button and then click Settings to configure it:

5. In Server Location type the external URL you use to access WorldClient along with /MDSyncML.DLL as follows, then add your account username and password:

http://mail.mydomain.com:3000/MDSyncML.DLL

(the above is an example URL and on your BlackBerry it should reflect the URL specific to your installation)

6. In Sync Contacts, change the Remote Name: value from card to contacts:

7. In Sync Calendar, change the Remote Name: value from scal to calendar:

(Note: In Funambol 8.7.1 it may be necessary to reboot the BlackBerry before the 'Remote Name' value change you make to the calendar is applied. This is a defect with 8.7.1 in particular)

8. In Sync Tasks, change the Remote Name: value from stask to tasks:

9. In Sync Notes, change the Remote Name: value from snote to notes:

10. The remaining settings will be specific to each BlackBerry user - for example, should you wish the Funambol client to perform a periodic sync rather than running one manually you can do so by ticking "Enabled Scheduled Sync" and specifying a sync interval:

11. Finally click the BlackBerry Button and choose Save to apply the settings:

12. To force a test Synchronisation either select the folder you want to synchronise and Funambol should start synchronising the data for that folder:

Alternatively click the BlackBerry Button and choose Sync ALL to force a synchronisation of all the folders:

The Funambol Client is now successfully configured!

Resolving Connectivity / Installation Issues:

1. Confirm the BlackBerry is configured with APN Gateway Details:

Typically a BlackBerry will be pre-configured with APN details that allow the Funambol client to connect to the Telco's BIS network, but you may want to confirm that these are populated on the BlackBerry if you have issues performing a successful synchronisation.

The settings are located in Options -> Advanced Options -> TCP (or Options -> TCP on some BlackBerry Handsets).

Below are details of the APN details for UK Telco's but we'd recommend confirming the correct APN details with the Telco to ensure these are correct for the particular handset:

O2
APN: mobile.o2.co.uk
Username for APN: mobileweb
Password for APN password

T-MOBILE
APN: general.t-mobile.uk
Username for APN: user
Password for APN: wap (or one2one)
(in Ireland you may need to use an APN of isp.vodafone.ie with a username and password of vodafone)

VODAFONE
APN: internet (or blackberry.net or wap.vodafone.net)
Username for APN: web
Password for APN: web

ORANGE
APN: orangeinternet (or orangewap or internetvpn2)
Username for APN: <leave blank>
Password for APN: <leave blank>

VIRGIN
APN: goto.virginmobile.uk
Username for APN: user
Password for APN: <leave blank>

2. Problems connecting via VodaFone Live:

If you are using a BlackBerry on the Vodafone network and are having issues connecting to MDaemon via Funambol then you may need to change the way Vodafone connects to allow the Funambol traffic to reach MDaemon without being altered. To do this choose Vodafone Live on the BlackBerry and then select "Web & Email", then under the a header "Web Tools" choose the "Web Preferences" link. Within "Display Options" change "View web pages WITH speed and layout improvements (using Mobile or PC styles)" to "View web pages WITHOUT speed and layout improvements (view original website)".

If you don't have these options on your VodaFone BlackBerry, then it may be due to VodaFone restricting the ability to turn this function off. Unfortunately, if this is the case then it won't be possible to use Funambol as the device relies on receiving incoming HTTP traffic which hasn't been compressed / altered. For further details regarding this VodaFone limitation see http://forum.vodafone.co.uk/topic/61777-vodafone-my-web-display-preferences/. You may therefore want to take a look at an alternative SyncML client called SyncJE (www.nexthaus.com). Note that the SyncJE client isn't an open source application so will need to be purchased from the vendors directly and it's not a client we actively support.

3. If you encounter problems synchronising a particular folder the \MDaemon\Logs\SyncML-YYYYMMDD.log should help identify the cause of the problem. No log information appearing in this log file will indicate a connectivity problem on the BlackBerry and the APN details on the handset itself and the Server Location in the Funambol client should be checked. You should also ensure that the WorldClient webmail interface is definately accessible from the Internet.

4. Funambol synchronises Calendar, Contacts, Tasks and Notes data held in WorldClient. If you use Outlook Connector then this WorldClient data mirrors the corresponding Outlook based data. However, standard POP3 and IMAP clients do not store their Calendar, Contacts and Tasks information in MDaemon and what gets synchronised using SyncML via WorldClient will not reflect your local Outlook data.

5. If you want to synchronise a Public Contacts, Calendar or Tasks folder instead of your personal data then use the following format in the 'Remote Name' field instead:

/Public Folders/company.mail/Contacts

6. Some Telco contracts don't include "data" transfer and this may incur an additional charge. We'd therefore recommend contacting your Telco to confirm this before using SyncML software on your BlackBerry.

7. You may need to enable the "Memopad" application on your BlackBerry in order to use and synchronise Tasks on it.