| 90 | {{{ |
| 91 | ================================================================= |
| 92 | POST-UPGRADE INSTRUCTIONS |
| 93 | ================================================================= |
| 94 | |
| 95 | UPGRADING instructions |
| 96 | ====================== |
| 97 | |
| 98 | Follow these instructions if upgrading from a previous version |
| 99 | of Roundcube Webmail. We recommend to carefully backup the existing |
| 100 | installation as well as the database before going through the following steps. |
| 101 | |
| 102 | Using the update script |
| 103 | ----------------------- |
| 104 | There is a shell script (for unix based systems) that does the job for you. |
| 105 | To use it, unpack the archive of the new Roundcube version to a temporary location |
| 106 | (don't replace the Roundcube installation you want to update) |
| 107 | and cd into that directory. From there, run the following command in a shell: |
| 108 | |
| 109 | ./bin/installto.sh <TARGET-FOLDER> |
| 110 | |
| 111 | For <TARGET-FOLDER> you specify the path to the Roundcube installation |
| 112 | which should be updated. The update script will then copy all new files to the |
| 113 | target location and check and update the configuration and database schema. |
| 114 | After all is done, the temporary folder with the new Roundcube files can be |
| 115 | removed again. |
| 116 | |
| 117 | WARNING: See Post-Upgrade Activities section below. |
| 118 | |
| 119 | |
| 120 | Updating manually |
| 121 | ----------------- |
| 122 | If you don't have shell access to the Roundcube installation or if not running |
| 123 | it on a unix system, you need to do the following operations by hand: |
| 124 | |
| 125 | 1. Replace index.php and all files in |
| 126 | - ./bin/ |
| 127 | - ./SQL/ |
| 128 | - ./program/ |
| 129 | - ./installer/ |
| 130 | 2. Replace the configuration defaults files: |
| 131 | - config/defaults.inc.php |
| 132 | - config/mimetypes.php |
| 133 | 3. rsync the contents of the following folders from your installation |
| 134 | directory into the target folder: |
| 135 | ./skins/ |
| 136 | ./plugins/ |
| 137 | 4. Run ./bin/update.sh from the commandline OR |
| 138 | open http://url-to-roundcube/installer/ in a browser and choose "3 Test config". |
| 139 | To enable the latter one, you have to temporary set 'enable_installer' |
| 140 | to true in your local config/config.inc.php file. |
| 141 | WARNING: See SQLite database upgrade below. |
| 142 | 5. Let the update script/installer check your configuration and |
| 143 | update your config files and database schema as suggested by the updater. |
| 144 | 6. Make sure 'enable_installer' is set to false again. |
| 145 | 7. See Post-Upgrade Activities section. |
| 146 | |
| 147 | |
| 148 | Post-Upgrade Activities |
| 149 | ----------------------- |
| 150 | 1. Check .htaccess settings (some php settings could become required) |
| 151 | 2. If you're using build-in addressbook, run indexing script /bin/indexcontacts.sh. |
| 152 | 3. When upgrading from version older than 0.6-beta you should make sure |
| 153 | your folder settings contain namespace prefix. For example Courier users |
| 154 | should add INBOX. prefix to folder names in main configuration file. |
| 155 | 4. Check system requirements in INSTALL file. |
| 156 | |
| 157 | SQLite database upgrade |
| 158 | ----------------------- |
| 159 | Versions older than 0.9 were supporting SQLite v2 only. Newer versions require |
| 160 | database in v3 format. The best what you can do is to convert database file |
| 161 | to the new format using command line tools: |
| 162 | |
| 163 | sqlite OLD.DB .dump | sqlite3 NEW.DB |
| 164 | |
| 165 | ================================================================= |
| 166 | }}} |