Installer Redmine¶

• Table of contents
• Installer Redmine
  • Prérequis
  • Installation
  • Configuration du serveur SMTP
  • Sauvegarde

Prérequis¶

• Ruby on Rails 2.0.2
• Une base de données (voir les compatibilités plus bas)

Optionnel:

• binaires SVN (>= 1.3), pour la consultation des dépôts (doivent être atteignables dans votre PATH)
• RMagick (export Gantt dans une image png)

Bases de données supportées:

• MySQL 4 ou ultiérieur (recommandé)
• PostgreSQL 8 (non testé intensivement sur 8.3)
• SQLite 3 (lire ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails)

Installation¶

1. Téléchargez et extrayez l'archive ou faites un checkout de Redmine.

2. Créez une base de données vide nommée par exemple redmine.

Pour MySQL:

create database redmine character set utf8;

3. Coiez config/database.yml.example dans config/database.yml et éditez ce fichier pour configurer vos paramètres de base dans l'environnement "production".

Exemple pour une base de données MySQL:

production:
    adapter: mysql
    database: redmine
    host: localhost
    username: bduser
    password: bdpasswd

4. Créez la structure de base en lançant la commande suivante depuis le répertoire racine de l'application:

rake db:migrate RAILS_ENV="production"

Ceci va créer les tables et le compte administrateur.

5. Insérez les données de la configuration par défaut dans la base en lançant la commande suivante:

rake redmine:load_default_data RAILS_ENV="production"

Cette étape est optionnelle mais fortement recommandée, sauf si vous définissez votre propre configuration depuis rien. Elle va charger les rôles par défaut, les trackers, statuts, workflows et énumérations.

6. Testez l'installation en lançant le serveur web WEBrick:

ruby script/server -e production

Une fois WEBrick démarré, dirigez votre navigateur sur http://localhost:3000/. Vous devriez voir maintenant la page de bienvenue de l'application.

7. Utilisez le compte administrateur par défaut pour vous connecter:

• identifiant: admin
• mot de passe: admin

8. Vous pouvez aller sur Administration pour modifier la configuration de l'application.

Configuration du serveur SMTP¶

Dans config/environment.rb, vous pouvez configurer les paramètres de votre serveur SMTP:

• config.action_mailer.smtp_settings: configuration du serveur SMTP
• config.action_mailer.perform_deliveries: mettre à false pour désactiver l'envoi de messages

N'oubliez pas de redémarrer l'application après toute modification.

Sauvegarde¶

Les sauvegardes Redmine devraient inclure:

• les données (stockées dans votre base de données redmine)
• pièces jointes (stockées dans le répertoire files de votre installation Redmine)

Voici un simple script shell pouvant être utilisé pour des sauvegardes quotidiennes (à supposer que vous utilisez une base mysql):

# Base
/usr/bin/mysqldump -u <utilisateur> -p <motdepasse> <base_redmine> | gzip > /chemin/vers/sauvegarde/db/redmine_`date +%y_%m_%d`.gz

# Pièces jointes
rsync -a /chemin/vers/redmine/files /chemin/vers/sauvegarde/files