doc/UPGRADING

   1 == Redmine upgrade
   2
   3 Redmine - project management software
   4 Copyright (C) 2006-2010  Jean-Philippe Lang
   5 http://www.redmine.org/
   6
   7
   8 == Upgrading
   9
  10 1. Uncompress the program archive in a new directory
  11
  12 2. Copy your database settings (RAILS_ROOT/config/database.yml)
  13    and SMTP settings (RAILS_ROOT/config/email.yml) into the new
  14    config directory
  15
  16 3. Copy the RAILS_ROOT/files directory content into your new installation
  17    This directory contains all the attached files.
  18
  19 4. Copy the folders of the installed plugins and themes into new installation
  20
  21 5. Generate a session store secret
  22
  23    Redmine stores session data in cookies by default, which requires
  24    a secret to be generated. Under the new application directory run:
  25      rake generate_session_store
  26
  27    DO NOT REPLACE OR EDIT ANY OTHER FILES.
  28
  29 6. Migrate your database
  30
  31    If you are upgrading to Rails 2.3.5 as part of this migration, you
  32    need to upgrade the plugin migrations before running the plugin migrations
  33    using:
  34      rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
  35
  36    Please make a backup before doing this! Under the new application
  37    directory run:
  38      rake db:migrate RAILS_ENV="production"
  39
  40    If you have installed any plugins, you should also run their database
  41    migrations using:
  42      rake db:migrate_plugins RAILS_ENV="production"
  43
  44 7. Clean up
  45
  46    Clear the cache and the existing sessions by running:
  47      rake tmp:cache:clear
  48      rake tmp:sessions:clear
  49
  50 8. Restart the application server (e.g. mongrel, thin, passenger)
  51
  52 9. Finally go to "Administration -> Roles & permissions" to check/set permissions
  53    for new features, if any
  54
  55 == Notes
  56
  57 * Rails 2.3.5 is required for versions 0.9.x and 1.0.x.
  58
  59 == References
  60
  61 * http://www.redmine.org/wiki/redmine/RedmineUpgrade