IMAP Annotations

From Kolab wiki

To view the manpage of cyradm, use the command:

 /kolab/bin/openpkg man cyradm

You can check the annotations of the folders in question with the info command, e.g.:

/kolab/bin/cyradm --user=manager localhost
lm *Calendar*
info user/john.doe/Calendar@example.com

To set annotation values you can use mboxconfig:

/kolab/bin/cyradm --user=manager localhost
mboxconfig user/john.doe/Calendar@example.com /vendor/kolab/folder-type event.default
mboxconfig user/john.doe/Calendar@example.com /vendor/kolab/incidences-for admins
mboxconfig user/john.doe/OtherCalendar@example.com /vendor/kolab/folder-type event
mboxconfig user/john.doe/OtherCalendar@example.com /vendor/kolab/incidences-for readers
mboxconfig user/meeting1/Calendar@example.com /vendor/kolab/pxfb-readable-for user@example.com staff@example.com

Kolab Server 2.2.0 was affected by kolab/issue3537, so you would have to add the DN of groups (distribution lists) in the value of pxfb-readable-for (in addition to the email address to stay working after upgrade to 2.2.1 or newer):

mboxconfig user/meeting1/Calendar@example.com /vendor/kolab/pxfb-readable-for user@example.com cn=staff@example.com,cn=internal,dc=example,dc=com staff@example.com

What annotation values to use?

The folder-type annotations are defined in the Kolab2 Storage Format Specification, e.g. section 2.1 (IMAP requirements) in version 2.0rc7.

The incidences-for annotation is described in section 2.8 Groupware Calendar in the (old) Architecture Document, you can get the pdf from http://kolab.org/documentation.html .

For pxfb-readable-for for the time being see Extended Freebusy Concept Draft PDF.