Projet

Général

Profil

Actions
Historique

Wiki » Historique » Révision 214

« Précédent | Révision 214/279 (diff) | Suivant »
Patrice Nadeau, 2018-03-24 16:08

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 :

{{lastupdated_at}} {{lastupdated_by}}

Installation

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

  • openSUSE 13.2
  • Redmine 3.1.1

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

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;

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.

Ruby

Installation des gems de Ruby


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

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

Serveur web

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

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

Apache

Transformation pour utilisation avec Apache.

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

Information provenant de :

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

Module Passenger 


cd /srv/redmine
gem install passenger
passenger-install-apache2-module.ruby2.1

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

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

Post-installation

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

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

Personnalisation

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

Plugins

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

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

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

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

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

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

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

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/

Réinstaller le module « Passenger » (voir plus haut)

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

Copie de sécurité

Copie de sécurité

Dépannage

Mot de passe perdu

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

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

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

Mis à jour par Patrice Nadeau il y a presque 7 ans · 214 révisions