Modification de Redmine : Installation sous CentOS 6

{{Auteur|Adadov}}

{{Note|titre=Prérequis|texte=Cet article part du principe que vous avez déjà un environnement LAMP qui fonctionne.<br/ >Si ce n'est pas le cas, reportez vous aux documentation permettant l'installation d'Apache et de MySQL avant de vous lancer dans cette installation}}

== Information utilisées ==

{{AlTable
|cols=2|fullwidth=true|row1header=true|class=wikitable|col1width=35%
|Variable|Valeur
|DB Adresse du serveur | localhost
|DB Utilisateur | redmine
|DB Mot de passe | my_password
|Emplacement de redmine | /var/www/redmine
}}

== Installation de mod_passenger ==

Sous CentOS 6, mod_passenger est disponible depuis le repo EPEL.<br />
L'installation se fait donc via yum.

{{LxTerm|user=root|text=yum install httpd mod_passenger}}

== Téléchargement Redmine ==

La version de mod_passenger disponible ne permet pas de faire fonctionner la version 3 de Redmine au moment de l'écriture de cette documentation.<br />
La version utilisée sera donc la 2 dans sa déclinaison la plus récente.

{{LxTerm|user=root|text=wget http://www.redmine.org/releases/redmine-2.6.2.tar.gz
tar xf redmine-2.6.2.tar.gz -C /var/www/
ln -s /var/www/redmine-2.6.2 /var/www/redmine}}

== Installation environnement Ruby ==

Il se peut que les paquets ci dessous soient déjà installés sur votre système, ce sont les prérequis pour l'installation des gem dont dépend redmine.<br />
Si vous avez un doute lancez l'installation, yum ne tentera pas de réinstaller ceux qui le sont déjà

{{LxTerm|user=root|text=yum install mysql-devel ruby-devel ImageMagick-devel bundler}}

Une fois les dépendances installées, il faut installer les gem. Redmine fourni directement le fichier pour utiliser bundler vous n'aurez normalement qu'à attendre qu'il termine.<br />
Bundler est un script ruby qui s'occupe d'installer une liste de gem dans leur version demandée.

{{LxTerm|user=root|text=cd /var/www/redmine
chown -R user .
su - user
bundle install --without development test}}

== Création de la DB MySQL ==

Connectez-vous sur votre serveur MySQL puis copier les lignes suivantes pour créer la base de données.

{{Note|texte=Ne pas oublier de remplacer 'my_password' par un mot de passe de votre choix}}

{{MySQLTerminal|text=CREATE DATABASE redmine CHARACTER SET utf8;
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'my_password';}}

== Configuration Redmine ==

La configuration de Redmine se résume à la configuration de son accès à la base de données.

Commençons par copier le fichier d'exemple, il ne restera plus qu'à modifier les paramètres souhaité pour configurer la connexion.

{{LxTerm|user=root|text=cd config
cp database.yml{.example,}
vim database.yml}}

<syntaxhighlight lang="yaml">
Configuration à venir
</syntaxhighlight>

Une fois la connexion configurée, il ne reste plus qu'à initialiser redmine.

{{LxTerm|user=root|text=rake generate_secret_token
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data}}

Puis ouvrir les accès en écriture sur les dossiers public et temporaires.

{{LxTerm|user=root|text=mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R apache:apache files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets}}

== Configuration Apache ==

La configuration d'apache se fait avec un VirtualHost normal, voici un exemple de ce qui peut être fait :

<syntaxhighlight lang="apache">
  <VirtualHost *:80>
    ServerName redmine.mondomaine.com
    DocumentRoot /var/www/redmine/public
    <Directory /var/www/redmine/public/>
                AllowOverride all
                Order allow,deny
                allow from all
                Options -MultiViews
    </Directory>
    ErrorLog logs/error_redmine.log
    LogLevel warn
    CustomLog logs/access_redmine.log combined
  </VirtualHost>
</syntaxhighlight>

[[Catégorie:Développement]]
[[Catégorie:SysAdmin]]