Gentoo - SysAdmin - Installation
From Kolab wiki
| Note |
|---|
| Please read these words of caution before embarking on a possibly painful journey with Kolab2/Gentoo |
A german translation of these instructions can be found here.
Contents |
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 echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf layman -f -a kolab
Installing Kolab2/Gentoo-2.2
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
Unmasking packages
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
Installing Kolab2/Gentoo
A simple emerge should now install Kolab:
emerge kolabd
If you encouter errors during compilation, please check the corresponding troubleshooting section.
Extensions
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
Bootstrap kolab
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.
/usr/share/kolabd/scripts/kolab_bootstrap -b
The script will ask you a few questions, configure Kolab and create a ssl certificate for you.
Start Kolab
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.
/etc/init.d/kolabd start
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.
Kolab Extensions
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.
Bugs
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".
In addition there is are some mailing lists and a forum available for discussions.
