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