| 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/ | |
| 9efa95 | 35 | 2. rsync the contents of the following folders from your installation |
| T | 36 | directory into the target folder: |
| 37 | ./skins/ | |
| 38 | ./plugins/ | |
| 39 | 3. Run ./bin/update.sh from the commandline OR | |
| 2491c6 | 40 | open http://url-to-roundcube/installer/ in a browser and choose "3 Test config". |
| e6bb83 | 41 | To enable the latter one, you have to temporary set 'enable_installer' |
| T | 42 | to true in your local config/main.inc.php file. |
| 6e3f2b | 43 | WARNING: See SQLite database upgrade below. |
| 9efa95 | 44 | 4. Let the update script/installer check your configuration and |
| e6bb83 | 45 | update your config files and database schema as suggested by the updater. |
| 9efa95 | 46 | 5. Make sure 'enable_installer' is set to false again. |
| T | 47 | 6. See Post-Upgrade Activities section. |
| 0089fd | 48 | |
| T | 49 | |
| 111a6f | 50 | Post-Upgrade Activities |
| A | 51 | ----------------------- |
| 52 | 1. Check .htaccess settings (some php settings could become required) | |
| 53 | 2. If you're using build-in addressbook, run indexing script /bin/indexcontacts.sh. | |
| d08333 | 54 | 3. When upgrading from version older than 0.6-beta you should make sure |
| A | 55 | your folder settings contain namespace prefix. For example Courier users |
| 56 | should add INBOX. prefix to folder names in main configuration file. | |
| 738996 | 57 | 4. Check system requirements in INSTALL file. |
| 6e3f2b | 58 | |
| AM | 59 | SQLite database upgrade |
| 60 | ----------------------- | |
| 61 | Versions older than 0.9 were supporting SQLite v2 only. Newer versions require | |
| 62 | database in v3 format. The best what you can do is to convert database file | |
| 63 | to the new format using command line tools: | |
| 64 | ||
| 65 | sqlite OLD.DB .dump | sqlite3 NEW.DB | |
