Kolab2 Installation - Source
From Kolab wiki
Kolab makes use of OpenPKG to provide a supportable base on a wide variety of platforms.
The installation method described here is the default installation variant for Kolab.
It should take about three hours of time on a machine with average speed.
For alternatives you can check the Kolab Installation Overview page. There are also some Open-Office documents available in the Kolab-CVS repository that also describe the Kolab server installation.
Contents |
Kolab-2.2.*
Download a snapshot
There are beta snapshots available from the mirrors. Just fetch all the files from the latest release and save them to a temporary directory on your local machine. This temporary directory needs to be world readable. You are advised to use the /tmp directory! The following would fetch the Kolab-2.2.0-beta2 release (as of: 2007-10-19):
cd /tmp mkdir kolabtemp cd kolabtemp wget -r -l1 -nd --no-parent http://ftp.gwdg.de/pub/linux/kolab/server/release/kolab-server-2.2.0/sources/
You can check the integrity of the downloaded files with:
gpg --keyserver hkp://subkeys.pgp.net --recv-key 5816791A gpg --verify MD5SUMS md5sum -c MD5SUMS
Install Kolab in the OpenPKG environment
The default is to install to the directory /kolab:
mkdir /kolab
For a fresh install /kolab needs to be an empty directory with at least 1GB of free disk space. If the directory does not yet exist, it will be created automatically.
You may link the /kolab directory to /usr/local/kolab if you want to though it is not necessary. In that case you can create the Kolab directory as described below:
mkdir /usr/local/kolab ln -s /usr/local/kolab /kolab
Another option is to mount /kolab on a separate disk or raid array but please do NOT use an NFS mounted drive..
Once you have all the files, check the following:
- that you have bison and flex installed
- that you have SELinux turned off (or set to non-enforcing) if your system has SELinux.
- that you have a gcc, make, libtool, automake and autoconf installed.
- that the following names are not in /etc/passwd or /etc/groups, as OpenPKG will want to create them: kolab, kolab-r, kolab-n
Then run install-kolab.sh as a priviledged user (usually root) to set up Kolab in the OpenPKG environment:
sh install-kolab.sh -H -F 2>&1 | tee kolab-install.log
or make the script executable and run it directly like this:
chmod +x install-kolab.sh ./install-kolab.sh -H -F 2>&1 | tee kolab-install.log
This will start the installation. It rebuilds the OpenPKG sources for your machine, and builds/installs rpms with a special OpenPKG rpm tool (this way the OpenPKG rpms do not conflict with your current systems rpms and are kept on a different database). It can take a couple of hours to finish this installation, so fetch some more coffee and check every now and then to see how its doing.
If you do not want to install the Horde groupware client and/or the free/busy view tool, you can drop the flag "-H" and/or "-F".
The command output will be logged to kolab-install.log.
The total installation needs around 750MB (this is without the sources, add another 265MB if you have the sources on the same partition).
If the installation goes smoothly, you should end up with a summary of the installed packages.
If something goes wrong, you should consult the troubleshooting section that deals with installation problems.
Initial configuration
You now should have a /kolab directory, but you are not quite finished. You still need to configure the server for your specific network conditions. kolab_bootstrap will allow you to bootstrap the system and specify required information such as your mail domain etc. Finally openpkg rc will be used for starting and stopping the Kolab server. But lets start with the bootstrap first:
/kolab/etc/kolab/kolab_bootstrap -b
The script will check your available network ports to see if there are any conflicting services (such as another web server, a mail transfer agent or a LDAP database) already running in the base system on your machine. The script will die if there are any since you can't have any of these services running on your machine and simultaneously try to run it in your OpenPKG-Kolab environment. If there are conflicting services, stop them, and make sure they do not restart on reboot or based on other conditions. If all required network ports are available, the bootstrap script will ask some questions to configure your server. The questions should be self explanatory. Go through this setup carefully to set the basic configuration of your Kolab server.
Start using Kolab
After bootstraping you can finally start your system:
/kolab/bin/openpkg rc all start
This starts all the Kolab services and you should see amavisd, apache, clamav, imapd, kolab, openldap, openpkg, postfix, proftpd, sasl, spamassassin start.
All done! You can now go to https://hostname.of.machine/admin/ (replace hostname.of.machine with your machines complete domain name) and log in as the user manager and the password you supplied during bootstrapping.
Check the additional documentation
In addition there are some documents in the Kolab-CVS repository that you might wish to read.
If your server works as expected you might also wish to read about configuring a client.
