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