X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=UPGRADE;h=ee77526ae7444ea5f7a4d069b88619880a837993;hb=0b20cce07db112b5fa316562c7aaecf4e6f94a59;hp=079d59e74a52764f1568ac7dece469fca1fd1518;hpb=4b45f6cb3cfc5ad2d8939d224fdd060ca57a85e2;p=squirrelmail.git diff --git a/UPGRADE b/UPGRADE index 079d59e7..ee77526a 100644 --- a/UPGRADE +++ b/UPGRADE @@ -7,7 +7,7 @@ using a previous version (0.1 or 0.2), it is suggested that you just start from scratch and configure your settings as if it was your first install. NOTE: The new plugin architecture required the use of some functions which -are not in all versions of PHP4. You will need at least PHP4 beta2. If you +are not in all versions of PHP4. You will need at least PHP 4.1.0. If you need to upgrade please go ahead and install the latest release version of PHP4. @@ -66,26 +66,27 @@ the config file. C. Copy plugins -Like SquirrelMail, plugins are fequently updated for improvements, as well +Like SquirrelMail, plugins are frequently updated for improvements, as well as to make them compatible with new SquirrelMail releases. It is suggested -that you download a new plugins archive at the same time you download your -SquirrelMail install, and that you install your plugins fresh (it's easy, -don't panic!). +that you download new versions of your plugins at the same time you download +your SquirrelMail install, and that you install your plugins fresh (it's +easy, don't panic!). -If you prefer to just copy your old plugins over (if it's the same version -or if you are lazy), you may do so. If you notice irregularities with the -plugins under the new SquirrelMail, try installing new versions of the -plugins. - - $ cp -Rp squirrelmail-1.0.6.bak/plugins/* squirrelmail-1.2.0/plugins +You should not try replacing plugins that are already included in SquirrelMail +package. Download latest versions of plugins that are not included in new +SquirrelMail package or copy them from older SquirrelMail install. D. Copy themes If you've created or modified themes, you should copy just those to the new -SquirrelMail themes direcory. To just copy them all over to the new +SquirrelMail themes directory. To just copy them all over to the new SquirrelMail installation, you can run one command. - $ cp squirrelmail-1.0.6.bak/themes/* squirrelmail-1.2.0/themes/ + $ cp -ui squirrelmail-1.0.6.bak/themes/* squirrelmail-1.2.0/themes/ + +When -u flag is used, command copies only missing and newer files. +When -i flag is used, command asks for confirmation before replacing +existing files. (While you are at it, you should send them to us! We might add them to the themes in the standard install!) @@ -98,10 +99,10 @@ example, we assume that user "nobody" and group "nobody" are the web server as is often the case with Apache. $ cd squirrelmail-1.2.0 - $ chown -R nobody.nobody data + $ chown -R nobody:nobody data See INSTALL for alternate userid/groupid pairs. Additionally, if "chown -user.group" doesn't work, you can use "chown user" and "chgrp group" +user:group" doesn't work, you can use "chown user" and "chgrp group" instead. See the man pages for these commands for more information. @@ -111,15 +112,10 @@ Run config/conf.pl to see the new configuration options available with the new version, as well as to verify that all of your old options are set properly. -When you have migrated plugins from your old install to your new -install, or even use any plugins at all, you *must* run conf.pl and do -the following: - -A. Select "8" (Plugins) -B. Select "A" (Sanitize all plugins for use with Squirrelmail 1.2) +Always save your options, also if you haven't changed anything. +This will ensure that any problems with conf.pl that might have been solved +are effective to your installation. -This will make sure the plugins work more efficiently (and will -release you from any "cannot redeclare" error messages). 6. DONE! =========