Differences

This shows you the differences between two versions of the page.

Link to this comparison view

howtos:kolab:installation:3.1 [2014/08/21 12:31] (current)
dmorlock Update external wiki for Kolab 3.2
Line 1: Line 1:
 +====== Install 3.1 ======
  
 +===== Prepare Python =====
 +
 +  * Make sure you enabled Python 2.7 since Kolab seems not to be ready for Python 3 yet:
 +<code bash>
 +$ eselect python list
 +eselect python list
 +Available Python interpreters:​
 +  [1]   ​python2.7 ​
 +  [2]   ​python3.2
 +$ eselect python set 1
 +</​code>​
 +
 +===== Unmasking =====
 +
 +  * Unmask the "​kolab"​ USE-flag for PHP and other related USE-flags for Roundcube:
 +<file bash /​etc/​portage/​profile/​use.mask>​
 +# Double mask USE flags in order to unmask them
 +# http://​forums.gentoo.org/​viewtopic-t-376608.html
 +-kolab
 +-nginx
 +-recipient-to-contact
 +-contextmenu ​
 +-threading-as-default ​
 +-listcommands
 +-message-label
 +-identity-smtp
 +-getmail
 +-persistent-login
 +</​file>​
 +
 +  * To unmask ebuilds for the latest version freeze, you might want to set the following keywords:
 +<file bash /​etc/​portage/​package.keywords/​kolab>​
 +# Unmask Kolab components from latest version freeze.
 +<​net-mail/​kolab-9999 ~amd64
 +<​dev-python/​pykolab-9999 ~amd64
 +<​net-nds/​kolab-schema-9999 ~amd64
 +<​www-apps/​kolab-webadmin-9999 ~amd64
 +<​www-apps/​kolab-syncroton-9999 ~amd64
 +<​www-apps/​kolab-irony-9999 ~amd64
 +<​dev-util/​kolab-utils-9999 ~amd64
 +<​www-apps/​kolab-chwala-9999 ~amd64
 +<​www-apps/​kolab-freebusy-9999 ~amd64
 +<​net-libs/​libkolabxml-9999 ~amd64
 +<​net-libs/​libkolab-9999 ~amd64
 +<​www-apps/​kolab-roundcube-9999 ~amd64
 +<​www-apps/​kolab-roundcube-recipient-to-contact-9999 ~amd64
 +<​www-apps/​kolab-roundcube-contextmenu-9999 ~amd64
 +<​www-apps/​kolab-roundcube-listcommands-9999 ~amd64
 +www-apps/​kolab-roundcube-threading-as-default ~amd64
 +www-apps/​kolab-roundcube-identity-smtp ~amd64
 +
 +# Use patched version for kolab.
 +dev-python/​python-augeas ~amd64
 +
 +# Versions used for recent kolab builds, stable
 +# unmasked version might work, too.
 +>​=dev-php/​smarty-3.1.12 ~amd64
 +>​=dev-python/​cheetah-2.4.4-r1 ~amd64
 +>​=dev-python/​python-ldap-2.4.13 ~amd64
 +>​=dev-python/​sqlalchemy-0.8.2 ~amd64
 +>​=dev-python/​icalendar-3.5 ~amd64
 +</​file>​
 +<note important>​The ''​net-mail/​kolab''​ ebuild is used to specify the version to be installed (e.g. 9999 for current head of the git repos). This will also define the required versions for the related packages. So you should only set the requested version to ''​net-mail/​kolab''​ and unmask all available version for the others.
 +</​note>​
 +
 +  * Kolab is using 389 directory service and also needs '​net-nds/​389-admin'​ which is using Apache as webserver:
 +<file bash /​etc/​portage/​package.keywords/​kolab-389>​
 +>​=net-nds/​389-ds-base-1.3.0.2-r2 ~amd64
 +>​=net-nds/​389-admin-1.1.31 ~amd64
 +>​=app-admin/​389-ds-console-1.2.6 ~amd64
 +>​=app-admin/​389-admin-console-1.1.8 ~amd64
 +>​=dev-libs/​389-adminutil-1.1.15 ~amd64
 +
 +>​=www-apache/​mod_nss-1.0.8-r1 ~amd64
 +>​=dev-java/​idm-console-framework-1.1.7 ~amd64
 +>​=dev-perl/​perl-mozldap-1.5.2 ~amd64
 +</​file>​
 +
 +===== USE-Flags =====
 +
 +  * Enable the following USE flags for Kolab:
 +<file bash /​etc/​portage/​package.use/​kolab>​
 +# kolab
 +net-mail/​cyrus-imapd afs openldap sieve -mysql
 +dev-libs/​cyrus-sasl openldap
 +dev-lang/​php kolab
 +
 +# kolab -> amavisd
 +net-analyzer/​net-snmp perl
 +
 +# kolab -> 389
 +app-crypt/​mit-krb5 openldap
 +dev-libs/​nss utils
 +www-servers/​apache suexec threads
 +
 +# kolab-chwala
 +dev-php/​PEAR-Net_SMTP sasl
 +
 +# pykolab
 +dev-lang/​python sqlite
 +</​file>​
 +
 +  * The Kolab object handling library ''​libkolab''​ is based on KDE libraries with enabled ''​qt3support''​. If you don't use KDE, you need at least the following USE-flags to be enabled:
 +<file bash /​etc/​portage/​package.use/​libkolab>​
 +dev-qt/​qtcore qt3support
 +dev-qt/​qtdeclarative qt3support
 +dev-qt/​qtgui dbus qt3support
 +dev-qt/​qtopengl qt3support
 +dev-qt/​qtsql qt3support
 +kde-base/​kdelibs semantic-desktop
 +kde-base/​kdepimlibs semantic-desktop
 +
 +sys-libs/​zlib minizip
 +dev-libs/​libattica qt4
 +media-plugins/​gst-plugins-meta ogg vorbis
 +sys-apps/​dbus X
 +sys-auth/​pambase consolekit
 +sys-auth/​consolekit policykit
 +virtual/​udev gudev hwdb
 +sys-fs/udev gudev hwdb
 +dev-libs/​libxml2 python
 +</​file>​
 +
 +===== Emerging =====
 +
 +  * Emerge Kolab:
 +<code bash>
 +$ emerge -avN kolab
 +</​code>​
 +
 +===== Initial setup =====
 +  * Run ''​setup-kolab''​ to initially configure your new system:
 +<note warning>''​setup-kolab''​ assumes a fresh installation and might overwrite existing configuration files. You don't have to run this when updating Kolab.</​note>​
 +<code bash>
 +$ setup-kolab
 +</​code>​