FrRedmineInstall » History » Version 3

Version 2 (Fabrice Phung, 2008-12-11 22:50) → Version 3/32 (Fabrice Phung, 2008-12-11 22:53)

h1. Installer Redmine

{{>TOC}}

h2. 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 :
If you checkout the source from the Redmine repository, you can install a specific Rails version on your machine by running:



gem install rails -v=2.1.2

* Une base de données

* MySQL 4.1 ou plus (recommandé)
* PostgreSQL 8
* SQLite 3 (svp lisez ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails)

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

h2. Installation

1. [[Download|Téléchargez]] et extrayez l'archive ou faites un [[CheckingoutRedmine|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@:

<pre>
mkdir tmp
sudo chown -R redmine:redmine files log tmp
sudo chmod -R 755 files log tmp
</pre>

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.

h2. Configuration du serveur SMTP

h3. versions 0.8.x

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

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

h2. 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):

<pre>
# 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
</pre>