Chris@1494: == Redmine upgrade
Chris@1494: 
Chris@1494: Redmine - project management software
Chris@1494: Copyright (C) 2006-2014  Jean-Philippe Lang
Chris@1494: http://www.redmine.org/
Chris@1494: 
Chris@1494: 
Chris@1494: == Upgrading
Chris@1494: 
Chris@1494: 1. Uncompress the program archive in a new directory
Chris@1494: 
Chris@1494: 2. Copy your database settings (RAILS_ROOT/config/database.yml)
Chris@1494:    and your configuration file (RAILS_ROOT/config/configuration.yml)
Chris@1494:    into the new config directory
Chris@1494:    Note: before Redmine 1.2, SMTP configuration was stored in
Chris@1494:    config/email.yml. It should now be stored in config/configuration.yml. 
Chris@1494: 
Chris@1494: 3. Copy the RAILS_ROOT/files directory content into your new installation
Chris@1494:    This directory contains all the attached files.
Chris@1494: 
Chris@1494: 4. Copy the folders of the installed plugins and themes into new installation
Chris@1494:    Plugins must be stored in the [redmine_root]/plugins directory
Chris@1494:    Themes must be stored in the [redmine_root]/public/themes directory
Chris@1494: 
Chris@1494:    WARNING: plugins from your previous Redmine version may not be compatible
Chris@1494:    with the Redmine version you're upgrading to.
Chris@1494: 
Chris@1494: 5. Install the required gems by running:
Chris@1494:      bundle install --without development test
Chris@1494: 
Chris@1494:    If ImageMagick is not installed on your system, you should skip the installation
Chris@1494:    of the rmagick gem using:
Chris@1494:      bundle install --without development test rmagick
Chris@1494: 
Chris@1494:    Only the gems that are needed by the adapters you've specified in your database
Chris@1494:    configuration file are actually installed (eg. if your config/database.yml
Chris@1494:    uses the 'mysql2' adapter, then only the mysql2 gem will be installed). Don't
Chris@1494:    forget to re-run `bundle install` when you change config/database.yml for using
Chris@1494:    other database adapters.
Chris@1494: 
Chris@1494:    If you need to load some gems that are not required by Redmine core (eg. fcgi),
Chris@1494:    you can create a file named Gemfile.local at the root of your redmine directory.
Chris@1494:    It will be loaded automatically when running `bundle install`.
Chris@1494: 
Chris@1494: 6. Generate a session store secret
Chris@1494:    
Chris@1494:    Redmine stores session data in cookies by default, which requires
Chris@1494:    a secret to be generated. Under the new application directory run:
Chris@1494:      rake generate_secret_token
Chris@1494:    
Chris@1494:    DO NOT REPLACE OR EDIT ANY OTHER FILES.
Chris@1494: 
Chris@1494: 7. Migrate your database
Chris@1494: 
Chris@1494:    If you are upgrading to Rails 2.3.14 as part of this migration, you
Chris@1494:    need to upgrade the plugin migrations before running the plugin migrations
Chris@1494:    using:
Chris@1494:      rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
Chris@1494:    
Chris@1494:    Please make a backup before doing this! Under the new application
Chris@1494:    directory run:
Chris@1494:      rake db:migrate RAILS_ENV="production"
Chris@1494:    
Chris@1494:    If you have installed any plugins, you should also run their database
Chris@1494:    migrations using:
Chris@1494:      rake db:migrate_plugins RAILS_ENV="production"
Chris@1494:    
Chris@1494: 8. Clear the cache and the existing sessions by running:
Chris@1494:      rake tmp:cache:clear
Chris@1494:      rake tmp:sessions:clear
Chris@1494: 
Chris@1494: 9. Restart the application server (e.g. mongrel, thin, passenger)
Chris@1494: 
Chris@1494: 10. Finally go to "Administration -> Roles & permissions" to check/set permissions
Chris@1494:     for new features, if any
Chris@1494: 
Chris@1494: == References
Chris@1494: 
Chris@1494: * http://www.redmine.org/wiki/redmine/RedmineUpgrade