DebianInstall¶

• Table of contents
• DebianInstall
• 1: Install ruby, rails, gems and passenger
  • 1.1 Prepare your system
  • 1.2 download, build and install ruby
  • 1.3 check if ruby works
  • 1.4 make ruby support OpenSSL
  • 1.5 gem installed?
  • 1.6 install rails
  • 1.7 install passenger (application server)
  • 1.8 configure apache
  • 1.9 activate module
• 2: Install redmine
  • 2.1 download redmine
  • 2.2 further prepare the system
  • 2.3 create databases
  • 2.4 configure DB-connection
  • 2.5 generate a session store secret
  • 2.6 prepare database / create tables
  • 2.7 set filesystem permissions

1: Install ruby, rails, gems and passenger¶

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: Install redmine¶

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.