Redmine est un gestionnaire de projet, plus particulièrement avancé dans la gestion des tâches. Il gêre les dépots SVN, GIT ou CVS et peut être interfacé avec Mylyn sous Eclipse ! Il est très complet et néanmoins impressionnant par sa claretée.

Pour installer Redmine, il vous faut une installation Ruby On Rails. Nous allons utiliser PostgreSQL comme base de données.

Téléchargement et extraction de Redmine

Dans un premier temps, télécharger puis dé-compressez la dernière version de Redmine. Vous pouvez vérifier l’arrivée d’une nouvelle version à cette adresse.

wget http://rubyforge.org/frs/download.php/56909/redmine-0.8.4.tar.gz
tar xzf redmine-0.8.4.tar.gz

Pour la base de données…

Il faut préparer la base de données à accueillir Redmine. Pour cela, créez une nouvelle base ou un nouveau schéma (ou pas), un nouvel utilisateur (ou pas). Bref, munissez vous de tous les éléments neccessaires à la connexion à PostgreSQL.

Une fois fait, il faut modifier le fichier de configuration de la base de données. Nous allons utiliser le fichier d’exemple:

cp config/database.yml.example config/database.yml

Maintenant, modifiez le fichier config/database.yml comme ceci:

production:
  adapter: postgresql
  database: DATABASE_NAME
  host: HOSTNAME
  username: USERNAME
  password: PASSWORD
  encoding: utf8
  schema_search_path: public

Maintenant, il faut installer le support de PosgreSQL par Ruby. Pour cela:

/etc/ruby/bin/gem install postgres

Ensuite, nous allons construire la base de données:

/etc/ruby/bin/rake db:migrate RAILS_ENV="production"
/etc/ruby/bin/rake redmine:load_default_data RAILS_ENV="production"

Note: Il vous sera demander de sélectionner la langue de Redmine. Tapez “fr”.

Droits d’écriture

L’utilisateur exécutant Redmine doit avoir les droits d’écriture du tmp, log et files. Nous allons lui donner ces droits là (ici, l’utilisateur est www-data) :

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

Configuration de l’envoi de mails

Il faut configurer le serveur SMTP d’envoi de mail de Redmine. Dans le répertoire de Redmine, exécutez:

cp config/email.yml.example config/email.yml

Ensuite, éditez le fichier config/email.yml pour y ajouter la configuration du SMTP. Pour utiliser un serveur SMTP distant, utilisez:

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.example.net
    port: 25
    domain: example.net
    authentication: :login
    user_name: user@example.net
    password: user_password

Note: Il semblerait qu’il ne soit pas possible d’utiliser sendmail ou un serveur d’envoi tel que ssmtp…

Tester l’installation

Afin de tester l’installation, nous allons utiliser le serveur Webrick joint avec Redmine. Pour cela, dans le répertoire de Redmine, lancez:

script/server webrick -e production

Si aucune erreur n’apparaît, le serveur est démarré sur le port 3000. Autorisez le port 3000 en tcp input/output et testez : http://ip_serveur:3000/
En toute logique, Redmine apparaît. Si ce n’est pas le cas, vérifiez vos configurations depuis le début et votre/vos firewall(s).

Utilisation avec Apache2

Pour ne pas rester avec le serveur Webrick, nous vous proposons d’utiliser mod_rails (i.e. Passenger) avec Apache2.