Blog Inforeseau.com – GNU Linux, technologie et autres geekeries

Faire tourner Redmine sur fedora 11 avec une installation rubyonrails un peu trop récente

Lire le POST en entier avant d’opérer une modification.
Ce POST est principalement un mémo pour moi relativement à la mise en place de Redmine sur un serveur Apache configuré avec les dernières version de ruby, rails, et rubygems + apache mod_gems.

Suite du cas d’école d’installation rubyonrails évoqué ici :
http://blog.inforeseau.com/2011/03/installer-ruby-rails-sur-fedora-11

Si vous avez suivi le POST précédent, vous avez entre autre une version trop récente de rubygems (gem) sur votre machine.
Si on se réfère aux spécifications de redmine : http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Requirements , on constate qu’il faut au maximum gem (rubygems) en version 1.5.0. Heureusement, gem est très bien fait et nous permet de « downgrader » (descendre en version) sa propre installation.

Pour cela, on va dans une console et on va descendre en version 1.3.7 (compatible avec Redmine donc) :
[bash]gem update –system 1.3.7[/bash]

Après quelques instants, vous vous retrouvez avec la version 1.3.7 de gem. Simple et efficace.

Il en est de même avec rails qui est en version 3.0.5, pour lequel on va réinstaller la version recommandée, la 2.3.5.
[bash]gem install rails -v=2.3.5[/bash]

Ceci va nous installer rails en version 2.3.5 (en plus de la 3.0.5), ainsi que rack-1.0.1 (la version demandée par Redmine). L’avantage étant avec gem que plusieurs versions peuvent cohabiter, et c’est dans les applications même que l’on va définir l’interpréteur (handler) exact que l’on souhaite utiliser, ainsi que le chemin (PATH) vers celui ci.

Il nous faut ensuite Rake (en version 0.8.3 minimum) :
[bash]gem insall rake[/bash]
(à ce jour c’est la 0.8.7 qui s’installe).

Il nous faut en suite I18n en version 0.4.2 (attention i minuscule dans la commande, contrairement à ce qu’on peut voir dans la documentationt de redmine) :
[bash]gem install i18n -v=0.4.2[/bash]

On a maintenant l’ensemble des éléments dans les versions désirées (pour la base de donnée on va utiliser le serveur MySql qui est déjà installé par yum en version 5.1.47 sur cette Fedora 11).

Il nous faut le connecteur mysql pour ruby que l’on installe depuis yum :
[bash]yum install ruby-mysql[/bash]

On va récupérer la dernière version de Redmine via SVN :
[bash]svn co http://redmine.rubyforge.org/svn/branches/1.1-stable redmine-1.1[/bash]
(Si la commande n’est pas reconnue, installer subversion : yum install svn – svn co = subversion checkout)

Sur le serveur mysql (via phpmyadmin par exemple) exécuter les commandes SQL suivantes qui vont créer la base de donnée pour redmine :
[sql]create database redmine character set utf8;
create user ‘redmine’@’localhost’ identified by ‘my_password’;
grant all privileges on redmine.* to ‘redmine’@’localhost’;[/sql]

Dans le dossier « Config » de redmine-1.1 récupéré par SVN on va configurer la connexion à la base de donnée :
[bash]cp database.yml.example database.yml[/bash]

et éditer le fichier database.yml en y mettant les informations suivantes :
[bash]production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: my_password
[/bash]
(vous devez adapter le my_password au mot de passe de votre choix, comme dans la commande SQL!)

Générer un « session_store » depuis le même dossier :
[bash]rake generate_session_store[/bash]

Création de la structure de base de donnée :
[bash]RAILS_ENV=production rake db:migrate[/bash]

Si vous obtenez une erreur mysql du style :
[bash]
!!! The bundled mysql.rb driver has been removed from Rails 2.2. Please install the mysql gem and try again: gem install mysql.
rake aborted!
no such file to load — mysql
[/bash]

On installe alors les sources de mysql sur la fedora :
[bash]yum install mysql-devel[/bash]

Puis on installe le module mysql pour gem :
[bash]gem install mysql[/bash]

Et on relance la commande pour créer la structure de base de donnée :
[bash]RAILS_ENV=production rake db:migrate[/bash]
La base de donnée doit être remplie ! :D

On charge les données de configuration par défaut dans la base (facultatif mais recommandé pour ne pas démarrer de rien !) :
[bash]RAILS_ENV=production rake redmine:load_default_data[/bash]

On ajoute un utilisateur redmin au système pour permettre de faire tourner l’application sur son compte :
[bash]adduser redmine[/bash]

On affecte les bons droits sur les dossiers concernés :
[bash]mkdir tmp public/plugin_assets
sudo chown -R redmine:redmine files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets[/bash]

On lance un test de l’application afin de vérifier que ça tourne :
[bash]ruby script/server webrick -e production[/bash]
(qui démarre sur le port 3000, si vous avez un firewall n’oubliez pas d’ouvrir le port 3000 pour pouvoir afficher le résultat).

Vous pouvez consulter le site/application en ouvrant votre navigateur à l’adresse http://localhost:3000 si vous avez mis ça en local, ou http://votre_serveur:3000 si c’est installé sur votre_serveur.

Oh joie ça tourne ;) Connectez vous avec les identifiants admin / admin pour tester le site.

Pour configurer les logs, réferez vous à l’information très claire présente ici :
http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Logger-Configuration

Il en est de même pour la configuration du smtp (qui se résume à éditer un fichier de config):
http://www.redmine.org/projects/redmine/wiki/RedmineInstall#SMTP-server-Configuration

Lisez le document en lien jusqu’en bas pour la mise en place des sauvegardes etc.

Ensuite on va mettre en place Redmin en « passenger » dans apache :
On installe un éléments manquant avec gem :
[bash]gem install RedCloth[/bash]

Puis il faut suivre la documentation à partir de « Configure Apache to run Redmine » juste après avoir défini le chemin de votre installation :
[bash]export REDMINE_HOME=dossier_dans_lequel_se_situe_votre_redmine[/bash]
La documentation à suivre est ici :
http://www.redmine.org/projects/redmine/wiki/Redmine+Apache+Passenger_InstallOnRedHat
(oui ce document est utilisable pour une installation depuis zero également!)

Après ça votre application Redmine devrait tourner comme un charme ;)

Sources :
http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Requirements
http://www.redmine.org/projects/redmine/wiki/Redmine+Apache+Passenger_InstallOnRedHat

Tags: apache, downgrade, fedora 11, installation, passenger, redmine, rubyonrails