Project

General

Profile

RedmineUpdate

This is a brief summary of the steps required to update this redmine installation.

The official upgrade documentation is found at https://www.redmine.org/projects/redmine/wiki/RedmineUpgrade

NOTE: The Redmine installation is a git clone from https://github.com/redmine/redmine. All modifications to existing and newly created configuration files are in the local branch edit-redmine-production. Thereby the update process does not involve moving/copying config files etc.

In the following it is assumed that the commands are executed from within the redmine installation folder, so as first step

cd $REDMINE_ROOT

1. Enable maintenance mode

Uncomment the following line in /etc/apache2/sites-available/siteconf/dev.e-taxonomy.eu.conf

# Disabling Redmine for maintenace
RewriteCond $1                  !^projects/edit/wiki/Maintenance.*
RewriteCond $1                  !^stylesheets/.*
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# restrict access by IP Adress:
#  ...
RewriteCond  %{REMOTE_ADDR}     !^**\.**\.**\.**$ 
RewriteRule ^/redmine/(.*)      http://dev.e-taxonomy.eu/redmine/projects/edit/wiki/Maintenance [R]

Reload Apache

service apache2 reload

2. Backup

mysqldump -h 160.45.63.*** -uredmine -p redmine | bzip2 > ../redmine-$(date +"%Y-%m-%d").sql.bz2
tar -czf ../redmine-$(date +"%Y-%m-%d").tar.gz ../redmine

3. Update the code base

git fetch -t
git fetch 
git tag --list

Check if the target release tag is available

Update by rebasing

(Create a new branch for each minor version)

git rebase --onto $TAG $LAST_TAG edit-redmine-production-3.3

4. Update the dependencies and database

bundle install --without development test rmagick
bundle exec rake generate_secret_token
bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
bundle exec rake tmp:cache:clear tmp:sessions:clear
service apache2 restart

Finally go to "Administration -> Roles & permissions" to check/set permissions
for new features, if any

5. Disable maintenance mode

Comment the line in the virtual host configuration again and reload apache.

Add picture from clipboard (Maximum size: 40 MB)