From e2e56261b977a3f70e2495e860e6e2c387305a15 Mon Sep 17 00:00:00 2001
From: Aleksander Machniak <alec@alec.pl>
Date: Wed, 13 Apr 2016 07:08:43 -0400
Subject: [PATCH] Fix handling of long script/style tags when converting to text
---
UPGRADING | 194 +++++++++++++++++------------------------------
1 files changed, 71 insertions(+), 123 deletions(-)
diff --git a/UPGRADING b/UPGRADING
index fecc377..fe0ad4d 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -1,131 +1,79 @@
-UPDATE instructions
-===================
+UPGRADING instructions
+======================
Follow these instructions if upgrading from a previous version
-of RoundCube Webmail.
+of Roundcube Webmail. We recommend to carefully backup the existing
+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)
+and cd into that directory. From there, run the following command in a shell:
+
+ ./bin/installto.sh <TARGET-FOLDER>
+
+For <TARGET-FOLDER> you specify the path to the Roundcube installation
+which should be updated. The update script will then copy all new files to the
+target location and check and update the configuration and database schema.
+After all is done, the temporary folder with the new Roundcube files can be
+removed again.
+
+WARNING: See Post-Upgrade Activities section below.
-from versions 0.1-alpha and 0.1-20050811
-----------------------------------------
-- replace index.php
-- replace all files in folder /program/
-- replace all files in folder /skins/default/
-- run all commands in SQL/*.update.sql or re-initalize database with *.initial.sql
-- add these line to /config/main.inc.php
- $rcmail_config['trash_mbox'] = 'Trash';
- $rcmail_config['default_imap_folders'] = array('INBOX', 'Drafts', 'Sent', 'Junk', 'Trash');
- $rcmail_config['prefer_html'] = TRUE;
- $rcmail_config['prettydate'] = TRUE;
- $rcmail_config['smtp_port'] = 25;
- $rcmail_config['default_port'] = 143;
- $rcmail_config['session_lifetime'] = 20;
- $rcmail_config['skip_deleted'] = FALSE;
- $rcmail_config['message_sort_col'] = 'date';
- $rcmail_config['message_sort_order'] = 'DESC';
- $rcmail_config['log_dir'] = 'logs/';
- $rcmail_config['temp_dir'] = 'temp/';
- $rcmail_config['message_cache_lifetime'] = '10d';
-- replace database properties (db_type, db_host, db_user, db_pass, $d_name)
- in /config/db.inc.php with the following line:
- $rcmail_config['db_dsnw'] = 'mysql://roundcube:pass@localhost/roundcubemail';
-- add these lines to /config/db.inc.php
- $rcmail_config['db_max_length'] = 512000;
+Updating manually
+-----------------
+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
+ - ./bin/
+ - ./SQL/
+ - ./program/
+ - ./installer/
+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/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.
+7. Make sure 'enable_installer' is set to false again.
+8. See Post-Upgrade Activities section.
-from version 0.1-20050820
-----------------------------------------
-- replace index.php
-- replace all files in folder /program/
-- replace all files in folder /skins/default/
-- run all commands in SQL/*.update.sql or re-initalize database with *.initial.sql
-- add these line to /config/main.inc.php
- $rcmail_config['prettydate'] = TRUE;
- $rcmail_config['smtp_port'] = 25;
- $rcmail_config['default_port'] = 143;
- $rcmail_config['session_lifetime'] = 20;
- $rcmail_config['skip_deleted'] = FALSE;
- $rcmail_config['message_sort_col'] = 'date';
- $rcmail_config['message_sort_order'] = 'DESC';
- $rcmail_config['log_dir'] = 'logs/';
- $rcmail_config['temp_dir'] = 'temp/';
- $rcmail_config['message_cache_lifetime'] = '10d';
-- replace database properties (db_type, db_host, db_user, db_pass, $d_name)
- in /config/db.inc.php with the following line:
- $rcmail_config['db_dsnw'] = 'mysql://roundcube:pass@localhost/roundcubemail';
-- add these lines to /config/db.inc.php
- $rcmail_config['db_max_length'] = 512000;
+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:
-from version 0.1-20051007
-----------------------------------------
-- replace index.php
-- replace all files in folder /program/
-- replace all files in folder /skins/default/
-- run all commands in SQL/*.update.sql or re-initalize database with *.initial.sql
-- add these lines to /config/main.inc.php
- $rcmail_config['smtp_auth_type'] = ''; // if you need to specify an auth method for SMTP
- $rcmail_config['session_lifetime'] = 20; // to specify the session lifetime in minutes
- $rcmail_config['skip_deleted'] = FALSE;
- $rcmail_config['message_sort_col'] = 'date';
- $rcmail_config['message_sort_order'] = 'DESC';
- $rcmail_config['log_dir'] = 'logs/';
- $rcmail_config['temp_dir'] = 'temp/';
- $rcmail_config['message_cache_lifetime'] = '10d';
- $rcmail_config['drafts_mbox'] = 'Drafts';
- $rcmail_config['product_name'] = 'RoundCube Webmail';
- $rcmail_config['read_when_deleted'] = TRUE;
- $rcmail_config['enable_spellcheck'] = TRUE;
-- add these lines to /config/db.inc.php
- $rcmail_config['db_max_length'] = 512000;
- $rcmail_config['db_sequence_user_ids'] = 'user_ids';
- $rcmail_config['db_sequence_identity_ids'] = 'identity_ids';
- $rcmail_config['db_sequence_contact_ids'] = 'contact_ids';
- $rcmail_config['db_sequence_cache_ids'] = 'cache_ids';
- $rcmail_config['db_sequence_message_ids'] = 'message_ids';
- $rcmail_config['db_persistent'] = TRUE;
-
-from version 0.1-20051021
-----------------------------------------
-- replace index.php
-- replace all files in folder /program/
-- replace all files in folder /skins/default/
-- run all commands in SQL/*.update.sql or re-initalize database with *.initial.sql
-- add these lines to /config/main.inc.php
- $rcmail_config['skip_deleted'] = FALSE;
- $rcmail_config['message_sort_col'] = 'date';
- $rcmail_config['message_sort_order'] = 'DESC';
- $rcmail_config['log_dir'] = 'logs/';
- $rcmail_config['temp_dir'] = 'temp/';
- $rcmail_config['message_cache_lifetime'] = '10d';
- $rcmail_config['drafts_mbox'] = 'Drafts';
- $rcmail_config['product_name'] = 'RoundCube Webmail';
- $rcmail_config['read_when_deleted'] = TRUE;
- $rcmail_config['enable_spellcheck'] = TRUE;
-- add these lines to /config/db.inc.php
- $rcmail_config['db_max_length'] = 512000;
- $rcmail_config['db_sequence_user_ids'] = 'user_ids';
- $rcmail_config['db_sequence_identity_ids'] = 'identity_ids';
- $rcmail_config['db_sequence_contact_ids'] = 'contact_ids';
- $rcmail_config['db_sequence_cache_ids'] = 'cache_ids';
- $rcmail_config['db_sequence_message_ids'] = 'message_ids';
- $rcmail_config['db_persistent'] = TRUE;
-
-
-form version 0.1-beta
-----------------------------------------
-- replace index.php
-- replace all files in folder /program/
-- replace all files in folder /skins/default/
-- add these lines to /config/db.inc.php
- $rcmail_config['db_persistent'] = TRUE;
-- add these lines to /config/main.inc.php
- $rcmail_config['drafts_mbox'] = 'Drafts';
- $rcmail_config['product_name'] = 'RoundCube Webmail';
- $rcmail_config['read_when_deleted'] = TRUE;
- $rcmail_config['enable_spellcheck'] = TRUE;
-- replace the following line from /config/main.inc.php
- @include($_SERVER['HTTP_HOST'].'.inc.php');
- with
- $rcmail_config['include_host_config'] = TRUE;
-
-
+sqlite OLD.DB .dump | sqlite3 NEW.DB
--
Gitblit v1.9.1