1 |
pva 11/10/01 20:29:56 |
2 |
|
3 |
Added: postupgrade-en-0.6.txt postinstall-en-0.6.txt |
4 |
Log: |
5 |
Version bump. |
6 |
|
7 |
(Portage version: 2.1.10.19/cvs/Linux x86_64) |
8 |
|
9 |
Revision Changes Path |
10 |
1.1 mail-client/roundcube/files/postupgrade-en-0.6.txt |
11 |
|
12 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo-x86/mail-client/roundcube/files/postupgrade-en-0.6.txt?rev=1.1&view=markup |
13 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo-x86/mail-client/roundcube/files/postupgrade-en-0.6.txt?rev=1.1&content-type=text/plain |
14 |
|
15 |
Index: postupgrade-en-0.6.txt |
16 |
=================================================================== |
17 |
Upgrade instructions for roundcube |
18 |
---------------------------------- |
19 |
|
20 |
* Web browser instructions |
21 |
|
22 |
1. temporary set 'enable_installer' to true in your local config/main.inc.php |
23 |
file. |
24 |
|
25 |
2. in your browser open |
26 |
http://${VHOST_HOSTNAME}/${VHOST_APPDIR}/installer/ |
27 |
and choose "3 Test config". |
28 |
|
29 |
3. Let the update script/installer check your configuration and update your |
30 |
config files and database schema as suggested by the updater. |
31 |
|
32 |
4. Make sure 'enable_installer' is set to false again. |
33 |
|
34 |
* Alternative update |
35 |
|
36 |
As an alternative to procedure outlined in "Web browser instructions" to |
37 |
execute: |
38 |
$ cd ${MY_SERVERCONFIGDIR}/bin |
39 |
$ chmod +x bin/*.sh |
40 |
$ ./bin/update.sh |
41 |
$ chmod -x bin/*.sh |
42 |
This will check your configuration and update your config files and database |
43 |
schema as suggested by the updater. |
44 |
|
45 |
|
46 |
* Post-Upgrade Activities |
47 |
|
48 |
1. Check .htaccess settings (some php settings could become required) |
49 |
2. If you're using build-in addressbook, run indexing script |
50 |
$ cd ${MY_SERVERCONFIGDIR}/bin |
51 |
$ chmod +x bin/*.sh |
52 |
$ ./bin/indexcontacts.sh. |
53 |
$ chmod -x bin/*.sh |
54 |
3. When upgrading from version older than 0.6-beta you should make sure your |
55 |
folder settings contain namespace prefix. For example Courier users should add |
56 |
INBOX. prefix to folder names in main configuration file. |
57 |
|
58 |
|
59 |
|
60 |
|
61 |
1.1 mail-client/roundcube/files/postinstall-en-0.6.txt |
62 |
|
63 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo-x86/mail-client/roundcube/files/postinstall-en-0.6.txt?rev=1.1&view=markup |
64 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo-x86/mail-client/roundcube/files/postinstall-en-0.6.txt?rev=1.1&content-type=text/plain |
65 |
|
66 |
Index: postinstall-en-0.6.txt |
67 |
=================================================================== |
68 |
0. DATABASE SETUP |
69 |
|
70 |
* MySQL |
71 |
------- |
72 |
|
73 |
For MySQL it's recommended to create the database for RoundCube with utf-8 |
74 |
charset. Here's an example of the init procedure: |
75 |
|
76 |
# mysql |
77 |
> CREATE DATABASE roundcubemail DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; |
78 |
> GRANT ALL PRIVILEGES ON roundcubemail.* TO roundcube@localhost |
79 |
IDENTIFIED BY 'password'; |
80 |
> quit |
81 |
|
82 |
# mysql roundcubemail < ${MY_INSTALLDIR}/SQL/mysql.initial.sql |
83 |
|
84 |
* SQLite |
85 |
-------- |
86 |
Here is an example how you can setup the sqlite.db for roundcube: |
87 |
|
88 |
# sqlite -init SQL/sqlite.initial.sql sqlite.db |
89 |
|
90 |
Make sure your configuration points to the sqlite.db file and that the |
91 |
webserver can write to the file and the directory containing the file. |
92 |
|
93 |
* PostgreSQL |
94 |
------------ |
95 |
To use RoundCube with PostgreSQL support you have to follow these |
96 |
simple steps, which have to be done as the postgres system user (or |
97 |
which ever is the database superuser): |
98 |
|
99 |
$ createuser roundcube |
100 |
$ createdb -O roundcube roundcubemail |
101 |
$ psql roundcubemail |
102 |
|
103 |
roundcubemail =# ALTER USER roundcube WITH PASSWORD 'the_new_password'; |
104 |
roundcubemail =# \c - roundcube |
105 |
roundcubemail => \i ${MY_INSTALLDIR}/SQL/postgres.initial.sql |
106 |
|
107 |
|
108 |
1. ROUNDCUBE CONFIGURATION |
109 |
|
110 |
Modify the files in ${MY_INSTALLDIR}/config/* to suit your local environment |
111 |
|
112 |
Details about the config parameters can be found in the config files. |
113 |
See http://trac.roundcube.net/wiki/Howto_Install for even more guidance. |
114 |
|
115 |
|
116 |
2. PHP CONFIGURATION |
117 |
|
118 |
- error_reporting E_ALL & ~E_NOTICE (or lower) |
119 |
- memory_limit > 16MB (increase as suitable to support large attachments) |
120 |
- file_uploads enabled (for attachment upload features) |
121 |
- session.auto_start disabled |
122 |
- zend.ze1_compatibility_mode disabled |
123 |
- suhosin.session.encrypt disabled |
124 |
- mbstring.func_overload disabled |
125 |
- magic_quotes_runtime disabled |
126 |
|
127 |
|
128 |
3. WEBSERVER CONFIGURATION |
129 |
|
130 |
Access through your webserver to at least the following directories should be denied: |
131 |
|
132 |
* /conf |
133 |
* /temp |
134 |
* /logs |
135 |
|
136 |
Roundcube uses .htaccess files to protect these directories if you are using Apache; |
137 |
be sure to allow override of the Limit directives to get them taken into account. |
138 |
|
139 |
If you are NOT using Apache, it is your responsibility to take care of the above as |
140 |
needed by your webserver. |