| 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 |
| 6 | installation as well as the database before executig 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. | |
| 11 | To use it, unpack the archive of the new Roundcube version to a temporary location (don't replace the Roundcube installation you want to update) | |
| 12 | and cd into that directory. From there, run the following command in a shell: | |
| 13 | ||
| 14 | ./bin/installto.sh <TARGET-FOLDER> | |
| 15 | ||
| 16 | For <TARGET-FOLDER> you specify the path to the Roundcube installation | |
| 17 | which should be updated. The update script will then copy all new files to the | |
| 18 | target location and check and update the configuration and database schema. | |
| 19 | After all is done, the temporary folder with the new Roundcube files can be | |
| 20 | removed again. | |
| 21 | ||
| 22 | ||
| 23 | Updating manually | |
| 24 | ----------------- | |
| 25 | If you don't have shell access to the Roundcube instalaltion or if not running | |
| 26 | it on a unix system, you need to do the following operations by hand: | |
| 27 | ||
| 0089fd | 28 | 1. Replace index.php and all files in |
| T | 29 | - ./bin/ |
| 30 | - ./SQL/ | |
| 31 | - ./program/ | |
| 32 | - ./installer/ | |
| 33 | - ./skins/default/ | |
| fc1102 | 34 | - ./plugins/ |
| 0089fd | 35 | 2. Run ./bin/update.sh from the commandline OR |
| 2491c6 | 36 | open http://url-to-roundcube/installer/ in a browser and choose "3 Test config". |
| e6bb83 | 37 | To enable the latter one, you have to temporary set 'enable_installer' |
| T | 38 | to true in your local config/main.inc.php file. |
| 0089fd | 39 | 3. Let the update script/installer check your configuration and |
| e6bb83 | 40 | update your config files and database schema as suggested by the updater. |
| T | 41 | 4. Make sure 'enable_installer' is set to false again. |
| 42 | 5. Check .htaccess settings (some php settings could become required) | |
| 0089fd | 43 | |
| T | 44 | |
