[Kroupware] setting up and checking basic Kolab functionality post obmtool (Was: Re: ZfOS kolab-1.0.14-20031126 ...)

[Thomas Lotterer]

On Tue, Dec 02, 2003, Marc Schumann wrote:

> Am Dienstag, 2. Dezember 2003 10:49 schrieb Uwe Heinrich:
> 
> > I started the obmtool, watched several hours of tv, and when I got back
> > there were a complete kolab-server installed and ready to run!!!
> 
> Ready for run is Ok ....
> 
> but have you tried to create a user ? Is Apache Log Ok ? Mine isn't. [...]
> 
Marc,
I tried to reproduce the problem you described today. Things were
working smoothly for me. But i feel it's time for step-by-step
instructions setting up and checking basic Kolab functionality post
obmtool. So here it comes

 DOWNLOAD, BUILD AND INSTALL

Grab one of CFG, SRC or BIN where CFG autodownloads, builds and
installs, SRC builds and installs and BIN installs from:

 ftp://ftp.zfos.org/brew/kolab/CFG/kolab-1.0.14-20031126/
 ftp://ftp.zfos.org/brew/kolab/SRC/kolab-1.0.14-20031126/
 ftp://ftp.zfos.org/brew/kolab/BIN/kolab-1.0.14-20031126/...

In any case run
    $ su -
    # sh obmtool kolab

 KOLAB SETUP

    # /kolab/etc/kolab/kolab_bootstrap -b

Answer the three questions regarding the hostname, the domainname
(currently Kolab only supports a single domain) and either remember or
better set a password for the manager account.

 LAUNCH BACKEND

Launch the daemons

    # /kolab/etc/rc all start

Check for daemons running

    # ps -ax | grep /kolab #BSD, Linux
    # ps -ef | grep /kolab #SV

The following daemons must be running:

    slapd                    #LDAP directory service
    slurpd                   #LDAP replication service
    apache (5x at least)     #HTTP service for manager WebUI
    postfix master           #SMTP mail service
    saslauthd                #SASL authentication service
    cyrmaster                #IMAP mailbox service
    /kolab/etc/kolab/kolab   #LDAP replication peer
    
 LAUNCH MANAGER FRONTEND

Point the browser to https://127.0.0.1/, log in using "manager" and the
password from the "kolab_bootstrap" step. HTTP ok.

 CREATE USER

Click on "Users" on the left pane then "Create User" beneath. At this
point the WebUI launches with the representation of an empty user
which doesn't even have the mandatory attributes filled in. This leads
to /kolab/var/apache/log/apache-error.log filling with two lines of
"[error] PHP Notice: Undefined index [...]" for each of the following
attributes: sn, cn, userPassword, mail, deleteflag; Although i don't
call it ideal it seems to be normal operation. Fill in the mandatory
fields, using "thomas at example.com" for the "Primary Email Address"
field where example.com is the domain from the "kolab_bootstrap" step.
Submitting the form by clicking OK does not add additional errors to
the apache-error.log and immediately redirects the browser to the
"Create New User" to the "Modify Existing User" dialog. Clicking
"User" on the left pane again and selecting the correct part of the
alphabet (sorted by Last Name, btw) or selecting all will reveal the new
"thomas at example.com" user. LDAP ok.

Also a '/kolab/var/imapd/user/t/thomas at example^com.seen' will be
created. This means slurpd contacted kolab daemon which updated imapd.

 SEND MAIL

    $ telnet 127.0.0.1 smtp

and send the following SMTP commands:

    HELO foo
    MAIL FROM:<root at localhost>
    RCPT TO:<thomas at example.com>
    DATA
    To: Thomas <thomas at example.com>
    Subject: first time

    Hello, World!
    .
    QUIT

This means slurpd contacted kolab daemon which updated postfix and SMTP
ok.

 RECV MAIL

Launch KMail (or any other IMAP aware mail client) and configure it to
use IMAP server 127.0.0.1, log in to it using thomas at example.com and the
password from the WebUI "Create New User" step. The "inbox" with the
telnetted mail will be shown almost immediately. IMAP ok.

Hope this troubleshooting information will help you pinpoint the
problem.

--
Thomas.Lotterer at cw.com, Cable & Wireless