Mercurial > hg > soundsoftware-site

annotate doc/.svn/text-base/UPGRADING.svn-base @ 922:ad295b270cd4 live

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
FIx #446: "non-utf8 paths in repositories blow up repo viewer and reposman" by ensuring the iconv conversion always happens even if source and dest are intended to be the same encoding
author Chris Cannam
date Tue, 13 Mar 2012 16:33:49 +0000
parents cbce1fd3b1b7
children
rev   line source
Chris@0 1 == Redmine upgrade
Chris@0 2
Chris@0 3 Redmine - project management software
Chris@441 4 Copyright (C) 2006-2011 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@210 13 and your configuration file (RAILS_ROOT/config/configuration.yml)
Chris@210 14 into the new config directory
Chris@210 15 Note: before Redmine 1.2, SMTP configuration was stored in
Chris@210 16 config/email.yml. It should now be stored in config/configuration.yml.
Chris@0 17
Chris@0 18 3. Copy the RAILS_ROOT/files directory content into your new installation
Chris@0 19 This directory contains all the attached files.
Chris@0 20
Chris@0 21 4. Copy the folders of the installed plugins and themes into new installation
Chris@0 22
Chris@0 23 5. Generate a session store secret
Chris@0 24
Chris@0 25 Redmine stores session data in cookies by default, which requires
Chris@0 26 a secret to be generated. Under the new application directory run:
Chris@0 27 rake generate_session_store
Chris@0 28
Chris@0 29 DO NOT REPLACE OR EDIT ANY OTHER FILES.
Chris@0 30
Chris@0 31 6. Migrate your database
Chris@0 32
Chris@441 33 If you are upgrading to Rails 2.3.11 as part of this migration, you
Chris@0 34 need to upgrade the plugin migrations before running the plugin migrations
Chris@0 35 using:
Chris@0 36 rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
Chris@0 37
Chris@0 38 Please make a backup before doing this! Under the new application
Chris@0 39 directory run:
Chris@0 40 rake db:migrate RAILS_ENV="production"
Chris@0 41
Chris@0 42 If you have installed any plugins, you should also run their database
Chris@0 43 migrations using:
Chris@0 44 rake db:migrate_plugins RAILS_ENV="production"
Chris@0 45
Chris@0 46 7. Clean up
Chris@0 47
Chris@0 48 Clear the cache and the existing sessions by running:
Chris@0 49 rake tmp:cache:clear
Chris@0 50 rake tmp:sessions:clear
Chris@0 51
Chris@0 52 8. Restart the application server (e.g. mongrel, thin, passenger)
Chris@0 53
Chris@0 54 9. Finally go to "Administration -> Roles & permissions" to check/set permissions
Chris@0 55 for new features, if any
Chris@0 56
Chris@0 57 == Notes
Chris@0 58
Chris@441 59 * Rails 2.3.11 is required for versions 1.2.x.
Chris@0 60
Chris@0 61 == References
Chris@0 62
Chris@0 63 * http://www.redmine.org/wiki/redmine/RedmineUpgrade