HowTo install Redmine on CentOS 5 » History » Version 31
Nick Shel, 2012-03-05 11:20
1 | 27 | Yu Kobayashi | h1. HowTo install Redmine on CentOS 5 or 6 |
---|---|---|---|
2 | 1 | Serafim J Fagundes | |
3 | 3 | Mischa The Evil | {{>toc}} |
4 | 3 | Mischa The Evil | |
5 | 31 | Nick Shel | h2. Introduction |
6 | 31 | Nick Shel | CentOS is one of the most frequently chosen Linux operating systems for Linux based production environments. There is extensive documentation available on setting up CentOS and it is arguably the best choice for deploying and running production Linux servers for organisation with all levels of in-house Linux server deployment and administration capability. |
7 | 31 | Nick Shel | |
8 | 31 | Nick Shel | Redmine is one of the best (if not THE best) open source issue tracking and project management applications, but because it is developed using Ruby on Rails it can be rather complex to deploy for anyone not familiar with the Ruby on Rails environment. |
9 | 31 | Nick Shel | |
10 | 31 | Nick Shel | This How-To provides detailed steps required to get Redmine up and running on a CentOS operating system using the following components: |
11 | 31 | Nick Shel | * Apache web server |
12 | 31 | Nick Shel | * MySQL database management system |
13 | 31 | Nick Shel | * Ruby on Rails |
14 | 31 | Nick Shel | |
15 | 31 | Nick Shel | The How-To provides detailed instructions on the installation and explains what each step does, so that it can be easily follows by people experienced and new to the Ruby on Rails environment. |
16 | 31 | Nick Shel | |
17 | 3 | Mischa The Evil | h2. Assumptions |
18 | 3 | Mischa The Evil | |
19 | 31 | Nick Shel | * CentOS is installed and works |
20 | 30 | Nick Shel | * Apache is installed and works |
21 | 30 | Nick Shel | * MySQL is installed and works |
22 | 1 | Serafim J Fagundes | * Your are logged as root |
23 | 1 | Serafim J Fagundes | * The next steps are done successively without errors |
24 | 1 | Serafim J Fagundes | |
25 | 3 | Mischa The Evil | h2. Steps to take |
26 | 3 | Mischa The Evil | |
27 | 6 | Gary Wilson | h3. Install gem and passenger dependencies |
28 | 6 | Gary Wilson | |
29 | 6 | Gary Wilson | <pre> |
30 | 14 | Erwin Baeyens | yum -y install zlib-devel curl-devel openssl-devel httpd-devel apr-devel apr-util-devel mysql-devel |
31 | 6 | Gary Wilson | </pre> |
32 | 6 | Gary Wilson | |
33 | 1 | Serafim J Fagundes | h3. Get Ruby |
34 | 1 | Serafim J Fagundes | |
35 | 3 | Mischa The Evil | <pre> |
36 | 28 | Nick Shel | # Create the directory where you will store the Downloads |
37 | 28 | Nick Shel | mkdir ~/Downloads # This can be any directory. |
38 | 28 | Nick Shel | |
39 | 28 | Nick Shel | # Change to directory where you will store the download |
40 | 28 | Nick Shel | cd ~/Downloads # This can be any directory. |
41 | 28 | Nick Shel | |
42 | 28 | Nick Shel | # FTP to where you will download ruby from. |
43 | 28 | Nick Shel | # When asked to login use user/password of anonymous/anonymous |
44 | 28 | Nick Shel | ftp ftp.ruby-lang.org |
45 | 28 | Nick Shel | Name (ftp.ruby-lang.org:root): anonymous |
46 | 28 | Nick Shel | Password: anonymous |
47 | 28 | Nick Shel | |
48 | 28 | Nick Shel | ftp> cd /pub/ruby |
49 | 28 | Nick Shel | ftp> get ruby-1.8.7-pXXX.tar.gz |
50 | 28 | Nick Shel | ftp> quit |
51 | 28 | Nick Shel | |
52 | 28 | Nick Shel | # You have now downloaded ruby and need to untar it |
53 | 28 | Nick Shel | tar zxvf ruby-1.8.7-pXXX.tar.gz |
54 | 28 | Nick Shel | |
55 | 28 | Nick Shel | # Compile ruby |
56 | 28 | Nick Shel | cd ruby-1.8.7-pXXX |
57 | 17 | Johannes M. | ./configure |
58 | 1 | Serafim J Fagundes | make |
59 | 1 | Serafim J Fagundes | make install |
60 | 28 | Nick Shel | |
61 | 28 | Nick Shel | # Verify ruby installation |
62 | 1 | Serafim J Fagundes | ruby -v |
63 | 1 | Serafim J Fagundes | which ruby |
64 | 28 | Nick Shel | |
65 | 28 | Nick Shel | # Change back into your downloads directory |
66 | 1 | Serafim J Fagundes | cd .. |
67 | 3 | Mischa The Evil | </pre> |
68 | 1 | Serafim J Fagundes | |
69 | 18 | Johannes M. | h3. Get Gems 1.4.2 (does not work with Gems 1.5) |
70 | 1 | Serafim J Fagundes | |
71 | 3 | Mischa The Evil | <pre> |
72 | 18 | Johannes M. | wget http://production.cf.rubygems.org/rubygems/rubygems-1.4.2.tgz |
73 | 19 | Johannes M. | tar zxvf rubygems-1.4.2.tgz |
74 | 18 | Johannes M. | cd rubygems-1.4.2 |
75 | 1 | Serafim J Fagundes | ruby setup.rb |
76 | 1 | Serafim J Fagundes | gem -v |
77 | 1 | Serafim J Fagundes | which gem |
78 | 1 | Serafim J Fagundes | cd .. |
79 | 3 | Mischa The Evil | </pre> |
80 | 1 | Serafim J Fagundes | |
81 | 26 | Anonymous | h3. Install Passenger (requires gcc) |
82 | 1 | Serafim J Fagundes | |
83 | 3 | Mischa The Evil | <pre> |
84 | 3 | Mischa The Evil | gem install passenger |
85 | 1 | Serafim J Fagundes | passenger-install-apache2-module |
86 | 1 | Serafim J Fagundes | </pre> |
87 | 1 | Serafim J Fagundes | |
88 | 26 | Anonymous | An alternate method is to install mod_passenger RPM for Apache from the following location: |
89 | 26 | Anonymous | http://passenger.stealthymonkeys.com/ |
90 | 26 | Anonymous | |
91 | 26 | Anonymous | RHEL/CentOS 5 |
92 | 26 | Anonymous | <pre> |
93 | 26 | Anonymous | rpm -Uvh http://passenger.stealthymonkeys.com/rhel/5/passenger-release.noarch.rpm |
94 | 26 | Anonymous | yum install mod_passenger |
95 | 26 | Anonymous | </pre> |
96 | 26 | Anonymous | |
97 | 26 | Anonymous | RHEL/CentOS 6 |
98 | 26 | Anonymous | <pre> |
99 | 26 | Anonymous | rpm --import http://passenger.stealthymonkeys.com/RPM-GPG-KEY-stealthymonkeys.asc |
100 | 26 | Anonymous | yum install http://passenger.stealthymonkeys.com/rhel/6/passenger-release.noarch.rpm |
101 | 26 | Anonymous | yum install mod_passenger |
102 | 26 | Anonymous | </pre> |
103 | 26 | Anonymous | |
104 | 8 | Erwin Baeyens | h3. Restart Apache |
105 | 1 | Serafim J Fagundes | |
106 | 1 | Serafim J Fagundes | <pre>service httpd restart</pre> |
107 | 3 | Mischa The Evil | |
108 | 1 | Serafim J Fagundes | h3. Download Redmine |
109 | 1 | Serafim J Fagundes | |
110 | 26 | Anonymous | Download page: http://rubyforge.org/frs/?group_id=1850 |
111 | 26 | Anonymous | |
112 | 16 | Steven Verbeek | <pre> |
113 | 26 | Anonymous | wget http://rubyforge.org/frs/download.php/75597/redmine-1.3.0.tar.gz # GET LATEST VERSION ON RUBYFORGE |
114 | 26 | Anonymous | tar zxvf redmine-1.3.0.tar.gz |
115 | 1 | Serafim J Fagundes | </pre> |
116 | 1 | Serafim J Fagundes | |
117 | 1 | Serafim J Fagundes | h3. Copy the folder to its HTTP document root folder |
118 | 16 | Steven Verbeek | |
119 | 26 | Anonymous | <pre>cp -av redmine-1.3.0/* /var/www/redmine</pre> |
120 | 1 | Serafim J Fagundes | |
121 | 1 | Serafim J Fagundes | h3. Configure Apache to host the documents |
122 | 10 | Erwin Baeyens | |
123 | 10 | Erwin Baeyens | more information can be found here: [[HowTo configure Apache to run Redmine]] |
124 | 1 | Serafim J Fagundes | |
125 | 1 | Serafim J Fagundes | h3. Install Bundler |
126 | 4 | Neil McFarlane | |
127 | 1 | Serafim J Fagundes | <pre>gem install bundler</pre> |
128 | 1 | Serafim J Fagundes | |
129 | 1 | Serafim J Fagundes | h3. Add the Bundler Boot and preinitializer code |
130 | 3 | Mischa The Evil | |
131 | 1 | Serafim J Fagundes | For more info go to the "Bundler site":http://gembundler.com/. |
132 | 1 | Serafim J Fagundes | |
133 | 1 | Serafim J Fagundes | h3. Create the Gemfile and register these gems in it |
134 | 22 | Johannes M. | |
135 | 8 | Erwin Baeyens | <pre>vi /var/www/redmine/Gemfile</pre> |
136 | 20 | Johannes M. | |
137 | 22 | Johannes M. | <pre> |
138 | 20 | Johannes M. | # file: /var/www/redmine/Gemfile |
139 | 21 | Johannes M. | source "http://rubygems.org" |
140 | 21 | Johannes M. | gem "rake", "0.8.3" |
141 | 21 | Johannes M. | gem "rack", "1.1.0" |
142 | 21 | Johannes M. | gem "i18n", "0.4.2" |
143 | 21 | Johannes M. | gem "rubytree", "0.5.2", :require => "tree" |
144 | 21 | Johannes M. | gem "RedCloth", "~>4.2.3", :require => "redcloth" # for CodeRay |
145 | 21 | Johannes M. | gem "mysql" |
146 | 20 | Johannes M. | gem "coderay", "~>0.9.7" |
147 | 1 | Serafim J Fagundes | </pre> |
148 | 3 | Mischa The Evil | |
149 | 1 | Serafim J Fagundes | <pre>bundle install</pre> |
150 | 1 | Serafim J Fagundes | |
151 | 1 | Serafim J Fagundes | h3. Create the Redmine MySQL database |
152 | 23 | Johannes M. | |
153 | 23 | Johannes M. | <pre> |
154 | 23 | Johannes M. | yum install mysql-server |
155 | 23 | Johannes M. | chkconfig mysqld on |
156 | 23 | Johannes M. | service mysqld start |
157 | 23 | Johannes M. | /usr/bin/mysql_secure_installation |
158 | 23 | Johannes M. | </pre> |
159 | 1 | Serafim J Fagundes | |
160 | 23 | Johannes M. | > For MySQL: |
161 | 11 | Erwin Baeyens | > start the mysql client (@mysql -u root -p@) and enter the following commands |
162 | 11 | Erwin Baeyens | > > <pre>create database redmine character set utf8; |
163 | 11 | Erwin Baeyens | create user 'redmine'@'localhost' identified by 'my_password'; |
164 | 10 | Erwin Baeyens | grant all privileges on redmine.* to 'redmine'@'localhost'; </pre> |
165 | 11 | Erwin Baeyens | |
166 | 11 | Erwin Baeyens | > For versions of MySQL prior to 5.0.2 - skip the 'create user' step and instead: |
167 | 11 | Erwin Baeyens | |
168 | 9 | Erwin Baeyens | > > <pre> grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';</pre> |
169 | 24 | Johannes M. | |
170 | 1 | Serafim J Fagundes | h3. Configure /var/www/redmine/config/database.yml (rename database.yml.example) |
171 | 1 | Serafim J Fagundes | |
172 | 1 | Serafim J Fagundes | h3. Set the production environment (optional) |
173 | 7 | Thibault B | |
174 | 1 | Serafim J Fagundes | Uncomment the following line in file redmine/config/environment.rb: |
175 | 3 | Mischa The Evil | |
176 | 1 | Serafim J Fagundes | <pre>ENV['RAILS_ENV'] ||= 'production'</pre> |
177 | 1 | Serafim J Fagundes | |
178 | 1 | Serafim J Fagundes | h3. Generate the session store |
179 | 3 | Mischa The Evil | |
180 | 1 | Serafim J Fagundes | <pre>RAILS_ENV=production bundle exec rake generate_session_store</pre> |
181 | 1 | Serafim J Fagundes | |
182 | 1 | Serafim J Fagundes | h3. Migrate the database models |
183 | 3 | Mischa The Evil | |
184 | 1 | Serafim J Fagundes | <pre>RAILS_ENV=production bundle exec rake db:migrate</pre> |
185 | 1 | Serafim J Fagundes | |
186 | 1 | Serafim J Fagundes | h3. Load default data (optional) |
187 | 3 | Mischa The Evil | |
188 | 1 | Serafim J Fagundes | <pre>RAILS_ENV=production bundle exec rake redmine:load_default_data</pre> |
189 | 1 | Serafim J Fagundes | |
190 | 1 | Serafim J Fagundes | Follow instructions. |
191 | 25 | Johannes M. | |
192 | 1 | Serafim J Fagundes | h3. Rename dispatch CGI files in /var/www/redmine/public/ |
193 | 3 | Mischa The Evil | |
194 | 3 | Mischa The Evil | <pre> |
195 | 1 | Serafim J Fagundes | mv dispatch.cgi.example dispatch.cgi |
196 | 1 | Serafim J Fagundes | mv dispatch.fcgi.example dispatch.fcgi |
197 | 3 | Mischa The Evil | mv dispatch.rb.example dispatch.rb |
198 | 1 | Serafim J Fagundes | </pre> |
199 | 1 | Serafim J Fagundes | |
200 | 5 | Mauro Mazzieri | h3. Edit .htaccess file for CGI dispatch configuration |
201 | 5 | Mauro Mazzieri | |
202 | 5 | Mauro Mazzieri | <pre> |
203 | 5 | Mauro Mazzieri | mv htaccess.fcgi.example .htaccess |
204 | 1 | Serafim J Fagundes | </pre> |
205 | 1 | Serafim J Fagundes | |
206 | 1 | Serafim J Fagundes | h3. Chown and Chmod files for read/write access for the Apache user |
207 | 3 | Mischa The Evil | |
208 | 3 | Mischa The Evil | <pre> |
209 | 1 | Serafim J Fagundes | cd .. |
210 | 1 | Serafim J Fagundes | chown -R apache:apache redmine-1.x |
211 | 3 | Mischa The Evil | chmod -R 755 redmine-1.x |
212 | 2 | Serafim J Fagundes | </pre> |
213 | 1 | Serafim J Fagundes | |
214 | 1 | Serafim J Fagundes | h3. Redmine should be fully installed now and fully usable |
215 | 1 | Serafim J Fagundes | |
216 | 1 | Serafim J Fagundes | Enjoy! |