Actions

Historique

Wiki » Historique » Révision 277

« Précédent | Révision 277/279 (diff) | Suivant »
Patrice Nadeau, 2024-11-09 11:20

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 (<%#) :

```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;"/>

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

Arrêter Redmine
```
sudo systemctl stop apache
```

Télécharger la nouvelle version

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

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

Décompresser le fichier

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

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

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

Installer les « gems »

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

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 environ 2 mois · 277 révisions

Projet

Général

Profil

Wiki

Wiki » Historique » Révision 277

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