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

Ajout

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

Activation des modules Apache

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

Modifier les fichiers comme indiqué lors de la compilation
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

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

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

Copier le logo dans /srv/redmine/public/images/logo.png
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;"/>
```
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

Arrêter Redmine

Télécharger la nouvelle version

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

Renommer le répertoire actuel
```
cd /srv/
mv redmine redmine.old
```

Décompresser le fichier

tar xvf redmine-4.2.7.tar.gz
mv redmine-4.2.7 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 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

Installer les « gems »

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

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

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.

Fichiers (0)

Mis à jour par Patrice Nadeau il y a plus d'un an · 273 révisions

Projet

Général

Profil

Wiki

Redmine¶

Installation¶

Prérequis¶

MySQL¶

Redmine¶

Ruby¶

Initialisation¶

Test¶

Apache¶

Modules Apache¶

Activation de la configuration¶

Post-installation¶

Personnalisation¶

Ajout d’un logo¶

Plugins¶

Mise à jour¶

Copie de sécurité¶

Dépannage¶

Mot de passe perdu¶

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