Redmine

h1. Upgrading

h2. Upgrading from a SVN checkout

Before upgrading, check that you meet the [[RedmineInstall#Requirements|requirements]] for the version you're about to install.

1. Go to the Redmine root directory and run the following command:

  svn update

2. Migrate your database (please, make a database backup before doing this):

  rake db:migrate RAILS_ENV="production"

3. If you upgrading from SVN r2493, you must generate secret for cookie store:

<pre>

rake config/initializers/session_store.rb

</pre>

Also remember that Redmine from r2494 now uses Rails 2.2.2, don't forget upgrade existing installation:

<pre>

gem install rails -v=2.2.2

</pre>

3. Clear the cache and existing sessions:

<pre>

rake tmp:cache:clear

rake tmp:sessions:clear

</pre>

4. Restart the application and go to _"Admin -> Roles & permissions"_ to check/set permissions for the new features, if any.

h2. Upgrading from a downloaded release

1. Uncompress the new program archive in a new directory.

2. Copy your database settings @config/database.yml@ into the new @config@ directory.

3. Copy config/email.yml.example to config/email.yml and edit this file to adjust your SMTP settings.

4. Go to your new redmine directory, then migrate your database (please, make a database backup before doing this):

<pre>

rake db:migrate RAILS_ENV="production"

</pre>

5. If you upgading from 0.8.x to SVN or 0.9.x, you must generate secret for cookie store:

<pre>

rake config/initializers/session_store.rb

</pre>

Also remember that Redmine from r2494 now uses Rails 2.2.2, don't forget upgrade existing installation:

<pre>

gem install rails -v=2.2.2

</pre>

5. Copy the @RAILS_ROOT/files@ directory content into your new installation.

6. Start the application and go to _"Admin -> Roles & permissions"_ to check/set permissions for the new features, if any.