h1. Redmine

Logiciel de gestion de projets, sources, bugs et timeline.
Contient un module de Wiki, de fichiers.
Supporte aussi les systèmes de version de fichier (Git, SVN entre autre).
Disponible à http://www.redmine.org/projects/redmine/wiki/Download

De base, ne fonctionne pas avec Apache

Sa principale difficulté d’installation est sa dépendance à Ruby.
Voir aussi :

• http://bitnami.com/stack/redmine
• http://www.turnkeylinux.org/redmine

{{lastupdated_at}} {{lastupdated_by}}

---

• Contenu
• Installation sur le serveur :
• Activer le module dans le ou les projets voulus
• Arrêter Redmine
• Renommer le répertoire actuel
• Télécharger la nouvelle version
• Décompresser le fichier
• Copier les anciens fichiers de configurations
• Refaire la sécurité
• Ne copier que les « plugins » qui ne sont pas fournis par la nouvelle version de Redmine
• Installer les « gems »
• Mise à jour (base de donnés, « plugins ») et ménage :
• Remettre le logo (facultatif)
• Relancer Redmine
• Vérifier
  • Administration
    • Informations
    • Plugins
    • Projects
    • Users
    • Roles & permissions
  • Essayer d'attacher un fichier à un projet
  • Essayer d’accéder au calendrier d'un projet

h2. Installation

Ce guide documente une installation GNU/Linux avec les version suivantes :

• openSUSE 13.2
• Redmine 3.1.1

h3. Prérequis

Un serveur LAMP(Linux, Apache, MySQL, PHP) openSUSE fonctionnel.

Les logiciels supplémentaires suivants :

zypper install libmysqlclient-devel ruby-2.1 ruby21-devel rubygem-bundler  rubygem-mysql2 rubygem-pg ImageMagick ImageMagick-devel libxml2-devel libxslt-devel git gcc make

h3. MySQL

Création de la base de donnés.
Substituer les items suivants à votre choix :

• redmine : Usager pour la base de donnés.
• password : Mot de passe de la base de donnees.
• db : Nom de la base de donnés.

Lancer MySQL :

mysql -u root -p

Commandes MySQL :

create database db character set utf8;
create user 'redmine'@'localhost' identified by 'password';
grant all privileges on db.* to 'redmine'@'localhost';
commit;
quit;

h3. Redmine

L’installation sera faite dans \srv\redmine (exemple avec la version 3.1)

cd /srv/
svn co http://svn.redmine.org/redmine/branches/3.1-stable redmine
cd redmine
cp config/database.yml.example config/database.yml
cp config/configuration.yml.example config/configuration.yml
mkdir public/plugin_assets

Si un usager MySQL autre que root ou mot de passe diffèrent est utilisé :
Éditer le fichier config/database.yml, section Production et modifier les lignes :

• username
• password

Éditer le fichier config/configuration.yml et modifier la configuration SMTP.

h3. Ruby

Installation des gems de Ruby

cd redmine
gem install bundler
gem install activerecord-mysql2-adapter
bundle install --without development test

h3. Initialisation

Création de la cryptographie, de la structure et des donnés de base :

cd /srv/redmine
rake generate_secret_token
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data

h3. Serveur web

Redmine peux être utiliser avec le serveur inclus webrick (port 3000) ou Apache (port 80).

h4. Webrick

Ouvrir dans le pare-feu le port TCP 3000 :

yast firewall services add tcpport=3000 zone=EXT

Lancer le serveur web

cd /srv/redmine
ruby bin/rails server webrick -e production

h5. Transformation en daemon

Le script original vient de http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_openSUSE
Copier le script dans le fichier /etc/init.d/redmine

Le modifier de la manière suivante :

• REDMINE_BIN=/srv/redmine/current/script/rails
• REDMINE_USER=user
• Corriger le «typo» à la ligne 73 : $REDMI-NE_BIN -> $REDMINE_BIN
• Dans la section stop, après la ligne killproc, ajouter rm $PIDFILE

Rendre le fichier exécutable, l’ajouter aux services SUSE et l’exécuter au démarrage :

chmod 0755 /etc/init.d/redmine
cp -s /etc/init.d/redmine /usr/bin/rcredmine
chkconfig -a redmine

h4. Apache

Transformation pour utilisation avec Apache.

• N'utilise pas webrick
• Accessible par le port 80 au lieu de 3000

Information provenant de :

• web :
  ** http://martin-denizet.com/install-redmine-2-5-x-with-git-and-subversion-on-debian-with-apache2-rvm-and-passenger/
  ** http://www.redmine.org/projects/redmine/wiki/HowTo_configure_Apache_to_run_Redmine
  ** http://www.redmine.org/boards/2/topics/43924
• livre : "Mastering Redmine":http://shop.oreilly.com/product/9781849519144.do

h3. Modules Apache

Apache 2.4

Ajout

zypper install libcurl-devel apache2-devel apache2-mod_perl perl-Apache-DBI subversion-server

Activation des modules Apache

a2enmod ssl
a2enmod perl
a2enmod dav
a2enmod dav_svn
a2enmod dav_fs
a2enmod rewrite
a2enmod headers

h3. Modules Passenger

cd /srv/redmine
gem install passenger
passenger-install-apache2-module2.0

Changer les droits sur le fichiers de log

chmod 0666 log/production.log

Créer le dossier des fichiers temporaire

Par défaut les fichiers sont dans /tmp mais se font enlever par le « clean-up » journalier et doivent être refait avec un reload d'Apache

mkdir tmp/passenger

h3. Activation de la configuration

Créer le fichier /etc/apache2/conf.d/passenger.conf et ajouter la configuration inscrite par l'installation.

Ajouter dans /etc/apache2/vhosts.d/vhost.conf

    # La ligne suivante est nécessaire seulement si plusieurs site web son présents sur le même serveur.
    ServerName redmine.yourdomain.com
    DocumentRoot /srv/redmine/public

    RailsEnv production
    PassengerAppRoot /srv/redmine
    PassengerTempDir /srv/redmine/tmp/passenger

    
        Options Indexes ExecCGI FollowSymLinks
        AllowOverride None
        Order deny,allow
        Require all granted
    

Relancer Apache :

systemctl reload apache2

h2. Post-installation

A partir d’un navigateur web, se brancher à :

• Webrick : http://server:3000
• Apache : http://server

Utiliser l’usager admin avec le mot de passe admin.
Vérifier la configuration dans Administration, Information.

Si un avertissement apparait pour l’écriture des répertoires, changer les droits :

Semble être nécessaire que pour Apache

cd /srv/redmine
chmod -R 0777 public/plugin_assets
chmod -R 0777 files
chown -R wwwrun:www tmp
# Pour la macro "thumbnails" du wiki, le plugin "redmine_people" nécessite au moins 0775
chmod -R 0777 tmp/thumbnails

h2. Personnalisation

h3. Ajout d’un logo

Cette étape sera à refaire lors d'une mise à jour.

Les informations viennent de : http://www.redmine.org/projects/redmine/wiki/Howto_add_a_logo_to_your_Redmine_banner

Copier le logo dans /srv/redmine/public/images/logo.png

Modifier le fichier /srv/redmine/app/views/layouts/base.html.erb

• Si on ne veux plus afficher le titre, mettre en commentaire :

• Ajouter en dessous la ligne

Relancer Redmine

h3. Plugins

Modules supplémentaires pour ajouter des fonctionnalités à Redmine.

Source de problème lors de mise à jour si incompatibilité.

h4. Redmine Rouge

Permet le support de langage supplémentaire pour l'affichage de la syntaxe d'un code source.

"Langage supporté":http://rouge.jayferd.us/demo

https://github.com/ngyuki/redmine_rouge

cd /srv/redmine/plugins
# Enlever l'ancienne version (si présente)
rm -r redmine_rouge
# Télécharger la nouvelle avec git
git clone https://github.com/ngyuki/redmine_rouge.git
cd ..
bundle.ruby2.1 install

Relancer redmine

h4. Code Highlight

http://www.redmine.org/plugins/codehightlight_button

Bouton permettant de sélectionner du code et d'activer la syntaxe selon un langage.

Installation

cd /srv/redmine/plugins
git clone https://github.com/mediatainment/redmine_codebutton.git
cd ..
rake redmine:plugins
rake redmine:plugins:migrate RAILS_ENV=production
# Relancer Redmine
rcredmine restart

Ajout des langages supplémentaires supportées par le « plug-in » Redmine Rouge. Voir "ici":https://github.com/mediatainment/redmine_codebutton/issues/2
Éditer le fichier /srv/redmine/plugins/redmine_codebutton/assets/javascripts/wiki-codehighlight.js

• Ajouter les langages voulus dans la variable codeRayLanguages

Relancer Apache

systemctl reload apache2.service

h4. Like Button

Bouton pour Facebook, Google+ et Twitter

http://www.redmine.org/plugins/like

Installation

cd /srv/redmine/plugins
svn svn co http://svn.s-andy.com/like-button like

Relancer Redmine

h4. Wiki Extensions

Voir #52

Ajoute des macros au Wiki de Redmine

La dernière version est disponible à https://bitbucket.org/haru_iida/redmine_wiki_extensions/downloads

Parmi les macros ajoutées:

• Emoticons : Un bouton apparait pour ajouter des « smilley » qui seront afficher en graphique
• !{{lastupdated_by}} : affiche le nom de la dernière personne à avoir modifier la page
• !{{lastupdated_at}} : affiche la date de la dernière modification de la page
• Liste complète à http://www.r-labs.org/projects/r-labs/wiki/Wiki_Extensions_en

Des « smilley » non voulus peuvent apparaîtrent dans les wiki déjà en place. L'utilisation de seras alors nécessaire.

Étapes :

Installation sur le serveur :¶

cd /srv/redmine/
wget https://bitbucket.org/haru_iida/redmine_wiki_extensions/downloads/redmine_wiki_extensions-0.8.0.zip
unzip redmine_wiki_extensions-0.8.0.zip -d plugins/
rake redmine:plugins:migrate RAILS_ENV=production
systemctl reload apache2.service
rm -r redmine_wiki_extensions-0.8.0.zip

Activer le module dans le ou les projets voulus¶

h2. Retrait d'un plug-in

cd /srv/redmine
rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production
rm -r plugins/plugin_name
rake db:migrate_plugins RAILS_ENV=production

h2. Mise à jour

Version 3.3.3 -> 3.4.2

S’assurer d'avoir les dernières versions des plugins ET qu'il sont compatibles avec la version de Redmine à installer.

Disponible à http://www.redmine.org/projects/redmine/wiki/Download

Mise à jour de Redmine à partir d'une version stable

http://www.redmine.org/projects/redmine/wiki/RedmineUpgrade

Arrêter Redmine¶

Renommer le répertoire actuel¶

cd /srv/
mv redmine redmine.old

Télécharger la nouvelle version¶

wget http://www.redmine.org/releases/redmine-3.4.2.tar.gz

Décompresser le fichier¶

tar xvf redmine-3.4.2.tar.gz
mv redmine-3.4.2 redmine

Copier les anciens fichiers de configurations¶

cp redmine.old/config/configuration.yml redmine/config
cp redmine.old/config/database.yml redmine/config
cp -r redmine.old/files redmine

Refaire la sécurité¶

chown -R root:root redmine
# Les commandes suivantes sont nécessaire seulement si Apache est utilisé
# Le même owner que config.ru doit être utiliser pour plusieurs dossier
chown wwwrun:www redmine/config.ru
mkdir redmine/tmp/passenger
chown -R wwwrun:www redmine/tmp
chmod 0777 redmine/public/plugin_assets
chmod -R 0777 redmine/files

Ne copier que les « plugins » qui ne sont pas fournis par la nouvelle version de Redmine¶

cp -r redmine.old/plugins/* redmine/plugins

Installer les « gems »¶

cd redmine
bundle.ruby2.1 install --without development test

Mise à jour (base de donnés, « plugins ») et ménage :¶

bundle.ruby2.1 exec rake generate_secret_token
bundle.ruby2.1 exec rake db:migrate RAILS_ENV=production
bundle.ruby2.1 exec rake redmine:plugins:migrate RAILS_ENV=production
bundle.ruby2.1 exec rake tmp:cache:clear tmp:sessions:clear

Remettre le logo (facultatif)¶

cd ..
cp redmine.old/public/images/logo.png redmine/public/images/
cp redmine.old/app/views/layouts/base.html.erb redmine/app/views/layouts/

Relancer Redmine¶

Vérifier¶

Administration¶

Informations¶

Plugins¶

Projects¶

Users¶

Roles & permissions¶

Essayer d'attacher un fichier à un projet¶

Essayer d’accéder au calendrier d'un projet¶

h2. Copie de sécurité

Copie de sécurité

h2. Dépannage

h3. Mot de passe perdu

Le mot de passe admin par défaut est en hash Sha1 : da3174755c5e82a436b6c7ff87c873ee50d6654b et est admin.

h3. Le service tombe « DEAD » à chaque fois (webrick)

Effacer le fichier /srv/redmine/tmp/pids/server.pid.