Chris@909: == Redmine upgrade Chris@909: Chris@909: Redmine - project management software Chris@909: Copyright (C) 2006-2011 Jean-Philippe Lang Chris@909: http://www.redmine.org/ Chris@909: Chris@909: Chris@909: == Upgrading Chris@909: Chris@909: 1. Uncompress the program archive in a new directory Chris@909: Chris@909: 2. Copy your database settings (RAILS_ROOT/config/database.yml) Chris@909: and your configuration file (RAILS_ROOT/config/configuration.yml) Chris@909: into the new config directory Chris@909: Note: before Redmine 1.2, SMTP configuration was stored in Chris@909: config/email.yml. It should now be stored in config/configuration.yml. Chris@909: Chris@909: 3. Copy the RAILS_ROOT/files directory content into your new installation Chris@909: This directory contains all the attached files. Chris@909: Chris@909: 4. Copy the folders of the installed plugins and themes into new installation Chris@909: Chris@909: 5. Generate a session store secret Chris@909: Chris@909: Redmine stores session data in cookies by default, which requires Chris@909: a secret to be generated. Under the new application directory run: Chris@909: rake generate_session_store Chris@909: Chris@909: DO NOT REPLACE OR EDIT ANY OTHER FILES. Chris@909: Chris@909: 6. Migrate your database Chris@909: Chris@909: If you are upgrading to Rails 2.3.14 as part of this migration, you Chris@909: need to upgrade the plugin migrations before running the plugin migrations Chris@909: using: Chris@909: rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production" Chris@909: Chris@909: Please make a backup before doing this! Under the new application Chris@909: directory run: Chris@909: rake db:migrate RAILS_ENV="production" Chris@909: Chris@909: If you have installed any plugins, you should also run their database Chris@909: migrations using: Chris@909: rake db:migrate_plugins RAILS_ENV="production" Chris@909: Chris@909: 7. Clean up Chris@909: Chris@909: Clear the cache and the existing sessions by running: Chris@909: rake tmp:cache:clear Chris@909: rake tmp:sessions:clear Chris@909: Chris@909: 8. Restart the application server (e.g. mongrel, thin, passenger) Chris@909: Chris@909: 9. Finally go to "Administration -> Roles & permissions" to check/set permissions Chris@909: for new features, if any Chris@909: Chris@909: == Notes Chris@909: Chris@909: * Rails 2.3.14 is required for versions 1.3.x. Chris@909: Chris@909: == References Chris@909: Chris@909: * http://www.redmine.org/wiki/redmine/RedmineUpgrade