Kolab2 Server Important Information =================================== For more information on Kolab, see http://www.kolab.org Quick install instructions -------------------------- For a fresh install /kolab needs to be an empty directory with enough space. You can use a symlink, but do _not_ use an NFS mounted drive. Make sure that the following names are not in /etc/passwd or /etc/groups, as openpkg will want to create them: "kolab" "kolab-r" "kolab-n" To install the Kolab2 server, you need to download the files from the directory containing this file (1st.README) to some local directory, then as root, chdir into that local directory and run # ./obmtool kolab to build and install packages in /kolab. After the build/install is complete, please run # /kolab/etc/kolab/kolab_bootstrap -b and follow the instructions. General update instructions --------------------------- Usually an update of the Kolab 2 server works as described here. In some cases you will need to deviate from these instructions a bit. All such cases are documented below, so read the release specific update instructions for all releases newer than the one you already have before you start the update. The installation of the new packages works just as for the initial installation. Download the files as described above and run # ./obmtool kolab obmtool will usually automatically determine which packages need to be built. If you have made changes to the configuration files in /kolab/etc/kolab/templates/ and the new release has a new kolabd package you may need to transfer your changes from the backups created by rpm (the *.rpmsave) files to the new template files. Then regenerate the configuration with # /kolab/sbin/kolabconf You may want to check the permissions of your files in /kolab/etc/kolab/ after installing or upgrading, as there have been problems with this in the past. Especially kolab.conf and copies shall only be readable to the owner (usually "kolab"). The installation and configuration scripts should make sure that the permissions are correct but there's a chance that the permissions can still go wrong, especially if you upgrade from pre Beta 1 releases. Upgrading from earlier versions ------------------------------- Direct upgrade from Kolab1 is not recommendable at this point. We suggest that you back up your IMAP store, install Kolab2 and manually recreate user accounts and then restore the IMAP data from the backup. After an upgrade, always run /kolab/sbin/kolabconf to make sure the configuration files are regenerated from your templates. Upgrade from versions older than Beta 1 --------------------------------------- If you are running a development version of Kolab2, please make sure to remove the old package named kolab if you have this installed. Check for existence with /kolab/bin/openpkg rpm -qi kolab and if it is there, run /kolab/bin/openpkg rpm -e kolab kolab-webadmin kolab-resource-handlers to remove it. After removing the package, make a copy of the .rpmsave files that were produced during uninstall and copy those back to their original names after upgrading. Upgrade from Beta 1 ------------------- Between Beta 1 and Beta 2 the names the imap folders of global shared folders, i.e. those managed by the web admin interface, were changed. The prefix they use for the imap folders has changed from "user." to "shared." in Beta 2. You can rename them with the cyradm tool. First, login with cyradm (the imap server must be running for this): # /kolab/bin/cyradm --user manager localhost IMAP Password: localhost> Then list the folders with "lm": localhost> lm user.common@kolabdomain (\HasNoChildren) user/some.user/Calendar@kolabdomain (\HasNoChildren) ... The folders starting with "user." are the shared folders. Rename them with the rename command so that they have the prefix "shared.": localhost> rename user.common@kolabdomain shared.common@kolabdomain Repeat this for all shared folders. Upgrade from Beta2 ------------------ The compile time options of apache and php have changed a little to enable multibyte strings. Unfortunately, obmtool will not automatically recompile the packages for you. To make sure the packages are recompiled, you need to uninstall the packages and remove the binary RPMs from /kolab/RPM/PKG: /kolab/bin/openpkg rpm -e --nodeps apache php rm /kolab/RPM/PKG/apache-* rm /kolab/RPM/PKG/php-4* Upgrade from Beta3 ------------------ Starting with Beta4, OpenLDAP is configured to use more indexes. When upgrading from an earlier version of Kolab, these indexes need to be created once: /kolab/bin/openpkg rc openldap stop /kolab/sbin/slapindex /kolab/bin/openpkg rc openldap start If your manager is only getting the role "user" run slapindex once again, with a fully stopped server. Upgrade from Beta4 ------------------ Beta5 has a new openldap package. Installing this will replace one of its configuration files, /kolab/etc/openldap/slapd.conf, with a default version from the rpm. openldap cannot be started with that version! Replace the new version with the backup created by rpm: mv /kolab/etc/openldap/slapd.conf.rpmsave \ /kolab/etc/openldap/slapd.conf One more ldap change: between Beta4 and Beta5 some more openldap indices were added, so the slapindex call described in "Upgrade from Beta3" has to be repeated. Make sure to run kolabconf as described above. Otherwise you may not be able to log in to the web-admin interface. Upgrade from Beta5 ------------------ Again, the openldap configuration has changed a bit. Rerun kolabconf and restart openldap. Distribution lists now have a mail attribute. Use an LDAP editor to fill the mail attribute for all kolabGroupOfNames objects with the email address of the distribution list. Upgrade from RC1 ---------------- The openldap package has been updated. For how to deal with an update of the openldap package, see the instructions for the upgrade from Beta4. There's also a new index for the openldap data, so the index has to be rebuilt as described for the update from Beta3. The mail attribute that was added to the distribution list entries in RC1 is now used to lookup the distribution list's ldap entry. Therefore, fixing the mail attribute as described for the upgrade from beta5 is important if you want your old distribution lists to work. Upgrade from RC2 ---------------- clamav will send an email Warning with unresolved configuration file conflicts. In /kolab/etc/clamav/ you can safely delete clamd.conf.rpmsave and freshclam.conf.rpmsave. Later after starting the server run kolabconf once. Upgrade from RC3 ---------------- Nothing special really, only a note to avoid confusion. This release uses a new openpkg base package and it's normal that obmtool lists the .sh part as MISSSRC or MISSPKG. The .sh part is only used for the initial install and is not required for an update. Upgrade from RC4 ---------------- There's nothing special to be done. Upgrade from 2.0 ---------------- Nothing special to be done for this update. $Id: README.1st,v 1.23.2.3 2005/08/08 19:22:06 bh Exp $