FrRedmineInstall » History » Version 4

« Previous - Version 4/32 (diff) - Next » - Current version
Fabrice Phung, 2008-12-11 22:54


Installer Redmine

Prérequis

  • Ruby & Ruby on Rails:
version Redmine version Rails requise
trunk Rails 2.1.2
0.8.x Rails 2.1.2
0.7.x Rails 2.0.2

Les distributions officielles comprennent la version appropriée de Rails dans leur répertoire vendor. Aucune action n'est donc demandée. Si vous faites un checkout des sources depuis le dépôt Redmine, vous pouvez installer une version spécifique de Rails sur votre machine en lançant :

gem install rails -v=2.1.2
  • Une base de données
  • 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)

Notez que Rails a quelques problèmes de compatibilité avec Ruby 1.8.7. La version de ruby supportée est 1.8.6.

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. Paramétrez les permissions

NB: Les utilisateurs sous Windows doivent sauter cette section.

L'utilisateur faisant tourner Redmine doit avoir la permission d'écriture sur les sous-répertoires suivants: files, log, tmp (créez ce dernier s'il n'est pas présent).

A supposer que vous fassiez tourner Redmine avec un utilisateur@redmine@:

mkdir tmp
sudo chown -R redmine:redmine files log tmp
sudo chmod -R 755 files log tmp

7. 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.

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

  • identifiant: admin
  • mot de passe: admin

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

Configuration du serveur SMTP

versions 0.8.x

Copiez config/email.yml.example vers config/email.yml et éditez ce fichier pour ajuster vos paramètres SMTP.

versions 0.7.x

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