HowTo install Redmine on CentOS 5 » History » Version 58
Stephan Schuberth, 2012-03-27 18:07
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 | |||
5 | 39 | Stephan Schuberth | h1. Assumptions |
6 | 33 | Nick Shel | |
7 | 34 | Nick Shel | * Apache is up and running |
8 | * Apache has previously been used and works quite well |
||
9 | * MySQL is up and running |
||
10 | * MySQL has previously been used and works quite well |
||
11 | 1 | Serafim J Fagundes | * Your are logged as root |
12 | * The next steps are done successively without errors |
||
13 | 30 | Nick Shel | |
14 | 40 | Stephan Schuberth | h1. Steps to take |
15 | 1 | Serafim J Fagundes | |
16 | 40 | Stephan Schuberth | h2. Install gem and passenger dependencies |
17 | 1 | Serafim J Fagundes | |
18 | 41 | Stephan Schuberth | <pre>yum -y install zlib-devel curl-devel openssl-devel httpd-devel apr-devel apr-util-devel mysql-devel</pre> |
19 | 28 | Nick Shel | |
20 | 1 | Serafim J Fagundes | h2. Get Ruby |
21 | 45 | Stephan Schuberth | |
22 | 44 | Stephan Schuberth | Things after *#* are comments, and it is no use to type this stuff in ;) |
23 | 41 | Stephan Schuberth | <pre>cd ~/Downloads # YOUR FOLDER OF CHOICE |
24 | 1 | Serafim J Fagundes | ftp ftp.ruby-lang.org |
25 | </pre> |
||
26 | 45 | Stephan Schuberth | |
27 | 44 | Stephan Schuberth | h3. FTP session |
28 | 45 | Stephan Schuberth | |
29 | 41 | Stephan Schuberth | <pre>ftp> Anonymous # USERLOGIN |
30 | 1 | Serafim J Fagundes | ftp> 'none', just hit Enter # NO PASSWORD |
31 | ftp> cd /pub/ruby |
||
32 | ftp> get ruby-1.8.7.pXXX.tar.gz # XXX is currently 358, as of 03/2012 |
||
33 | 41 | Stephan Schuberth | ftp> bye</pre> |
34 | 45 | Stephan Schuberth | |
35 | 44 | Stephan Schuberth | h3. Unzip |
36 | 45 | Stephan Schuberth | |
37 | 41 | Stephan Schuberth | <pre>tar zxvf ruby-1.8.7.pXXX.tar.gz</pre> |
38 | 45 | Stephan Schuberth | |
39 | 44 | Stephan Schuberth | h3. Install |
40 | 45 | Stephan Schuberth | |
41 | 41 | Stephan Schuberth | <pre>cd ruby-1.8.7.pXXX |
42 | 1 | Serafim J Fagundes | ./configure |
43 | make |
||
44 | 41 | Stephan Schuberth | make install</pre> |
45 | 45 | Stephan Schuberth | |
46 | 44 | Stephan Schuberth | h3. Check Installation |
47 | 45 | Stephan Schuberth | |
48 | 54 | Stephan Schuberth | If this does not work, it is probably because there is no ruby at /usr/bin to be found. |
49 | 1 | Serafim J Fagundes | If it works, skip directly to "Get Gems 1.4.2". |
50 | 55 | Stephan Schuberth | <pre>ruby -v</pre> |
51 | |||
52 | 53 | Stephan Schuberth | |
53 | 49 | Stephan Schuberth | h3. Fix dependencies with a symlink |
54 | 51 | Stephan Schuberth | |
55 | 49 | Stephan Schuberth | (Only in case _ruby -v_ is *NOT* working) |
56 | 1 | Serafim J Fagundes | <pre>which ruby # TO CHECK WHERE IT SHOULD BE |
57 | 43 | Stephan Schuberth | whereis ruby # TO CHECK WHERE IT IS INSTALLED</pre> |
58 | 49 | 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). |
59 | 1 | Serafim J Fagundes | |
60 | 49 | Stephan Schuberth | Create the Link: |
61 | <pre>ln -s /usr/local/bin/ruby /usr/bin/ruby</pre> |
||
62 | Check again if it is working: |
||
63 | <pre>ruby -v # NOW IT MUST RETURN RUBY VERSION, ELSE SOMETHING ELSE IS BROKEN |
||
64 | 41 | Stephan Schuberth | cd ..</pre> |
65 | 38 | Stephan Schuberth | |
66 | 40 | Stephan Schuberth | h2. Get Gems 1.4.2 (does not work with Gems 1.5) |
67 | 1 | Serafim J Fagundes | |
68 | 41 | Stephan Schuberth | <pre>wget http://production.cf.rubygems.org/rubygems/rubygems-1.4.2.tgz |
69 | 1 | Serafim J Fagundes | tar zxvf rubygems-1.4.2.tgz |
70 | cd rubygems-1.4.2 |
||
71 | ruby setup.rb |
||
72 | gem -v |
||
73 | which gem |
||
74 | 41 | Stephan Schuberth | cd ..</pre> |
75 | 3 | Mischa The Evil | |
76 | 1 | Serafim J Fagundes | h2. Install Passenger (requires gcc) |
77 | |||
78 | 41 | Stephan Schuberth | <pre>gem install passenger |
79 | passenger-install-apache2-module</pre> |
||
80 | 26 | Anonymous | |
81 | An alternate method is to install mod_passenger RPM for Apache from the following location: |
||
82 | http://passenger.stealthymonkeys.com/ |
||
83 | |||
84 | 56 | Stephan Schuberth | h3. RHEL/CentOS 5 |
85 | 57 | Stephan Schuberth | |
86 | 41 | Stephan Schuberth | <pre>rpm -Uvh http://passenger.stealthymonkeys.com/rhel/5/passenger-release.noarch.rpm |
87 | yum install mod_passenger</pre> |
||
88 | 26 | Anonymous | |
89 | 56 | Stephan Schuberth | h3. RHEL/CentOS 6 |
90 | 57 | Stephan Schuberth | |
91 | 41 | Stephan Schuberth | <pre>rpm --import http://passenger.stealthymonkeys.com/RPM-GPG-KEY-stealthymonkeys.asc |
92 | 26 | Anonymous | yum install http://passenger.stealthymonkeys.com/rhel/6/passenger-release.noarch.rpm |
93 | 41 | Stephan Schuberth | yum install mod_passenger</pre> |
94 | 26 | Anonymous | |
95 | 40 | Stephan Schuberth | h2. Restart Apache |
96 | 1 | Serafim J Fagundes | |
97 | <pre>service httpd restart</pre> |
||
98 | |||
99 | h2. Download Redmine |
||
100 | 3 | Mischa The Evil | |
101 | 40 | Stephan Schuberth | Download page: http://rubyforge.org/frs/?group_id=1850 |
102 | 1 | Serafim J Fagundes | |
103 | 41 | Stephan Schuberth | <pre>wget http://rubyforge.org/frs/download.php/75597/redmine-1.3.0.tar.gz # GET LATEST VERSION ON RUBYFORGE |
104 | tar zxvf redmine-1.3.0.tar.gz</pre> |
||
105 | 16 | Steven Verbeek | |
106 | 1 | Serafim J Fagundes | h2. Copy the folder to its HTTP document root folder |
107 | |||
108 | 40 | Stephan Schuberth | <pre>cp -av redmine-1.3.0/* /var/www/redmine</pre> |
109 | 16 | Steven Verbeek | |
110 | 26 | Anonymous | h2. Configure Apache to host the documents |
111 | 1 | Serafim J Fagundes | |
112 | 40 | Stephan Schuberth | more information can be found here: [[HowTo configure Apache to run Redmine]] |
113 | 1 | Serafim J Fagundes | |
114 | 40 | Stephan Schuberth | h2. Install Bundler |
115 | 4 | Neil McFarlane | |
116 | 1 | Serafim J Fagundes | <pre>gem install bundler</pre> |
117 | |||
118 | h2. Add the Bundler Boot and preinitializer code |
||
119 | |||
120 | 8 | Erwin Baeyens | For more info go to the "Bundler site":http://gembundler.com/. |
121 | 20 | Johannes M. | |
122 | 22 | Johannes M. | h2. Create the Gemfile and register these gems in it |
123 | 20 | Johannes M. | |
124 | 21 | Johannes M. | <pre>vi /var/www/redmine/Gemfile</pre> |
125 | |||
126 | 41 | Stephan Schuberth | <pre># file: /var/www/redmine/Gemfile |
127 | 21 | Johannes M. | source "http://rubygems.org" |
128 | gem "rake", "0.8.3" |
||
129 | gem "rack", "1.1.0" |
||
130 | gem "i18n", "0.4.2" |
||
131 | 20 | Johannes M. | gem "rubytree", "0.5.2", :require => "tree" |
132 | 1 | Serafim J Fagundes | gem "RedCloth", "~>4.2.3", :require => "redcloth" # for CodeRay |
133 | 3 | Mischa The Evil | gem "mysql" |
134 | 41 | Stephan Schuberth | gem "coderay", "~>0.9.7"</pre> |
135 | 1 | Serafim J Fagundes | |
136 | 40 | Stephan Schuberth | <pre>bundle install</pre> |
137 | 23 | Johannes M. | |
138 | h2. Create the Redmine MySQL database |
||
139 | |||
140 | 41 | Stephan Schuberth | <pre>yum install mysql-server |
141 | 23 | Johannes M. | chkconfig mysqld on |
142 | service mysqld start |
||
143 | 41 | Stephan Schuberth | /usr/bin/mysql_secure_installation</pre> |
144 | 1 | Serafim J Fagundes | |
145 | 58 | Stephan Schuberth | h3. For MySQL: |
146 | |||
147 | > start the mysql client (@mysql -u root -p@) and enter the following commands: |
||
148 | 11 | Erwin Baeyens | > > <pre>create database redmine character set utf8; |
149 | 1 | Serafim J Fagundes | create user 'redmine'@'localhost' identified by 'my_password'; |
150 | grant all privileges on redmine.* to 'redmine'@'localhost'; </pre> |
||
151 | 11 | Erwin Baeyens | |
152 | 58 | Stephan Schuberth | h3. For versions of MySQL prior to 5.0.2 - skip the 'create user' step and instead: |
153 | 11 | Erwin Baeyens | |
154 | 58 | Stephan Schuberth | > <pre> grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';</pre> |
155 | 24 | Johannes M. | |
156 | 40 | Stephan Schuberth | h2. Configure /var/www/redmine/config/database.yml (rename database.yml.example) |
157 | 1 | Serafim J Fagundes | |
158 | 40 | Stephan Schuberth | h2. Set the production environment (optional) |
159 | 7 | Thibault B | |
160 | 1 | Serafim J Fagundes | Uncomment the following line in file redmine/config/environment.rb: |
161 | 3 | Mischa The Evil | |
162 | 1 | Serafim J Fagundes | <pre>ENV['RAILS_ENV'] ||= 'production'</pre> |
163 | |||
164 | 40 | Stephan Schuberth | h2. Generate the session store |
165 | 3 | Mischa The Evil | |
166 | 1 | Serafim J Fagundes | <pre>RAILS_ENV=production bundle exec rake generate_session_store</pre> |
167 | |||
168 | 40 | Stephan Schuberth | h2. Migrate the database models |
169 | 3 | Mischa The Evil | |
170 | 1 | Serafim J Fagundes | <pre>RAILS_ENV=production bundle exec rake db:migrate</pre> |
171 | |||
172 | 40 | Stephan Schuberth | h2. Load default data (optional) |
173 | 3 | Mischa The Evil | |
174 | 1 | Serafim J Fagundes | <pre>RAILS_ENV=production bundle exec rake redmine:load_default_data</pre> |
175 | |||
176 | Follow instructions. |
||
177 | 25 | Johannes M. | |
178 | 40 | Stephan Schuberth | h2. Rename dispatch CGI files in /var/www/redmine/public/ |
179 | 3 | Mischa The Evil | |
180 | <pre> |
||
181 | 1 | Serafim J Fagundes | mv dispatch.cgi.example dispatch.cgi |
182 | mv dispatch.fcgi.example dispatch.fcgi |
||
183 | 3 | Mischa The Evil | mv dispatch.rb.example dispatch.rb |
184 | 1 | Serafim J Fagundes | </pre> |
185 | |||
186 | 40 | Stephan Schuberth | h2. Edit .htaccess file for CGI dispatch configuration |
187 | 5 | Mauro Mazzieri | |
188 | <pre> |
||
189 | mv htaccess.fcgi.example .htaccess |
||
190 | 1 | Serafim J Fagundes | </pre> |
191 | |||
192 | 40 | Stephan Schuberth | h2. Chown and Chmod files for read/write access for the Apache user |
193 | 3 | Mischa The Evil | |
194 | <pre> |
||
195 | 1 | Serafim J Fagundes | cd .. |
196 | chown -R apache:apache redmine-1.x |
||
197 | 3 | Mischa The Evil | chmod -R 755 redmine-1.x |
198 | 2 | Serafim J Fagundes | </pre> |
199 | 1 | Serafim J Fagundes | |
200 | 40 | Stephan Schuberth | h2. Redmine should be fully installed now and fully usable |
201 | 1 | Serafim J Fagundes | |
202 | Enjoy! |