Gentoo - SysAdmin - Installation
From Kolab Wiki
A german translation of these instructions can be found here.
Getting the news
Before installing the server you should always check the latest news so that you are up-to-date concerning the project status.
Installing the overlay
The tool layman is the preferred method for installing the Kolab2 overlay on your machine.
The following three commands are sufficient to retrieve the package definitions:
emerge layman emerge subversion
#(for layman 1.1) echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf
#(for layman 1.2) echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf
#(for layman 1.3 and later) echo "source /var/lib/layman/make.conf" >> /etc/make.conf
layman -f -a kolab
At this point the instructions for the Kolab2/Gentoo-2.2 installation will start to deviate from the steps required for 2.1. The next version of the Kolab-Server on Gentoo is currently in preparation. As version 2.2 includes massive changes to core concepts it will still take a while until it is finished. The following link only leads to a preliminary version of the 2.2 installation instructions:
Specifying the package features
Several of the basic servers that are required for Kolab also need specific features. The following selects a reasonable set of use flags that should allow to run the Kolab server. If you would like to modify these flags you can do so, but check with the specific server pages if this conflicts with the Kolab requirements:
echo " #### Kolab start # Use flags dev-lang/php kolab ldap nls session xml apache2 cgi force-cgi-redirect sqlite berkdb ftp imap ctype pcre dev-libs/cyrus-sasl berkdb ldap ssl dev-perl/perl-ldap sasl net-nds/openldap berkdb crypt overlays perl readline ssl -sasl net-ftp/proftpd ldap ssl mail-mta/ssmtp mailwrapper mail-mta/postfix ldap sasl ssl mailwrapper net-libs/c-client kolab ssl net-mail/cyrus-imapd kolab ssl net-mail/cyrus-imap-admin kolab ssl www-servers/apache ldap dev-libs/apr-util ldap # #### Kolab end " >> /etc/portage/package.use
There are some packages within portage that are still marked "unstable" but are required for the kolab server to work correctly. The following keyword settings must be added to your /etc/portage/package.keywords file to install the server.
echo " #### Kolab start # Keywords net-mail/cyrus-imap-admin ~x86 net-mail/cyrus-imapd ~x86 net-libs/c-client ~x86 # #### Kolab end " >> /etc/portage/package.keywords
A simple emerge should now install Kolab:
If you encouter errors during compilation, please check the corresponding troubleshooting section.
If you want to enable specific use flags provided by the kolabd ebuild, please consult the following pages:
- USE-Flag "spam"
- Improved spam filtering
- USE-Flag "horde"
- Horde webmail
- USE-Flag "dav"
- DAV access to the web server
- USE-Flag "mailman"
- Mailing list capabilities
- USE-Flag "otrs"
- Ticket support system
Up to this point everything was standard portage stuff and the different Kolab components are not yet configured to work together as a groupware server. This is what bootstrapping will accomplish. At this point kolab will start modifying and controlling a number of your configuration files within /etc ! If you are uncertain whether you want that or need more details, please read the Configuration concept page.
The script will ask you a few questions, configure Kolab and create a ssl certificate for you.
Now you should be able to fire up Kolab and start adding users. Start the init script and go to the webpage the bootstrap script directs you to.
Either you stop here since everything works and you are a happy user of a Kolab server or you choose to continue with the troubleshooting section.
If you specifically have problems with sending/receiving mail, check the postfix troubleshooting part.
The Kolab version on Gentoo features a few nice extensions. You could install Horde as a webmail client or add a ticket support system if you have many customers you need to support. Mailing lists are another supported feature.
It is possible to submit bugs to the Kolab bug tracker in case something is not working. Make sure these bugs have the keyword "gentoo" and are assigned to "wrobel".