Wiki » Historique » Révision 191

Révision 190 (Patrice Nadeau, 2015-09-06 18:45) → Révision 191/279 (Patrice Nadeau, 2015-09-15 20:47)

h1. Redmine 

 > Version 3.1.0 

 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 : 
 * http://bitnami.com/stack/redmine 
 * http://www.turnkeylinux.org/redmine 

 {{lastupdated_at}} {{lastupdated_by}} 

 --- 

 {{toc}} 

 h2. Installation 

 Ce guide documente une installation GNU/Linux avec les version suivantes : 
 * openSUSE 13.2 
 * Redmine 3.1.0 

 h3. Prérequis 

 Un serveur *LAMP(Linux, Apache, MySQL, PHP)* [[guides_opensuse:|openSUSE]] *fonctionnel*. 

 Les logiciels supplémentaires suivants : 

 <pre><code class="bash"> 
 zypper install libmysqlclient-devel ruby-2.1 ruby21-devel rubygem-bundler    rubygem-mysql2 rubygem-pg ImageMagick ImageMagick-devel git gcc make 
 </code></pre> 

 h3. 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 donnees. 
 * db : Nom de la base de donnés. 

 Lancer MySQL : 
 <pre><code class="bash"> 
 mysql -u root -p 
 </code></pre> 

 Commandes MySQL : 
 <pre><code class="sql"> 
 create database db character set utf8; 
 create user 'redmine'@'localhost' identified by 'password'; 
 grant all privileges on db.* to 'redmine'@'localhost'; 
 commit; 
 quit; 
 </code></pre> 

 h3. Redmine 

 L’installation sera faite dans _\srv\redmine_ (exemple avec la version 3.1) 
 <pre><code class="bash"> 
 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 
 </code></pre> 

 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. 

 h3. Ruby 

 Installation des gems de Ruby 
 <pre><code class="bash"> 
 cd redmine 
 gem install bundler 
 gem install activerecord-mysql2-adapter 
 bundle install --without development test 
 </code></pre> 

 h3. Initialisation 

 Création de la cryptographie, de la structure et des donnés de base : 
 <pre><code class="bash"> 
 cd /srv/redmine 
 rake generate_secret_token 
 RAILS_ENV=production rake db:migrate 
 RAILS_ENV=production rake redmine:load_default_data 
 </code></pre> 

 h3. Serveur web 

 Redmine peux être utiliser avec le serveur inclus _webrick_ (port 3000) ou _Apache_ (port 80). 

 h4. Webrick 

 Ouvrir dans le pare-feu le port TCP 3000 : 
 <pre><code class="bash"> 
 yast firewall services add tcpport=3000 zone=EXT 
 </code></pre> 

 Lancer le serveur web 
 <pre><code class="bash"> 
 cd /srv/redmine 
 ruby bin/rails server webrick -e production 
 </code></pre> 

 h5. Transformation en daemon 

 Le script original vient de http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_openSUSE 
 Copier le script dans le fichier */etc/init.d/redmine* 

 Le modifier de la manière suivante : 
 * REDMINE_BIN=/srv/redmine/current/script/rails 
 * REDMINE_USER=user 
 * Corriger le «typo» à la ligne 73 : $REDMI-NE_BIN -> $REDMINE_BIN 
 * Dans la section stop, après la ligne killproc, ajouter *rm $PIDFILE* 

 Rendre le fichier exécutable, l’ajouter aux services SUSE et l’exécuter au démarrage : 
 <pre><code class="bash"> 
 chmod 0755 /etc/init.d/redmine 
 cp -s /etc/init.d/redmine /usr/bin/rcredmine 
 chkconfig -a redmine 
 </code></pre> 

 

 h4. Apache 

 > En test, voir #23 

 Transformation pour utilisation avec Apache. 
 * N'utilise pas _webrick_ 
 * Accessible par le port 80 au lieu de 3000 

 Information provenant de : 
 * web :  
 ** http://martin-denizet.com/install-redmine-2-5-x-with-git-and-subversion-on-debian-with-apache2-rvm-and-passenger/  
 ** http://www.redmine.org/projects/redmine/wiki/HowTo_configure_Apache_to_run_Redmine 
 ** http://www.redmine.org/boards/2/topics/43924 
 * livre : "Mastering Redmine":http://shop.oreilly.com/product/9781849519144.do 

 

 h3. Modules Apache 

 > Apache 2.4 

 Ajout 
 <pre><code class="bash"> 
 zypper install libcurl-devel apache2-devel apache2-mod_perl perl-Apache-DBI subversion-server 
 </code></pre> 

 Activation des modules Apache 
 <pre><code class="bash"> 
 a2enmod ssl 
 a2enmod perl 
 a2enmod dav 
 a2enmod dav_svn 
 a2enmod dav_fs 
 a2enmod rewrite 
 a2enmod headers 
 </code></pre> 

 h3. Modules _Passenger_ 

 <pre><code class="bash"> 
 cd /srv/redmine 
 gem install passenger 
 passenger-install-apache2-module2.0 
 </code></pre> 

 Changer les droits sur le fichiers de log 
 <pre><code class="bash"> 
 chmod 0666 log/production.log 
 </code></pre> 

 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 
 <pre><code class="bash"> 
 mkdir tmp/passenger 
 </code></pre> 

 h3. 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_ 
 <pre><code class="bash"> 
 <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> 
 </code></pre> 

 Relancer Apache : 
 <pre><code class="bash"> 
 systemctl reload apache2 
 </code></pre> 

 h2. 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 apparait pour l’écriture des répertoires, changer les droits : 
 > Semble être nécessaire que pour Apache 
 <pre><code class="bash"> 
 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 
 </code></pre> 

 h2. Personnalisation 

 h3. 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.rhtml.erb_ 
 * Si on ne veux plus afficher le titre, mettre en commentaire : 
 <pre><code class="ruby"> 
 <!--<h1><%= page_header_title %></h1>--> 
 </code></pre> 
 * Ajouter en dessous la ligne  
 <pre><code class="ruby"> 
 <img src="<%= Redmine::Utils.relative_url_root %>/images/logo.png" style="top-margin: 15px; left-margin: 15px;"/> 
 </code></pre> 

 Relancer Redmine 

 h3. Plugins 

 Modules supplémentaires pour ajouter des fonctionnalités à Redmine. 

 > Source de problème lors de mise à jour si incompatibilité. 

 h4. Redmine Rouge 

 Permet le support de langage supplémentaire pour l'affichage de la syntaxe d'un code source. 

 "Langage supporté":http://rouge.jayferd.us/demo 

 https://github.com/ngyuki/redmine_rouge 

 <pre> 
 <code class="bash"> 
 cd /srv/redmine/plugins 
 git clone https://github.com/ngyuki/redmine_rouge.git 
 cd .. 
 bundle install 
 </code> 
 </pre> 

 Relancer redmine 

 h4. Code Highlight 

 http://www.redmine.org/plugins/codehightlight_button 

 Bouton permettant de sélectionner du code et d'activer la syntaxe selon un langage. 

 Installation 
 <pre><code class="bash"> 
 cd /srv/redmine/plugins 
 git clone https://github.com/mediatainment/redmine_codebutton.git 
 cd .. 
 rake redmine:plugins 
 rake redmine:plugins:migrate RAILS_ENV=production 
 # Relancer Redmine 
 rcredmine restart 
 </code></pre> 

 Ajout des langages supplémentaires supportées par le « plug-in » _Redmine Rouge_. Voir "ici":https://github.com/mediatainment/redmine_codebutton/issues/2 
 Éditer le fichier */srv/redmine/plugins/redmine_codebutton/assets/javascripts/wiki-codehighlight.js* 
 * Ajouter les langages voulus dans la variable *codeRayLanguages* 

 Relancer Apache 
 <pre><code class="bash"> 
 systemctl reload apache2.service 
 </code></pre> 

 h4. Like Button 

 Bouton pour Facebook, Google+ et Twitter 

 http://www.redmine.org/plugins/like 

 Installation 

 <pre><code class="bash"> 
 cd /srv/redmine/plugins 
 svn svn co http://svn.s-andy.com/like-button like 
 </code></pre> 

 Relancer Redmine 

 h4. Wiki Extensions 

 Voir #52 

 Ajoute des macros au Wiki de Redmine 
 > La dernière version est disponible à https://bitbucket.org/haru_iida/redmine_wiki_extensions/downloads 

 Parmi les macros ajoutées: 
 * Emoticons : Un bouton apparait pour ajouter des « smilley » qui seront afficher en graphique 
 * !{{lastupdated_by}} : affiche le nom de la dernière personne à avoir modifier la page 
 * !{{lastupdated_at}} : affiche la date de la dernière modification de la page 
 * Liste complète à http://www.r-labs.org/projects/r-labs/wiki/Wiki_Extensions_en 

 > Des « smilley » non voulus peuvent apparaîtrent dans les wiki déjà en place. L'utilisation de *<notextile><notextile> </notextile></notextile>* seras alors nécessaire. 

 Étapes : 
 # Installation sur le serveur : 
 <pre><code class="bash"> 
 cd /srv/redmine/ 
 wget https://bitbucket.org/haru_iida/redmine_wiki_extensions/downloads/redmine_wiki_extensions-0.7.0.zip 
 unzip redmine_wiki_extensions-0.7.0.zip -d plugins/ 
 rake redmine:plugins:migrate RAILS_ENV=production 
 systemctl reload apache2.service 
 rm -r redmine_wiki_extensions-0.7.0.zip 
 </code></pre> 
 # Activer le module dans le ou les projets voulus 

 h2. Retrait d'un plug-in 

 <pre><code class="bash"> 
 cd /srv/redmine 
 rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production 
 rm -r plugins/plugin_name 
 rake db:migrate_plugins RAILS_ENV=production 
 </code></pre> 

 h2. Mise à jour 

 > Version 3.1.0 

 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 
 # Renommer le répertoire actuel 
 <pre><code class="bash"> 
 cd /srv/ 
 mv redmine redmine.old 
 </code></pre> 
 # Télécharger la nouvelle version 
 <pre><code class="bash"> 
 wget http://www.redmine.org/releases/redmine-3.1.0.tar.gz 
 </code></pre> 
 # Décompresser le fichier 
 <pre><code class="bash"> 
 tar xvf redmine-3.1.0.tar.gz 
 mv redmine-3.1.0 redmine 
 </code></pre> 
 # Copier les anciens fichiers de configurations 
 <pre><code class="bash"> 
 cp redmine.old/config/configuration.yml redmine/config 
 cp redmine.old/config/database.yml redmine/config 
 cp -r redmine.old/files redmine 
 </code></pre> 
 # Refaire la sécurité 
 <pre><code class="bash"> 
 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 utiliser pour plusieurs dossier 
 chown wwwrun:www redmine/config.ru 
 chown -R wwwrun:www redmine/tmp 
 mkdir redmine/tmp/passenger 
 chown -R wwwrun:www redmine/tmp 
 chmod 0777 redmine/public/plugin_assets 
 chmod -R 0777 redmine/files 
 </code></pre> 
 # Ne copier que les « plugins » qui ne sont pas fournis par la nouvelle version de Redmine 
 <pre><code class="bash"> 
 cp -r redmine.old/plugins/* redmine/plugins 
 </code></pre> 
 # Installer les « gems » 
 <pre><code class="bash"> 
 cd redmine 
 bundle install --without development test 
 </code></pre> 
 # Mise à jour (base de donnés, « plugins ») et ménage : 
 <pre><code class="bash"> 
 bundle exec rake generate_secret_token 
 bundle exec rake db:migrate RAILS_ENV=production 
 bundle exec rake redmine:plugins:migrate RAILS_ENV=production 
 bundle exec rake tmp:cache:clear tmp:sessions:clear 
 </code></pre> 
 # Remettre le logo (facultatif) 
 # Relancer Redmine  
 # Vérifier  
 ## Administration 
 ### Projects 
 ### Users 
 ### Roles & permissions 
 ## Essayer d'attacher un fichier à un projet 
 ## Essayer d’accéder au calendrier d'un projet 

 h2. Copie de sécurité 

 [[Copie de sécurité]] 



 h2. Dépannage 

 h3. Mot de passe perdu 

 Le mot de passe admin par défaut est en _hash Sha1_ : *da3174755c5e82a436b6c7ff87c873ee50d6654b* et est *admin.* 

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

 Effacer le fichier _/srv/redmine/tmp/pids/server.pid_.