HowTo Install Redmine in Ubuntu » History » Version 5
Roger Lipscombe, 2010-06-16 21:21
1 | 3 | Sam Wilson | h1. Ubuntu 10.4 LTS |
---|---|---|---|
2 | 3 | Sam Wilson | |
3 | 3 | Sam Wilson | As of 10.4, Redmine is available through Ubuntu's package manager, and installation is simple: |
4 | 3 | Sam Wilson | |
5 | 3 | Sam Wilson | > $ sudo apt-get install redmine redmine-mysql |
6 | 3 | Sam Wilson | |
7 | 3 | Sam Wilson | The second package, _redmine-mysql_, can be replaced by either _redmine-pgsql_ or _redmine-sqlite_ if you want to use either of those databases. |
8 | 3 | Sam Wilson | |
9 | 3 | Sam Wilson | Redmine will now be installed in @/usr/share/redmine@ and @/etc/redmine@ |
10 | 3 | Sam Wilson | |
11 | 3 | Sam Wilson | h2. Configuration |
12 | 3 | Sam Wilson | |
13 | 3 | Sam Wilson | Symlink @/usr/share/redmine/public@ to your desired web-accessible location. E.g.: |
14 | 3 | Sam Wilson | |
15 | 3 | Sam Wilson | > $ ln /usr/share/redmine/public /var/www/redmine |
16 | 3 | Sam Wilson | |
17 | 3 | Sam Wilson | The other files that you need to modify/create are as follows: |
18 | 3 | Sam Wilson | |
19 | 3 | Sam Wilson | @/etc/redmine/database.yml@: |
20 | 3 | Sam Wilson | |
21 | 3 | Sam Wilson | <pre> |
22 | 3 | Sam Wilson | production: |
23 | 3 | Sam Wilson | adapter: mysql |
24 | 3 | Sam Wilson | database: redmine |
25 | 3 | Sam Wilson | host: localhost |
26 | 3 | Sam Wilson | username: redmine |
27 | 3 | Sam Wilson | password: pa55w0rd |
28 | 3 | Sam Wilson | encoding: utf8 |
29 | 3 | Sam Wilson | </pre> |
30 | 3 | Sam Wilson | |
31 | 3 | Sam Wilson | @/user/share/redmine/public/dispatch.cgi@: |
32 | 3 | Sam Wilson | |
33 | 3 | Sam Wilson | <pre> |
34 | 3 | Sam Wilson | #!/usr/bin/ruby |
35 | 3 | Sam Wilson | |
36 | 3 | Sam Wilson | require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT) |
37 | 3 | Sam Wilson | |
38 | 3 | Sam Wilson | require "dispatcher" |
39 | 3 | Sam Wilson | |
40 | 3 | Sam Wilson | ADDITIONAL_LOAD_PATHS.reverse.each { |dir| $:.unshift(dir) if File.directory?(dir) } if defined?(Apache::RubyRun) |
41 | 3 | Sam Wilson | Dispatcher.dispatch |
42 | 3 | Sam Wilson | </pre> |
43 | 3 | Sam Wilson | |
44 | 4 | Sam Wilson | @/usr/share/redmine/public/.htaccess@: |
45 | 3 | Sam Wilson | |
46 | 3 | Sam Wilson | <pre> |
47 | 3 | Sam Wilson | RewriteEngine On |
48 | 3 | Sam Wilson | RewriteBase /redmine |
49 | 3 | Sam Wilson | RewriteRule ^$ index.html [QSA] |
50 | 3 | Sam Wilson | RewriteRule ^([^.]+)$ $1.html [QSA] |
51 | 3 | Sam Wilson | RewriteCond %{REQUEST_FILENAME} !-f |
52 | 3 | Sam Wilson | RewriteRule ^(.*)$ dispatch.cgi [QSA,L] |
53 | 3 | Sam Wilson | </pre> |
54 | 3 | Sam Wilson | |
55 | 3 | Sam Wilson | And that's it! If these instructions didn't work for you, please expand them to include whatever is needed. |
56 | 3 | Sam Wilson | |
57 | 5 | Roger Lipscombe | h1. Redmine Installation on Ubuntu 10.4 using Passenger |
58 | 5 | Roger Lipscombe | |
59 | 5 | Roger Lipscombe | > $ sudo apt-get install redmine redmine-mysql |
60 | 5 | Roger Lipscombe | |
61 | 5 | Roger Lipscombe | The second package, _redmine-mysql_, can be replaced by either _redmine-pgsql_ or _redmine-sqlite_ if you want to use either of those databases. |
62 | 5 | Roger Lipscombe | |
63 | 5 | Roger Lipscombe | Ubuntu should prompt you for all the interesting details. |
64 | 5 | Roger Lipscombe | |
65 | 5 | Roger Lipscombe | Redmine will now be installed in @/usr/share/redmine@ and @/etc/redmine@ |
66 | 5 | Roger Lipscombe | |
67 | 5 | Roger Lipscombe | h2. Configuration |
68 | 5 | Roger Lipscombe | |
69 | 5 | Roger Lipscombe | Symlink @/usr/share/redmine/public@ to your desired web-accessible location. E.g.: |
70 | 5 | Roger Lipscombe | |
71 | 5 | Roger Lipscombe | > $ ln /usr/share/redmine/public /var/www/redmine |
72 | 5 | Roger Lipscombe | |
73 | 5 | Roger Lipscombe | By default, passenger runs as 'nobody', so you'll need to fix that. In @/etc/apache2/mods-available/passenger.conf@, add a @PassengerDefaultUser www-data@ directive. |
74 | 5 | Roger Lipscombe | |
75 | 5 | Roger Lipscombe | You'll also need to configure the @/var/www/redmine@ location in @/etc/apache2/sites-available/default@: |
76 | 5 | Roger Lipscombe | |
77 | 5 | Roger Lipscombe | <pre><Directory /var/www/redmine> |
78 | 5 | Roger Lipscombe | RailsBaseURI /redmine |
79 | 5 | Roger Lipscombe | </Directory> |
80 | 5 | Roger Lipscombe | </pre> |
81 | 5 | Roger Lipscombe | |
82 | 5 | Roger Lipscombe | > $ sudo a2enmod passenger |
83 | 5 | Roger Lipscombe | |
84 | 5 | Roger Lipscombe | Restart apache2 and you should be good to go. |
85 | 5 | Roger Lipscombe | |
86 | 3 | Sam Wilson | h1. Redmine Installation on Virtual or Normal Ubuntu < 10.4 |
87 | 1 | Umit Uzun | |
88 | 2 | Sam Wilson | This page is a guide to installing Redmine on either a virtual or actual installation of the Ubuntu operating system. If you follow all instructions correctly you will be installed your Redmine server successfully almost an hour. |
89 | 1 | Umit Uzun | |
90 | 2 | Sam Wilson | h2. Step 1: Install Ubuntu |
91 | 1 | Umit Uzun | |
92 | 2 | Sam Wilson | If you are installing on a non-virtual Ubuntu instance, please skip this section. |
93 | 1 | Umit Uzun | |
94 | 2 | Sam Wilson | *Installing VirtualBox:* |
95 | 2 | Sam Wilson | |
96 | 2 | Sam Wilson | 1.Download last version of Sun VirtualBox (version 3.0.10 or newer) tool in your system. |
97 | 1 | Umit Uzun | 2.Install to your system by following the instructions. |
98 | 1 | Umit Uzun | |
99 | 1 | Umit Uzun | *Installing Ubuntu on VirtualBox:* |
100 | 1 | Umit Uzun | |
101 | 1 | Umit Uzun | 1.Download last version of Ubuntu(version 9.10 or newer) OS in your system. |
102 | 1 | Umit Uzun | 2.After installed VirtualBox on your system you will create a new virtual operating which will be Linux type and Ubuntu subtype. If you don't know anything about VirtualBox and/or its usage please refer to the google. |
103 | 1 | Umit Uzun | |
104 | 1 | Umit Uzun | 3.While installing Ubuntu you should type the related configurations as follows: |
105 | 1 | Umit Uzun | (These all configurations are optional, you can give any name what you what.) |
106 | 1 | Umit Uzun | Q: What is your name? A: Redmine Server |
107 | 1 | Umit Uzun | Q: What name do you want to use to login? A: redmine |
108 | 1 | Umit Uzun | Q: Choose to password to keep your account safe? A: redmine |
109 | 1 | Umit Uzun | Q: What is the name of this computer? A: redmine-server |
110 | 1 | Umit Uzun | Choose “Log in automatically.” radio button. |
111 | 1 | Umit Uzun | |
112 | 1 | Umit Uzun | 4.When you finished up installation all of them open up your new VirtualBox Ubuntu OS and open up terminal(console) screen and issuing these commands: |
113 | 1 | Umit Uzun | > sudo apt-get update |
114 | 1 | Umit Uzun | > sudo apt-get upgrade |
115 | 1 | Umit Uzun | |
116 | 1 | Umit Uzun | *Configuring VirtualBox:* |
117 | 1 | Umit Uzun | |
118 | 1 | Umit Uzun | 1.If you want to reach your VirtualBox Ubuntu OS from different machine, you have to configure VirtualBox Ubuntu OS's network setting to Bridged Adapter. So you can reach your VirtualBox Ubuntu from internal IP address easily. Because it get's same IP block as you from DHCP easily. I mean your guest and host computer is same IP block as different network client. |
119 | 1 | Umit Uzun | |
120 | 1 | Umit Uzun | 2.If you had assigned a static IP to your Network Consult by giving your static ethernet MAC address, you have to assign unique MAC address your VirtualBox Ubuntu OS by Setting->Network->MAC address initialization box. By this MAC address, you can get static ip easily or you can configure your Ubuntu system to not use DHCP, instead of that you can assign static IP manually. |
121 | 1 | Umit Uzun | |
122 | 2 | Sam Wilson | h2. Step 2: Install Redmine |
123 | 1 | Umit Uzun | |
124 | 2 | Sam Wilson | Once you have a functioning Ubuntu operating system up and running, you can continue with installing Redmine. |
125 | 1 | Umit Uzun | |
126 | 2 | Sam Wilson | h3. Install dependencies |
127 | 2 | Sam Wilson | |
128 | 2 | Sam Wilson | The following packages are required to install and run Redmine. Please install them by running @apt-get@ as root: |
129 | 2 | Sam Wilson | |
130 | 2 | Sam Wilson | >sudo apt-get package-name |
131 | 2 | Sam Wilson | |
132 | 2 | Sam Wilson | where @package-name@ is each of: |
133 | 2 | Sam Wilson | * apache2 |
134 | 2 | Sam Wilson | * apache2-threaded-dev |
135 | 2 | Sam Wilson | * build-essential |
136 | 2 | Sam Wilson | * libapache-dbi-perl |
137 | 2 | Sam Wilson | * libapache2-mod-perl2 |
138 | 2 | Sam Wilson | * libapache2-svn |
139 | 2 | Sam Wilson | * libdigest-sha1-perl |
140 | 2 | Sam Wilson | * libgemplugin-ruby |
141 | 2 | Sam Wilson | * libgemplugin-ruby1.8 |
142 | 2 | Sam Wilson | * libruby-extras |
143 | 2 | Sam Wilson | * libruby1.8-extras |
144 | 2 | Sam Wilson | * mongrel |
145 | 2 | Sam Wilson | * mysql-server |
146 | 2 | Sam Wilson | * rails |
147 | 2 | Sam Wilson | * rake |
148 | 2 | Sam Wilson | * ruby |
149 | 2 | Sam Wilson | * rubygems |
150 | 2 | Sam Wilson | * rubygems1.8 |
151 | 2 | Sam Wilson | * ruby1.8-dev |
152 | 2 | Sam Wilson | * subversion |
153 | 2 | Sam Wilson | |
154 | 2 | Sam Wilson | _(Could someone please clean up this list?)_ |
155 | 2 | Sam Wilson | |
156 | 1 | Umit Uzun | *Package Installation and Setup:* |
157 | 1 | Umit Uzun | |
158 | 1 | Umit Uzun | 1.Once you’ve installed the VirtualBox Ubuntu OS and updated it, you need to install a bunch of packages that we will prepare the server for the Redmine installation. So, as root, install the following packages by issuing: |
159 | 2 | Sam Wilson | > sudo apt-get install |
160 | 2 | Sam Wilson | > sudo apt-get install |
161 | 1 | Umit Uzun | |
162 | 1 | Umit Uzun | The packages we’re installing above are MySQL, phpMyAdmin, Rails, Ruby Gems, Mongrel and Ruby Dev environment. |
163 | 1 | Umit Uzun | During the installation of the packages, when MySQL is installed, it will prompt you to create a password. Make sure you remember it. You will need it later to log in to the phpMyAdmin. To make simplicity you can set all passwords to “redmine”. |
164 | 1 | Umit Uzun | |
165 | 1 | Umit Uzun | 2.Create a new directory for Redmine. I put mine in /opt/redmine. And download last version of Redmine in it with wget command line downloader and extract it by issuing: |
166 | 1 | Umit Uzun | > sudo mkdir /opt/redmine |
167 | 1 | Umit Uzun | > sudo cd /opt/redmine |
168 | 1 | Umit Uzun | > sudo wget http://rubyforge.org/frs/download.php/66633/redmine-0.8.6.tar.gz |
169 | 1 | Umit Uzun | > tar -xvf redmine-0.8.6.tar.gz |
170 | 1 | Umit Uzun | |
171 | 1 | Umit Uzun | *Database Setup:* |
172 | 1 | Umit Uzun | |
173 | 1 | Umit Uzun | 1.Now it’s time to create an empty database for Redmine. As you may have noticed, we installed phpMyAdmin earlier. phpMyAdmin will come in handy now. Head over to http://localhost/phpmyadmin. You should be presented with the phpMyAdmin login screen. |
174 | 1 | Umit Uzun | Type in “root” and the MySQL “password” you created when installing MySQL. |
175 | 1 | Umit Uzun | |
176 | 1 | Umit Uzun | 2.First, click on “Databases” Then, at the bottom of the screen, in the “Create new database” text box create a new database called “redmine” and set “Collation” to “utf8_general_ci”. |
177 | 1 | Umit Uzun | |
178 | 1 | Umit Uzun | 3.Now, go back to the home screen and click on: |
179 | 1 | Umit Uzun | “Privileges” |
180 | 1 | Umit Uzun | “Add a new User” |
181 | 1 | Umit Uzun | Fill out the “Login Information” boxes. Call your user “redmine”. Make sure you remember password you create here. It will be used when you set up the database connection details in Redmine. |
182 | 1 | Umit Uzun | In the “Database for user” section, check “Create database with same name and grant all privileges” and click on the “Go” button. |
183 | 1 | Umit Uzun | |
184 | 1 | Umit Uzun | 4.Log out of phpMyAdmin. |
185 | 1 | Umit Uzun | |
186 | 1 | Umit Uzun | *Redmine Database Connection Configuration:* |
187 | 1 | Umit Uzun | |
188 | 1 | Umit Uzun | 1.It’s time to configure the database connection. If you installed Redmine as I did above, then copy “config/database.yml.example” to “config/database.yml” and edit this file in order to configure your database settings for “production” environment. You’ll find the “database.yml.example” issuing: |
189 | 1 | Umit Uzun | > sudo cd /opt/redmine/redmine-0.8.6/config |
190 | 1 | Umit Uzun | |
191 | 1 | Umit Uzun | 2.So now, assuming you’re in the “/opt/redmine/redmine-0.8.6/config” directory, issue: |
192 | 1 | Umit Uzun | > sudo cp database.yml.example database.yml |
193 | 1 | Umit Uzun | |
194 | 1 | Umit Uzun | 3.Then, open the “database.yml” file, issue: |
195 | 1 | Umit Uzun | > sudo gedit database.yml |
196 | 1 | Umit Uzun | … and edit it as in the example for a MySQL database below: |
197 | 1 | Umit Uzun | |
198 | 1 | Umit Uzun | production: |
199 | 1 | Umit Uzun | adapter: mysql |
200 | 1 | Umit Uzun | socket: /var/run/mysqld/mysqld.sock |
201 | 1 | Umit Uzun | database: redmine |
202 | 1 | Umit Uzun | host: localhost |
203 | 1 | Umit Uzun | username: redmine |
204 | 1 | Umit Uzun | password: [password] |
205 | 1 | Umit Uzun | |
206 | 1 | Umit Uzun | Then save “database.yml” file and exit to the command prompt. |
207 | 1 | Umit Uzun | On Ubuntu the “mysql.sock” is located in /var/run/mysqld/mysqld.sock, as noted in the “config” above. |
208 | 1 | Umit Uzun | (The standard Redmine installation assumes the socket is located in “/opt/redmine/redmine-0.8.6/tmp/mysqld.sock”.) |
209 | 1 | Umit Uzun | |
210 | 1 | Umit Uzun | 4.Create the database structure, by running the following command under the application root directory(I mean “/opt/redmine/redmine-0.8.6”): |
211 | 1 | Umit Uzun | > sudo rake db:migrate RAILS_ENV="production" |
212 | 1 | Umit Uzun | It will create the necessary tables in the redmine database you created earlier and an administrator account. |
213 | 1 | Umit Uzun | |
214 | 1 | Umit Uzun | 5.Insert default configuration data in database, by issuing: |
215 | 1 | Umit Uzun | > sudo rake redmine:load_default_data RAILS_ENV="production" |
216 | 1 | Umit Uzun | (This step is optional but highly recommended, as you can define your own configuration from scratch. It will load default roles, trackers, statuses, work flows and enumerations. While loading default data command prompt wants to given language selection by you.) |
217 | 1 | Umit Uzun | |
218 | 1 | Umit Uzun | *Setting up Permissions:* |
219 | 1 | Umit Uzun | |
220 | 1 | Umit Uzun | 1.The user who runs Redmine must have write permission on the following sub directories: “files”, “log”, “tmp” (create the last one if not present). You probably already have a “tmp” directory in /opt/redmine/redmine-0.8.6, but if you don’t, create one now by issuing: |
221 | 1 | Umit Uzun | > sudo mkdir /opt/redmine/redmine-0.8.6 |
222 | 1 | Umit Uzun | |
223 | 1 | Umit Uzun | 2.If you haven’t created a Redmine user, do it now by issuing: |
224 | 1 | Umit Uzun | > sudo useradd redmine |
225 | 1 | Umit Uzun | |
226 | 1 | Umit Uzun | 3.Now, assuming you run Redmine with a redmine user, from your /opt/redmine/redmine-0.8.6 directory issue: |
227 | 1 | Umit Uzun | > sudo chown -R redmine:redmine files log tmp |
228 | 1 | Umit Uzun | > sudo chmod -R 755 files log tmp |
229 | 1 | Umit Uzun | |
230 | 1 | Umit Uzun | *Testing the Installation:* |
231 | 1 | Umit Uzun | |
232 | 1 | Umit Uzun | 1.It should all be working now. Test the installation by running the WEBrick web server issue: |
233 | 1 | Umit Uzun | > sudo cd /opt/redmine/redmine-0.8.6 |
234 | 1 | Umit Uzun | > sudo ruby script/server -e production |
235 | 1 | Umit Uzun | |
236 | 1 | Umit Uzun | Once WEBrick has started, point your browser to http://localhost:3000/. Or, if you are using a browser on another computer than what you installed Redmine on, point your browser to http://192.168.1.10:3000/ (if that’s the IP address you gave your Redmine server). You should now see the application welcome page. |
237 | 1 | Umit Uzun | |
238 | 1 | Umit Uzun | *Log in:* |
239 | 1 | Umit Uzun | |
240 | 1 | Umit Uzun | 1.Use default administrator account to log in: |
241 | 1 | Umit Uzun | Login : admin |
242 | 1 | Umit Uzun | Password : admin |
243 | 1 | Umit Uzun | |
244 | 1 | Umit Uzun | 2.You can go to Admin & Settings to modify application settings. |
245 | 1 | Umit Uzun | |
246 | 1 | Umit Uzun | *Setting Up Static IP:* |
247 | 1 | Umit Uzun | |
248 | 1 | Umit Uzun | 1.A more easy method for configuring a static IP address is to use your local DHCP server to assign a permanent IP to the VirtualBox OS mac address. That way you will not have to do anything inside VBS. Consult your network administrator. |
249 | 1 | Umit Uzun | |
250 | 1 | Umit Uzun | 2.Or you should learn configuration parameters as given below, and can configure your system to get static IP address: |
251 | 1 | Umit Uzun | The desired IP address |
252 | 1 | Umit Uzun | Network mask and broadcast address |
253 | 1 | Umit Uzun | Gateway address |
254 | 1 | Umit Uzun | Your local DNS server address(es) |
255 | 1 | Umit Uzun | |
256 | 1 | Umit Uzun | *Assigning Host Name and Domain for VirtualBox OS:* |
257 | 1 | Umit Uzun | |
258 | 1 | Umit Uzun | 1.A more easy method for adding your IP address - Host name pair configurations to your DNS server . Consult your network administrator. |
259 | 1 | Umit Uzun | |
260 | 2 | Sam Wilson | h2. Configuring the Passenger Apache module |
261 | 1 | Umit Uzun | |
262 | 2 | Sam Wilson | Passenger is a module for apache2 that allow apache to run ruby on rails applications. Install it thus: |
263 | 2 | Sam Wilson | |
264 | 2 | Sam Wilson | >$ sudo gem install passenger |
265 | 2 | Sam Wilson | |
266 | 2 | Sam Wilson | Then go to the passenger apache2 module installation directory and run @passenger-install-apache2-module@ |
267 | 2 | Sam Wilson | |
268 | 2 | Sam Wilson | > $ cd /var/lib/gems/1.X/gems/passenger-X.X.X/ |
269 | 2 | Sam Wilson | |
270 | 2 | Sam Wilson | > $ sudo bin/passenger-install-apache2-module |
271 | 2 | Sam Wilson | |
272 | 2 | Sam Wilson | Next, configure Apache: |
273 | 2 | Sam Wilson | |
274 | 2 | Sam Wilson | In /etc/apache2/mods-available/passenger.load we will add next line |
275 | 2 | Sam Wilson | |
276 | 2 | Sam Wilson | > LoadModule passenger_module /var/lib/gems/1.X/gems/passenger-X.X.X/ext/apache2/mod_passenger.so |
277 | 2 | Sam Wilson | |
278 | 2 | Sam Wilson | We have to edit the conf of the passenger apache2 module in /etc/apache2/mods-available/passenger.conf |
279 | 2 | Sam Wilson | |
280 | 2 | Sam Wilson | > PassengerRoot /var/lib/gems/1.X/gems/passenger-X.X.X |
281 | 2 | Sam Wilson | > PassengerRuby /usr/bin/ruby1.X |
282 | 2 | Sam Wilson | |
283 | 2 | Sam Wilson | And now we active the module |
284 | 2 | Sam Wilson | |
285 | 2 | Sam Wilson | > $ sudo a2enmod passenger |
286 | 2 | Sam Wilson | |
287 | 2 | Sam Wilson | Apache virtualhost for redmine web app |
288 | 2 | Sam Wilson | |
289 | 2 | Sam Wilson | <pre> |
290 | 2 | Sam Wilson | <VirtualHost *:80> |
291 | 2 | Sam Wilson | ServerName redmine.server.com |
292 | 2 | Sam Wilson | |
293 | 2 | Sam Wilson | DocumentRoot /var/www/redmine/public |
294 | 2 | Sam Wilson | |
295 | 2 | Sam Wilson | ServerAdmin user@server.com |
296 | 2 | Sam Wilson | LogLevel warn |
297 | 2 | Sam Wilson | ErrorLog /var/log/apache2/redmine_error |
298 | 2 | Sam Wilson | CustomLog /var/log/apache2/redmine_access combined |
299 | 2 | Sam Wilson | |
300 | 2 | Sam Wilson | <Directory /var/www/redmine/public> |
301 | 2 | Sam Wilson | Options Indexes FollowSymLinks MultiViews |
302 | 2 | Sam Wilson | AllowOverride None |
303 | 2 | Sam Wilson | Order allow,deny |
304 | 2 | Sam Wilson | allow from all |
305 | 2 | Sam Wilson | </Directory> |
306 | 2 | Sam Wilson | </VirtualHost> |
307 | 2 | Sam Wilson | </pre> |
308 | 2 | Sam Wilson | |
309 | 2 | Sam Wilson | subversion server config in apache |
310 | 2 | Sam Wilson | |
311 | 2 | Sam Wilson | <pre> |
312 | 2 | Sam Wilson | <VirtualHost *:80> |
313 | 2 | Sam Wilson | ServerName svn.server.com |
314 | 2 | Sam Wilson | ServerAdmin user@server.com |
315 | 2 | Sam Wilson | ErrorLog /var/log/apache2/svn_error |
316 | 2 | Sam Wilson | CustomLog /var/log/apache2/svn_access combined |
317 | 2 | Sam Wilson | <Location /project> |
318 | 2 | Sam Wilson | DAV svn |
319 | 2 | Sam Wilson | SVNPath /var/lib/svn/project |
320 | 2 | Sam Wilson | |
321 | 2 | Sam Wilson | AuthType Basic |
322 | 2 | Sam Wilson | AuthName "Trac system for Server projects" |
323 | 2 | Sam Wilson | AuthUserFile "/var/lib/svn/.htpasswd" |
324 | 2 | Sam Wilson | Require valid-user |
325 | 2 | Sam Wilson | <LimitExcept GET PROPFIND OPTIONS REPORT> |
326 | 2 | Sam Wilson | Require valid-user |
327 | 2 | Sam Wilson | </LimitExcept> |
328 | 2 | Sam Wilson | </Location> |
329 | 2 | Sam Wilson | </Virtualhost> |
330 | 2 | Sam Wilson | </pre> |
331 | 2 | Sam Wilson | |
332 | 2 | Sam Wilson | h2. Sendmail Server Configuration: |
333 | 2 | Sam Wilson | |
334 | 1 | Umit Uzun | 1.Before configure the email support of Redmine, we should download sendmail application for Ubuntu, issue: |
335 | 1 | Umit Uzun | > sudo apt-get install sendmail |
336 | 1 | Umit Uzun | > sudo sendmailconfig (Answer Yes to all questions which will be asked you) |
337 | 1 | Umit Uzun | |
338 | 1 | Umit Uzun | 2.It’s time to configure the server connection. Copy “config/email.yml.example” to “config/email.yml” and edit this file in order to configure your database settings for “production” environment. You’ll find the “email.yml.example” issue: |
339 | 1 | Umit Uzun | > sudo cd /opt/redmine/redmine-0.8.6/config |
340 | 1 | Umit Uzun | |
341 | 1 | Umit Uzun | 3.So now, assuming you’re in the “/config” directory, issue: |
342 | 1 | Umit Uzun | > sudo cp email.yml.example email.yml |
343 | 1 | Umit Uzun | |
344 | 1 | Umit Uzun | 4.Then, open the “email.yml” file, issue: |
345 | 1 | Umit Uzun | > sudo gedit email.yml |
346 | 1 | Umit Uzun | … and edit it as in the example for sendmail configuration below: |
347 | 1 | Umit Uzun | |
348 | 1 | Umit Uzun | production: |
349 | 1 | Umit Uzun | delivery_method: :sendmail |
350 | 1 | Umit Uzun | sendmail_settings: |
351 | 1 | Umit Uzun | location: /usr/sbin/sendmail |
352 | 1 | Umit Uzun | arguments: -i -t |
353 | 1 | Umit Uzun | address: smtp.example.net |
354 | 1 | Umit Uzun | port: 25 |
355 | 1 | Umit Uzun | domain: example.net |
356 | 1 | Umit Uzun | authentication: :none |
357 | 1 | Umit Uzun | user_name: redmine@example.net |
358 | 1 | Umit Uzun | password: redmine |
359 | 1 | Umit Uzun | |
360 | 1 | Umit Uzun | Then save “email.yml” file and exit to the command prompt. |
361 | 1 | Umit Uzun | |
362 | 1 | Umit Uzun | 5.It’s time to configure the “environmet.rb” configuration. Open up the “environment.rb” and change “config.action_mailer.perform_deliveries = false” to “config.action_mailer.perform_deliveries = true” then save and close the “environment.rb”. |
363 | 1 | Umit Uzun | |
364 | 1 | Umit Uzun | *Subversion Installation and Configuration:* |
365 | 1 | Umit Uzun | |
366 | 1 | Umit Uzun | 1.Before configure the subversion support of Redmine, we should download subversion application for Ubuntu, issue: |
367 | 1 | Umit Uzun | > sudo apt-get install subversion |
368 | 1 | Umit Uzun | |
369 | 1 | Umit Uzun | 2.If your Redmine can't find the “subversion” command you can help to find by issuing: |
370 | 1 | Umit Uzun | · > sudo cd /opt/redmine/redmine-0.8.6/config |
371 | 1 | Umit Uzun | · > sudo gedit environment.rb |
372 | 1 | Umit Uzun | · Add ENV['PATH'] = "#{ENV['PATH']}:/subversion/path" line in it. |
373 | 1 | Umit Uzun | · Save and close the “environment.rb” |
374 | 1 | Umit Uzun | |
375 | 1 | Umit Uzun | *Start Application Boot Time:* |
376 | 1 | Umit Uzun | |
377 | 1 | Umit Uzun | 1.To automatically start the application on booting your server you need to modify your “crontab”, issue: |
378 | 1 | Umit Uzun | > export EDITOR=gedit |
379 | 1 | Umit Uzun | > crontab -e |
380 | 1 | Umit Uzun | |
381 | 1 | Umit Uzun | 2.Your “crontab” file will be presented. This is the list of programs that start at certain times or at boot. Add the following to the “crontab” (all on one line): |
382 | 1 | Umit Uzun | @reboot cd /opt/redmine/redmine-0.8.6 ; rm -f log/mongrel.pid ; mongrel_rails start -e production -p 3000 -d |
383 | 1 | Umit Uzun | |
384 | 1 | Umit Uzun | *Backup:* |
385 | 1 | Umit Uzun | |
386 | 1 | Umit Uzun | 1.Running backups is always a good idea. Redmine backups should include: |
387 | 1 | Umit Uzun | data (stored in your redmine database) |
388 | 1 | Umit Uzun | /usr/bin/mysqldump -u -p | gzip > /path/to/redmine/backup/db/redmine_`date +%y_%m_%d`.gz |
389 | 1 | Umit Uzun | attachments (stored in the files directory of your Redmine install) |
390 | 1 | Umit Uzun | rsync -a /path/to/redmine/files /path/to/redmine/backup/files |
391 | 1 | Umit Uzun | |
392 | 1 | Umit Uzun | 2.Or you can use bash shell to automate kind of this operation issue: |
393 | 1 | Umit Uzun | > sudo cd /opt/redmine/redmine-0.8.6 |
394 | 1 | Umit Uzun | > sudo mkdir backup |
395 | 1 | Umit Uzun | > sudo mkdir backup/db |
396 | 1 | Umit Uzun | > sudo mkdir backup/files |
397 | 1 | Umit Uzun | > sudo gedit backup/runRedmineBackup.bash |
398 | 1 | Umit Uzun | |
399 | 1 | Umit Uzun | And after opened gedit with “runRedmineBackup.bash” write all commands below: |
400 | 1 | Umit Uzun | |
401 | 1 | Umit Uzun | #!/bin/bash |
402 | 1 | Umit Uzun | data=`date -I` |
403 | 1 | Umit Uzun | mysqldump --user=root --password="redmine" --all-databases | gzip > db/backup-$data.sql.gz |
404 | 1 | Umit Uzun | cd db |
405 | 1 | Umit Uzun | ftp -i -n << EOF |
406 | 1 | Umit Uzun | open ftpserver.example.net |
407 | 1 | Umit Uzun | user username password |
408 | 1 | Umit Uzun | bin |
409 | 1 | Umit Uzun | mput backup-$data.sql.gz |
410 | 1 | Umit Uzun | bye |
411 | 1 | Umit Uzun | EOF |
412 | 1 | Umit Uzun | |
413 | 1 | Umit Uzun | Then save “runRedmineBackup.bash” file and exit to the command prompt. After creation of runRedmineBackup.bash you can add this bash to run continually between specified periods. Issue: |
414 | 1 | Umit Uzun | |
415 | 1 | Umit Uzun | > export EDITOR=gedit |
416 | 1 | Umit Uzun | > crontab -e |
417 | 1 | Umit Uzun | Add 0 0 * * 0 cd /opt/redmine/redmine-0.8.6/backup ; sh runRedmineBackup.bash commands to crontab to backup database weekly. |
418 | 1 | Umit Uzun | |
419 | 1 | Umit Uzun | To work this bush without any permission problem you have to change all of them modes to maxium permission issue: |
420 | 1 | Umit Uzun | |
421 | 1 | Umit Uzun | > sudo chmod -R 777 backup |
422 | 1 | Umit Uzun | > sudo chown -R redmine:redmine backup |
423 | 1 | Umit Uzun | |
424 | 1 | Umit Uzun | That's all. Now we completely installed Redmine our virtual Ubuntu OS and can reach from any machine at our network easily. Congratulations..! |
425 | 1 | Umit Uzun | |
426 | 2 | Sam Wilson | h2. Sources & contributors. |
427 | 2 | Sam Wilson | |
428 | 2 | Sam Wilson | * Ümit Uzun 06/11/2009. |
429 | 2 | Sam Wilson | * Some of the above material comes from Macada's wiki, licenced under the GNU Free Documentation License 1.2. See "Redmine in Ubuntu Jaunty 9.04":http://wiki.ousli.org/index.php/Redmine_in_Ubuntu_Jaunty_9.04 by David 'macada', last modified 2010-02-08, accessed 2010-05-26. |
430 | 2 | Sam Wilson | * Sam Wilson 2010-05-26, formatting changes. |