|
Chris@0
|
1 == Redmine upgrade
|
|
Chris@0
|
2
|
|
Chris@0
|
3 Redmine - project management software
|
|
Chris@441
|
4 Copyright (C) 2006-2011 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@0
|
22
|
|
Chris@0
|
23 5. Generate a session store secret
|
|
Chris@0
|
24
|
|
Chris@0
|
25 Redmine stores session data in cookies by default, which requires
|
|
Chris@0
|
26 a secret to be generated. Under the new application directory run:
|
|
Chris@0
|
27 rake generate_session_store
|
|
Chris@0
|
28
|
|
Chris@0
|
29 DO NOT REPLACE OR EDIT ANY OTHER FILES.
|
|
Chris@0
|
30
|
|
Chris@0
|
31 6. Migrate your database
|
|
Chris@0
|
32
|
|
Chris@441
|
33 If you are upgrading to Rails 2.3.11 as part of this migration, you
|
|
Chris@0
|
34 need to upgrade the plugin migrations before running the plugin migrations
|
|
Chris@0
|
35 using:
|
|
Chris@0
|
36 rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
|
|
Chris@0
|
37
|
|
Chris@0
|
38 Please make a backup before doing this! Under the new application
|
|
Chris@0
|
39 directory run:
|
|
Chris@0
|
40 rake db:migrate RAILS_ENV="production"
|
|
Chris@0
|
41
|
|
Chris@0
|
42 If you have installed any plugins, you should also run their database
|
|
Chris@0
|
43 migrations using:
|
|
Chris@0
|
44 rake db:migrate_plugins RAILS_ENV="production"
|
|
Chris@0
|
45
|
|
Chris@0
|
46 7. Clean up
|
|
Chris@0
|
47
|
|
Chris@0
|
48 Clear the cache and the existing sessions by running:
|
|
Chris@0
|
49 rake tmp:cache:clear
|
|
Chris@0
|
50 rake tmp:sessions:clear
|
|
Chris@0
|
51
|
|
Chris@0
|
52 8. Restart the application server (e.g. mongrel, thin, passenger)
|
|
Chris@0
|
53
|
|
Chris@0
|
54 9. Finally go to "Administration -> Roles & permissions" to check/set permissions
|
|
Chris@0
|
55 for new features, if any
|
|
Chris@0
|
56
|
|
Chris@0
|
57 == Notes
|
|
Chris@0
|
58
|
|
Chris@441
|
59 * Rails 2.3.11 is required for versions 1.2.x.
|
|
Chris@0
|
60
|
|
Chris@0
|
61 == References
|
|
Chris@0
|
62
|
|
Chris@0
|
63 * http://www.redmine.org/wiki/redmine/RedmineUpgrade
|
