Project

General

Profile

RedmineUpgrade » History » Version 14

Eric Davis, 2009-02-26 19:29
Added comment about upgrading plugin migration versions

1 1 Jean-Philippe Lang
h1. Upgrading
2
3
Before upgrading, check that you meet the [[RedmineInstall#Requirements|requirements]] for the version you're about to install.
4
5 12 Mischa The Evil
h2. Upgrading from a SVN [[CheckingoutRedmine|checkout]]
6
7 2 Jean-Philippe Lang
1. Go to the Redmine root directory and run the following command:
8 11 Mischa The Evil
<pre>
9
svn update
10
</pre>
11 1 Jean-Philippe Lang
12
2. Migrate your database (please, make a database backup before doing this):
13 11 Mischa The Evil
<pre>
14
rake db:migrate RAILS_ENV="production"
15
</pre>
16 2 Jean-Philippe Lang
17 13 Mischa The Evil
3. If you are upgrading from Redmine 0.8.x or trunk < r2493 to Redmine trunk => r2494, you must generate a secret for cookie store:
18 10 Azamat Hackimov
<pre>
19
rake config/initializers/session_store.rb
20
</pre>
21
22 12 Mischa The Evil
Also remember that Redmine trunk => r2494 now uses Rails 2.2.2, don't forget to upgrade the existing installation:
23 10 Azamat Hackimov
<pre>
24
gem install rails -v=2.2.2
25
</pre>
26 2 Jean-Philippe Lang
27 14 Eric Davis
Also as part of the Rails 2.2.2 upgrade, plugin migrations will need to be updated as well
28
29
<pre>
30
rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
31
</pre>
32
33 12 Mischa The Evil
4. Clear the cache and the existing sessions:
34 2 Jean-Philippe Lang
<pre>
35
rake tmp:cache:clear
36
rake tmp:sessions:clear
37
</pre>
38 1 Jean-Philippe Lang
39 12 Mischa The Evil
5. Restart the application and go to _"Admin -> Roles & permissions"_ to check/set permissions for the new features, if any.
40 2 Jean-Philippe Lang
41 1 Jean-Philippe Lang
h2. Upgrading from a downloaded release
42
43 10 Azamat Hackimov
1. Uncompress the new program archive in a new directory.
44 3 Jean-Philippe Lang
45 12 Mischa The Evil
2. Copy your database settings-file @config/database.yml@ into the new @config@ directory.
46 3 Jean-Philippe Lang
47 12 Mischa The Evil
3. Copy the email settings-file @config/email.yml.example@ to @config/email.yml@ and edit this file to adjust your SMTP settings.
48 1 Jean-Philippe Lang
49
4. Go to your new redmine directory, then migrate your database (please, make a database backup before doing this):
50 10 Azamat Hackimov
<pre>
51
rake db:migrate RAILS_ENV="production"
52
</pre>
53 1 Jean-Philippe Lang
54 13 Mischa The Evil
5. If you are upgrading from Redmine 0.8.x or trunk < r2493 to Redmine trunk => r2494, you must generate a secret for cookie store:
55 10 Azamat Hackimov
<pre>
56
rake config/initializers/session_store.rb
57
</pre>
58
59 12 Mischa The Evil
Also remember that Redmine trunk => r2494 now uses Rails 2.2.2, don't forget to upgrade the existing installation:
60 10 Azamat Hackimov
<pre>
61
gem install rails -v=2.2.2
62
</pre>
63 1 Jean-Philippe Lang
64 12 Mischa The Evil
6. Copy the @RAILS_ROOT/files@ directory content into your new installation.
65 1 Jean-Philippe Lang
66 12 Mischa The Evil
7. Restart the application and go to _"Admin -> Roles & permissions"_ to check/set permissions for the new features, if any.