b8aaaa7b |
1 | Upgrading from 0.3 or higher |
47f9c368 |
2 | ============================ |
3 | |
4 | If you are upgrading from versions 0.3 or higher of SquirrelMail, you can |
5 | use this guide to make the transition a bit smoother. If you have been |
6 | using a previous version (0.1 or 0.2), it is suggested that you just start |
7 | from scratch and configure your settings as if it was your first install. |
f4057b81 |
8 | |
2b996daf |
9 | NOTE: The new plugin architecture required the use of some functions which |
238d4cfc |
10 | are not in all versions of PHP. You will need at least PHP 4.1.0. If you |
2b996daf |
11 | need to upgrade please go ahead and install the latest release version of |
238d4cfc |
12 | PHP. |
f4057b81 |
13 | |
8462c882 |
14 | |
15 | 1. Backup old install |
16 | ====================== |
2b996daf |
17 | |
18 | Make a backup of your current SquirrelMail directory. If you use "cp", be |
19 | sure to use the "-Rp" options. -R means recursive, and -p will save the |
8462c882 |
20 | permissions in the directory. |
21 | |
b8aaaa7b |
22 | In this example, we assume that your httpd document directory is |
8462c882 |
23 | /home/httpd/html, that your SquirrelMail install is located at |
b8aaaa7b |
24 | /home/httpd/html/squirrelmail-1.2.6, and that your new SM version is 1.4.0. |
8462c882 |
25 | Substitute version numbers and names as required. |
f4057b81 |
26 | |
27 | $ cd /home/httpd/html |
b8aaaa7b |
28 | $ cp -Rp squirrelmail-1.2.6 squirrelmail-1.2.6.bak |
f4057b81 |
29 | |
30 | |
8462c882 |
31 | 2. Unarchive new SquirrelMail |
32 | ============================== |
33 | Make sure that you are in your httpd document directory (/home/httpd/html) |
b8aaaa7b |
34 | and then unarchive the SquirrelMail archive (whatever the filename is): |
2b996daf |
35 | |
b8aaaa7b |
36 | $ tar -zxvf squirrelmail-1.4.0.tar.gz |
f4057b81 |
37 | |
38 | |
8462c882 |
39 | 3. Copy important files from old install |
40 | ========================================= |
41 | The important files to copy are: |
42 | A. Preferences |
43 | B. Config details |
44 | C. Plugins |
45 | D. Themes (if you've edited or added any of them) |
b8aaaa7b |
46 | |
8462c882 |
47 | A. Preferences |
f4057b81 |
48 | |
4b45f6cb |
49 | First, copy your preference data over to the new directory. Usually |
50 | this is ok, but if you are upgrading from anything less than 1.0.5, we |
51 | strongly suggest you let your users reset their preferences. There |
52 | were important security upgrades in 1.0.5 regarding preference files. |
b8aaaa7b |
53 | |
54 | $ cp squirrelmail-1.2.6.bak/data/* squirrelmail-1.4.0/data |
55 | |
8462c882 |
56 | B. Config details |
57 | |
b8aaaa7b |
58 | If at all possible, start the configuration process from scratch. It is |
8462c882 |
59 | much less prone to missing configuration options than copying your old |
60 | configuration. Ideally, you should just run conf.pl to reconfigure |
61 | SquirrelMail. If you decide to copy your old config.php over, we strongly |
62 | recommend that you run conf.pl to make sure things are correct and then save |
63 | the config file. |
64 | |
b8aaaa7b |
65 | $ cp squirrelmail-1.2.6.bak/config/config.php squirrelmail-1.4.0/config |
f4057b81 |
66 | |
8462c882 |
67 | C. Copy plugins |
68 | |
3d8fe250 |
69 | Like SquirrelMail, plugins are frequently updated for improvements, as well |
8462c882 |
70 | as to make them compatible with new SquirrelMail releases. It is suggested |
e5a561ac |
71 | that you download new versions of your plugins at the same time you download |
72 | your SquirrelMail install, and that you install your plugins fresh (it's |
73 | easy, don't panic!). |
8462c882 |
74 | |
3fe751d7 |
75 | You should not try replacing plugins that are already included in SquirrelMail |
76 | package. Download latest versions of plugins that are not included in new |
77 | SquirrelMail package or copy them from older SquirrelMail install. |
b8aaaa7b |
78 | |
8462c882 |
79 | D. Copy themes |
80 | |
81 | If you've created or modified themes, you should copy just those to the new |
3d8fe250 |
82 | SquirrelMail themes directory. To just copy them all over to the new |
8462c882 |
83 | SquirrelMail installation, you can run one command. |
84 | |
b8aaaa7b |
85 | $ cp -ui squirrelmail-1.2.6.bak/themes/* squirrelmail-1.4.0/themes/ |
3fe751d7 |
86 | |
b8aaaa7b |
87 | When -u flag is used, command copies only missing and newer files. |
3fe751d7 |
88 | When -i flag is used, command asks for confirmation before replacing |
89 | existing files. |
8462c882 |
90 | |
f4057b81 |
91 | |
92 | 4. Change permissions |
93 | ====================== |
94 | The web server must have write permission to the data directory. In this |
95 | example, we assume that user "nobody" and group "nobody" are the web server |
96 | as is often the case with Apache. |
97 | |
b8aaaa7b |
98 | $ cd squirrelmail-1.4.0 |
afc8a074 |
99 | $ chown -R nobody:nobody data |
b8aaaa7b |
100 | |
8462c882 |
101 | See INSTALL for alternate userid/groupid pairs. Additionally, if "chown |
afc8a074 |
102 | user:group" doesn't work, you can use "chown user" and "chgrp group" |
8462c882 |
103 | instead. See the man pages for these commands for more information. |
104 | |
105 | |
106 | 5. Run conf.pl |
107 | =============== |
108 | Run config/conf.pl to see the new configuration options available with the |
109 | new version, as well as to verify that all of your old options are set |
110 | properly. |
f4057b81 |
111 | |
bcbbfc89 |
112 | Always save your options, also if you haven't changed anything. |
113 | This will ensure that any problems with conf.pl that might have been solved |
114 | are effective to your installation. |
4b45f6cb |
115 | |
f4057b81 |
116 | |
8462c882 |
117 | 6. DONE! |
f4057b81 |
118 | ========= |
2b996daf |
119 | That should be all! The most important part is copying your users' |
120 | preference files back into the new data directory. This will insure that |
8462c882 |
121 | your users will have their old preferences. Remember to do so with caution, |
122 | especially if you are upgrading from a version before 1.0.5 to version 1.0.5 |
123 | or later. |