Project

General

Profile

Actions

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 :

Installation

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

  • openSUSE Leap 15.3
  • Redmine 3.4.6

Prérequis

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

Les logiciels supplémentaires suivants :

zypper install libmysqlclient-devel ruby ruby-devel ImageMagick ImageMagick-devel libxml2-devel libxslt-devel libmariadb-devl git gcc make gcc-c++

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 données.
  • 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.4)

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

Le « gem » rmagick ne fonctionne pas avec ImageMagick 2.7 (https://github.com/rmagick/rmagick/pull/299)

cd redmine
gem install bundler
# Install sans rmagick
bundle.ruby2.5 install --local without development test rmagick

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

Test

Le serveur inclus webrick n'est pas conçu pour être utilisé en production.

Ouvrir dans le pare-feu le port TCP 3000 (ou simplement desactiver temporairement le parefeu) :

yast firewall services add tcpport=3000 zone=EXT

Se rendre au server.tld:3000

Apache

Information provenant de :

Modules Apache

TODO A revoir avec l'utilisation du rpm rubygem-passenger

Apache 2.4

  1. Ajout

    zypper install libcurl-devel apache2-devel apache2-mod_perl perl-Apache-DBI subversion-server rubygem-passenger
    
  2. Activation des modules Apache

    a2enmod ssl
    a2enmod perl
    a2enmod dav
    a2enmod dav_svn
    a2enmod dav_fs
    a2enmod rewrite
    a2enmod headers
    
  3. Modifier les fichiers comme indiqué lors de la compilation

  4. Changer les droits sur le fichiers de log

    chmod 0666 log/production.log
    
  5. 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

<VirtualHost *:80>
    # 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

    <Directory "/srv/redmine/public">
        Options Indexes ExecCGI FollowSymLinks
        AllowOverride None
        Order deny,allow
        Require all granted
    </Directory>
</VirtualHost>

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 apparaît 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

  1. Copier le logo dans /srv/redmine/public/images/logo.png
  2. Modifier le fichier /srv/redmine/app/views/layouts/base.html.erb

    • Sous la ligne

    Si on ne veux plus afficher le titre, la mettre en commentaire (<%#) :

        <h1><%= page_header_title %></h1>
    
    • Ajouter en dessous la ligne
    <img src="<%= Redmine::Utils.relative_url_root %>/images/logo.png" style="top-margin: 15px; left-margin: 15px;"/>
    
  3. Relancer Redmine

Plugins

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

Source de problème lors de mise à jour si incompatibilité (ce qui arrive a chaque mise à niveau...).

Mise à jour

Version 3.4.6 -> 4.0.5

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

  1. Arrêter Redmine

  2. Télécharger la nouvelle version

    wget http://www.redmine.org/releases/redmine-4.2.7.tar.gz
    
  3. Renommer le répertoire actuel

    cd /srv/
    mv redmine redmine.old
    
  4. Décompresser le fichier

    tar xvf redmine-4.2.7.tar.gz
    mv redmine-4.2.7 redmine
    
  5. 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
    
  6. 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 utilisé 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
    
  7. Installer les « gems »

    cd redmine
    bundle.ruby2.5 install --without development test
    
  8. Mise à jour (base de donnés, « plugins ») et ménage :

    bundle.ruby2.5 exec rake generate_secret_token
    bundle.ruby2.5 exec rake db:migrate RAILS_ENV=production
    bundle.ruby2.5 exec rake redmine:plugins:migrate RAILS_ENV=production
    bundle.ruby2.5 exec rake tmp:cache:clear RAILS_ENV=production
    
  9. 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/
    
  10. Réinstaller le module « Passenger » (voir plus haut)

  11. Relancer Redmine

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

Updated by Patrice Nadeau 11 days ago · 273 revisions