Projet

Général

Profil

Actions
Historique

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
  1. Activation des modules Apache
a2enmod ssl
a2enmod perl
a2enmod dav
a2enmod dav_svn
a2enmod dav_fs
a2enmod rewrite
a2enmod headers
  1. Modifier les fichiers comme indiqué lors de la compilation
  2. Changer les droits sur le fichiers de log
chmod 0666 log/production.log
  1. 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 (<%#) :

    ```ruby
 <h1><%= page_header_title %></h1>

    * Ajouter en dessous la ligne 

```ruby
<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 4.0.5 > 5.1.3

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

    sudo systemctl stop apache

  2. Télécharger la nouvelle version

    wget https://www.redmine.org/releases/redmine-5.1.3.tar.gz

  3. Renommer le répertoire actuel

    cd /srv/
sudo mv redmine redmine.old

  4. Décompresser le fichier

    sudo tar xvf redmine-5.1.3.tar.gz
sudo mv redmine-5.1.3 redmine

  5. Copier les anciens fichiers de configurations

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

  6. Refaire la sécurité

    sudo 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
sudo chown wwwrun:www redmine/config.ru
sudo mkdir redmine/tmp/passenger
sudo chown -R wwwrun:www redmine/tmp
sudo chmod 0777 redmine/public/plugin_assets
sudo chmod -R 0777 redmine/files

  7. Installer les « gems »

    cd redmine
bundle config set --local without 'development test'
bundle install

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

    sudo bundle exec rake generate_secret_token
sudo bundle exec rake db:migrate RAILS_ENV=production
sudo bundle exec rake redmine:plugins:migrate RAILS_ENV=production
sudo bundle 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

    sudo systemctl restart apache

  12. Vérifier

    • Administration
      • Informations
      • Plugins
      • Projects
      • Users
      • Roles & permissions
      • Settings
        • Text formating : CommonMark Markdon
    • 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 environ 2 mois · 279 révisions