UPGRADING

   1 UPGRADING instructions
   2 ======================
   3
   4 First you should remove all subfolders from /program/localization/
   5 because most language codes have changed in 0.2-alpha. This way you
   6 can make sure that no old localization files remain on your disk.
   7
   8 Then follow these instructions if upgrading from a previous version
   9 of RoundCube Webmail.
  10
  11 1. Replace index.php and all files in
  12    - ./bin/
  13    - ./SQL/
  14    - ./program/
  15    - ./installer/
  16    - ./skins/default/
  17    - ./plugins/
  18 2. Run ./bin/update.sh from the commandline OR
  19    open http://url-to-roundcube/installer/ in a browser. To enable
  20    the latter one, you have to temporary set 'enable_installer' to true
  21    in your local config/main.inc.php file.
  22 3. Let the update script/installer check your configuration and
  23    update your config files as suggested by the updater.
  24 4. If suggested by the update script, run all commands in
  25    ./SQL/[yourdbtype].update.sql that are superscribed with the
  26    currently installed version number.
  27 5. Make sure 'enable_installer' is set to false again.
  28 6. Check .htaccess settings (some php settings could become required)
  29
  30
  31 For manually upgrading your RoundCube installation follow the instructions
  32 that match the currently installed version:
  33
  34 from version 0.2-alpha
  35 ----------------------------------------
  36 * replace index.php
  37 * replace all files in folder /bin/
  38 * replace all files in folder /program/
  39 * replace all files in folder /installer/
  40 * replace all files in folder /skins/default/
  41 * run all commands in SQL/[yourdbtype].update.sql
  42   below the line "-- Updates from version 0.2-alpha"
  43 * check the config/main.inc.php.dist for new configuration
  44   options and add them to your config
  45   WARNING: 'skin_path' option was replaced by 'skin' option
  46 * WARNING: 'db_backend' option has been removed, now only
  47   PEAR::MDB2 driver is supported
  48
  49
  50 from version 0.1.1
  51 ----------------------------------------
  52 * replace index.php
  53 * replace all files in folder /bin/
  54 * replace all files in folder /program/
  55 * replace all files in folder /skins/default/
  56 * run all commands in SQL/[yourdbtype].update.sql
  57   below the line "-- Updates from version 0.1.1"
  58 * check the config/main.inc.php.dist for new configuration
  59   options and add them to your config
  60
  61
  62 from version 0.1-stable
  63 ----------------------------------------
  64 * replace index.php
  65 * replace all files in folder /bin/
  66 * replace all files in folder /program/
  67 * replace all files in folder /skins/default/
  68 * run all commands in SQL/[yourdbtype].update.sql
  69 * check the config/main.inc.php.dist for new configuration options
  70   and add them to your config
  71
  72
  73 from version 0.1-rc2
  74 ----------------------------------------
  75 * replace index.php
  76 * replace all files in folder /bin/
  77 * replace all files in folder /program/
  78 * replace all files in folder /skins/default/
  79 * run all commands in SQL/[yourdbtype].update.sql
  80
  81
  82 from version 0.1-rc1
  83 ----------------------------------------
  84 * replace index.php
  85 * replace all files in folder /bin/
  86 * replace all files in folder /program/
  87 * replace all files in folder /skins/default/
  88 * If you have LDAP servers configured you should re-configure
  89   the config entries using the template given in /config/main.inc.php.dist
  90
  91
  92 from version 0.1-beta2
  93 ----------------------------------------
  94 * replace index.php
  95 * replace all files in folder /bin/
  96 * replace all files in folder /program/
  97 * replace all files in folder /skins/default/
  98 * run all commands in SQL/[yourdbtype].update.sql or
  99   re-initalize the database with [yourdbtype].initial.sql
 100 * add these lines to /config/main.inc.php
 101    $rcmail_config['draft_autosave'] = 300;
 102    $rcmail_config['date_today'] = 'H:i';
 103 * If you have LDAP servers configured you should re-configure
 104   the config entries using the template given in /config/main.inc.php.dist
 105
 106
 107 form version 0.1-beta
 108 ----------------------------------------
 109 * replace index.php
 110 * replace all files in folder /bin/
 111 * replace all files in folder /program/
 112 * replace all files in folder /skins/default/
 113 * run all commands in SQL/[yourdbtype].update.sql or
 114   re-initalize the database with [yourdbtype].initial.sql
 115 * add this line to /config/db.inc.php
 116    $rcmail_config['db_persistent'] = false;
 117 * add these lines to /config/main.inc.php
 118    $rcmail_config['drafts_mbox'] = 'Drafts';
 119    $rcmail_config['junk_mbox'] = 'Junk';
 120    $rcmail_config['product_name'] = 'RoundCube Webmail';
 121    $rcmail_config['read_when_deleted'] = false;
 122    $rcmail_config['enable_spellcheck'] = false;
 123    $rcmail_config['protect_default_folders'] = false;
 124 * replace the following line from /config/main.inc.php
 125    @include($_SERVER['HTTP_HOST'].'.inc.php');
 126   with
 127    $rcmail_config['include_host_config'] = false;