Installation de Redmine sur une Ubuntu 12.04

L’objet de cet article est l’installation de redmine sur un serveur Ubuntu 12.04. Ce dernier sera intégré avec notre Active Directory et nous verrons quelques plugins et thèmes supplémentaires que j’apprécie.

Ce post est inspiré de cet article de blog.

Pour cette installation, nous allons utiliser une installation vierge d’Ubuntu 12.04, configurée en serveur LAMP. Personnellement j’héberge cette machine au sein d’une infra VMWare et j’aime bien créer des volumes logiques par exemple pour stocker la base de données et le répertoire redmine (j’écrirai un petit tuto concernant les LVM bientôt).

Installation de Redmine

Se rendre dans le répertoire ou nous allons installer Redmine:

# cd /usr/share

Télécharger la dernière version stable et l’extraire:

# wget http://rubyforge.org/frs/download.php/77023/redmine-2.3.2.tar.gz
# tar -xzvf redmine-2.3.2.tar.gz
# rm redmine-2.3.2.tar.gz
# mv redmine-2.3.2.tar.gz redmine

Ajustons les droits sur ce répertoire:

# chown -R root:root /usr/share/redmine
# chown www-data /usr/share/redmine/config/environment.rb

Création de la base de donnée:

# mysql -u root -p
mysql> CREATE DATABASE db_redmine character SET utf8;
mysql> CREATE user ‘redmine’@’localhost’ IDENTIFIED BY ‘votre_mot_de_passe’;
mysql> GRANT ALL privileges ON db_redmine.* TO ‘redmine’@’localhost’;
mysql> exit

Maintenant nous allons configurer le fichier redmine pour réaliser la connexion avec la base de données:

# cp redmine/config/database.yml.example redmine/config/database.yml

Edition du fichier database.yml

production:
adapter: mysql2
database: db_redmine
host: localhost
username: redmine
password: « votre_mot_de_passe »
encoding: utf8

Installation des librairies nécessaires:

# apt-get install ruby1.9.3 libmysqlclient-dev libmagickcore-dev libmagickwand-dev

Puis les gem nécessaire:

# gem install bundler

Ensuite dans le répertoire redmine, nous allons installer les gem nécessaire à MySQL et sans Postgre et SQLite.

# bundle install --without development test postgresql sqlite

Configuration de Redmine:

# rake generate_secret_token
# RAILS_ENV=production rake db:migrate
# RAILS_ENV=production rake redmine:load_default_data

La dernière commande vous invite à sélectionner le langage.

Il faut encore faire quelques modifications de droits:

# mkdir public/plugin_assets
# chown -R www-data:www-data files log tmp public/plugin_assets
# chmod -R 755 files log tmp public/plugin_assets

Nous pouvons ensuite tester si la configuration de notre redmine fonctionne en lançant le serveur

# ruby script/rails server webrick -e production

Et en essayant d’y accèder via http://@IP_du_serveur:3000

Installation de « Passenger »:

# gem install passenger

Avant d’installer le module « passenger », installation des dépendances:

# apt-get install libcurl4-openssl-dev libssl-dev apache2-prefork-dev libapr1-dev libaprutil1-dev

Nous pouvons installer le module « passenger » pour Apache:

# passenger-install-apache2-module

Création du loader:

# vi /etc/apache2/mods-available/passenger.load
LoadModule passenger_module /var/lib/gems/1.9.1/gems/passenger-4.0.17/buildout/apache2/mod_passenger.so

Puis créer un lien pour activer le module:

# ln -s /etc/apache2/mods-available/passenger.load /etc/apache2/mods-enabled/passenger.load

Création d’un fichier de configuration pour « Passenger »:

# vi /etc/apache2/mods-available/passenger.conf
PassengerRoot /var/lib/gems/1.9.1/gems/passenger-4.0.17
PassengerRuby /usr/bin/ruby1.9.1

Nous pouvons configurer apache pour notre nouveau site (exemple de vhost que je n’ai pas retenu):

# vi /etc/apache2/sites-available/mysite
<VirtualHost *:80>
ServerName my_domain.com
DocumentRoot /var/www/redmine
ServerAdmin user@example.com
LogLevel warn
ErrorLog /var/log/apache2/redmine_error
CustomLog /var/log/apache2/redmine_access combined
<Directory /var/www/redmine>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
RailsBaseURI /redmine
PassengerResolveSymlinksInDocumentRoot on
</Directory>
</VirtualHost>

Configuration d’Apache pour configurer « Passenger »:

# vi /etc/apache2/apache2.conf

Ajouter les lignes suivantes:

Include /etc/apache2/mods-available/passenger.conf

Activer le site créer avec la commande a2ensite et vérifier que le module « Passenger » est bien actif a2enmod passenger.

Redémarrer apache: service apache2 restart

Vous devriez pouvoir accéder à votre site configurer avec votre vHost.

Le compte par défaut sous Redmine est admin@admin. Je vous conseille de vérifier dans administration/informations que vous respectez bien les prérequis.

Personnalisation du thème

Hormis si vous êtes fan de la simplicité, le thème par défaut de Redmine ne doit pas vous faire rêver. Ma préférence va pour le thème de Pixel Cookers.

Pour l’installation petit rappel, télécharger la dernière version ici.

Décompresser le fichier dans ../public/themes puis redémarrer Redmine avec la commande habituelle: service apache2 restart

Vous devriez pouvoir modifier le thème en vous rendant dans le menu: Administration/Configuration/Affichage.

Les plugins que j’utilise

Pour l’installation de ces derniers je vous renvois vers la page de la doc Redmine (RTFM comme on dit)

 

 

 

Mots-clés : , ,

kiolul