UPGRADING FROM 1.0.x
---------------------

The process is simple enough. Make sure you follow this document
meticulously, or things won't work.

0. Download and install squirrelmail-1.4. Vadmin will not work with 1.2.

1. Look at your vadmin_config.php and migrate the settings to 
   conf/vadmin.conf. Things to keep in mind:
   * all paths should be full paths. Not relative.
   * If your $VADMIN_DIR is /var/vadmin, it is strongly suggested
     moving it to /var/lib/vadmin for FHS compliance 
     (mv /var/vadmin /var/lib/vadmin). Otherwise set [storage]->dir
     accordingly.
   * VADMIN_CROSS_ADMIN_AUTH_METHOD is now [auth]->method.
   * VADMIN_CROSS_ADMIN_FORCE_HTTPS is now [auth]->force_https
   * VADMIN_MAX_ORG_IMAGE_SIZE_KB is deprecated and now set per-domain.
   * VADMIN_DELIMITERS are in vadmin.conf, too, but changing these is not
     encouraged, unless you have chosen custom values for your vmailmgr 
     setup.

2. Uncomment the [upgrade] section in vadmin.conf.

3. Find out what your apache process runs as -- user "nobody" on most BSDs,
   or user "apache" on Red Hat Linux. Chown /var/lib/vadmin to that user.
   E.g.:
   chown -R apache /var/lib/vadmin

4. Locate your apache.inc that contains MCRYPT_ALGO and CRYPTO_HASH_LINE
   and change it so the <Directory> settings points not to plugins/vadmin
   directory, but to the whole squirrelmail directory (required with the
   new codebase, see SECURITY for more info).
   E.g.:
   if it used to be <Directory /usr/share/squirrelmail/plugins/vadmin>, then
   it becomes <Directory /usr/share/squirrelmail>.

5. Make sure your PHP is at least version 4.1 and compiled with DBA/GDBM
   support (most prebuild PHP binaries ship with gdbm enabled). If you have
   built your own, check if you have compiled it with "--enable-dba
   --with-gdbm" and if not, recompile with these options set.

6. Back up your /var/lib/vadmin directory. Alternatively, move it to
   /var/lib/vadmin-old and create a new /var/lib/vadmin directory, setting
   appropriate permissions. Specify /var/lib/vadmin-old in the [upgrade]
   section and set "cleanup" to "no" to preserve vadmin-old untouched.

7. Restart apache.

8. NOTE: "Admin" link is no longer displayed along the top. To get to the
   Administrative interface, go to "Options".

That should be it. If your setup doesn't work after this, please email
squirrelmail-plugins@lists.sf.net for support with [Vadmin] in the subject.
