annotate .svn/pristine/03/03387de6b294853cc867f560276231ad9e9e4136.svn-base @ 1327:287f201c2802 redmine-2.2-integration

Add italic
author Chris Cannam <chris.cannam@soundsoftware.ac.uk>
date Wed, 19 Jun 2013 20:56:22 +0100
parents 038ba2d95de8
children
rev   line source
Chris@1296 1 == Redmine upgrade
Chris@1296 2
Chris@1296 3 Redmine - project management software
Chris@1296 4 Copyright (C) 2006-2012 Jean-Philippe Lang
Chris@1296 5 http://www.redmine.org/
Chris@1296 6
Chris@1296 7
Chris@1296 8 == Upgrading
Chris@1296 9
Chris@1296 10 1. Uncompress the program archive in a new directory
Chris@1296 11
Chris@1296 12 2. Copy your database settings (RAILS_ROOT/config/database.yml)
Chris@1296 13 and your configuration file (RAILS_ROOT/config/configuration.yml)
Chris@1296 14 into the new config directory
Chris@1296 15 Note: before Redmine 1.2, SMTP configuration was stored in
Chris@1296 16 config/email.yml. It should now be stored in config/configuration.yml.
Chris@1296 17
Chris@1296 18 3. Copy the RAILS_ROOT/files directory content into your new installation
Chris@1296 19 This directory contains all the attached files.
Chris@1296 20
Chris@1296 21 4. Copy the folders of the installed plugins and themes into new installation
Chris@1296 22 Plugins must be stored in the [redmine_root]/plugins directory
Chris@1296 23 Themes must be stored in the [redmine_root]/public/themes directory
Chris@1296 24
Chris@1296 25 WARNING: plugins from your previous Redmine version may not be compatible
Chris@1296 26 with the Redmine version you're upgrading to.
Chris@1296 27
Chris@1296 28 5. Install the required gems by running:
Chris@1296 29 bundle install --without development test
Chris@1296 30
Chris@1296 31 If ImageMagick is not installed on your system, you should skip the installation
Chris@1296 32 of the rmagick gem using:
Chris@1296 33 bundle install --without development test rmagick
Chris@1296 34
Chris@1296 35 6. Generate a session store secret
Chris@1296 36
Chris@1296 37 Redmine stores session data in cookies by default, which requires
Chris@1296 38 a secret to be generated. Under the new application directory run:
Chris@1296 39 rake generate_secret_token
Chris@1296 40
Chris@1296 41 DO NOT REPLACE OR EDIT ANY OTHER FILES.
Chris@1296 42
Chris@1296 43 7. Migrate your database
Chris@1296 44
Chris@1296 45 If you are upgrading to Rails 2.3.14 as part of this migration, you
Chris@1296 46 need to upgrade the plugin migrations before running the plugin migrations
Chris@1296 47 using:
Chris@1296 48 rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
Chris@1296 49
Chris@1296 50 Please make a backup before doing this! Under the new application
Chris@1296 51 directory run:
Chris@1296 52 rake db:migrate RAILS_ENV="production"
Chris@1296 53
Chris@1296 54 If you have installed any plugins, you should also run their database
Chris@1296 55 migrations using:
Chris@1296 56 rake db:migrate_plugins RAILS_ENV="production"
Chris@1296 57
Chris@1296 58 8. Clear the cache and the existing sessions by running:
Chris@1296 59 rake tmp:cache:clear
Chris@1296 60 rake tmp:sessions:clear
Chris@1296 61
Chris@1296 62 9. Restart the application server (e.g. mongrel, thin, passenger)
Chris@1296 63
Chris@1296 64 10. Finally go to "Administration -> Roles & permissions" to check/set permissions
Chris@1296 65 for new features, if any
Chris@1296 66
Chris@1296 67 == References
Chris@1296 68
Chris@1296 69 * http://www.redmine.org/wiki/redmine/RedmineUpgrade