InstallRedmineOnDebianStableApacheMysqlPassenger » History » Version 7

Jan Niggemann (redmine.org team member), 2013-01-24 15:36

1 3 Jan Niggemann (redmine.org team member)
h1. InstallRedmineOnDebianStableApacheMysqlPassenger
2 1 Jan Niggemann (redmine.org team member)
3 4 Jan Niggemann (redmine.org team member)
h1. Preface
4 1 Jan Niggemann (redmine.org team member)
5 7 Jan Niggemann (redmine.org team member)
Last updated: 2013-01-23
6 1 Jan Niggemann (redmine.org team member)
7 4 Jan Niggemann (redmine.org team member)
*After reading this guide you should have a working redmine instance*.
8 4 Jan Niggemann (redmine.org team member)
If this is not the case or if a step fails, please post details on the forums and refer to this wiki page. Make sure to include the output of @gem env@ and / or @RAILS_ENV=production /opt/redmine/script/about@.
9 4 Jan Niggemann (redmine.org team member)
If this guide has issues, please "contact me":http://www.redmine.org/users/55460 or correct it yourself.
10 4 Jan Niggemann (redmine.org team member)
11 3 Jan Niggemann (redmine.org team member)
h2. About this guide
12 1 Jan Niggemann (redmine.org team member)
13 1 Jan Niggemann (redmine.org team member)
This is a step-by-step guide to install redmine on "Debian stable" (called Squeeze at the moment of writing).
14 3 Jan Niggemann (redmine.org team member)
It is written for people who are familiar with Debian, the shell, MySQL, Apache and Linux in general.
15 4 Jan Niggemann (redmine.org team member)
To keep this guide short, it does not explain every step in detail, but 
16 1 Jan Niggemann (redmine.org team member)
17 4 Jan Niggemann (redmine.org team member)
*The filenames and paths in this document are subject to frequent change. I'll do my best to keep them up-to-date, but please check anyway.*
18 3 Jan Niggemann (redmine.org team member)
19 4 Jan Niggemann (redmine.org team member)
*%{color:red}Please note:%* I'm assuming that you know how to use the tools at hand. If that's not the case (eg. you don't know how to create a new database or you don't know how to restart apache) please use the search engine of your choice and come back afterwards.
20 4 Jan Niggemann (redmine.org team member)
21 3 Jan Niggemann (redmine.org team member)
h1. Chapter 1: Install ruby, rails, gems and passenger
22 1 Jan Niggemann (redmine.org team member)
23 1 Jan Niggemann (redmine.org team member)
{{collapse(Read chapter 1)
24 1 Jan Niggemann (redmine.org team member)
25 1 Jan Niggemann (redmine.org team member)
h2. 1.1 Prepare your system
26 1 Jan Niggemann (redmine.org team member)
27 1 Jan Niggemann (redmine.org team member)
<pre>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</pre>
28 1 Jan Niggemann (redmine.org team member)
29 1 Jan Niggemann (redmine.org team member)
h2. 1.2 download, build and install ruby
30 1 Jan Niggemann (redmine.org team member)
31 4 Jan Niggemann (redmine.org team member)
<pre>cd ~
32 4 Jan Niggemann (redmine.org team member)
wget ftp://ftp.ruby-lang.org/pub/ruby/stable/ruby-1.9.3-p374.tar.gz
33 4 Jan Niggemann (redmine.org team member)
tar xvfz ruby-1.9.3-p374.tar.gz
34 4 Jan Niggemann (redmine.org team member)
cd ruby-1.9.3-p374
35 1 Jan Niggemann (redmine.org team member)
./configure --enable-pthread --prefix=/usr/local
36 1 Jan Niggemann (redmine.org team member)
make && make install</pre>
37 1 Jan Niggemann (redmine.org team member)
38 1 Jan Niggemann (redmine.org team member)
h2. 1.3 check if ruby works
39 1 Jan Niggemann (redmine.org team member)
40 4 Jan Niggemann (redmine.org team member)
Expected output: @ruby 1.9.3p374 (2013-01-15 revision 38858) [i686-linux]@
41 1 Jan Niggemann (redmine.org team member)
<pre>ruby –v</pre>
42 1 Jan Niggemann (redmine.org team member)
43 1 Jan Niggemann (redmine.org team member)
h2. 1.4 make ruby support OpenSSL
44 1 Jan Niggemann (redmine.org team member)
45 4 Jan Niggemann (redmine.org team member)
<pre>cd ext/openssl/
46 1 Jan Niggemann (redmine.org team member)
ruby extconf.rb
47 1 Jan Niggemann (redmine.org team member)
make && make install</pre>
48 1 Jan Niggemann (redmine.org team member)
49 1 Jan Niggemann (redmine.org team member)
h2. 1.5 gem installed?
50 1 Jan Niggemann (redmine.org team member)
51 4 Jan Niggemann (redmine.org team member)
Ruby 1.9 comes with RubyGems by default, so by now @gem@ should be installed. If correctly installed, the following command will output a version number like @1.8.2x@:
52 1 Jan Niggemann (redmine.org team member)
<pre>gem -v</pre>
53 1 Jan Niggemann (redmine.org team member)
54 1 Jan Niggemann (redmine.org team member)
h2. 1.6 install rails
55 1 Jan Niggemann (redmine.org team member)
56 1 Jan Niggemann (redmine.org team member)
<pre>gem install rails</pre>
57 1 Jan Niggemann (redmine.org team member)
58 1 Jan Niggemann (redmine.org team member)
h2. 1.7 install passenger (application server)
59 1 Jan Niggemann (redmine.org team member)
60 1 Jan Niggemann (redmine.org team member)
<pre>gem install passenger
61 1 Jan Niggemann (redmine.org team member)
passenger-install-apache2-module</pre>
62 1 Jan Niggemann (redmine.org team member)
63 1 Jan Niggemann (redmine.org team member)
h2. 1.8 configure apache
64 1 Jan Niggemann (redmine.org team member)
65 4 Jan Niggemann (redmine.org team member)
Put this in @/etc/apache/mods-available/passenger.load@ (remember to adjust the paths if necessary).
66 1 Jan Niggemann (redmine.org team member)
<pre>LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.18/ext/apache2/mod_passenger.so</pre>
67 1 Jan Niggemann (redmine.org team member)
68 4 Jan Niggemann (redmine.org team member)
And put this in @/etc/apache/mods-available/passenger.conf@ (remember to adjust the paths if necessary).
69 1 Jan Niggemann (redmine.org team member)
<pre>PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.18
70 1 Jan Niggemann (redmine.org team member)
PassengerRuby /usr/local/bin/ruby
71 1 Jan Niggemann (redmine.org team member)
PassengerDefaultUser www-data</pre>
72 1 Jan Niggemann (redmine.org team member)
73 1 Jan Niggemann (redmine.org team member)
74 1 Jan Niggemann (redmine.org team member)
h2. 1.9 activate module
75 1 Jan Niggemann (redmine.org team member)
76 3 Jan Niggemann (redmine.org team member)
<pre>a2enmod passenger</pre>
77 3 Jan Niggemann (redmine.org team member)
78 3 Jan Niggemann (redmine.org team member)
}}
79 2 Jan Niggemann (redmine.org team member)
80 1 Jan Niggemann (redmine.org team member)
h1. Chapter 2: Install redmine
81 2 Jan Niggemann (redmine.org team member)
82 1 Jan Niggemann (redmine.org team member)
{{collapse(Read chapter 2)
83 2 Jan Niggemann (redmine.org team member)
84 2 Jan Niggemann (redmine.org team member)
h2. 2.1 download redmine
85 2 Jan Niggemann (redmine.org team member)
86 4 Jan Niggemann (redmine.org team member)
Get latest zip from "here":http://rubyforge.org/frs/?group_id=1850 and unpack to /opt/redmine
87 2 Jan Niggemann (redmine.org team member)
88 2 Jan Niggemann (redmine.org team member)
h2. 2.2 further prepare the system
89 2 Jan Niggemann (redmine.org team member)
90 2 Jan Niggemann (redmine.org team member)
Note: Installing @libmagick9-dev@ installs a lot of packages (depends / recommends)
91 2 Jan Niggemann (redmine.org team member)
<pre>gem install bundler
92 1 Jan Niggemann (redmine.org team member)
apt-get install libmagick9-dev
93 4 Jan Niggemann (redmine.org team member)
cd /opt/redmine
94 2 Jan Niggemann (redmine.org team member)
bundle install --without postgresql</pre>
95 2 Jan Niggemann (redmine.org team member)
96 4 Jan Niggemann (redmine.org team member)
h2. 2.3 create database
97 2 Jan Niggemann (redmine.org team member)
98 2 Jan Niggemann (redmine.org team member)
<pre>create database redmine character set utf8;
99 2 Jan Niggemann (redmine.org team member)
create user 'redmine'@'localhost' identified by 'XXX';
100 2 Jan Niggemann (redmine.org team member)
grant all privileges on redmine.* to 'redmine'@'localhost';
101 4 Jan Niggemann (redmine.org team member)
</pre>
102 1 Jan Niggemann (redmine.org team member)
103 1 Jan Niggemann (redmine.org team member)
104 1 Jan Niggemann (redmine.org team member)
h2. 2.4 configure DB-connection
105 1 Jan Niggemann (redmine.org team member)
106 1 Jan Niggemann (redmine.org team member)
Put this in /opt/redmine/config/database.yml
107 2 Jan Niggemann (redmine.org team member)
<pre>production:
108 6 Jan Niggemann (redmine.org team member)
  adapter: mysql2
109 6 Jan Niggemann (redmine.org team member)
  database: redmine
110 6 Jan Niggemann (redmine.org team member)
  host: localhost
111 6 Jan Niggemann (redmine.org team member)
  username: redmine
112 6 Jan Niggemann (redmine.org team member)
  password: XXX</pre>
113 2 Jan Niggemann (redmine.org team member)
114 2 Jan Niggemann (redmine.org team member)
h2. 2.5 generate a session store secret
115 1 Jan Niggemann (redmine.org team member)
116 1 Jan Niggemann (redmine.org team member)
<pre>rake generate_secret_token</pre>
117 1 Jan Niggemann (redmine.org team member)
118 1 Jan Niggemann (redmine.org team member)
h2. 2.6 prepare database / create tables
119 1 Jan Niggemann (redmine.org team member)
120 1 Jan Niggemann (redmine.org team member)
<pre>RAILS_ENV=production rake db:migrate</pre>
121 2 Jan Niggemann (redmine.org team member)
122 1 Jan Niggemann (redmine.org team member)
h2. 2.7 set filesystem permissions
123 1 Jan Niggemann (redmine.org team member)
124 4 Jan Niggemann (redmine.org team member)
<pre>cd /opt/redmine
125 4 Jan Niggemann (redmine.org team member)
mkdir tmp tmp/pdf public/plugin_assets
126 4 Jan Niggemann (redmine.org team member)
chown -R www-data:www-data files log tmp public/plugin_assets
127 4 Jan Niggemann (redmine.org team member)
chmod -R 755 files log tmp public/plugin_assets
128 4 Jan Niggemann (redmine.org team member)
</pre>
129 1 Jan Niggemann (redmine.org team member)
130 1 Jan Niggemann (redmine.org team member)
h2. 2.8 test if it works
131 4 Jan Niggemann (redmine.org team member)
132 5 Jan Niggemann (redmine.org team member)
<pre>ruby script/rails server webrick -e production</pre>
133 3 Jan Niggemann (redmine.org team member)
Now go to http://localhost:3000 and see redmine in action.
134 3 Jan Niggemann (redmine.org team member)
135 3 Jan Niggemann (redmine.org team member)
}}
136 3 Jan Niggemann (redmine.org team member)
137 3 Jan Niggemann (redmine.org team member)
h1. Chapter 3: Configure apache and passenger
138 3 Jan Niggemann (redmine.org team member)
139 3 Jan Niggemann (redmine.org team member)
In this guide, we deploy to a sub-URI. Read other guides if you want a name-based virtual host configuration.
140 3 Jan Niggemann (redmine.org team member)
141 3 Jan Niggemann (redmine.org team member)
{{collapse(Read chapter 3)
142 3 Jan Niggemann (redmine.org team member)
143 4 Jan Niggemann (redmine.org team member)
h2. 3.1 Configure apache (subURI deployment)
144 3 Jan Niggemann (redmine.org team member)
145 4 Jan Niggemann (redmine.org team member)
<pre>ln -s /opt/redmine/public /var/www/redmine</pre>
146 3 Jan Niggemann (redmine.org team member)
147 4 Jan Niggemann (redmine.org team member)
Put this in @/etc/apache2/sites-available/redmine@
148 4 Jan Niggemann (redmine.org team member)
<pre>
149 4 Jan Niggemann (redmine.org team member)
<Location /redmine>
150 3 Jan Niggemann (redmine.org team member)
		RailsEnv production
151 3 Jan Niggemann (redmine.org team member)
		RailsBaseURI /redmine
152 3 Jan Niggemann (redmine.org team member)
		Options –MultiViews
153 4 Jan Niggemann (redmine.org team member)
</Location>
154 3 Jan Niggemann (redmine.org team member)
</pre>
155 4 Jan Niggemann (redmine.org team member)
156 4 Jan Niggemann (redmine.org team member)
Restart apache, test if http://yourhost.com/redmine is working, rejoice if it is :-)
157 4 Jan Niggemann (redmine.org team member)
158 4 Jan Niggemann (redmine.org team member)
If you see something unexpected, please post details on the forums and refer to this wiki page. Make sure to include the output of @gem env@ and / or @RAILS_ENV=production /opt/redmine/script/about@.
159 3 Jan Niggemann (redmine.org team member)
160 1 Jan Niggemann (redmine.org team member)
}}