Redmine on CentOS installation HOWTO » History » Version 30
Stephan Schuberth, 2012-03-28 02:43
1 | 1 | Stephan Schuberth | h1. Redmine on CentOS installation HOWTO |
---|---|---|---|
2 | |||
3 | {{>toc}} |
||
4 | |||
5 | 2 | Stephan Schuberth | This works with CentOS versions 5 and 6 and describes how to get Redmine 1.3.2 set up. |
6 | 1 | Stephan Schuberth | |
7 | h2. Assumptions |
||
8 | |||
9 | * Apache is up and running |
||
10 | * Apache has previously been used and works quite well |
||
11 | * MySQL is up and running |
||
12 | * MySQL has previously been used and works quite well |
||
13 | * Your are logged as root |
||
14 | * The next steps are done successively without errors |
||
15 | 25 | Stephan Schuberth | * You can of course use vi/vim as your editor of choice instead of nano, if you know what you are doing. ;) |
16 | 1 | Stephan Schuberth | |
17 | h1. Install pre-dependencies |
||
18 | |||
19 | <pre>yum -y install zlib-devel curl-devel openssl-devel httpd-devel apr-devel apr-util-devel mysql-devel</pre> |
||
20 | |||
21 | h2. Ruby |
||
22 | |||
23 | Things after *#* are comments, and it is no use to type this stuff in ;) |
||
24 | <pre>cd ~/Downloads # YOUR FOLDER OF CHOICE |
||
25 | ftp ftp.ruby-lang.org |
||
26 | </pre> |
||
27 | |||
28 | h3. FTP session |
||
29 | |||
30 | <pre>ftp> Anonymous # USERLOGIN |
||
31 | ftp> 'none', just hit Enter # NO PASSWORD |
||
32 | ftp> cd /pub/ruby |
||
33 | ftp> get ruby-1.8.7.pXXX.tar.gz # XXX is currently 358, as of 03/2012 |
||
34 | ftp> bye</pre> |
||
35 | |||
36 | h3. Untar |
||
37 | |||
38 | <pre>tar zxvf ruby-1.8.7.pXXX.tar.gz</pre> |
||
39 | |||
40 | h3. Install |
||
41 | |||
42 | <pre>cd ruby-1.8.7.pXXX |
||
43 | ./configure |
||
44 | make |
||
45 | make install</pre> |
||
46 | |||
47 | h3. Check installation |
||
48 | |||
49 | If this does not work, it is probably because there is no ruby at /usr/bin to be found. |
||
50 | <pre>ruby -v</pre> |
||
51 | 22 | Stephan Schuberth | If it works, skip directly to "RubyGems 1.4.2". |
52 | |||
53 | 1 | Stephan Schuberth | |
54 | 6 | Stephan Schuberth | h3. Fix dependencies |
55 | 1 | Stephan Schuberth | |
56 | (Only in case _ruby -v_ is *NOT* working) |
||
57 | <pre>which ruby # TO CHECK WHERE IT SHOULD BE |
||
58 | whereis ruby # TO CHECK WHERE IT IS INSTALLED</pre> |
||
59 | _which_ returns like /usr/bin/ along with other directories (where ruby is expected to be), and _whereis_ returns like /usr/local/bin/ruby (thats where ruby actually lies). |
||
60 | |||
61 | 6 | Stephan Schuberth | h4. Fix via adding /usr/local/bin to $PATH |
62 | |||
63 | 9 | Stephan Schuberth | (Do this with your editor of choice, if you do not like nano.) |
64 | 6 | Stephan Schuberth | <pre>nano /etc/profile</pre> |
65 | |||
66 | Make the section with _pathmunge_ look alike like this: |
||
67 | <pre>#Path manupulation |
||
68 | if [ "$EUID" = "0" ]; then |
||
69 | pathmunge /sbin |
||
70 | pathmunge /usr/sbin |
||
71 | pathmunge /usr/local/sbin |
||
72 | pathmunge /usr/local/bin # ADDED THIS |
||
73 | else |
||
74 | pathmunge /usr/local/bin after # ADDED THIS |
||
75 | pathmunge /usr/local/sbin after |
||
76 | pathmunge /usr/sbin after |
||
77 | pathmunge /sbin |
||
78 | fi</pre> |
||
79 | |||
80 | OR ADD THIS AT THE END OF THE FILE: |
||
81 | |||
82 | <pre>nano /etc/profile |
||
83 | export PATH="$PATH:/usr/local/bin"</pre> |
||
84 | |||
85 | 15 | Stephan Schuberth | This sets the PATH for all Users beside root. For this setup you want to change the PATH for root, too: |
86 | 6 | Stephan Schuberth | |
87 | <pre>nano ~/.bashrc |
||
88 | 1 | Stephan Schuberth | export PATH="$PATH:/usr/local/bin"</pre> |
89 | 15 | Stephan Schuberth | |
90 | Logout your user and login again, to make the changes work. |
||
91 | 6 | Stephan Schuberth | |
92 | h4. Fix via Symlink Creation |
||
93 | |||
94 | 7 | Stephan Schuberth | This is not recommended, since if the ruby dependency is broken, others will likely be later on, too. Repair this by adding the folder to the $PATH variable like described before, else _gem_, _rake_, _bundle_, _passenger-install-apache2-module_ will not work either... you would have to creat symlinks for them, too. |
95 | 6 | Stephan Schuberth | Symlinks are created like this |
96 | |||
97 | 1 | Stephan Schuberth | <pre>ln -s /usr/local/bin/ruby /usr/bin/ruby</pre> |
98 | 6 | Stephan Schuberth | |
99 | 8 | Stephan Schuberth | h4. Verify ruby to be working |
100 | 6 | Stephan Schuberth | |
101 | 16 | Stephan Schuberth | <pre>which ruby # MUST RETURN PATH TO RUBY |
102 | ruby -v # MUST RETURN RUBY VERSION |
||
103 | 1 | Stephan Schuberth | cd ..</pre> |
104 | 16 | Stephan Schuberth | |
105 | 19 | Stephan Schuberth | Now it has to work. When changing $PATH variable, did you log out and log on again with your current user? |
106 | 18 | Stephan Schuberth | If this does not function properly, other things later on will also not work. |
107 | 1 | Stephan Schuberth | |
108 | h2. RubyGems 1.4.2 |
||
109 | |||
110 | *Does not work with Gems 1.5!* |
||
111 | |||
112 | h3. Download |
||
113 | |||
114 | <pre>wget http://production.cf.rubygems.org/rubygems/rubygems-1.4.2.tgz</pre> |
||
115 | |||
116 | h3. Untar |
||
117 | |||
118 | <pre>tar zxvf rubygems-1.4.2.tgz</pre> |
||
119 | |||
120 | h3. Setup |
||
121 | |||
122 | <pre>cd rubygems-1.4.2 |
||
123 | ruby setup.rb</pre> |
||
124 | |||
125 | h3. Check installation |
||
126 | |||
127 | <pre>gem -v</pre> |
||
128 | |||
129 | 21 | Stephan Schuberth | h3. Do things work? |
130 | 1 | Stephan Schuberth | |
131 | 21 | Stephan Schuberth | ... else the cause is the same as with the ruby problem before... |
132 | 1 | Stephan Schuberth | |
133 | h2. Passenger |
||
134 | |||
135 | h3. Regular install method |
||
136 | |||
137 | 23 | Stephan Schuberth | Requires C++ compiler to complete. |
138 | But if it cannot be found in the system, the commands how to install it will be shown later on. |
||
139 | 1 | Stephan Schuberth | |
140 | <pre>gem install passenger |
||
141 | passenger-install-apache2-module</pre> |
||
142 | |||
143 | 14 | Stephan Schuberth | The install process is interactive and you wil be told what to do. How to install missing dependencies is described exactly. JUST READ! |
144 | 1 | Stephan Schuberth | |
145 | h3. Alternative install method |
||
146 | |||
147 | Install mod_passenger RPM for Apache from the following location: |
||
148 | |||
149 | > http://passenger.stealthymonkeys.com/ |
||
150 | |||
151 | _RHEL/CentOS 5_ |
||
152 | <pre>rpm -Uvh http://passenger.stealthymonkeys.com/rhel/5/passenger-release.noarch.rpm |
||
153 | yum install mod_passenger</pre> |
||
154 | |||
155 | _RHEL/CentOS 6_ |
||
156 | <pre>rpm --import http://passenger.stealthymonkeys.com/RPM-GPG-KEY-stealthymonkeys.asc |
||
157 | yum install http://passenger.stealthymonkeys.com/rhel/6/passenger-release.noarch.rpm |
||
158 | yum install mod_passenger</pre> |
||
159 | |||
160 | h2. Restart Apache |
||
161 | |||
162 | <pre>service httpd restart</pre> |
||
163 | |||
164 | h1. Install Redmine |
||
165 | |||
166 | h3. Download |
||
167 | |||
168 | Download page: |
||
169 | > http://rubyforge.org/frs/?group_id=1850 |
||
170 | |||
171 | <pre>wget http://rubyforge.org/frs/download.php/75910/redmine-1.3.2.tar.gz # GET LATEST VERSION ON RUBYFORGE</pre> |
||
172 | |||
173 | h3. Untar |
||
174 | |||
175 | <pre>tar zxvf redmine-1.3.2.tar.gz</pre> |
||
176 | |||
177 | h3. Copy the folder to its HTTP document root folder |
||
178 | |||
179 | <pre>mkdir /var/www/redmine |
||
180 | cp -av redmine-1.3.2/* /var/www/redmine</pre> |
||
181 | |||
182 | 13 | Stephan Schuberth | h1. Link Redmine to the Database |
183 | |||
184 | h2. Install MySQL DB Server |
||
185 | |||
186 | <pre>yum install mysql-server |
||
187 | chkconfig mysqld on |
||
188 | service mysqld start |
||
189 | /usr/bin/mysql_secure_installation</pre> |
||
190 | |||
191 | h2. Create a MySQL database to use with Redmine |
||
192 | |||
193 | 25 | Stephan Schuberth | Start the mysql client (@mysql -u root -p@), the version you have is shown in the welcome message. |
194 | Enter the following commands: |
||
195 | <pre>create database redmine character set utf8;</pre> |
||
196 | |||
197 | 13 | Stephan Schuberth | h3. Latest MySQL Version |
198 | |||
199 | 25 | Stephan Schuberth | <pre>create user 'redmine'@'localhost' identified by 'my_password'; |
200 | 1 | Stephan Schuberth | grant all privileges on redmine.* to 'redmine'@'localhost'; |
201 | \q</pre> |
||
202 | |||
203 | h3. For versions of MySQL prior to 5.0.2 |
||
204 | |||
205 | 25 | Stephan Schuberth | Skip the 'create user' step and do instead: |
206 | 26 | Stephan Schuberth | <pre>grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password'; |
207 | 25 | Stephan Schuberth | \q</pre> |
208 | 13 | Stephan Schuberth | |
209 | 25 | Stephan Schuberth | Now the database and a user to be used with it is created. Also the user has the rights to work on the database that was created. |
210 | 13 | Stephan Schuberth | |
211 | 25 | Stephan Schuberth | h2. Configure database.yml |
212 | 13 | Stephan Schuberth | |
213 | 29 | Stephan Schuberth | There you have to enter the user:password combination (redmine:my_password) in the config file, so Redmine can actually talk to the database (redmine). |
214 | 25 | Stephan Schuberth | |
215 | 27 | Stephan Schuberth | <pre>cd /var/www/redmine/config |
216 | 28 | Stephan Schuberth | cp database.yml.example database.yml |
217 | nano database.yml</pre> |
||
218 | 1 | Stephan Schuberth | |
219 | 27 | Stephan Schuberth | Change it to look like: |
220 | <pre>production: |
||
221 | adapter: mysql |
||
222 | database: redmine |
||
223 | host: localhost |
||
224 | username: redmine |
||
225 | password: my_password |
||
226 | encoding: utf8</pre> |
||
227 | |||
228 | 30 | Stephan Schuberth | The other entries are not important, since we will use only the production environment. But if you would need the development or test environment, don't forget the create additional databases. *Don't* use the same database for production and testing or development! |
229 | 1 | Stephan Schuberth | |
230 | h1. Rails Settings |
||
231 | |||
232 | h2. Dependency management with bundler |
||
233 | |||
234 | For more info go to the "bundler site":http://gembundler.com/. |
||
235 | |||
236 | h3. Install |
||
237 | |||
238 | <pre>gem install bundler</pre> |
||
239 | |||
240 | h3. Create Gemfile |
||
241 | |||
242 | <pre>nano /var/www/redmine/Gemfile</pre> |
||
243 | |||
244 | h3. Register gems |
||
245 | |||
246 | Put the following into the file you just opened: |
||
247 | <pre># file: /var/www/redmine/Gemfile |
||
248 | source "http://rubygems.org" |
||
249 | gem "rake", "0.8.3" |
||
250 | gem "rack", "1.1.0" |
||
251 | gem "i18n", "0.4.2" |
||
252 | gem "rubytree", "0.5.2", :require => "tree" |
||
253 | gem "RedCloth", "~>4.2.3", :require => "redcloth" # for CodeRay |
||
254 | gem "mysql" |
||
255 | gem "coderay", "~>0.9.7"</pre> |
||
256 | Save and exit the editor. |
||
257 | 20 | Stephan Schuberth | |
258 | 1 | Stephan Schuberth | h3. Install the provided dependencies |
259 | 10 | Stephan Schuberth | |
260 | <pre>cd /var/www/redmine |
||
261 | 1 | Stephan Schuberth | bundle install</pre> |
262 | 12 | Stephan Schuberth | |
263 | h2. Set environment to "production" |
||
264 | |||
265 | Rails has the concept of environments to represent the stages of an application’s lifecycle: test, development, and production by default. |
||
266 | Specify your choice with the RAILS_ENV environment variable. |
||
267 | Production has less verbose logging and is a bit faster, testing and development environment are not needed anyway for your Redmine. |
||
268 | |||
269 | Uncomment the following line in file redmine/config/environment.rb: |
||
270 | |||
271 | <pre>ENV['RAILS_ENV'] ||= 'production'</pre> |
||
272 | |||
273 | h2. Generate the session store |
||
274 | |||
275 | <pre>RAILS_ENV=production bundle exec rake generate_session_store</pre> |
||
276 | |||
277 | h2. Migrate the database models |
||
278 | |||
279 | <pre>RAILS_ENV=production bundle exec rake db:migrate</pre> |
||
280 | |||
281 | h2. Load default data (optional) |
||
282 | |||
283 | <pre>RAILS_ENV=production bundle exec rake redmine:load_default_data</pre> |
||
284 | |||
285 | Follow instructions. |
||
286 | |||
287 | h2. Rename dispatch CGI files in /var/www/redmine/public/ |
||
288 | |||
289 | <pre> |
||
290 | mv dispatch.cgi.example dispatch.cgi |
||
291 | mv dispatch.fcgi.example dispatch.fcgi |
||
292 | mv dispatch.rb.example dispatch.rb |
||
293 | 1 | Stephan Schuberth | </pre> |
294 | |||
295 | 11 | Stephan Schuberth | h1. Apache Settings |
296 | |||
297 | h2. Configure Apache to host the documents |
||
298 | |||
299 | 1 | Stephan Schuberth | more information can be found here: [[HowTo configure Apache to run Redmine]] |
300 | |||
301 | h2. Edit .htaccess file for CGI dispatch configuration |
||
302 | |||
303 | <pre> |
||
304 | mv htaccess.fcgi.example .htaccess |
||
305 | </pre> |
||
306 | |||
307 | h2. Fix rights for the apache user |
||
308 | |||
309 | <pre> |
||
310 | cd .. |
||
311 | chown -R apache:apache redmine-1.x |
||
312 | chmod -R 755 redmine-1.x |
||
313 | </pre> |
||
314 | |||
315 | |||
316 | |||
317 | |||
318 | |||
319 | |||
320 | This should be everything. |
||
321 | 5 | Stephan Schuberth | |
322 | |||
323 | 1 | Stephan Schuberth | *Redmine is now installed and usable.* |
324 | |||
325 | *Enjoy!* |