Upgrade Redmine from 0.9.3 to 1.0.5

This article has been contributed by our Winter Intern Sebastien Thouvenin.

You may have installed Redmine 0.9.3 with this method to track bugs and manage your projects and we hope that you like it. But now you need something more… powerful? You may want to install a test case management tool which integrates with Redmine e.g. Klaros Test Case Management Tool. Most of the test case management plug in or software which could work with Redmine are only available for Redmine1.0.x

So let’s start the upgrade process.

In the beginning, you need to download a new version. At this moment, the last stable version is 1.0.5, so I downloaded it in my Downloads folder :

{code}sudo wget http://rubyforge.org/frs/download.php/73692/redmine-1.0.5.tar.gz {/code}

Uncompressed this file:

{code}sudo tar -xvf redmine-1.0.5.tar.gz{/code}

Now copy this folder in /usr/share/ :

{code}sudo cp -R redmine-1.0.5  /usr/share{/code}

Now, that you need to copy your database information. In your old installation you can find your database information in /etc/redmine/default/database.yml and the email information in /etc/redmine/default/email.yml. So copy these files as below :

{code}sudo cp /etc/redmine/default/database.yml  /usr/share/redmine-1.0.5/config/

sudo cp /etc/redmine/default/email.yml  /usr/share/redmine-1.0.5/config{/code}

And create a link like this :

{code}sudo ln -s /usr/share/redmine-1.0.5/public/  /var/www/redmine-1.0.5{/code}

The version 1.0.5 need a gem installation, so just do this :

{code}sudo gem install -v=0.42i18n{/code}

Wait a while, and go to your new installation’s folder :

{code}cd /usr/share/redmine-1.0.5{/code}

Do a little rake to create a secret key to protect your information:

{code}sudo rake generate_session_store{/code}

To carry on you need to upgrade your rack version :

{code}sudo gem install rack -v=1.0.1{/code}

And now you can update your new database with information of your old redmine :

{code}rake db:migrate RAILS_ENV=production{/code}

Change the permission of settings.yml and database.yml :

{code}sudo chmod 644 /usr/share/redmine-1.0.5/config/settings.yml

sudo chmod 644 /usr/share/redmine-1.0.5/config/database.yml

sudo chmod 644 /usr/share/redmine-1.0.5/config/email.yml{/code}

Add following lines in /etc/apache2/sites-available/default :

{code}

RailsEnv production

RailsBaseURI /redmine-1.0.5

<Directory /opt/redmine-1.0.5/public/>

Options FollowSymLinks

AllowOverride None

Order deny,allow

Allow from all

</Directory>

{/code}

You can either comment our or delete the following lines pointing to the old installation :

{code}

#RailsEnv production

#RailsBaseURI /redmine

#<Directory /opt/redmine/public/>

#Options FollowSymLinks

#AllowOverride None

#Order deny,allow

#Allow from all

#</Directory>

{/code}

Restart Apache :

{code}

sudo /etc/init.d/apache2 restart

{/code}

You can see your new version on http://YourIpAddress/redmine-1.0.5/

If you prefer your old address (http://YourIpAddress/redmine/) :

{code}

sudo rm -r /var/www/redmine (you delete the old link)

sudo mv /var/www/redmine-1.0.5  /var/www/redmine (change the name of the link)

sudo nano /etc/apache2/sites-available/default

{/code}

and modify the redmine-1.0.5 to redmine in /etc/apache2/sites-available/default

That’s it your upgraded Redmine is now ready.

— Contributed by Sebastien Thouvenin