FrRedmineInstall » History » Revision 28
Revision 27 (Pierre Labrie, 2012-09-21 19:01) → Revision 28/32 (Pierre Labrie, 2012-09-21 20:37)
h1. Installer Redmine facilement
{{>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, RubyGem
* 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 RubyGems exigée|
|current trunk |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 |Rails 3.2.8 |RubyGems <= 1.8|
|2.1.0 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 |Rails 3.2.8 |RubyGems <= 1.8|
|2.0.3 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 |Rails 3.2.6 |RubyGems <= 1.8|
|2.0.2 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 |Rails 3.2.5 |RubyGems <= 1.8|
|2.0.0, 2.0.1 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 |Rails 3.2.3 |RubyGems <= 1.8|
|1.4.x |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7 |Rails 2.3.14 |RubyGems <= 1.8|
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 mysql2@. Si vous rencontrez des problèmes lors de l'installation de cette gem, consultez la "page dédiée de Ruby on Rails":http://wiki.rubyonrails.org/fr/database-support/mysql
** les versions Mysql 4.1 et 4.X supérieurs peuvent poser des problèmes
* PostgreSQL 8 ou plus (8.2 ou plus à partir de Redmine 2.0.0)
** 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
* SQLite 3
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. Depuis la version 1.4.0, Redmine utilise Bundler pour gérer les dépendances de _gems_. Vous devez installer Bundler en premier:
<pre>
gem install bundler
</pre>
Après vous pouvez installer tous les _gems_ requis avec la commande suivante:
<pre>
bundle install --without development test
</pre>
Si ImageMagick n'est pas installé sur votre système, vous pouvez retirer l'installation du _gem rmagick_ avec cette commande:
<pre>
bundle install --without development test rmagick
</pre>
Note concernant l'installation de rmagick sur Windows:
>Au moment d'écrire ces lignes, il se peut que l'installation du @gem rmagick@ fonctionne mal avec la commande @bundle install@ si elle n'est pas déjà installée. Vous pouvez trouver de l'aide "ici":http://www.redmine.org/projects/redmine/wiki/HowTo_install_rmagick_gem_on_Windows
>
Vous pouvez aussi retirer l'installation des adapteurs que vous n'utilisez pas. Par exemple si vous utilisez MySql, vous pouvez retirer les @gems postgresql et sqlite@ avec la commande `bundle install --without development test postgresql sqlite`.
Si vous avez besoin de _gems_ non requis par le noyau Redmine (eg. puma,fcgi), créez un fichier nommé Gemfile.local à la racine de votre répertoire de Redmine et il sera chargé automatiquement au lancement de la commande `bundle install`. Exemple:
<pre>
# Gemfile.local
gem 'puma'
</pre>
3. 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>
4. 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>
5. Générer un secret de session.
* Avec Redmine 1.4.x:
<pre>
rake generate_session_store
</pre>
* Avec Redmine 2.x:
<pre>
rake generate_secret_token
</pre>
6. Créez la structure de base en lançant la commande suivante depuis le répertoire racine de l'application:
<pre>
RAILS_ENV=production rake db:migrate
</pre>
Ceci va créer les tables et le compte administrateur.
Si vous obtenez cette erreur:
<pre>
Rake aborted!
no such file to load -- net/https
</pre>
Vous devez installer libopenssl-ruby1.8 dans Ubuntu avec cette commande: @apt-get install libopenssl-ruby1.8@
7. Insérez les données de la configuration par défaut dans la base en lançant la commande suivante:
<pre>
RAILS_ENV=production rake redmine:load_default_data
</pre>
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:
* Avec Redmine 1.4.x:
<pre>
ruby script/server webrick -e production
</pre>
* Avec Redmine 2.x:
<pre>
ruby script/rails server webrick -e production
</pre>
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
Depuis la version 1.2.0, les configurations de Redmine sont définies dans le fichier @config/configuration.yml@.
Copier le fichier @config/configuration.yml.example@ @config/email.yml.example@ en @config/configuration.yml@ @config/email.yml@ et éditer le fichier pour adapter les paramètres SMTP et surcharger SMTP.
Consulter les exemples de configuration par défaut; le fichier est bien documenté par lui-même et devrait vous guider facilement. [[frRedmineConfigurationEmail|Exemple de configuration de mail]].
Les configurations peuvent être définies par environnements _Rails_(production/development/test).
Ne pas oublier de redémarrer l'application après avoir effectué les modifications
h3. Configuration du serveur SMTP
La configuration du SMTP fait l'objet d'un article distinct. Consulter les exemples de configuration [[frRedmineConfigurationEmail|Exemple de configuration de mail]].
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>
Pour Windows, Robocopy fonctionne efficacement pour les fichiers avec sa fonctionnalité mirroir.
<pre>
Robocopy /path/to/redmine/files /path/to/backup/files /MIR
</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]].