Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
redmine [Le 21/12/2012, 22:53] 82.247.161.123 [Méthode 1 : Dans un dossier] |
redmine [Le 11/09/2022, 12:09] (Version actuelle) moths-art 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) |
||
---|---|---|---|
Ligne 10: | Ligne 10: | ||
* gestion multi-projets ; | * gestion multi-projets ; | ||
* gestion fine des droits utilisateurs définis par des rôles ; | * 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 ; | * Wiki multi-projets ; | ||
* forums multi-projets ; | * forums multi-projets ; | ||
* news accessibles par RSS / ATOM ; | * news accessibles par RSS / ATOM ; | ||
- | * notifications par email ; | + | * notifications par courriel ; |
* gestion de feuilles de route, GANTT, calendrier ; | * gestion de feuilles de route, GANTT, calendrier ; | ||
* historique ; | * historique ; | ||
Ligne 20: | Ligne 20: | ||
* identification possible via LDAP ; | * identification possible via LDAP ; | ||
* multilingue (25 langues disponibles pour la 0.7.0) ; | * 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 ===== |
- | + | ||
- | 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). | + | Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>redmine|redmine]]**. |
+ | |||
+ | 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 == | == Créer un utilisateur spécifique == | ||
Ligne 42: | Ligne 47: | ||
sudo chmod -R 755 files log tmp public/plugin_assets | sudo chmod -R 755 files log tmp public/plugin_assets | ||
+ | |||
+ | <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> | ||
+ | <note important>Après l'installation, il faudra également lancer la commande ''sudo chown -R redmine:users /etc/redmine''. </note> | ||
===== Installation depuis les sources ===== | ===== Installation depuis les sources ===== | ||
==== Pré-requis ==== | ==== Pré-requis ==== | ||
Ligne 51: | Ligne 59: | ||
=== 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. | L'installation de Rails est précisée ci-dessous, car la version à installer est importante suivant la version de Redmine. | ||
Ligne 60: | Ligne 68: | ||
<note important>Les versions 1.2.x nécessitent la version 2.3.11 de Rails et la version 1.1.1 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 : | Installez donc ces dépendances à l'aide des commandes : | ||
Ligne 130: | Ligne 138: | ||
exit | 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. | Un mot de passe sera demandé pour l'utilisateur redmine. | ||
Ligne 183: | Ligne 191: | ||
RAILS_ENV=production rake db:migrate | RAILS_ENV=production rake db:migrate | ||
| | ||
- | <note important>Si vous obtenez l'erreur : | + | <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> | 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 : | + | <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 | 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 193: | Ligne 201: | ||
rake config/initializers/session_store.rb | 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 == | ||
Ligne 354: | Ligne 362: | ||
| | ||
<note important> | <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) : | + | 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.11/bin/passenger-install-apache2-module | /var/lib/gems/1.8/gems/passenger-3.0.11/bin/passenger-install-apache2-module | ||
Ligne 443: | Ligne 451: | ||
Votre application est désormais accessible depuis **http://localhost/redmine** ! | Votre application est désormais accessible depuis **http://localhost/redmine** ! | ||
+ | <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): | ||
+ | 16: <p><%= f.text_field :firstname, :required => true %></p> | ||
+ | 17: <p><%= f.text_field :lastname, :required => true %></p> | ||
+ | 18: <p><%= f.text_field :mail, :required => true %></p> | ||
+ | 19: <p><%= f.select :language, lang_options_for_select %></p> | ||
+ | 20: <% if Setting.openid? %> | ||
+ | 21: <p><%= f.text_field :identity_url %></p> | ||
+ | 22: <% 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 ==== | ==== Méthode 2 : via un domaine ==== | ||
Ligne 531: | Ligne 623: | ||
<code>$ sudo /etc/init.d/apache2 reload</code> | <code>$ sudo /etc/init.d/apache2 reload</code> | ||
- | ===== Notifications par e-mail ===== | + | ===== Notifications par courriel ===== |
==== Gmail ==== | ==== Gmail ==== | ||
Ligne 619: | Ligne 711: | ||
Redmine interprètera ainsi les logs et reportera sur l'interface de votre projet toutes les modifications effectuées sur les sources. | 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 === | === Gitolite === | ||
Ligne 643: | Ligne 737: | ||
* **(fr, en)** [[http://www.redmine.org/wiki/redmine/FrGuide|Le guide officiel de Redmine]] : installation, mise à jour, utilisation, etc. | * **(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]] | * **(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]] | + | * **(fr)** [[http://www.projet-plume.org/fr/fiche/redmine|Une fiche descriptive de Redmine]] |
---- | ---- | ||
//Contributeurs : [[:utilisateurs:v0n]], Rohja, Respawner. yquenechdu// | //Contributeurs : [[:utilisateurs:v0n]], Rohja, Respawner. yquenechdu// |