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