Toltec Connector

From Kolab wiki

Jump to: navigation, search


Contents

General

You can get the Toltec Connector from www.toltec.co.za. It is proprietary plugin for Microsoft Outlook and a 30 day evaluation key helps to test it. The company behind this product is Radley Network Technologies CC, South Afrika. They brought Toltec Connector 1 on the market in October 2003 and it nicely operates on Kolab1 Servers in many production systems. The second generation of the Toltec Connector implements the Kolab2 Storage format. Radley participated in the development of the format. Since the Beta versions user reports indicate that Toltec is used to satisfaction in production systems with Kolab2 already.

The current release is Toltec Connector 2.2.0 from 2007/10/27.

Documentation

Status

Within the Proko2 Contract which led to the Kolab 2 Community Edition all testing for Outlook compatibility and quality assurrance was done using Toltec Connector 2.0.

This includes tests with the proprietary Sphinx S/MIME encryption plugin CryptoEx 0308 eval.

Some issues with the proprietary Toltec Connector 2.0 are currently tracked on the Kolab Issue tracker.


Outlook 2003 with toltec connector

Install

Install Outlook and the toltec connector, the toltec connector must have a licence key added, this can be added via Help > About Toltec Connector in Outlook. You can ask for a demo key after registration or buy a licence key from the toltec website. Typically your request is processed within some hours.

Add POP3/SMTP Account

Add a POP3 account to outlook, using your kolab username, you should check "use encrypted connection" in the advanced tab of "more settings". The toltec connector uses POP, then syncs with the kolab server, so you can still read the mail with eg horde

Map Toltec to personal store file

  • Click Tools > Options > Toltec Connector tab
  • Click New to start the wizard
  • Select an existing store, or create a new one
  • Choose Open Format(Kolab-XML 2.x) when asked
  • In the next screen, fill in host name and user details, and check the box for "Encrypt Connection..."
  • You should see something like:
 Connecting to myserver...
 IMAP4 server found.
 STARTTLS successful.
 Authenticated user with PLAIN.
 Able to list the INBOX folder.
 ACL capability reported by server.
 NAMESPACE capability reported by server.
 Compatible NAMESPACE values.
 ANNOTATEMORE capability reported by server.
 Server supports custom vendor annotation.
  • Click next > Finish

Free/Busy Lists

  • Free/Busy was broken in Kolab 2.1rcX, follow the instructions in 1st.README (delete cache) to upgrade to kolab 2.2
  • click Preferences->Options->Tools->Calendar Options->Free/Busy Options
  • Enter this URL in "Search Location"
https://<your_username>:<your_password>@<servername>/freebusy/%NAME%@%SERVER%.ifb
  • Publish Free/Busy-Information is not necessary (leave emtpy)

Problems

  • Windows has to trust the certificate to use https, otherwise use http
  • try to enter the URL directly into your browser, replate %NAME% and %SERVER% with existing uid

Automatic Invitation

In the Kolab webinterface the user can configure the behavior for receiving invitations. To use this feature you have to give write permissions to your calendar folder to calendar@your.domain.info - Click right on yout calendar folder->Toltec->Permissions.

Shared Folders

You need shared folders for sharing calendar, contacts and TODO. There are three ways to use shared folders.

1. group account
  • Recommended way, because seperate data for the group.
  • Create a new User of Account Type GROUP in the Kolab web configurator.
  • Add this account to one of your outlook installations to configure it.
    • Create new pst-file for this account Tools->Options->Mail-Setup->Files->Add. Use an cool name for this group account pst file.
    • Add this account as an POP account.
    • Map the new pst-file to the new POP account in Tools->Options->Toltec Connector->new
  • Set the permissions of the new folders. Right click on the imap folder (for example calendar) and then ->Properties->Toltec->Permissions. Add users (uid or full email address) and rights.
  • Now the new folder appears in your private imap folder list.
2. share personal folder with others
  • Others can see your private data.
  • Set the permissions of the folder to share. Right click on the imap folder (for example calendar) and then ->Properties->Toltec->Permissions. Add users (uid or full email address) and rights.
3. shared folder without account
  • Not recommended, because this foldertype can only be maintained in the kolab webinterface.
  • In the webinterface select "Shared Folder" and add new folders.


To use the shared contacts folder in your addressbook you have to activate this. Click right ob the shared contact folder ->Properties->Outlook-addressbook->Use this folder as email-addresses

LDAP Adressbook

The LDAP Adressbook contains only the users of kolab and the manually added addresses in the kolab webinterface by an administrator. The users can not add adresses here. If users need sharing adresses yout should consider to use an group account.


Click Tools->E-Mail Accounts->Add a new directory or address book->Next->Internet Directory Service (LDAP)->Next

Enter your servername

More Settings->Search Page

Enter your DN, for example dc=helge,dc=schneider,dc=local


PLEASE FINISH THIS HOWTO IF YOU HAVE SUCCESSFULLY USE TOLTEC WITH OUTLOOK 2003

Personal tools