|
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
|