HowTo Install Redmine 231 On Ubuntu 1204 with git and Redmine Git Hosting plugin » History » Revision 10
Revision 9 (Yovav Cohen Tene, 2013-07-13 22:03) → Revision 10/19 (Yovav Cohen Tene, 2013-07-13 22:04)
h1. HowTo Install Redmine 231 On Ubuntu 1204 clean installation with git and Redmine Git Hosting plugin
h2. Installing LAMP
<pre>
apt-get update && apt-get upgrade -y
apt-get install tasksel
tasksel
</pre>
choose LAMP server and choose a password for MySQL root account
h2. Installing Packages
<pre>
apt-get install ruby rubygems libruby libapache2-mod-passenger ruby-dev libmysqlclient-dev libmagickcore-dev libmagickwand-dev git git-core -y
</pre>
Reboot your machine!!!
h2. Installing Redmine
<pre>
cd /tmp
wget rubyforge.org/frs/download.php/76933/redmine-2.3.1.tar.gz
tar -xzvf redmine-2.3.1.tar.gz
mv redmine-2.3.1 /usr/local/share/redmine-2.3.1
ln -s /usr/local/share/redmine-2.3.1 /usr/local/share/redmine
chown -R root:root /usr/local/share/redmine-2.3.1
gem install bundler
cd /usr/local/share/redmine/
bundle install --without development test postgresql sqlite
</pre>
h2 .Setting up Redmine user and database in MySQL
<pre>
mysql -u root -p
</pre>
<pre>
CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
</pre>
h2. Configuration
h3. File premissions
<pre>
useradd redmine
mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R redmine:redmine files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets
</pre>
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.
Example for a MySQL database using ruby1.8 or jruby:
<pre>
production:
adapter: mysql2 (note: For Rails < 3.1 use mysql instead of mysql2)
database: redmine
host: localhost
username: redmine
password: my_password
</pre>
Generate a session store secret:
<pre>
rake generate_secret_token
</pre>
Generate the database structure:
<pre>
RAILS_ENV=production rake db:migrate
</pre>
Generate default configuration data:
<pre>
RAILS_ENV=production rake redmine:load_default_data
</pre>
(using “es” for Spanish language in terminal prompt)
h4. Database encryption
If you want to encrypt your redmine database do as follows:
# Copy the default config file @/usr/local/share/redmine/config/configuration.yml.example@ to @/usr/local/share/redmine/config/configuration.yml@
# 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.
# Run: <pre>
rake db:encrypt RAILS_ENV=production
</pre>
h2. Apache
Setup Apache’s VirtualHost config
<pre>
vim /etc/apache2/sites-available/redmine.example.com
<pre>
# 8080 in this case is because we use a reverse proxy before Apache. Otherwise simply use "*:80"
<VirtualHost *:8080>
ServerName redmine.example.com
DocumentRoot /usr/local/share/redmine/public
<Directory /usr/local/share/redmine/public>
AllowOverride all
Options -MultiViews
</Directory>
</VirtualHost>
</pre>
*TODO:: The redmine installation works but users editing return an error*
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.
The default login/password is admin/admin (don't forget to change this).
h2. Sources of inspiration
We used the following resources as a starting point. Thanks to their respective authors.
* http://madpropellerhead.com/random/20100820-installing-redmine-on-debian-with-apache (outdated, for Lenny)
* http://www.redmine.org/projects/redmine/wiki/RedmineInstall
* http://hodza.net/2012/03/15/howto-install-redmine-on-debian-6-squeeze-ruby-on-rails-apache2-passenger/
* http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_Debian_with_Ruby-on-Rails_and_Apache2-Passenger