RedmineUpgrade » History » Version 10

Azamat Hackimov, 2009-02-21 20:17
notes about upgrading

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