| 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. | |
| 111a6f | 22 | See Post-Upgrade Activities section. |
| e6bb83 | 23 | |
| T | 24 | |
| 25 | Updating manually | |
| 26 | ----------------- | |
| 111a6f | 27 | If you don't have shell access to the Roundcube installation or if not running |
| e6bb83 | 28 | it on a unix system, you need to do the following operations by hand: |
| T | 29 | |
| 0089fd | 30 | 1. Replace index.php and all files in |
| T | 31 | - ./bin/ |
| 32 | - ./SQL/ | |
| 33 | - ./program/ | |
| 34 | - ./installer/ | |
| 35 | - ./skins/default/ | |
| fc1102 | 36 | - ./plugins/ |
| 0089fd | 37 | 2. Run ./bin/update.sh from the commandline OR |
| 2491c6 | 38 | open http://url-to-roundcube/installer/ in a browser and choose "3 Test config". |
| e6bb83 | 39 | To enable the latter one, you have to temporary set 'enable_installer' |
| T | 40 | to true in your local config/main.inc.php file. |
| 0089fd | 41 | 3. Let the update script/installer check your configuration and |
| e6bb83 | 42 | update your config files and database schema as suggested by the updater. |
| T | 43 | 4. Make sure 'enable_installer' is set to false again. |
| 111a6f | 44 | 5. See Post-Upgrade Activities section. |
| 0089fd | 45 | |
| T | 46 | |
| 111a6f | 47 | Post-Upgrade Activities |
| A | 48 | ----------------------- |
| 49 | 1. Check .htaccess settings (some php settings could become required) | |
| 50 | 2. If you're using build-in addressbook, run indexing script /bin/indexcontacts.sh. | |
| d08333 | 51 | 3. When upgrading from version older than 0.6-beta you should make sure |
| A | 52 | your folder settings contain namespace prefix. For example Courier users |
| 53 | should add INBOX. prefix to folder names in main configuration file. | |
