Wiki » Historique » Révision 39
Révision 38 (Patrice Nadeau, 2014-08-19 21:03) → Révision 39/279 (Patrice Nadeau, 2014-08-19 21:07)
%{font-size:18pt}Redmine%
> Merge du fichier PDF : issue:#13
---
{{toc}}
h1. 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
Pour une solution possible, voir : http://www.redmine.org/projects/redmine/wiki/HowTo_configure_Apache_to_run_Redmine
Sa principale difficulté d’installation et sa dépendance à Ruby. D’où le but de ce guide.
Voir aussi :
* http://bitnami.com/stack/redmine
* http://www.turnkeylinux.org/redmine
h1. Installation
Ce guide documente une installation GNU/Linux avec les version suivantes :
* openSUSE 13.1
* Redmine 2.4.2
h2. Prérequis
Un serveur LAMP openSUSE
Les logiciels suivants :
* libmysqlclient-devel
* mysql-community-server
* ruby-2.0
* ruby20-devel
* rubygem-bundler
* rubygem-mysql2
* rubygem-pg
* ImageMagick
* ImageMagick-devel
* git
* gcc
* make
h2. MySQL
Ajout au démarrage automatique et démarrage du service :
<pre><code class="bash">
chkconfig -a mysql
rcmysql start
</code></pre>
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>
h2. Redmine
L’installation sera faite dans _\srv\redmine_
<pre><code class="bash">
cd /srv/
svn co http://svn.redmine.org/redmine/branches/2.4-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.
h2. 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>
h2. 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>
Ouvrir dans le pare-feu :
* TCP : 3000
Lancer le serveur web (test)
<pre><code class="bash">
cd /srv/redmine
ruby script/rails server webrick -e production
</code></pre>
A partir d’un navigateur web, se brancher à http://server:3000.
Utiliser l’usager *admin* avec le mot de passe *admin*.
Vérifier la configuration dans *Administration*, *Information*.
h2. 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>
h1. Personnalisation
h2. Ajout d’un logo
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/layout/base.rhtml.erb_
* Ajouter 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>
* Si on ne veux plus afficher le titre, mettre en commentaire :
<pre><code class="ruby">
<!--<h1><%= page_header_title %></h1>-->
</code></pre>
Redémarrer Redmine
<pre><code class="bash">
rcredmine restart
</code></pre>
h2. Plugins
h3. Extended Fields
Permet de créer de nouveau champ dans la basse de donnés.
http://www.redmine.org/plugins/extended_fields
Installation :
<pre><code class="bash">
cd /srv/redmine
svn co http://svn.s-andy.com/extended-fields plugins/extended_fields
rake redmine:plugins:migrate RAILS_ENV=production
rcredmine restart
</code></pre>
h3. 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
# Relancer redmine
rcredmine restart
</code>
</pre>
h3. Code Highlight
http://www.redmine.org/plugins/codehightlight_button
Bouton permettant de sélectionner du code et d'activer la syntaxe selon un langage.
>Ne fonctionne pas pour les langages supplémentaires supportées par le « plug-in » _Redmine Rouge_. Voir "ici":https://github.com/mediatainment/redmine_codebutton/issues/2
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>
h3. Redmine Issue Checklist
Extends issues to store checklist items
http://redminecrm.com/projects/checklist
Installation
<pre><code class="bash">
cd /srv/redmine/plugins
wget http://redminecrm.com/license_manager/4200/redmine_issue_checklist-2_0_5.zip
unzip redmine_issue_checklist-2_0_5.zip
bundle exec rake redmine:plugins NAME=redmine_issue_checklist RAILS_ENV=production
# Relancer Redmine
rcredmine restart
</code></pre>
Configuration
Dans *Administration*
* *Plugins*
** Choisir les options voulues
* *Roles and permissions*
** Choisir le rôle
Donner les droits voulus sur :
*** Done checklist items
*** Edit checklist items
*** View checklist
h3. Redmine People
> A faire
h3. WikiNG
Personnalisation des items dans le wiki.
Ajoute des boutons et des icônes comme FIXME et TODO.
> « Écrase » le bouton installé par _Code Highlight_
Installation
<pre><code class="bash">
cd /srv/redmine
wget http://projects.andriylesyuk.com/attachments/download/564/wiking-1.0.0b.tar.bz2
tar xvf wiking-1.0.0b.tar.bz2
mv wiking plugins
rake redmine:plugins:migrate RAILS_ENV=production
# restart Redmine
rcredmine restart
</code></pre>
h1. Mise à jour
S’assurer d'avoir les dernières versions des plugins.
h1. Copie de sécurité
<pre> <code class="bash">
#!/bin/bash
#
# backup_redmine.sh
# Backup of a Redmine setup
# Last Changes: 2013-02-23
# Maintainer: Patrice Nadeau <patricen@telwarwick.net>
# TODO Verify the results (folder exist, enough disk pace , etc..)
## The only variable needed to be changed
# Directory of the Redmine install
declare -r RAIL_ROOT='/srv/redmine'
# MySQL database
declare -r MYSQL_DB=''
# MySQL username for the Redemine db
declare -r MYSQL_USER=''
# MySQL password for the Redemine db
declare -r MYSQL_PASSWORD=''
# Directory for the backup (must exist and with no space in the name)
declare -r DIR='/root'
## end
# Exit level
declare -ir EXIT_OK=0
declare -ir EXIT_WARNING=1
declare -ir EXIT_ERROR=2
declare -i STATUS=$EXIT_OK
# The directory inside the archive
declare -r REDMINE='redmine'
TMP_DIR=$DIR/$REDMINE
# This will be used for the archive file
declare -r DST=$DIR/redmine_$(date +%Y%m%d_%H%M%S).tar.gz
# The temporary sql file
declare -r TMP_MYSQL=$TMP_DIR/$MYSQL_DB.mysql
echo "Backup in progress in $DST"
#### Create the temp directory ####
mkdir $TMP_DIR
#### backup MySQL ####
if [ $STATUS -eq $EXIT_OK ]
then
STEP='Creating MySQL backup'
mysqldump --user=$MYSQL_USER --password=$MYSQL_PASSWORD $MYSQL_DB \
> $TMP_MYSQL
STATUS=$?
fi
#### backup the Redmine folder ####
if [ $STATUS -eq $EXIT_OK ]
then
STEP='Creating Redmine'"'"' files backup'
cp --recursive $RAIL_ROOT $TMP_DIR
STATUS=$?
fi
#### create the archive file ####
if [ $STATUS -eq $EXIT_OK ]
then
STEP="Creating archive"
tar --create --gzip --file $DST --directory=$DIR $REDMINE
STATUS=$?
fi
#### cleanup ####
if [ $STATUS -eq $EXIT_OK ]
then
STEP='Cleaning up'
rm --recursive --force $TMP_DIR
STATUS=$?
fi
#### exit ####
if [ $STATUS -eq $EXIT_OK ]
then
echo "Backup done"
else
echo "Bakup failed with error code $STATUS in step $STEP"
fi
exit $STATUS
</code></pre>
h1. Dépannage
h2. Mot de passe perdu
Le mot de passe admin par défaut est en _hash Sha1_ : *da3174755c5e82a436b6c7ff87c873ee50d6654b* et est *admin.*
h2. Le service tombe « DEAD » a chaque fois
Effacer le fichier _/srv/redmine/tmp/pids/server.pid_.