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 1 Jean-Philippe Lang
3 1 Jean-Philippe Lang
Before upgrading, check that you meet the [[RedmineInstall#Requirements|requirements]] for the version you're about to install.
4 1 Jean-Philippe Lang
5 12 Mischa The Evil
h2. Upgrading from a SVN [[CheckingoutRedmine|checkout]]
6 12 Mischa The Evil
7 2 Jean-Philippe Lang
1. Go to the Redmine root directory and run the following command:
8 11 Mischa The Evil
<pre>
9 11 Mischa The Evil
svn update
10 11 Mischa The Evil
</pre>
11 1 Jean-Philippe Lang
12 1 Jean-Philippe Lang
2. Migrate your database (please, make a database backup before doing this):
13 11 Mischa The Evil
<pre>
14 11 Mischa The Evil
rake db:migrate RAILS_ENV="production"
15 11 Mischa The Evil
</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 10 Azamat Hackimov
rake config/initializers/session_store.rb
20 10 Azamat Hackimov
</pre>
21 10 Azamat Hackimov
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 10 Azamat Hackimov
gem install rails -v=2.2.2
25 10 Azamat Hackimov
</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 14 Eric Davis
29 14 Eric Davis
<pre>
30 14 Eric Davis
rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
31 14 Eric Davis
</pre>
32 14 Eric Davis
33 12 Mischa The Evil
4. Clear the cache and the existing sessions:
34 2 Jean-Philippe Lang
<pre>
35 2 Jean-Philippe Lang
rake tmp:cache:clear
36 2 Jean-Philippe Lang
rake tmp:sessions:clear
37 2 Jean-Philippe Lang
</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 1 Jean-Philippe Lang
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 1 Jean-Philippe Lang
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 10 Azamat Hackimov
rake db:migrate RAILS_ENV="production"
52 10 Azamat Hackimov
</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 10 Azamat Hackimov
rake config/initializers/session_store.rb
57 10 Azamat Hackimov
</pre>
58 10 Azamat Hackimov
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 10 Azamat Hackimov
gem install rails -v=2.2.2
62 10 Azamat Hackimov
</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.