bh: server README.1st,1.1,1.2

[cvs at intevation.de]

Author: bh

Update of /kolabrepository/server
In directory doto:/tmp/cvs-serv7361

Modified Files:
	README.1st 
Log Message:
Update to what was shipped with beta 2


Index: README.1st
===================================================================
RCS file: /kolabrepository/server/README.1st,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- README.1st	25 Nov 2004 12:41:54 -0000	1.1
+++ README.1st	9 Mar 2005 15:09:23 -0000	1.2
@@ -1,16 +1,29 @@
 Kolab2 Important Information
 ============================
 
+WARNING: There's an incompatible change between Beta 1 and Beta 2.  See
+below for more information.
+
+WARNING: Check the permissions of your files in /kolab/etc/kolab/ after
+installing or upgrading.  Especially kolab.conf and copies shall only be
+readable to the owner (usually "kolab").
+
+The installation and configuration script have been changed to 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.
+
+
 Quick install instructions
 --------------------------
 
-To install the Kolab2 server, you only need to download obmtool and
-obmtool.conf, then as root, run
+To install the Kolab2 server, you need to download the files in this
+directory, then as root, run
 
 # ./obmtool kolab
 
-to download, build and install packages in /kolab. After the
-build/install is complete, please run
+to build and install packages in /kolab. After the build/install is
+complete, please run
 
 # /kolab/etc/kolab/kolab_bootstrap -b
 
@@ -24,6 +37,37 @@
 suggest that you back up your IMAP store, install Kolab2 and manually
 recreate user accounts and then restore the IMAP data from the backup.
 
+
+Global Shared Folders (relevant for upgrades from Beta 1 or earlier):
+
+If you upgrade from Beta 1 or an earlier release and use global shared
+folders, i.e. those managed by the web admin interface, you have to
+rename them.  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 at kolabdomain (\HasNoChildren)                  
+user/some.user/Calendar at 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 at kolabdomain shared.common at kolabdomain
+
+Repeat this for all shared folders.
+
+
+Old kolab-*.rpm (relevant for upgrades from pre Beta 1 releases):
+
 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
@@ -38,9 +82,8 @@
 files that were produced during uninstall and copy those back to their
 original names after upgrading.
 
-For more information, see http://www.kolab.org
+
+For more information on Kolab, see http://www.kolab.org
 
 $Id$
 
-regards
-Steffen Hansen <steffen at klaralvdalens-datakonsult.se>
\ No newline at end of file