annotate doc/UPGRADING @ 881:fade849e02c5 feature_73

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