Mercurial > hg > soundsoftware-site

annotate doc/UPGRADING @ 8:0c83d98252d9 yuya

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
* Add custom repo prefix and proper auth realm, remove auth cache (seems like an unwise feature), pass DB handle around, various other bits of tidying
author Chris Cannam
date Thu, 12 Aug 2010 15:31:37 +0100
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