From 3d6d0389385b2a52ae83c8e09eadbd99c97c1113 Mon Sep 17 00:00:00 2001 From: Aleksander Machniak <alec@alec.pl> Date: Mon, 16 May 2016 02:52:05 -0400 Subject: [PATCH] Fix typo in localization message --- UPGRADING | 55 +++++++++++++++++++++++++++++++++++++++++++++---------- 1 files changed, 45 insertions(+), 10 deletions(-) diff --git a/UPGRADING b/UPGRADING index f203643..fe0ad4d 100644 --- a/UPGRADING +++ b/UPGRADING @@ -3,12 +3,13 @@ Follow these instructions if upgrading from a previous version of Roundcube Webmail. We recommend to carefully backup the existing -installation as well as the database before executig the following steps. +installation as well as the database before going through the following steps. Using the update script ----------------------- There is a shell script (for unix based systems) that does the job for you. -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) +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) and cd into that directory. From there, run the following command in a shell: ./bin/installto.sh <TARGET-FOLDER> @@ -19,10 +20,12 @@ After all is done, the temporary folder with the new Roundcube files can be removed again. +WARNING: See Post-Upgrade Activities section below. + Updating manually ----------------- -If you don't have shell access to the Roundcube instalaltion or if not running +If you don't have shell access to the Roundcube installation or if not running it on a unix system, you need to do the following operations by hand: 1. Replace index.php and all files in @@ -30,15 +33,47 @@ - ./SQL/ - ./program/ - ./installer/ - - ./skins/default/ - - ./plugins/ -2. Run ./bin/update.sh from the commandline OR +2. Replace the configuration defaults files: + - config/defaults.inc.php + - config/mimetypes.php +3. rsync the contents of the following folders from your installation + directory into the target folder: + ./skins/ + ./plugins/ + ./vendor/ +4a. If you previously installed plugins through composer, update dependencies + by running `php composer.phar update --no-dev` +4b. Install/update dependencies using composer: + - get composer from https://getcomposer.org/download/ + - rename the composer.json-dist file into composer.json + - if you want to use LDAP address books, enable the LDAP libraries in your + composer.json file by moving the items from "suggest" to the "require" + section (remove the explanation texts after the version!). + - run `php composer.phar install --no-dev` +5. Run `./bin/update.sh` from the commandline OR open http://url-to-roundcube/installer/ in a browser and choose "3 Test config". To enable the latter one, you have to temporary set 'enable_installer' - to true in your local config/main.inc.php file. -3. Let the update script/installer check your configuration and + to true in your local config/config.inc.php file. + WARNING: See SQLite database upgrade below. +6. Let the update script/installer check your configuration and update your config files and database schema as suggested by the updater. -4. Make sure 'enable_installer' is set to false again. -5. Check .htaccess settings (some php settings could become required) +7. Make sure 'enable_installer' is set to false again. +8. See Post-Upgrade Activities section. +Post-Upgrade Activities +----------------------- +1. Check .htaccess settings (some php settings could become required) +2. If you're using build-in addressbook, run indexing script /bin/indexcontacts.sh. +3. When upgrading from version older than 0.6-beta you should make sure + your folder settings contain namespace prefix. For example Courier users + should add INBOX. prefix to folder names in main configuration file. +4. Check system requirements in INSTALL file. + +SQLite database upgrade +----------------------- +Versions older than 0.9 were supporting SQLite v2 only. Newer versions require +database in v3 format. The best what you can do is to convert database file +to the new format using command line tools: + +sqlite OLD.DB .dump | sqlite3 NEW.DB -- Gitblit v1.9.1