Redmine

h1. Installer Redmine

{{>TOC}}

h2. Exigences

h3. Système d'exploitation 

Redmine devrait fonctionner sur la plupart des Unix, Linux, Mac et systèmes Windows aussi longtemps que Ruby est disponible sur ces plates-formes.

h3. Ruby, Ruby on Rails, Rack

* Les versions de Ruby on Rails pour une version donnée de Redmine sont les suivantes :

|_. Version de Redmine|_. Versions de Ruby supportées|_. Version de Rails exigée|_. Version de Rails exigée|

|current trunk|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1|

|trunk de r2493 à r2886|ruby 1.8.6, 1.8.7|Rails 2.2.2||

|trunk avant r2493|ruby 1.8.6, 1.8.7|Rails 2.1.2||

|0.9.x|ruby 1.8.6, 1.8.7|Rails 2.3.5|Rack 1.0.1|

|0.8.x|ruby 1.8.6, 1.8.7|Rails 2.1.2||

|0.7.x|ruby 1.8.6|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.3.5 

Installer Rack: 

 gem install rack -v=1.0.1 

Notes:

* *Ruby 1.9 n'est pas supporté.* Vous _devez_ utiliser Ruby 1.8.x comme indiqué au dessus.

* RubyGems 1.3.1 est obligatoire

* Rake 0.8.3 est obligatoire

* Rack 1.0.1  est obligatoire. Si vous n'avez pas la version exacte, la migration de la base de données peut échouer.

h3. Base de données

* MySQL 5.0 ou plus (recommandé)

** Assurez-vous d'avoir installé les liens C pour Ruby qui améliorent considérablement les performances. Vous pouvez les obtenir en exécutant la commande @gem install mysql@. Si vous rencontrez des problèmes lors de l'installation de cette gem, consultez la "page dédiée du du Ruby on Rails":http://wiki.rubyonrails.org/fr/database-support/mysql

** le support de MySQL 5.1 par la gem mysql n'est pas garanti pour le moment

** les versions Mysql 4.1 et 4.X supérieurs peuvent poser des problèmes

* PostgreSQL 8

** Il faut être sûr que le format de date (datestyle) de votre base de données est positionné à "ISO" (paramètre par défaut de Postgres). Vous pouvez la positionner avec la commande: @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@

** Certaines anomalies dans PostgreSQL 8.4.0 et 8.4.1 affectent le comportement de Redmine (#4259, #4314), elles sont corrigées dans PostgreSQL 8.4.2

** Assurez vous d'avoir installé le connecteur PosgreSQL pour Ruby. Vous pouvez le faire en utilisant une des techniques suivantes :

***  @gem install postgres-pr@

***  @gem install pg@ (fonctionne avec une connexion SSL, peut nécessiter les librairies de développement libraries/packages pour votre OS avant la compilation)

**** Ubuntu OS: La librairie de développement peut être installée de la manière suivante (ou similaire): @sudo aptitude install libdbd-pg-ruby1.8@

* SQLite 3 (svp lisez ceci: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails)

h3. Composants optionnels

* binaires pour les gestionnaires de version (SCM, par exemple: @svn@), pour la consultation des dépôts (doivent être disponible dans votre PATH). Voir [[RedmineRepositories]] pour consulter les exigences et comptabilités des différents SCM.

* "RMagick":http://rmagick.rubyforge.org/ (pour activer l'export Gantt dans une image au format png)

* "La bibliothèque Ruby OpenID":http://openidenabled.com/ruby-openid/ (pour activer le support  OpenID) ; seulement sur les versions de développement (trunk) de Redmine / 0.9-dev ; a version 2 ou supérieure est obligatoire.

h2. Installation

1. [[Download|Téléchargez (en)]] et extrayez l'archive ou faites un [[CheckingoutRedmine|checkout (en)]] de Redmine.

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

Pour MySQL:

<pre>

create database redmine character set utf8;

create user 'redmine'@'localhost' identified by 'my_password';

grant all privileges on redmine.* to 'redmine'@'localhost';

</pre>

Pour les versions de MySQL antérieures à la 5.0.2 - passez l'étape 'create user' et optez plutôt pour cette commande :

<pre>

grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';

</pre>

Pour PostgreSQL:

<pre>

CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';

CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

</pre>

3. Copiez @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:

<pre>

production:

  adapter: mysql

  database: redmine

  host: localhost

  username: redmine

  password: my_password

</pre>

Si votre serveur ne fonctionne pas sur le port standard (3306), utiliser plutôt cette configuration:

<pre>

production:

  adapter: mysql

  database: redmine

  host: localhost

  port: 3307

  username: redmine

  password: my_password

</pre>

Exemple pour la base de données PostgreSQL (port par défaut):

<pre>

production:

  adapter: postgresql

  database: <le nom de votre base de données>

  host: <nom de la machine de la DB>

  username: <identifiant postgres>

  password: <mot de passe postgres>

  encoding: utf8

  schema_search_path: <schéma de la base de données> (par défaut - public)

</pre>

4. Générer un secret de session. Il est obligatoire depuis le trunk r2493 ou pour les versions de Redmine version 0.8.7 et supérieure.

Redmine stocke les données de session dans un cookie par défaut, ce qui nécessite une clé secrète. Ceci peut être fait en exécutant:

   RAILS_ENV=production rake config/initializers/session_store.rb

Si vous utilisez une version de Redmine postérieure à r3055, le fichier ci-dessus n'existe plus, il était obsolète sur le r3054. Sur ces versions, exécutez

   rake generate_session_store

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

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

Si vous obtenez l'erreur suivante: 

<pre>

Rake aborted!

no such file to load -- net/https

</pre>

Vous devez installer la librairie libopenssl-ruby1.8 ou équivalente. Sur Ubuntu, exécutez la commande suivante : @sudo aptitude install libopenssl-ruby1.8@

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

8. Paramétrez les permissions

NB: _Les utilisateurs sous Windows doivent sauter cette section._

L'utilisateur qui exécute Redmine doit avoir les permissions en écriture sur les sous-répertoires suivants: @files@, @log@, @tmp@ (créer ce dernier s'il n'est pas présent).

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

<pre>

mkdir tmp public/plugin_assets

sudo chown -R redmine:redmine files log tmp public/plugin_assets

sudo chmod -R 755 files log tmp public/plugin_assets

</pre>

9. Testez l'installation en exécutant le serveur web WEBrick:

  ruby script/server webrick -e production

Une fois WEBrick démarré, saisir l'URL dans votre navigateur http://localhost:3000/. Vous devriez voir apparaître la page de bienvenue de Redmine.

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

Copier le fichier @config/email.yml.example@ en @config/email.yml@ et éditer le fichier pour adapter les paramètres SMTP.

Consulter les exemples de configuration [[frRedmineConfigurationEmail|Exemple de configuration de mail]].

Ne pas oublier de redémarrer l'application après avoir effectué les modifications 

h3. Sauvegarde

Une sauvegarde Redmine inclue les éléments suivants:

* Les données (stockées dans votre base de données Redmine)

* Les fichiers (Stockés dans le répertoire @files@ de votre installation de Redmine)

Voici un simple script shell que vous pouvez utiliser quotidiennement pour sauvegarder vos données (en supposant que vous utilisez une base de données mysql)

<pre>

# Base de données

/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz

# Fichiers

rsync -a /path/to/redmine/files /path/to/backup/files

</pre>

h2. Notes à propos de l'installation sur Windows

Récupérer et installer  rubyinstaller depuis le site http://rubyforge.org. Depuis le menu démarrer, exécuter la console @cmd@ 

Depuis la console les commandes suivantes :

<pre>

RAILS_ENV=production rake db:migrate

RAILS_ENV=production rake redmine:load_default_data

</pre>

Doivent être changées par les commandes suivantes :

<pre>

set RAILS_ENV=production

rake db:migrate

rake redmine:load_default_data

</pre>  

Vous pouvez avoir besoin d'installer mysql gem, avec la commande

<pre>

gem install mysql

</pre>

Et dans certains cas, il peut être nécessaire de copier le fichier  libmysql.dll file dans votre répertoire ruby/bin.

Toutes les librairies ne semblent pas fonctionner, récupérer sur  http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll

h3. Les Problèmes avec MySQL 5.1 et Rails 2.2+

Avec la dernière version de MySQL, vous pouvez rencontrer plusieurs erreurs, telles que : "!!! The bundled mysql.rb driver has been removed from Ruby 2.2" et quand vous effectuez la commande "gem install mysql" vous pouvez aussi rencontrer plusieurs erreurs. Une solution possible :

Télécharger le fichier DLL depuis le projet InstantRails:

http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll

Copier ce fichier dans le répertoire  \Ruby\bin directory et essayer d'effectuer une nouvelle fois votre commande rake.

h2. Alternative à l'installation manuelle 

Certains utilisateurs préfèrent sauter l'installation manuelle en utilisant un package pré-installé depuis la page de téléchargement [[Download#Third-party-Redmine-bundles|third-party Redmine bundles]].