Redmine - Historique des versions

Ddevleeschauwer : /* Configuration d'Apache */

2015-02-23T10:53:03Z

‎Configuration d'Apache

Ddevleeschauwer : /* Configuration */

2015-02-10T20:33:18Z

‎Configuration

Ddevleeschauwer : /* Authentification */

2015-02-10T20:33:03Z

‎Authentification

Ddevleeschauwer le 14 novembre 2013 à 19:29

2013-11-14T19:29:52Z

Ddevleeschauwer : Page créée avec « {{introduction | Cette page va vous permettre de mettre en place Redmine utilisant une base de données PostgreSQL.}} == Infrastructure == === PostgreSQL === [[Fichier:... »

2013-04-08T13:05:55Z

Page créée avec « {{introduction | Cette page va vous permettre de mettre en place Redmine utilisant une base de données PostgreSQL.}} == Infrastructure == === PostgreSQL === [[Fichier:... »

Nouvelle page

{{introduction | Cette page va vous permettre de mettre en place Redmine utilisant une base de données PostgreSQL.}}

== Infrastructure ==

=== PostgreSQL ===
[[Fichier:redmine-postgresql.jpg|center]]
=== PgPool ===
[[Fichier:redmine-watchdog.jpg|center]]
=== LDAP-Mail ===
[[Fichier:redmine-ldap-mail.jpg|center]]
 

== Utilisateur Redmine ==

Pour des raisons de sécurité, il est préférable de créer un utilisateur spécifique à Redmine pour utiliser la base :

{{Console root | addgroup redmine [root@ordi ~]# adduser redmine --no-create-home --ingroup redmine }}
 

== Ruby ==

Pour installer ruby, utilisez la commande suivante :

{{Console root | apt-get install build-essential ruby1.8-dev rubygems rake}}
 

== PostgreSQL ==

Pour l'installation, référencer vous à la page sur [[PostgreSQL]]

=== Création d'un user ===

Pour créer un utilisateur, il faut d'abord se connecter en tant que ''postgres''

{{Console | sudo -s -u postgres}}

 
On peux maintenant créer l'utilisateur qui va être propriétaire de la database :

{{Console | createuser redmine --no-superuser --no-createdb --no-createrole --login --pwprompt --encrypted}} 

=== Création de la database ===

Création de la database :
createdb --owner=redmine --encoding=utf-8 redmine
 

== Redmine ==
=== Rack ===
Pour utiliser Redmine, il faut installer les dépendances suivantes :
gem install rack -v=1.1.3 gem install rails -v=2.3.14
 
=== Récupérer les sources ===
{{Console | wget http://rubyforge.org/frs/download.php/75910/redmine-1.3.2.tar.gz [user@ordi ~]$ tar -zxvf redmine-1.3.2.tar.gz}}
 
=== Configuration ===
{{Console | cd redmine-1.3.*}}
 
==== Configuration de la DB ====
{{Console |cp config/database.yml.example config/database.yml}}
 

==== Edition du fichier config/database.yml ====
<pre>
production:
adapter: postgresql
database: redmine
host: IP
username: redmine
password: password
encoding: utf8
schema_search_path: public
</pre>
 
==== Création d'une session store ====
{{Console | rake generate_session_store}}
 
==== Création de la structure de la base ====
<pre>RAILS_ENV=production rake db:migrate</pre>
 

==== Insertion des données par défaut ====
<pre>RAILS_ENV=production rake redmine:load_default_data</pre>
 
{{Note | La langue sera demandée, indiquez donc fr pour du français}}
 

=== Finir l'installation ===

==== Copie vers /opt ====

Il nous faut tout d'abord créer le dossier {{File | /opt/redmine}} pour y copier les sources :
{{Console root | mkdir /opt/redmine [root@ordi ~]# cp -r redmine 1.3.0/* /opt/redmine}}
 
Un dossier {{File | tmp}} et {{File | public/plugin_assets}} doit être présent par convention dans les sources (si ce n'est pas déjà le cas) :
{{Console root | mkdir -p /opt/redmine/tmp /opt/redmine/public/plugin_assets}}
 
Un dossier pids doit être présent également pour permettre à mongrel de démarrer :
{{Console root | mkdir /opt/redmine/tmp/pids}}
 

==== Définition des droits ====
L'utilisateur qui lance Redmine doit avoir les droits d'écriture sur les dossiers files, log, tmp et public/plugin_assets des sources. Nous allons prendre ici l'utilisateur redmine précédement créé :
{{Console root | cd /opt/redmine [root@ordi ~]# chown -R redmine:redmine files log tmp public/plugin_assets [root@ordi ~]# chmod -R 755 files log tmp public/plugin_assets}}
 
==== Nettoyage ====
On peut maintenant supprimer les sources que nous avions téléchargée :
{{Console | rm -rf redmine-1.3.*}}
 

== Apache ==
=== Installation d'Apache ===
Pour que Redmine fonctionne correctement, assurez vous d'avoir installé Apache ainsi que les composants suivants :
{{Console root | apt-get install libapr1 apache2 apache2.2-common apache2-utils apache2-prefork-dev libapr1-dev libaprutil1-dev}}
 
=== Passenger ===
Il nous faut également installer Passenger :
{{Console root | gem install passenger}}
 
==== Installation du module ====
Une fois passenger installé, on doit installer le module pour apache :
{{Console root | ruby passenger-install-apache2-module}}
 
{{Avertissement | Si vous obtenez l'erreur «ruby: No such file or directory – passenger-install-apache2-module (LoadError)», il vous faudra repérer la version de passenger lors de son installation un peu plus haut (pour l'exemple, version 3.0.8) et lancer le script suivant }}
 
{{Console root | /var/lib/gems/1.8/gems/passenger-3.0.11/bin/passenger-install-apache2-module}}
 
Selectionner l'option 1 "The Apache 2 module will be installed for you"
S'il manque "Curl development headers with SSL support" , installez
{{Console root | apt-get install libcurl4-openssl-dev }}
 
Relancez le script

==== Configuration d'Apache ====
* Créez/éditer le fichier /etc/apache2/mods-available/passenger.load pour y indiquer le chemin du module :
LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-3.0.11/ext/apache2/mod_passenger.so

* Créez (ou éditez) ensuite le fichier /etc/apache2/mods-available/passenger.conf pour y adapter le chemin de Passenger et Ruby:
PassengerRoot /var/lib/gems/1.8/gems/passenger-3.0.11
PassengerRuby /usr/bin/ruby1.8

* Activer les modules d'apache necessaire :
{{Console root | a2enmod passenger [root@ordi ~]# a2enmod rewrite}}

* Configuration URI

''Faites une copie de votre fichier de configuration (par soucis de sauvegarde) :''
{{Console root | cp /etc/apache2/sites-available/default /etc/apache2/sites-available/default.save}}
 
''Puis éditez /etc/apache2/sites-available/default pour y mettre le contenu suivant :''
<syntaxhighlight lang="bash">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName redmine.admin.pass.be

DocumentRoot /opt/redmine/public
RailsEnv production
RailsBaseURI /redmine

<Directory /opt/redmine/public/>
Options Indexes ExecCGI FollowSymLinks
AllowOverride None
Order deny,allow
Allow from all
</Directory>

ErrorLog /opt/redmine/log/apache-error.log
LogLevel warn
CustomLog /opt/redmine/log/apache-access.log combined
</VirtualHost>
</syntaxhighlight>
 
{{Avertissement | Le domaine "redmine.admin.pass.be" doit exister au préalable dans le serveur DNS}}
 
''Définissez l'utilisateur de Redmine comme propriétaire des sources de l'application :''
{{Console root | chown -R redmine:users /opt/redmine}}
 
{{Avertissement | Remarques : Il se peut que Redmine ne se lance pas à cause d'un bug de Ruby. L'utilisateur de Redmine peut avoir besoin d'un dossier personnel. Si ce n'est pas le cas , définissez lui en un : }}
 
{{Console root | usermod -d /var/www/redmine redmine}}
 

== Configuration Mail ==
Modifier le fichier {{File | /opt/redmine/config/configuration.yml}}
<pre>
# default configuration options for all environments
default:
# Outgoing emails configuration (see examples above)
email_delivery:
delivery_method: :smtp
smtp_settings:
address: mail.pass.be
port: 25
domain: pass.be
authentication: :none
# user_name: "redmine@example.net"
# password: "redmine"

# Outgoing email settings

production:
email_delivery:
delivery_method: :smtp
smtp_settings:
address: mail.pass.be
port: 25
domain: pass.be
authentication: :none
</pre>
 

== OpenLDAP ==
=== Authentification ===
La configuration pour utiliser un serveur OpenLDAP à des fins d'authentification, se réalise à partir de l'interface Web (Administrations -> Authentification LDAP)
[[Image:ConfigLDAP.png|center|alt=Fonctionnement de Redmine au sein du PASS|Fonctionnement du Redmine au sein du PASS]]

=== Plugin Sync LDAP ===
==== Installation ====
{{Console | sudo ./script/plugin install https://github.com/thorin/redmine_ldap_sync.git}}
 
==== Configuration ====
Une fois le plugin installer, il faut le configurer toujours à partir de l'interface Web (Administration -> Plugins -> Redmine -LDAP Sync)
[[Image:ldapSync.png|center|alt=Fonctionnement de Redmine au sein du PASS|Fonctionnement du Redmine au sein du PASS]]
 
==== Synchronisation complète ====
Il nous faut lancer, une première fois, une synchronisation complète avec notre serveur OpenLDAP :
 
sudo rake redmine:plugins:redmine_ldap_sync:sync_users RAILS_ENV=production
 
{{ Avertissement | IL faut se placer dans le dossier {{File | /opt/redmine}} avant de lancer la commande de synchronisation }}
 

== Utilisation ==
=== Lancer Redmine ===

Pour lancer Redmine, vous pouvez exécuter le script ruby des sources :

{{Console | ruby /opt/redmine/script/server -e production}}
 
L'option -d permet de le lancer en démon :

{{Console | ruby /opt/redmine/script/server -d -e production}}
 

=== Redémarrer Redmine ===

Dans certain cas, redémarrer le serveur est le meilleur moyen d'être sûr que redmine redémarre bien.

=== Changer password Admin ===

Pour changer le mot de passe Administrateur, on peux le faire via l'interface web mais également en ligne de commande :
RAILS_ENV=production script/runner 'user = User.find(:first, :conditions => {:admin => true}) ; user.password, user.password_confirmation = "PASSWORD"; user.save!'
En ayant au préalablement été se placer dans le dossier {{File | /opt/redmine}}

== Procédure ==

=== Mise à jour ===
 
{{ Note | Cette procédure a été réalisé pour une mise à jour de Redmine 1.3.0 vers 2.3.0 Procédure basée sur la documentation de Redmine [http://www.redmine.org/projects/redmine/wiki/FrRedmineUpgrade FrRedmineUpgrade]}}
 

'''1. Téléchargez la nouvelle version'''

On télécharge la nouvelle version sur le site de Redmine ( [http://rubyforge.org/frs/?group_id=1850 Redmine Forge] ) qu'on va placez dans {{ File | /opt }}
 
{{ Console | wget http://rubyforge.org/frs/download.php/76867/redmine-2.3.0.tar.gz }}
 
On désarchive la nouvelle version
 
{{ Console | tar -zxvf redmine-2.3.0.tar.gz }}
 

'''2. Copie les fichiers de configuration'''

* Copiez vos paramètres de base {{ File | config/database.yml }} dans le nouveau répertoire de configuration config

* Copiez vos paramètres de configuration {{ File | config/configuration.yml}} dans le nouveau répertoire de configuration config.

* Si vous migrez depuis une version plus vielle que 1.2.0, copiez vos configurations de courriel de votre {{ File | config/email.yml }} dans le nouveau {{ File | config/configuration.yml }} dont l'exemple peut être copié du fichier configuration.yml.example.

* Copiez le contenu de {{ File | files }} dans le répertoire files de votre nouvelle installation

* Copiez le répertoire contenant vos plugin personnalisés de votre répertoire {{ File | vendor/plugins }} dans le répertoire plugins de votre nouvelle installation ( si vous migrez d'une version antérieure à 2.0.0 vers une version >= 2.0.0). Assurez-vous de ne copier que les plugins différents de l'installation originale de Redmine de votre précédente installation. (Que le dossier du plugin LDAP)

'''3. Mise a jour session'''

* On installe le bundler dans le répertoire de la nouvelle installation
 
{{ Console | sudo gem install bundler [user@ordi ~]$ sudo bundle install}}
 

On installe les éventules plugins manquants

* Nokogiri

 
{{ Console | sudo apt-get install ruby1.8-dev ruby1.8 ri1.8 rdoc1.8 irb1.8 libreadline-ruby1.8 libruby1.8 libopenssl-ruby libxslt-dev libxml2-dev [user@ordi ~]$ sudo gem install nokogiri}}
 

*RMagick
 
{{ Console | sudo apt-get install imagemagick libmagickwand-dev}}
 
* Exécturer les commandes suivantes depuis le répertoire Redmine de la nouvelle installation
 
{{ Console | sudo rake config/initializers/session_store.rb }}
 

* Génération d'un nouveau secret secret_token.rb
On exécute les commandes suivantes depuis le répertoire Redmine de votre nouvelle installation
 
{{ Console | sudo rake config/initializers/session_store.rb }}
 

Avant 2.0.0, un fichier session_store.rb devait être généré dans le répertoire config pour permettre les sessions basées sur les fichiers témoins (cookies).

À partir de la version 2.0.0 le fichier session_store.rb ne devrait plus exister. À la place la commande suivante va générer le fichier secret_token.rb.
 
{{ Console | 1=sudo rake generate_secret_token }}
 
{{ Note | le dépot du code de Redmine ne contient pas pas le fichier config/initializers/secret_token.rb file, c'est le code précédent qui le crée.}}
 

'''4. Mise à jour de la base de données'''

Cette étape va modifier le contenu de la base de données. Allez dans le répertoire de votre nouvelle installation de Redmine et effectuez la commande suivante :
 
{{ Console | 1=sudo rake db:migrate RAILS_ENV=production }}
 
Si vous avez installé des plugin, vous devrez effectuer une migration de la base de données. Effectuer la commande suivante :
 
{{ Console | 1=sudo rake redmine:plugins:migrate RAILS_ENV=production }}
 
'''5.Nettoyage'''

* Vous devez nettoyer le cache et les sessions existantes, pour ce faire, exécuter les commandes suivantes :
<pre>
rake tmp:cache:clear
rake tmp:sessions:clear
</pre>

'''6.Apache'''

Il faut modifier le fichier {{ File | /etc/apache2/sites-available/redmine }} pour qu'il prenne en compte notre nouvelle installation :
<pre>
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName redmine.admin.pass.be

DocumentRoot /opt/redmine-2.3.0/public
RailsEnv production
RailsBaseURI /redmine

<Directory /opt/redmine-2.3.0/public/>
Options Indexes ExecCGI FollowSymLinks
AllowOverride None
Order deny,allow
Allow from all
</Directory>

ErrorLog /opt/redmine-2.3.0/log/apache-error.log
LogLevel warn
CustomLog /opt/redmine-2.3.0/log/apache-access.log combined
</VirtualHost>
</pre>

Remplacer redmine-2.3.0 par le nom de dossier correspondant à la nouvelle installation.

'''7. Redémarrez l'application'''
 
{{ Console | sudo service apache2 restart }}
 

8. Finalement, lancez votre navigateur et allez dans "Administration -> Rôles & permissions" pour vérifier et/ou paramétrer les permissions sur les nouvelles fonctionnalités, s'il y en a.

'''9. Vérification envoi de mail'''

Vérifier via le menu Administration->Notification par email->Envoyer un email de test

Si le message d'erreur suivant s'affiche :
<pre>
Erreur lors de l'envoi de l'email (hostname was not match with the server certificate)
</pre>

Il faut modifier le fichier {{ File | /opt/redminer-2.3.0/config/configuration.yml }} pour que la section production ressemble à ceci :
<pre>
production:
email_delivery:
delivery_method: :smtp
smtp_settings:
address: mail.pass.be
port: 25
domain: pass.be
authentication: :none
tls: false
enable_starttls_auto: false
</pre>

'''10. Assigner les droit sur le dossier'''

A la fin de l amigration, on ré-assigne le propriétaire du dossier {{ File | /opt/redmine-2.3.0 }}
 
{{ Console | sudo chown -R redmine:users redmine-2.3.0/ }}
 

[[Catégorie:Applicatifs]]

@@ Ligne 125 : / Ligne 125 : @@
 ==== Configuration d'Apache ====
-* Créez/éditer le fichier /etc/apache2/mods-available/passenger.load pour y indiquer le chemin du module :
+* Créez/éditer le fichier {{ File | /etc/apache2/mods-available/passenger.load }} pour y indiquer le chemin du module :
   LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-3.0.11/ext/apache2/mod_passenger.so
-* Créez (ou éditez) ensuite le fichier /etc/apache2/mods-available/passenger.conf pour y adapter le chemin de Passenger et Ruby:
+* Créez (ou éditez) ensuite le fichier {{ File | /etc/apache2/mods-available/passenger.conf }} pour y adapter le chemin de Passenger et Ruby:
   PassengerRoot /var/lib/gems/1.8/gems/passenger-3.0.11
   PassengerRuby /usr/bin/ruby1.8

@@ Ligne 212 : / Ligne 212 : @@
 ==== Configuration ====
 Une fois le plugin installer, il faut le configurer toujours à partir de l'interface Web (Administration -> Plugins -> Redmine -LDAP Sync)
 <br>
 ==== Synchronisation complète ====
 Il nous faut lancer, une première fois, une synchronisation complète avec notre serveur OpenLDAP :

@@ Ligne 205 : / Ligne 205 : @@
 === Authentification ===
 La configuration pour utiliser un serveur OpenLDAP à des fins d'authentification, se réalise à partir de l'interface Web (Administrations -> Authentification LDAP)
 === Plugin Sync LDAP ===

@@ Ligne 1 : / Ligne 1 : @@
 {{introduction | Cette page va vous permettre de mettre en place Redmine utilisant une base de données PostgreSQL.}}
 == Utilisateur Redmine ==
@@ Ligne 154 : / Ligne 144 : @@
 <VirtualHost *:80>
          ServerAdmin webmaster@localhost
-         ServerName redmine.admin.pass.be
+         ServerName redmine.domaine.be
          DocumentRoot /opt/redmine/public
@@ Ligne 173 : / Ligne 163 : @@
 </syntaxhighlight>
 <br />
-{{Avertissement | Le domaine "redmine.admin.pass.be" doit exister au préalable dans le serveur DNS}}
+{{Avertissement | Le domaine "redmine.domain.be" doit exister au préalable dans le serveur DNS}}
 <br />
 ''Définissez l'utilisateur de Redmine comme propriétaire des sources de l'application :''
@@ Ligne 192 : / Ligne 182 : @@
      delivery_method: :smtp
      smtp_settings:
-       address: mail.pass.be
+       address: mail.domain.be
        port: 25
-       domain: pass.be
+       domain: domain.be
        authentication: :none
        # user_name: "redmine@example.net"
@@ Ligne 205 : / Ligne 195 : @@
      delivery_method: :smtp
      smtp_settings:
-       address: mail.pass.be
+       address: mail.domain.be
        port: 25
-       domain: pass.be
+       domain: domain.be
        authentication: :none
 </pre>
@@ Ligne 348 : / Ligne 338 : @@
 <VirtualHost *:80>
          ServerAdmin webmaster@localhost
-         ServerName redmine.admin.pass.be
+         ServerName redmine.domain.be
          DocumentRoot /opt/redmine-2.3.0/public
@@ Ligne 391 : / Ligne 381 : @@
      delivery_method: :smtp
      smtp_settings:
-       address: mail.pass.be
+       address: mail.domain.be
        port: 25
-       domain: pass.be
+       domain: domain.be
        authentication: :none
        tls: false
@@ Ligne 401 : / Ligne 391 : @@
 '''10. Assigner les droit sur le dossier'''
-A la fin de l amigration, on ré-assigne le propriétaire du dossier {{ File | /opt/redmine-2.3.0 }}
+A la fin de la migration, on ré-assigne le propriétaire du dossier {{ File | /opt/redmine-2.3.0 }}
 <br>
 {{ Console | sudo chown -R redmine:users redmine-2.3.0/ }}