Aleksander Machniak
2016-05-20 2d12748662ffd4d1dec5bc8ad89681afa6af7ba4
commit | author | age
a2451c 1 UPGRADING instructions
T 2 ======================
4e17e6 3
2491c6 4 Follow these instructions if upgrading from a previous version
T 5 of Roundcube Webmail. We recommend to carefully backup the existing
111a6f 6 installation as well as the database before going through the following steps.
4e17e6 7
e6bb83 8 Using the update script
T 9 -----------------------
10 There is a shell script (for unix based systems) that does the job for you.
111a6f 11 To use it, unpack the archive of the new Roundcube version to a temporary location
A 12 (don't replace the Roundcube installation you want to update)
e6bb83 13 and cd into that directory. From there, run the following command in a shell:
T 14
15   ./bin/installto.sh <TARGET-FOLDER>
16
17 For <TARGET-FOLDER> you specify the path to the Roundcube installation 
18 which should be updated. The update script will then copy all new files to the 
19 target location and check and update the configuration and database schema.
20 After all is done, the temporary folder with the new Roundcube files can be 
21 removed again.
faf10e 22
738996 23 WARNING: See Post-Upgrade Activities section below.
e6bb83 24
T 25
26 Updating manually
27 -----------------
111a6f 28 If you don't have shell access to the Roundcube installation or if not running 
e6bb83 29 it on a unix system, you need to do the following operations by hand:
T 30
0089fd 31 1. Replace index.php and all files in
T 32    - ./bin/
33    - ./SQL/
34    - ./program/
6d1e31 35    - ./installer/
TB 36 2. Replace the configuration defaults files:
37    - config/defaults.inc.php
38    - config/mimetypes.php
39 3. rsync the contents of the following folders from your installation
9efa95 40    directory into the target folder:
T 41    ./skins/
42    ./plugins/
d4a820 43    ./vendor/
b7d669 44 4a. If you previously installed plugins through composer, update dependencies
TB 45    by running `php composer.phar update --no-dev`
46 4b. Install/update dependencies using composer:
47    - get composer from https://getcomposer.org/download/
48    - rename the composer.json-dist file into composer.json
49    - if you want to use LDAP address books, enable the LDAP libraries in your
50      composer.json file by moving the items from "suggest" to the "require"
51      section (remove the explanation texts after the version!).
52    - run `php composer.phar install --no-dev`
53 5. Run `./bin/update.sh` from the commandline OR
2491c6 54    open http://url-to-roundcube/installer/ in a browser and choose "3 Test config".
e6bb83 55    To enable the latter one, you have to temporary set 'enable_installer'
461a30 56    to true in your local config/config.inc.php file.
001b17 57    WARNING: See SQLite database upgrade below.
b7d669 58 6. Let the update script/installer check your configuration and
e6bb83 59    update your config files and database schema as suggested by the updater.
0c137f 60 7. Make sure 'enable_installer' is set to false again.
TB 61 8. See Post-Upgrade Activities section.
0089fd 62
T 63
111a6f 64 Post-Upgrade Activities
A 65 -----------------------
66 1. Check .htaccess settings (some php settings could become required)
67 2. If you're using build-in addressbook, run indexing script /bin/indexcontacts.sh.
d08333 68 3. When upgrading from version older than 0.6-beta you should make sure
A 69    your folder settings contain namespace prefix. For example Courier users
70    should add INBOX. prefix to folder names in main configuration file.
738996 71 4. Check system requirements in INSTALL file.
001b17 72
AM 73 SQLite database upgrade
74 -----------------------
75 Versions older than 0.9 were supporting SQLite v2 only. Newer versions require
76 database in v3 format. The best what you can do is to convert database file
77 to the new format using command line tools:
78
79 sqlite OLD.DB .dump | sqlite3 NEW.DB