Différences

Ci-dessous, les différences entre deux révisions de la page.

--- redmine [Le 05/10/2011, 22:43] – [Liens] 86.212.115.54
+++ redmine [Le 11/09/2022, 12:09] (Version actuelle) – Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892) moths-art
@@ Ligne 10: / Ligne 10: @@
     * gestion multi-projets ;
     * gestion fine des droits utilisateurs définis par des rôles ;
-    * rapports de bugs, demandes d'évolutions ;
+    * rapports de bogues, demandes d'évolutions ;
     * Wiki multi-projets ;
     * forums multi-projets ;
     * news accessibles par RSS / ATOM ;
-    * notifications par email ;
+    * notifications par courriel ;
     * gestion de feuilles de route, GANTT, calendrier ;
     * historique ;
@@ Ligne 20: / Ligne 20: @@
     * identification possible via LDAP ;
     * multilingue (25 langues disponibles pour la 0.7.0) ;
-    * support de plusieurs bases de données : [[MySQL]], [[PostgreSQL]] ou SQLite.
+    * prise en charge de plusieurs bases de données : [[MySQL]], [[PostgreSQL]] ou SQLite.
-====== Installation depuis les dépôts : ======
+===== Installation =====
+Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>redmine|redmine]]**.
-Depuis Lucid Lynx, Redmine est disponible dans les dépôts ! Il vous suffira d'installer [[apt://redmine]] et/ou [[apt://redmine-mysql]] (pour que Redmine utilise [[mysql|MySQL]]) ou [[apt://redmine-pgsql]] (pour que Redmine utilise [[postgresql|PostgreSQL]]) ou [[apt://redmine-sqlite]] (pour que Redmine utilise SQLite).
+Selon la base de données utilisée, on installera :
+  * **[[apt>redmine|redmine-sqlite]]**  pour [[sqlite|SQLite]] ;
+  * **[[apt>redmine|redmine-pgsql]]** pour [[postgresql|PostgreSQL]] ;
+  * **[[apt>redmine|redmine-mysql]]** pour [[mysql|MySQL]].
 == Créer un utilisateur spécifique ==
@@ Ligne 44: / Ligne 48: @@
+<note important>Si vous intallez depuis les dépôts, l'application redmine est installée dans **/usr/share/redmine** et non **/opt/redmine**. Tenez-en compte pour les paramétrages et autre actions sur les fichiers à partir de la section 3. </note>
-====== Installation depuis les sources ======
-===== Pré-requis =====
+<note important>Après l'installation, il faudra également lancer la commande ''sudo chown -R redmine:users /etc/redmine''. </note>
+===== Installation depuis les sources =====
+==== Pré-requis ====
 Pour installer Redmine vous aurez besoin de //Ruby//, son framework //Ruby on Rails// et un //système de base de données//.
-==== Ruby ====
+=== Ruby ===
-Redmine nécessite Ruby 1.8. [[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **[[apt://build-essential,ruby1.8-dev,rubygems,rake|build-essential ruby1.8-dev rubygems rake]]**.
+Redmine nécessite Ruby. [[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **[[apt://build-essential,ruby-dev,rubygems,rake|build-essential ruby-dev rubygems rake]]**.
 L'installation de Rails est précisée ci-dessous, car la version à installer est importante suivant la version de Redmine.
-==== Sources de Redmine ====
+=== Ruby on Rails et sources de Redmine ===
-La dernière version stable de Redmine à ce jour est la version **1.1.2**. Elle nécessite la version 2.3.5 de Rails et la version 1.0.1 de Rack.
+La dernière version stable de Redmine à ce jour est la version **1.3.0** (2011-12-10). Elle nécessite la version 2.3.14 de Rails et la version 1.1.x de Rack.
 <note important>Les versions 1.2.x nécessitent la version 2.3.11 de Rails et la version 1.1.1 de Rack
-(voir sur [[http://www.redmine.org/projects/redmine/wiki/RedmineInstall|le site de Redmine]])</note>
+(voir sur [[https://www.redmine.org/projects/redmine/wiki/RedmineInstall|le site de Redmine]])</note>
 Installez donc ces dépendances à l'aide des commandes :
-  sudo gem install rack -v=1.0.1
+  sudo gem install rack -v=1.1.3
-  sudo gem install rails -v=2.3.5
+  sudo gem install rails -v=2.3.14
 Télécharger les sources de Redmine dans votre répertoire personnel :
   cd ~
-  wget http://rubyforge.org/frs/download.php/74419/redmine-1.1.2.tar.gz
+  wget http://rubyforge.org/frs/download.php/75597/redmine-1.3.0.tar.gz
 Extrayez les sources :
-  tar zxf redmine-1.1.2.tar.gz
+  tar zxf redmine-1.3.0.tar.gz
 ==== Base de données ====
@@ Ligne 89: / Ligne 96: @@
   sudo gem install mysql
-== Créer un utilisateur spécifique ==
-Pour des raisons de sécurité, il est préfèrable de créer un utilisateur spécifique à Redmine pour utiliser la base :
-  sudo addgroup redmine
-  sudo adduser redmine --no-create-home --ingroup redmine
-Un mot de passe sera demandé pour l'utilisateur redmine.
 <note>Pour la suite de la documentation, nous considérerons que le mot de passe de l'utilisateur redmine est "//password//".</note>
@@ Ligne 140: / Ligne 138: @@
   exit
-<note help>Si l'erreur 'Unknown id' est survenue à la ligne "su - postgres", il suffit alors de se référer à la page [[http://doc.ubuntu-fr.org/postgresql|postgresql]] </note>
+<note help>Si l'erreur 'Unknown id' est survenue à la ligne "su - postgres", il suffit alors de se référer à la page [[:postgresql|postgresql]] </note>
 Un mot de passe sera demandé pour l'utilisateur redmine.
@@ Ligne 146: / Ligne 144: @@
 <note>Pour la suite de la documentation, nous considérerons que le mot de passe de l'utilisateur redmine est "//password//".</note>
-===== Installation =====
+==== Installation ====
 Vous devez vous trouver dans le répertoire des sources de Redmine pour la suite des opérations :
-  cd ~/redmine-1.1.2
+  cd ~/redmine-1.3.0
-==== Configuration de Redmine ====
+=== Configuration de Redmine ===
 Copier le fichier de configuration :
@@ Ligne 183: / Ligne 181: @@
     schema_search_path: public
-=== Créer un ''session store'' ===
+== Créer un ''session store'' ==
 Depuis la version 0.8.7 de Redmine, cette commande est nécessaire :
@@ Ligne 189: / Ligne 187: @@
   rake generate_session_store
-=== Créer la structure de la base ===
+== Créer la structure de la base ==
   RAILS_ENV=production rake db:migrate
 <note important>Si vous obtenez l'erreur :
 rake aborted ! no such file to load -- net/https. Il vous suffit d'installer  [[apt://libopenssl-ruby1.8]] </note>
 <note important>Si vous obtenez l'erreur :
   A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb
@@ Ligne 203: / Ligne 201: @@
   rake config/initializers/session_store.rb
-puis de créer la structure de la base. (ref: [[http://www.redmine.org/issues/4848]] )</note>
+puis de créer la structure de la base. (ref: [[https://www.redmine.org/issues/4848]] )</note>
-=== Insérer les données par défaut ===
+== Insérer les données par défaut ==
   RAILS_ENV=production rake redmine:load_default_data
@@ Ligne 211: / Ligne 209: @@
 La langue sera demandée, indiquez donc ''fr'' pour du français.
-==== Finir l'installation proprement ====
+=== Finir l'installation proprement ===
 L'installation consiste grossièrement à télécharger les sources dans votre dossier personnel.
@@ Ligne 219: / Ligne 217: @@
 Le principe est de déplacer ce dossier dans **/opt/**. D'autres parts, ceci rendra le logiciel installé pour tous les utilisateurs du système et non seulement pour vous.
-=== Copie vers /opt/ ===
+== Copie vers /opt/ ==
 Créer le dossier **/opt/redmine** :
@@ Ligne 227: / Ligne 225: @@
 Copier les sources vers ce répertoire :
-  sudo cp -r ~/redmine-1.1.2/* /opt/redmine
+  sudo cp -r ~/redmine-1.3.0/* /opt/redmine
 Un dossier ''tmp'' et ''public/plugin_assets'' doit être présent par convention dans les sources (si ce n'est pas déjà le cas) :
@@ Ligne 237: / Ligne 235: @@
   sudo mkdir /opt/redmine/tmp/pids
-=== Définition des droits ===
+== 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éé :
@@ Ligne 245: / Ligne 243: @@
   sudo chmod -R 755 files log tmp public/plugin_assets
-=== Nettoyage ===
+== Nettoyage ==
 Redmine étant proprement installé, on peut maintenant supprimer les sources du dossier personnel :
-  rm -rf ~/redmine-1.1.2 ~/redmine-1.1.2.tar.gz
+  rm -rf ~/redmine-1.3.0*
-==== Automatiser le lancement de Redmine ====
+===== Automatiser le lancement de Redmine =====
 <note important>
@@ Ligne 323: / Ligne 321: @@
   sudo update-rc.d redmine defaults
 Redmine sera désormais lancé à chaque démarrage de la machine.
+Vous pouvez y accédez à présent via l'adresse : http://localhost:3000/
 <note tip>
@@ Ligne 330: / Ligne 330: @@
 </note>
-==== Servir Redmine via Apache ====
+===== Servir Redmine via Apache =====
 On a deux manières de configurer Apache :
@@ Ligne 341: / Ligne 341: @@
 </note>
-=== Méthode 1 : Dans un dossier ===
+==== Méthode 1 : Dans un dossier ====
-== Pré-requis ==
+=== Pré-requis ===
 Si ce n'est pas le cas, mettez à jour votre système.
@@ Ligne 351: / Ligne 351: @@
 [[:tutoriel:comment_installer_un_paquet|Installez donc les paquets]] : [[apt://apache2-prefork-dev,libapr1-dev,libaprutil1-dev|apache2-prefork-dev libapr1-dev libaprutil1-dev]].
-== Installation de Passenger ==
+=== Installation de Passenger ===
 Il faut à présent installer Passenger (alias //mod_rails//), le module d'Apache permettant de faire tourner une application Ruby on Rails sur Apache.
@@ Ligne 362: / Ligne 362: @@
 <note important>
 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 (avec une version de gems = 1.8) :
-  /var/lib/gems/1.8/gems/passenger-3.0.9/bin/passenger-install-apache2-module
+  /var/lib/gems/1.8/gems/passenger-3.0.11/bin/passenger-install-apache2-module
 </note>
@@ Ligne 376: / Ligne 376: @@
 [[:tutoriel:comment_editer_un_fichier|Créez (ou éditez) le fichier]] **''/etc/apache2/mods-available/passenger.load''**, pour y indiquer le chemin du module comme suit :
-  LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-3.0.9/ext/apache2/mod_passenger.so
+  LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-3.0.11/ext/apache2/mod_passenger.so
 [[:tutoriel:comment_editer_un_fichier|Créez (ou éditez) ensuite le fichier]] **''/etc/apache2/mods-available/passenger.conf''** pour y adapter le chemin de Passenger et Ruby comme suit :
-  PassengerRoot /var/lib/gems/1.8/gems/passenger-3.0.9
+  PassengerRoot /var/lib/gems/1.8/gems/passenger-3.0.11
   PassengerRuby /usr/bin/ruby1.8
-<note>Il se peut que **passenger** ne soit pas installé dans ''/var/lib/gems/1.8/gems/passenger-3.0.9'', mais dans '' /usr/lib/gems/1.8/gems/passenger-3.0.9'' par exemple, suivant la distribution. Dans ce cas, adaptez simplement les chemins précédents.</note>
+<note>Il se peut que **passenger** ne soit pas installé dans ''/var/lib/gems/1.8/gems/passenger-3.0.11'', mais dans '' /usr/lib/gems/1.8/gems/passenger-3.0.11'' par exemple, suivant la distribution. Dans ce cas, adaptez simplement les chemins précédents.</note>
 Activez les modules d'Apache nécessaires :
@@ Ligne 407: / Ligne 407: @@
 	RailsBaseURI /redmine
-	<Directory /opt/redmine/public/>
+	<Directory /var/www/redmine>
 		Options FollowSymLinks
 		AllowOverride None
 		Order deny,allow
 		Allow from all
+                RailsBaseURI /redmine
+		PassengerResolveSymlinksInDocumentRoot on
 	</Directory>
@@ Ligne 449: / Ligne 451: @@
 Votre application est désormais accessible depuis **http://localhost/redmine** !
-=== Méthode 2 : via un domaine ===
+<note>
+Au lancement de Redmine, il est possible d'obtenir une erreur de ce type :
+<code>
+Web application could not be started
+cannot load such file -- bundler/setup (LoadError)
+  /usr/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require'
+  /usr/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require'
+  /usr/lib/ruby/vendor_ruby/phusion_passenger/loader_shared_helpers.rb:245:in `block in run_load_path_setup_code'
+  /usr/lib/ruby/vendor_ruby/phusion_passenger/loader_shared_helpers.rb:348:in `running_bundler'
+  /usr/lib/ruby/vendor_ruby/phusion_passenger/loader_shared_helpers.rb:243:in `run_load_path_setup_code'
+  /usr/share/passenger/helper-scripts/rack-preloader.rb:100:in `preload_app'
+  /usr/share/passenger/helper-scripts/rack-preloader.rb:158:in `<module:App>'
+  /usr/share/passenger/helper-scripts/rack-preloader.rb:29:in `<module:PhusionPassenger>'
+  /usr/share/passenger/helper-scripts/rack-preloader.rb:28:in `<main>'
+</code>
+Cela  peut provenir du fait que bundler n'est pas installé. La correction est simple et rapide : l'installer et relancer Apache.
+<code>
+sudo gem install bundler
+sudo service apache2 restart
+</code>
+source : [[https://www.redmine.org/boards/2/topics/42399?r=42428#message-42428]]
+</note>
+<note>
+Les logs de Redmine sont dans /var/log/redmine/default/ et le plus important dans une utilisation normale est production.log.
+Il peut arriver que l'application n'ait pas les droits d'écriture et ne puisse pas remplir correctement ce fichier de log. Dans ce cas, les informations sont renvoyées vers /var/log/apache2/error/log et on trouve le message d'erreur suivant :
+<code>
+Rails Error: Unable to access log file. Please ensure that /var/log/redmine/default/production.log exists and is chmod 0666. The log level has been raised to WARN and the output directed to STDERR until the problem is fixed.
+</code>
+Solution :
+<code>
+sudo chown -R redmine:users /var/log/redmine/
+sudo chmod 666 /var/log/redmine/default/*
+sudo service apache2 restart
+</code>
+Les messages d'erreur de Redmine sont de retour dans /var/log/redmine/default/production.log.
+</note>
+<note>
+Il arrive que l'accès aux pages /my/account, settings et users/1/edit ne soit pas possible
+<code>
+Internal error
+An error occurred on the page you were trying to access.
+If you continue to experience problems please contact your Redmine administrator for assistance.
+If you are the Redmine administrator, check your log files for details about the error.
+</code>
+et que l'on trouve un message de ce type dans /var/log/redmine/default/production.log
+<code>
+ActionView::Template::Error (Permission denied - /var/cache/redmine/default/cache/900):
+:   <p><%= f.text_field :firstname, :required => true %></p>
+:   <p><%= f.text_field :lastname, :required => true %></p>
+:   <p><%= f.text_field :mail, :required => true %></p>
+:   <p><%= f.select :language, lang_options_for_select %></p>
+:   <% if Setting.openid? %>
+:   <p><%= f.text_field :identity_url  %></p>
+:   <% end %>
+  lib/redmine/i18n.rb:95:in `languages_options'
+  app/helpers/application_helper.rb:962:in `lang_options_for_select'
+  app/views/my/account.html.erb:19:in `block in _app_views_my_account_html_erb__1203571593285091717_37874920'
+  app/helpers/application_helper.rb:977:in `labelled_form_for'
+  app/views/my/account.html.erb:9:in `_app_views_my_account_html_erb__1203571593285091717_37874920'
+</code>
+Dans ce cas, il s'agit de mauvais droits d'accès au répertoire /var/cache/redmine/ (voir le chemin indiqué dans le message).
+Solution :
+<code>
+sudo chown -R redmine:redmine  /var/cache/redmine/
+sudo service apache2 restart
+</code>
+Et recharger la page web.
+</note>
+<note>
+**L'ajout de fichiers de marche pas !**
+-> problème de droits sur le dossier /var/lib/redmine/
+Solution moche (sécurité) mais qui marche :
+<code>
+sudo chmod go+rw -R /var/lib/redmine/
+sudo service apache2 restart
+</code>
+On donne les droits de lecture/écriture à tout le monde et on redémarre le serveur.
+</note>
+==== Méthode 2 : via un domaine ====
 <note important>
@@ Ligne 501: / Ligne 587: @@
 <note help>Le nom du fichier (ici **redmine.lan**) n'a pas besoin d'être identique au domaine. Vous pouvez le nommer comme vous voulez. Si vous utilisez beaucoup de domaines sur une même installation d'Apache, c'est une bonne manière de toujours savoir à quoi corresond quel fichier.</note>
-== Fichiers de log ==
+=== Fichiers de log ===
 On va créer les fichiers de log pour y stocker les accès et les erreurs propres au VirtualHost, afin de bien les dissocier des autres domaines :
@@ Ligne 511: / Ligne 597: @@
 $ sudo chown www-data:www-data /opt/redmine/log/apache-access.log</code>
-== Activation du site ==
+=== Activation du site ===
 Il ne reste plus qu'à activer le site dans Apache. Cela se fait simplement avec la commande **a2ensite** suivie du nom du fichier que l'on a créé.
@@ Ligne 525: / Ligne 611: @@
 <note important>Le domaine n'est pas créé par la manipulation : il doit déjà avoir été enregistré (sur votre serveur DNS, chez un Registar, ...) et pointer sur l'IP de votre serveur.</note>
-== Désactivation ==
+=== Désactivation ===
 Si, pour une raison ou pour une autre, vous souhaitiez désactiver le site, utilisez **a2dissite** :
@@ Ligne 537: / Ligne 623: @@
 <code>$ sudo /etc/init.d/apache2 reload</code>
-==== Notifications par e-mail ====
+===== Notifications par courriel =====
-=== Gmail ===
+==== Gmail ====
 Placez-vous dans le dossier des sources de Redmine :
@@ Ligne 625: / Ligne 711: @@
 Redmine interprètera ainsi les logs et reportera sur l'interface de votre projet toutes les modifications effectuées sur les sources.
+<note tip>Concernant les dépôts [[git|GIT]], si ces derniers sont sur un autre serveur *nix, il est possible de les exploiter directement via un simple partage [[nfs|nfs]] et de paramétrer votre projet en lui donnant le chemin de montage (ex.: ''/mnt/depots/monProjet.git''), simple et efficace ;-)</note>
 === Gitolite ===
@@ Ligne 649: / Ligne 737: @@
   * **(fr, en)** [[http://www.redmine.org/wiki/redmine/FrGuide|Le guide officiel de Redmine]] : installation, mise à jour, utilisation, etc.
   * **(en)** [[http://demo.redmine.org/|Démo en ligne de Redmine]]
   * **(fr)** [[http://www.projet-plume.org/fr/fiche/redmine|Une fiche descriptive de Redmine]]
 ----
 //Contributeurs : [[:utilisateurs:v0n]], Rohja, Respawner. yquenechdu//

Différences

Outils de la page

Outils du site

Divers