Chris@0
|
1 == Redmine upgrade
|
Chris@0
|
2
|
Chris@0
|
3 Redmine - project management software
|
Chris@1494
|
4 Copyright (C) 2006-2014 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@1115
|
22 Plugins must be stored in the [redmine_root]/plugins directory
|
Chris@1115
|
23 Themes must be stored in the [redmine_root]/public/themes directory
|
Chris@0
|
24
|
Chris@1115
|
25 WARNING: plugins from your previous Redmine version may not be compatible
|
Chris@1115
|
26 with the Redmine version you're upgrading to.
|
Chris@1115
|
27
|
Chris@1115
|
28 5. Install the required gems by running:
|
Chris@1115
|
29 bundle install --without development test
|
Chris@1115
|
30
|
Chris@1115
|
31 If ImageMagick is not installed on your system, you should skip the installation
|
Chris@1115
|
32 of the rmagick gem using:
|
Chris@1115
|
33 bundle install --without development test rmagick
|
Chris@1115
|
34
|
Chris@1464
|
35 Only the gems that are needed by the adapters you've specified in your database
|
Chris@1464
|
36 configuration file are actually installed (eg. if your config/database.yml
|
Chris@1464
|
37 uses the 'mysql2' adapter, then only the mysql2 gem will be installed). Don't
|
Chris@1464
|
38 forget to re-run `bundle install` when you change config/database.yml for using
|
Chris@1464
|
39 other database adapters.
|
Chris@1464
|
40
|
Chris@1464
|
41 If you need to load some gems that are not required by Redmine core (eg. fcgi),
|
Chris@1464
|
42 you can create a file named Gemfile.local at the root of your redmine directory.
|
Chris@1464
|
43 It will be loaded automatically when running `bundle install`.
|
Chris@1464
|
44
|
Chris@1115
|
45 6. Generate a session store secret
|
Chris@0
|
46
|
Chris@0
|
47 Redmine stores session data in cookies by default, which requires
|
Chris@0
|
48 a secret to be generated. Under the new application directory run:
|
Chris@1115
|
49 rake generate_secret_token
|
Chris@0
|
50
|
Chris@0
|
51 DO NOT REPLACE OR EDIT ANY OTHER FILES.
|
Chris@0
|
52
|
Chris@1115
|
53 7. Migrate your database
|
Chris@0
|
54
|
Chris@909
|
55 If you are upgrading to Rails 2.3.14 as part of this migration, you
|
Chris@0
|
56 need to upgrade the plugin migrations before running the plugin migrations
|
Chris@0
|
57 using:
|
Chris@0
|
58 rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
|
Chris@0
|
59
|
Chris@0
|
60 Please make a backup before doing this! Under the new application
|
Chris@0
|
61 directory run:
|
Chris@0
|
62 rake db:migrate RAILS_ENV="production"
|
Chris@0
|
63
|
Chris@0
|
64 If you have installed any plugins, you should also run their database
|
Chris@0
|
65 migrations using:
|
Chris@0
|
66 rake db:migrate_plugins RAILS_ENV="production"
|
Chris@0
|
67
|
Chris@1115
|
68 8. Clear the cache and the existing sessions by running:
|
Chris@0
|
69 rake tmp:cache:clear
|
Chris@0
|
70 rake tmp:sessions:clear
|
Chris@0
|
71
|
Chris@1115
|
72 9. Restart the application server (e.g. mongrel, thin, passenger)
|
Chris@0
|
73
|
Chris@1115
|
74 10. Finally go to "Administration -> Roles & permissions" to check/set permissions
|
Chris@1115
|
75 for new features, if any
|
Chris@0
|
76
|
Chris@0
|
77 == References
|
Chris@0
|
78
|
Chris@0
|
79 * http://www.redmine.org/wiki/redmine/RedmineUpgrade
|