1.1 Prepare your system¶

apt-get install gcc build-essential zlib1g zlib1g-dev zlibc libzlib-ruby libssl-dev libyaml-dev libcurl4-openssl-dev apache2-mpm-prefork apache2-prefork-dev libapr1-dev

1.2 download, build and install ruby¶

wget ftp://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p327.tar.gz
tar xvfz ruby-1.9.3-p327.tar.gz
cd ruby-1.9.2-p0
./configure --enable-pthread --prefix=/usr/local
make && make install

1.3 check if ruby works¶

ruby –v

1.4 make ruby support OpenSSL¶

cd ruby-1.9.2-p0
cd ext/openssl/
ruby extconf.rb
make && make install

1.5 gem installed?¶

By now, gem should already be installed, check:

gem -v

1.6 install rails¶

gem install rails

1.7 install passenger (application server)¶

gem install passenger
passenger-install-apache2-module

1.8 configure apache¶

Put this in /etc/apache/mods-available/passenger.load

LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.18/ext/apache2/mod_passenger.so

And put this in /etc/apache/mods-available/passenger.conf

PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.18
PassengerRuby /usr/local/bin/ruby
PassengerDefaultUser www-data

1.9 activate module¶

a2enmod passenger

2.1 download redmine¶

Get latest zip from here and unpack to /opt

2.2 further prepare the system¶

Note: Installing libmagick9-dev installs a lot of packages (depends / recommends)

gem install bundler
apt-get install libmagick9-dev
bundle install --without postgresql

2.3 create databases¶

We now create 2 databases, one for production and one for development.
I won't give detailed instructions on how to use mysql, please use you favorite search engine to find information you need.

create database redmine character set utf8;
create database redmine_dev character set utf8;
create user 'redmine'@'localhost' identified by 'XXX';
grant all privileges on redmine.* to 'redmine'@'localhost';
grant all privileges on redmine_dev.* to 'redmine'@'localhost';

2.4 configure DB-connection¶

Put this in /opt/redmine/config/database.yml

production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: my_password

2.5 generate a session store secret¶

rake generate_secret_token

2.6 prepare database / create tables¶

RAILS_ENV=production rake db:migrate

2.7 set filesystem permissions¶

mkdir /opt/redmine/plugin_assets (oder public/plugin_assets?)
chown www-data:www-data /opt/redmine/plugin_assets</<pre>

h2. 2.8 test if it works
<pre>ruby script/rails server webrick -e production</<pre>
Now go to http://localhost:3000 and see redmine in action.

Deployment in subURI

ln -s /opt/redmine/public /var/www/redmine

/etc/apache2/sites-available/redmine

[Location /redmine-dev]
  RailsEnv development
        RailsBaseURI /redmine-dev
        Options –MultiViews
[/Location]
[Location /redmine]
        RailsEnv production
        RailsBaseURI /redmine
        Options –MultiViews
[/Location]