Présentation

Redmine est une application web de management de projet il est écrit en Ruby et il est compatible toutes plateformes et toutes bases de données.

Redmine est un Projet Opensource sous license GNU/GPL .

Il dispose de pleins de fonctionnalités différentes, mais les plus intéressantes sont:

-support de multiples projets
-on peut créer des tickets d'incidents pour troubleshooter
-il comporte un plugin pour github
-il dispose d'un forum et d'un wiki

Installation de Ruby

Cette installation a été faite pour Redmine 2.x et ruby 1.9 donc certaines commandes peuvent êtres différentes

Redmine utilise ce que l'on appel des GEM qui est un gestionnaire de package pour ruby. Tout les paramètres définis pour redmine (tel que la bdd) sont écris dans le fichier config/configuration.yml, on modifiera ce fichier plusieurs fois pour ajouter des fonctionnalités.

Avant tout , il faut savoir que Redmine utilise le langage Ruby donc on va commencer par l'installer, et pour ça il suffis tout simplement de faire:

apt-get install ruby-dev

Pleins d'autres modules seront a installer pour redmine via gem, il suffira de faire:

gem install monpackage -v x.x.x

Installation de redmine

Pour commencer on installe notre bundler avec gem:

gem install bundler

ensuite on installe les GEM:

bundle install --without test rmagick 

“–without” pour exclure les gem que l'on ne veut pas installer.

Ensuite on crée la structure de la base de données à l'aide de la commande suivante:

RAILS_ENV=production rake db:migrate

cette commande aura pour effet de créer les tables et les permissions et le compte de l'administrateur qui sera par défaut 'admin:admin'

voici un exemple de configuration de base de donnée se trouvant dans 'config/database.yml'

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: my_password

ruby 1.9 demande a ce que la database soit en mysql2 alors que ruby 1.8 lui veut du mysql

Si on veut insérer la configuration par défaut dans la base de données on utilise tout simplement la commande suivante:

RAILS_ENV=production rake redmine:load_default_data

Les compte des utilisateurs utilisent certains fichier a qui il faudra donc donner les droits d’écriture le mieux est donc de les mettre en 755, ces fichiers ou dossiers sont:

-dossier files
-dossier log/production.log
-tmp et tmp/pdf
-public/plugin_assets

si vous lancez l'application avec l'utilisateur redmine,il faudra lancer les commandes suivantes:

mkdir -p tmp tmp/pdf public/plugin_assets #(si ils n'existent pas)
sudo chown -R redmine:redmine files log tmp public/plugin_assets

Normalement après toutes ces manipulations, Redmine doit fonctionner, et pour vérifier cela on va lancer la commande:

ruby script/server webrick -e production pour redmine 1.4.x
ruby script/rails server webrick -d production #(-p 80 si vous voulez le lancer sur le port 80)

On utilise WEBRICK pour tester l'installation mais pour un usage sur un serveur de prod il est conseillé d'utiliser autre chose tel que fcgi ou passenger, sachez qu'il en existe pleins d'autres.

après ça on va directement aller sur notre navigateur préféré afin de vérifier que tout fonctionne, et pour ça , taper juste votre adresse dans la barre avec le port correspondant ex:http://localhost:xxxx/

et normalement une jolie page apparait et vous pourrez vous logger avec les identifiants générés tout a l'heure, soit : admin:admin

On peut changer l'emplacement de stockage des fichiers et autre en ajoutant dans 'config/configuration.yml' la ligne:

attachments_storage_path: /var/redmine/files

Backup et sécurité

Voici deux autres commandes tres utiles si vous voulez creer un backup de vos données:

rsync -a /path/to/redmine/files /path/to/backup/files # pour les fichiers déposés
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz # pour la base de données

Si vous voulez ajouter un peu de sécurité et encoder les cookies vous pouvez utiliser la commande suivante:

rake generate_session_store pour redmine 1.4.x
rake generate_secret_toke

cette commande génère une clé aléatoire utilisée par Rails pour encoder les données pour éviter qu'elles dumpées, ou du moins pour les chiffrer.

Apache

Si vous voulez utiliser redmine a tout temps ou que votre application est susceptible d'avoir du traffic, le mieux est de ne plus le lancer avec webrick mais plutôt avec passenger qui est un module d'apache2 et qui est plus approprié. Pour commencer on va l'installer avec gem: gem install passenger ensuite on lance l'installation du module:

sudo /var/lib/gems/1.9.1/gems/passenger-4.0.53/bin/passenger-install-apache2-module

on choisis le langage, ici ce sera ruby(espace pour selectionner) et on laisse l'installation se faire. Une fois l'installation terminée on édite le fichier /etc/apache2/apache2.conf et on y ajoute ces lignes:

   LoadModule passenger_module /var/lib/gems/1.9.1/gems/passenger-4.0.53/buildout/apache2/mod_passenger.so 
   <IfModule mod_passenger.c> 
     PassengerRoot /var/lib/gems/1.9.1/gems/passenger-4.0.53 
     PassengerDefaultRuby /usr/bin/ruby1.9.1 
   </IfModule> 

on modifie /etc/apache2/mods/enabled/passenger.conf et on y rajoute

<IfModule mod_passenger.c> 
  PassengerRoot /var/lib/gems/1.9.1/gems/passenger-4.0.53 
  #PassengerRuby /usr/lib/ruby1.9.1 
</IfModule> 

ainsi que /etc/apache2/mods/enabled/passenger.load et on y rajoute

LoadModule passenger_module /var/lib/gems/1.9.1/gems/passenger-4.0.53/buildout/apache2/mod_passenger.so

On configure un Vhost redmine de la sorte:

   <VirtualHost *:80>  
      DocumentRoot /usr/share/redmine/redmine-2.4.7/public 
      ServerName 5.104.99.17 
      <Directory /var/www/redmine/redmine-2.4.7/public> 
         AllowOverride all 
          Options -MultiViews 
        Require all granted 
      </Directory> 
   </VirtualHost>

Ne pas oublier de faire notre lien symbolique redmine pour qu'il soit accessible:

ln -s /usr/share/redmine/redmine-2.4.7/public /var/www/redmine/redmine-2.4.7/public

On redémarre notre serveur apache avec la commandes sudo service apache2 restart

et le tour est joué, il ne vous reste plus qu'a vous y mettre.

wiki/redmine.txt · Dernière modification: 2018/04/23 19:13 (modification externe)
CC0 1.0 Universal
Powered by PHP Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0 Valid HTML5