====== Installation de Redmine =======

[[https://www.gandi.net/hebergement/simple?language=ruby&db=mysql|{{:fr:tutorials:simple:ruby.png?nolink|}}]]{{:fr:tutorials:simple:plus.png?nolink|}}[[https://www.gandi.net/hebergement/simple?language=ruby&db=mysql|{{:fr:tutorials:simple:mysql.png?nolink|}}]]{{:fr:tutorials:simple:slash.png?nolink|}}[[https://www.gandi.net/hebergement/simple?language=ruby&db=mysql|{{:fr:tutorials:simple:pgsql.png?nolink|}}]]

Dans un premier temps, il est nécessaire de récupérer la dernière version de Redmine : http://www.redmine.org/projects/redmine/wiki/Download

<code>
$ wget http://www.redmine.org/releases/redmine-2.5.1.tar.gz
$ tar -xzvf redmine-2.5.1.tar.gz
$ mv redmine-2.5.1 redmine
$ rm redmine-2.5.1.tar.gz
$ cd redmine
</code>

===== Préparer le fichier .gitignore =====

Enlevez les lignes suivantes du fichier .gitignore:

<code>
/config/database.yml
/config/initializers/session_store.rb
/config/initializers/secret_token.rb
/public/plugin_assets
/Gemfile.lock
/Gemfile.local
/db/schema.rb
</code>

===== Configuration de la base de données =====

<code>
$ cp config/database.yml.example config/database.yml
</code>

On configure la base de données :

**Pour MySQL :**

<code>
--
file : config/database.yml
--

production:
  adapter: mysql2
  database: redmine
  socket: /srv/run/mysqld/mysqld.sock
  username: root
  password: ""
  encoding: utf8
  pool: 5
</code>

**Pour PostgreSQL :**

<code>
--
file : config/database.yml
--

[...]
production:
  adapter: postgresql
  template: template0
  database: redmine
  host: localhost
  port: 5432
  username: hosting-db
  password: 
  encoding: unicode
  pool: 5
[...]
</code>

===== Installer les dépendances =====

On installe les dépendances et génère le fichier 'Gemfile.lock' grâce à Bundler :

<note>
Redmine utilise Rmagick pour la manipulation des images et l'export PDF et PNG, installez le paquet 'libmagickwand-dev' pour que les dépendances soient satisfaites lors de la génération du fichier Gemfile.lock, ou bien utilisez l'option 'bundle install --without rmagick'
</note>

<code>
$ bundle install
</code>

On génère un jeton secret :

<code>
$ bundle exec rake generate_secret_token
</code>

===== Push sur l'instance =====

On initialise le repo et on push le code sur l'instance :

<code>
$ git init 
$ git add .
$ git commit -am 'First install'
$ git remote add gandi git+ssh://<login>@git.dc<dc_id>.gpaas.net/default.git
$ git push gandi master
</code>

===== Déployer =====

Le déploiement se fait simplement avec la commande :

<code>
$ ssh <login>@git.dc<dc_id>.gpaas.net 'deploy default.git'
</code>

Pour finir, activez la console de l'instance, puis connectez vous dessus et executez la commande suivante pour initialiser la base de donnée :

<code>
$ cd web/vhosts/default/
$ bundle exec rake db:setup
</code>

===== Premier accès =====

Il est souvent utile d'executer une commande supplémentaire pour créer certaines options Redmine par défaut, comme la langue de l'interface.

Toujours dans le répertoire `web/vhosts/default/`
<code>
$ bundle exec rake redmine:load_default_data
</code>

<note> Choisissez "fr" pour avoir l'interface en français, "en" pour de l'Anglais et "es" pour de l'Espagnol</note>

Pour accéder à votre installation de Redmine, ouvrez l'URL par défaut qui est affichée dans la fiche de l'instance dans votre compte Gandi.

Par défaut, vous pourrez vous connecter en utilisant les identifiants suivants: 
  
  * Login: admin
  * Password: admin

<note>N'oubliez pas de changer le mot de passe à votre première connexion</note>

Vous pouvez maintenant vous servir de votre Redmine pour gérer vos projets.