Redmine

h1. Upgrading

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

h2. Upgrading from a SVN [[CheckingoutRedmine|checkout]]

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

<pre>

svn update

</pre>

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

<pre>

rake db:migrate RAILS_ENV="production"

</pre>

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:

<pre>

rake config/initializers/session_store.rb

</pre>

Also remember that Redmine trunk => r2494 now uses Rails 2.2.2, don't forget to upgrade the existing installation:

<pre>

gem install rails -v=2.2.2

</pre>

Also as part of the Rails 2.2.2 upgrade, plugin migrations will need to be updated as well

<pre>

rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"

</pre>

4. Clear the cache and the existing sessions:

<pre>

rake tmp:cache:clear

rake tmp:sessions:clear

</pre>

5. 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-file @config/database.yml@ into the new @config@ directory.

3. Copy the email settings-file @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 are upgrading from Redmine 0.8.x or trunk < r2493 to Redmine trunk => r2494, you must generate a secret for cookie store:

<pre>

rake config/initializers/session_store.rb

</pre>

Also remember that Redmine trunk => r2494 now uses Rails 2.2.2, don't forget to upgrade the existing installation:

<pre>

gem install rails -v=2.2.2

</pre>

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

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