Gestionnaire de projets en ligne RedMine

RedMine est un gestionnaire de projets en ligne basé sur le langage de programmation Ruby.

Site officiel : http://www.redmine.org

• Une demo en live est disponible à cette adresse : http://demo.redmine.org/
• Il est l'équivalent de Trac http://trac.edgewall.org/.

Sous une “debian-like”, taper :

# apt-get install ruby

Ou root est l'utilisateur qui à tous les privilèges.

$ mysql -u root -p

> CREATE DATABASE 'redmine' DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
 
> GRANT ALL PRIVILEGES ON redmine.* TO 'user_redmine'@'localhost'
  -> IDENTIFIED BY 'password_redmine' WITH GRANT OPTION;

Rendez vous à cette adresse pour trouver la dernière version http://rubyforge.org/frs/?group_id=1850

Vous pouvez aussi utiliser le SVN, taper cette commande dans le dossier ou vous souhaitez télécharger les sources :

$ svn checkout svn://rubyforge.org/var/svn/redmine/trunk

Voila, votre système est près à exécuter le code Ruby de RedMine.

• Éditer le fichier d'accès à la base MySQL :

$ cp config/database.yml.example config/database.yml
$ vi config/database.yml

• Adapter la partie ”production:“ :

production:
  adapter: mysql
  database: redmine
  host: localhost
  username: user_redmine
  password: password_redmine

• À la racine des sources RedMine, taper :

$ rake db:migrate RAILS_ENV="production"
$ rake load_default_data RAILS_ENV="production"

Si vous avez l'erreur :

rake aborted!
No such file or directory - /tmp/mysql.sock
(See full trace by running task with --trace)

C'est que ruby ne trouve pas votre socket mysqld dans le dossier /tmp, exécutez par exemple :

# ln -s /var/run/mysqld/mysqld.sock /tmp/mysql.sock

• Éditer le fichier ”config/environment.rb“ :

Pour une configuration en local, sans authentification

        config.action_mailer.smtp_settings = {
                :address => "localhost",
                :port => 25,
                :domain => "domaine.com",
                :authentication => :none,
                :user_name => "",
                :password => "",
        }
 
        config.action_mailer.perform_deliveries = true

Pour une configuration sur un serveur distant avec authentification

        config.action_mailer.smtp_settings = {
                :address => "smtp.domaine.com",
                :port => 25,
                :domain => "domaine.com",
                :authentication => :plain,
                :user_name => "user@domaine.com",
                :password => "password_user",
        }
 
        config.action_mailer.perform_deliveries = true

RedMine fonctionne avec un daemon qui écoute sur le port 3000 par défaut.

• Pour lancer le daemon, taper :

ruby /dossier/sources/redmine/script/server -e production

• Vérifier que le port 3000 est bien à l'écoute par RedMine :

# netstat -ntlp | grep 3000

Out :

tcp        0      0 0.0.0.0:3000            0.0.0.0:*               LISTEN     6197/ruby

• Pour faire écouter le daemon sur un autre port :

Editez le fichier vendor/rails/railties/lib/commands/servers/webrick.rb, et changez le numéro de port.

Afin de pouvoir vous connecter à votre Interface RedMine par le port 80, mais que celui-ci est déjà occupé par Apache.
Nous allons configurer un Vhost par nom, qui redirigera les requetes HTTP vers le port 3000.

• Activer le mod Proxy :

# a2moden proxy
# a2moden proxy_html

• Ajouter le Vhost RedMine (/etc/apache2/site-enable/000-default) :

<VirtualHost *:80>
        ServerName      vhost-redmine.domaine.com
        ServerAlias     redmine.domaine.com
        DocumentRoot /dossier
        LogLevel debug
        ErrorLog /dossier/log/error.log
        CustomLog /dossier/log/access.log combined
 
        ProxyRequests Off
        ProxyRequests On
        ProxyVia On
        <Proxy *>
                Order deny,allow
                Allow from all
        </Proxy>
 
        ProxyPass / http://localhost:3000/
        ProxyPassReverse / http://localhost:3000/
 
        <Location />
                Order allow,deny
                Allow from all
        </Location>
 
</VirtualHost>