====== Redmine ======
A free and open source, web-based project management and issue tracking tool. It allows users to manage multiple projects and associated subprojects. It features per project wikis and forums, time tracking, and flexible role based access control. It includes a calendar and Gantt charts to aid visual representation of projects and their deadlines. Redmine integrates with various version control systems and includes a repository browser and diff viewer.
===== Installation =====
  - install required packages:<code bash> apt-get install redmine-mysql</code>
  - do not setup database connection during setup
  - create new database<code sql>
create database redmine;
grant all privileges on redmine.* to redmine@localhost identified by 'redmine';
</code>
  - (optionally) put DB dump from older version into newly created DB
  - setup database manually in /etc/redmine/database.yaml:<code yaml>
production:
  adapter: mysql2
  database: redmine
  host: localhost
  port: 
  username: redmine
  password: redmine
  encoding: utf8</code>
  - create database structure:<code bash>
cd /usr/share/redmine/
bundle exec rake db:migrate RAILS_ENV=production</code>
  - create a symlink to working directory:<code bash>
ln -s /usr/share/redmine /var/lib/redmine/default/passenger</code>
  - install passenger module to apache:<code bash>
apt-get install libapache2-mod-passenger
</code>
  - setup default user for passenger in /etc/apache2/mods-available/passenger.conf:<code xml>
<IfModule mod_passenger.c>
  PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
  PassengerDefaultRuby /usr/bin/ruby
  PassengerDefaultUser www-data
</IfModule>
</code>
  - create apache configuration /etc/apache2/sites-available/redmine.conf:<code xml>
Listen 3000
<VirtualHost *:3000>
        # ServerName my.domain.name
        # this is the passenger config
        RailsEnv production
        # create a link in /var/lib/redmine/default/passenger to /usr/share/redmine
        PassengerAppRoot /var/lib/redmine/default/passenger
        SetEnv X_DEBIAN_SITEID "default"
        Alias "/plugin_assets/" /var/cache/redmine/default/plugin_assets/
        DocumentRoot /usr/share/redmine/public
        <Directory "/usr/share/redmine/public">
                Order allow,deny
                Allow from all
        </Directory>
</VirtualHost></code>
  - reload apache<code>
apache2ctl graceful</code>
  - access the redmine on port 3000
===== Migration =====
[[https://www.redmine.org/projects/redmine/wiki/HowTo_Migrate_Redmine_to_a_new_server_to_a_new_Redmine_version]]

  - setup new server following the previous steps
  - copy files from old server to new (files are in /var/lib/redmine/default/files) and don't forget to grant permissions for www-data user