HowTo Install Redmine 212 in Ubuntu 1210 and Apache Passenger » History » Version 14
Yovav Cohen Tene, 2013-07-13 21:02
1 | 1 | Julian Perelli | h1. HowTo Install Redmine 212 in Ubuntu 1210 and Apache Passenger |
---|---|---|---|
2 | |||
3 | Inspired in "HowTo Install Redmine 210 on Debian Squeeze with Apache Passenger", from this same wiki, so meta-kudos, to the original authors. |
||
4 | |||
5 | h2. Assumptions |
||
6 | |||
7 | * We will be using redmine.example.com; so every time you see this below, replace it by your own domain |
||
8 | 3 | Julian Perelli | * For this to work maybe you shold edit /etc/hosts file adding a line "127.0.0.1 redmine.example.com" |
9 | 1 | Julian Perelli | * If you are behind a proxy, you could do export http_proxy="http://proxy.domain.tld:port" and the installation should work ok. |
10 | |||
11 | h2. Warming up |
||
12 | |||
13 | We will first need to install basic packages: |
||
14 | <pre> |
||
15 | 5 | ian stoddart | apt-get install ruby rubygems libruby libapache2-mod-passenger ruby-dev |
16 | 1 | Julian Perelli | </pre> |
17 | Download the latest version of Redmine (2.1.2 in our case) and untar it, then move it to /usr/local/share |
||
18 | <pre> |
||
19 | 4 | Julian Perelli | cd /usr/local/share/ |
20 | 2 | Julian Perelli | wget http://rubyforge.org/frs/download.php/76495/redmine-2.1.2.tar.gz |
21 | 1 | Julian Perelli | tar -xzvf redmine-2.1.2.tar.gz |
22 | 7 | ian stoddart | ln -s /usr/local/share/redmine-2.1.2 /usr/local/share/redmine |
23 | 1 | Julian Perelli | chown -R root:root /usr/local/share/redmine-2.1.2 |
24 | </pre> |
||
25 | |||
26 | 2 | Julian Perelli | Install development libraries for MySQL and Imagick: |
27 | 1 | Julian Perelli | <pre> |
28 | 2 | Julian Perelli | apt-get install libmysqlclient-dev libmagickcore-dev libmagickwand-dev (install shitload of packages) |
29 | 1 | Julian Perelli | </pre> |
30 | |||
31 | h2. Running the Gem stuff |
||
32 | |||
33 | Install Bundler (removing useless module, which would otherwise create dependencies): |
||
34 | <pre> |
||
35 | gem install bundler |
||
36 | cd /usr/local/share/redmine/ |
||
37 | 3 | Julian Perelli | bundle install --without development test postgresql sqlite |
38 | 1 | Julian Perelli | </pre> |
39 | |||
40 | 6 | ian stoddart | h2. Creating the database |
41 | |||
42 | On a new installation you need to create the database and a user for redmine. |
||
43 | Open a mysql command prompt: |
||
44 | <pre> |
||
45 | mysql -u root -p |
||
46 | </pre> |
||
47 | |||
48 | At the mysql prompt enter the mysql commands: |
||
49 | <pre> |
||
50 | create user 'redmine' identified by 'redmine'; |
||
51 | set password for 'redmine'@'localhost' = password('my_password'); |
||
52 | 11 | Boaz Rymland | grant all on redmine.* to 'redmine'@'localhost'; |
53 | 6 | ian stoddart | create database redmine; |
54 | quit; |
||
55 | </pre> |
||
56 | |||
57 | 1 | Julian Perelli | h2. Configuration |
58 | |||
59 | 12 | Boaz Rymland | Copy /usr/local/share/redmine/config/database.yml.example to /usr/local/share/redmine/config/database.yml and edit this file in order to configure your database settings for "production" environment. |
60 | 1 | Julian Perelli | Example for a MySQL database using ruby1.8 or jruby: |
61 | <pre> |
||
62 | production: |
||
63 | 10 | Roland Giesler | adapter: mysql2 (note: For Rails < 3.1 use mysql instead of mysql2) |
64 | 1 | Julian Perelli | database: redmine |
65 | host: localhost |
||
66 | username: redmine |
||
67 | password: my_password |
||
68 | </pre> |
||
69 | |||
70 | Generate a session store secret: |
||
71 | <pre> |
||
72 | 3 | Julian Perelli | rake generate_secret_token |
73 | 1 | Julian Perelli | </pre> |
74 | |||
75 | Generate the database structure: |
||
76 | <pre> |
||
77 | 3 | Julian Perelli | RAILS_ENV=production rake db:migrate |
78 | 1 | Julian Perelli | </pre> |
79 | |||
80 | Generate default configuration data: |
||
81 | <pre> |
||
82 | 3 | Julian Perelli | RAILS_ENV=production rake redmine:load_default_data |
83 | 1 | Julian Perelli | </pre> |
84 | (using “es” for Spanish language in terminal prompt) |
||
85 | |||
86 | 13 | Boaz Rymland | h4. Database encryption |
87 | 1 | Julian Perelli | |
88 | 13 | Boaz Rymland | If you want to encrypt your redmine database do as follows: |
89 | |||
90 | # Copy the default config file @/usr/local/share/redmine/config/configuration.yml.example@ to @/usr/local/share/redmine/config/configuration.yml@ |
||
91 | # Edit configuration.yml and create a cipher key there for the environment you've used so thus far - production. Be sure to read the comment in this file. They are very detailed and there for you. |
||
92 | # Run: <pre> |
||
93 | 3 | Julian Perelli | rake db:encrypt RAILS_ENV=production |
94 | 1 | Julian Perelli | </pre> |
95 | |||
96 | h2. Apache |
||
97 | |||
98 | Setup Apache’s VirtualHost config |
||
99 | |||
100 | <pre> |
||
101 | # 8080 in this case is because we use a reverse proxy before Apache. Otherwise simply use "*:80" |
||
102 | |||
103 | <VirtualHost *:8080> |
||
104 | ServerName redmine.example.com |
||
105 | DocumentRoot /usr/local/share/redmine/public |
||
106 | <Directory /usr/local/share/redmine/public> |
||
107 | AllowOverride all |
||
108 | Options -MultiViews |
||
109 | </Directory> |
||
110 | </VirtualHost> |
||
111 | </pre> |
||
112 | |||
113 | 3 | Julian Perelli | Once you enable this virtual host (a2ensite redmine.example.com) and reload Apache (apache2ctl graceful), you should see your site running on http://redmine.example.com. |
114 | 1 | Julian Perelli | |
115 | The default login/password is admin/admin (don't forget to change this). |
||
116 | |||
117 | h2. Sources of inspiration |
||
118 | |||
119 | We used the following resources as a starting point. Thanks to their respective authors. |
||
120 | |||
121 | * http://madpropellerhead.com/random/20100820-installing-redmine-on-debian-with-apache (outdated, for Lenny) |
||
122 | * http://www.redmine.org/projects/redmine/wiki/RedmineInstall |
||
123 | * http://hodza.net/2012/03/15/howto-install-redmine-on-debian-6-squeeze-ruby-on-rails-apache2-passenger/ |
||
124 | * http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_Debian_with_Ruby-on-Rails_and_Apache2-Passenger |