X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=UPGRADING;h=ce951d1147cff891b2cdd1ab78cdf0d587ca1151;hb=9d358bb749203c1c4cb278a01e51f79754aa643a;hp=b2c1977b2c7371b2f367361b1b988bddd1243fa4;hpb=1213c6e65f2bab1e140369839a9d0f6db28a9492;p=roundcube.git diff --git a/UPGRADING b/UPGRADING index b2c1977..ce951d1 100644 --- a/UPGRADING +++ b/UPGRADING @@ -1,12 +1,32 @@ UPGRADING instructions ====================== -First you should remove all subfolders from /program/localization/ -because most language codes have changed in 0.2-alpha. This way you -can make sure that no old localization files remain on your disk. +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 going through the following steps. -Then follow these instructions if upgrading from a previous version -of RoundCube Webmail. +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 + +For 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. + +Please also see Post-Upgrade Activities section. + + +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/ @@ -14,112 +34,21 @@ of RoundCube Webmail. - ./program/ - ./installer/ - ./skins/default/ + - ./plugins/ 2. Run ./bin/update.sh from the commandline OR - open http://url-to-roundcube/installer/ in a browser. To enable - the latter one, you have to temporary set 'enable_installer' to true - in your local config/main.inc.php file. + 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 - update your config files as suggested by the updater. -4. If suggested by the update script, run all commands in - ./SQL/[yourdbtype].update.sql that are superscribed with the - currently installed version number. -5. Make sure 'enable_installer' is set to false again. - - -For manually upgrading your RoundCube installation follow the instructions -that match the currently installed version: - -from version 0.2-alpha ----------------------------------------- -* replace index.php -* replace all files in folder /bin/ -* replace all files in folder /program/ -* replace all files in folder /installer/ -* replace all files in folder /skins/default/ -* run all commands in SQL/[yourdbtype].update.sql - below the line "-- Updates from version 0.2-alpha" -* check the config/main.inc.php.dist for new configuration - options and add them to your config - WARNING: 'skin_path' option was replaced by 'skin' option -* WARNING: 'db_backend' option has been removed, now only - PEAR::MDB2 driver is supported - - -from version 0.1.1 ----------------------------------------- -* replace index.php -* replace all files in folder /bin/ -* replace all files in folder /program/ -* replace all files in folder /skins/default/ -* run all commands in SQL/[yourdbtype].update.sql - below the line "-- Updates from version 0.1.1" -* check the config/main.inc.php.dist for new configuration - options and add them to your config - - -from version 0.1-stable ----------------------------------------- -* replace index.php -* replace all files in folder /bin/ -* replace all files in folder /program/ -* replace all files in folder /skins/default/ -* run all commands in SQL/[yourdbtype].update.sql -* check the config/main.inc.php.dist for new configuration options - and add them to your config - - -from version 0.1-rc2 ----------------------------------------- -* replace index.php -* replace all files in folder /bin/ -* replace all files in folder /program/ -* replace all files in folder /skins/default/ -* run all commands in SQL/[yourdbtype].update.sql - - -from version 0.1-rc1 ----------------------------------------- -* replace index.php -* replace all files in folder /bin/ -* replace all files in folder /program/ -* replace all files in folder /skins/default/ -* If you have LDAP servers configured you should re-configure - the config entries using the template given in /config/main.inc.php.dist - - -from version 0.1-beta2 ----------------------------------------- -* replace index.php -* replace all files in folder /bin/ -* replace all files in folder /program/ -* replace all files in folder /skins/default/ -* run all commands in SQL/[yourdbtype].update.sql or - re-initalize the database with [yourdbtype].initial.sql -* add these lines to /config/main.inc.php - $rcmail_config['draft_autosave'] = 300; - $rcmail_config['date_today'] = 'H:i'; -* If you have LDAP servers configured you should re-configure - the config entries using the template given in /config/main.inc.php.dist - - -form version 0.1-beta ----------------------------------------- -* replace index.php -* replace all files in folder /bin/ -* replace all files in folder /program/ -* replace all files in folder /skins/default/ -* run all commands in SQL/[yourdbtype].update.sql or - re-initalize the database with [yourdbtype].initial.sql -* add this line to /config/db.inc.php - $rcmail_config['db_persistent'] = false; -* add these lines to /config/main.inc.php - $rcmail_config['drafts_mbox'] = 'Drafts'; - $rcmail_config['junk_mbox'] = 'Junk'; - $rcmail_config['product_name'] = 'RoundCube Webmail'; - $rcmail_config['read_when_deleted'] = false; - $rcmail_config['enable_spellcheck'] = false; - $rcmail_config['protect_default_folders'] = false; -* replace the following line from /config/main.inc.php - @include($_SERVER['HTTP_HOST'].'.inc.php'); - with - $rcmail_config['include_host_config'] = false; + update your config files and database schema as suggested by the updater. +4. Make sure 'enable_installer' is set to false again. +5. 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.