add context here as discussed on i18n list
[kdepim.git] / README.Kolab
blob227e02674d0659f13604f7aa155ede8a835f929a
1 These are preliminary instructions on how to set up kdepim to work
2 with a kolab server. It is meant to be a help for people setting
3 up for testing. It is also meant as a list of things to set up in the
4 upcoming Kolab setup wizard.
7 There are the steps needed to setup the Kolab server as the primary
8 server.
11 KMail:
13 1. Set up your identity.
14 2. Set up a disconnected IMAP account to the server and sync it.
15    Optional: Choose TLS and Clear text
16 3. Set up sending through the kolab server
17    Optional: Choose authentication and/or TLS
18 4. After the first sync, enable IMAP resource folder options in
19    Misc->Groupware and set to be subfolders of the account INBOX
20 5. Enable groupware functionality on the same page
21 6. TODO: Where is sieve setup???
23 Note: We might want to add a KMail profile for this in addition
24 to the kolab wizard.
26 KAddressBook:
28 1. Start KDE Control Center and go to KDE Components, page KDE
29    Resources Configuration. Choose the contact resource. Add an
30    IMAP resource and set it to standard.
31    Optional: Delete others or set them to readonly.
32 2. Start KAddressBook and add an LDAP server in the configuration
33    with these settings:
34       Host = "kolab.kde.org" (for example)
35       Port = "389"
36       Base DN = "dc=kolab,dc=kde,dc=org"
37    TODO: Are Bind DN and password the Kolab user settings?
38    TODO: If yes, do they make the LDAP resource writable?
39    The scheme for the base DN is to take the parts of the fully
40    qualified hostname of the kolab server and put ",dc=" between
41    the parts and "dc=" in front of it. Or in Qt code:
42       baseDN = "dc=" + hostname.replace( '.', ",dc=" );
43    Finally check the checkbox to activate the LDAP server. Now
44    you can search the Kolab LDAP server and get all users on the
45    system.
48 KOrganizer:
50 1. Start KDE Control Center and go to KDE Components, page KDE
51    Resources Configuration. Choose the calendar resource. Add an
52    IMAP resource and set it to standard.
53    Optional: Delete others or set them to readonly.
54 TODO: Free-Busy setup and KMail mail scheduling.
57 TODO
60 KitchenSync:
62 TODO
65 kalarmd:
67 TODO
70 Kontact:
73 General Notes:
74 ==============
75 Autocompletion: Works in both KMail and KOrganizer. The order of resources used for completion
76 is as follows:
77   1. All available addressbook resources as seen in "kcmshell kresources", section "kabc"
78   2. LDAP
80 Nothing special, AFAIK