TUTO : Installation de Redmine sous WS2012

Matériels nécessaires :
- Une machine sous WS2012
- Xampp 7.2.1
- RailsInstaller 3.4.0
- Redmine 3.4.4
- Connexion internet

ETAPE 1 / INSTALLATION DE XAMPP

- Télécharger Xampp 7.2.1

- Activer les services Apache et Mysql sur Xampp

ETAPE 2 / CREATION DE LA BDD ET UN USER POUR ADMINISTRER LA BASE

- Création de la BDD dans Phpmyadmin : taper sur internet ‘localhost/phpmyadmin’

- Création d’un user pour l’administration de la base : Taper la requête suivante :
CREATE DATABASE redmine CHARACTER SET utf8 ;
CREATE USER ‘redmine’@’localhost’ IDENTIFIED BY ‘redmine123’ ;
GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine’@’localhost’ ;

ETAPE 3 / INSTALLATION DE RAILSINSTALLER

- Installer Railsinstaller 3.4.0

- L’installer en tant qu’administrateur dans votre C :
ETAPE 4 / INSTALLATION DE REDMINE

- Installer redmine 3.4.4

Décompresser le zip ici C:\xampp\htdocs

- Editer le nom du fichier database.yml.example en database.yml, la route sera

« C:\xampp\htdocs\redmine-3.4.4\config\database.yml »

- Editer le fichier, sur la partie production modifier les paramètres comme ceci :
Production :
Adapter : mysql2
Database : redmine
Host : localhost
Username : redmine
Password : « redmine123 »
Encodinf : utf8

ETAPE 5 / CONFIGURATION DE REDMINE

- Maintenant, ouvrir CMD et placé vous dans le répertoire ‘C:\xampp\htdocs\redmine-

3.4.4’

- Exécuter la commande suivante afin d’installer les dépendances et installer nos

paquet Gem = Apt-get sur linux.

Gem install bundler

Gem install rake

Bundle install –without development test rmagick

ETAPE 6 / GENERATION DES TOKEN

- Générer des token pour la génération des cookies des utilisateurs qui se
connecteront. Rails l’utilisera pour prévenir des accès malveillants.
Toujours sur le chemin de redmine, taper la commande suivante :

Bundle exec rake generate_secret_token

ETAPE 7 / CREATION DE LA STRUCTURE DE LA BDD

- Création d’une variable d’environnement, taper la commande suivante :

SET RAILS_ENV=production

- Exécuter la commande suivante pour créer la structure de la BDD :

Il va créer des tables en exécutant toutes les migrations puis créer l’ensemble des
permissions et le compte admin de l’application, nommé admin.
Bundle exec rake db:migrate

- Redmine a besoin d’un ensemble de données de base pour pouvoir fonctionner.

Lancer la commande suivante pour réaliser l’insertion dans notre base :

Set RAILS_ENV=production
Set REDMINE_LANG=fr
Bundle exec rake redmine:load_default_data

Nous avons fini la configuration de Redmine, nous pouvons avoir un aperçu de la

configuration générale de notre système en exécutant la commande suivante :

Gem env

ETAPE 8 / CONFIGURATION DU SERVICE WEB

- Pour la configuration du service web, lancer les commandes suivantes :

Gem install rails

 Bundle exec rails server webrick -e production

- L’accès internet se fera sur l’adresse suivante : http://localhost:3000

Connexion par defaut login : admin mdp : admin

CONFIGURATION NOTIFICATION PAR MAIL AVEC

ACTION MAILER

*les fichier ce trouve en annexe plus bas dans la page.

ETAPE 1 / FICHIER SMTP_TLS.RB

- Beaucoup de problèmes sont rencontrés par rapport à la sécurité (SSL) lors de la

configuration des mails. Ce qu’il va falloir faire, c’est de copier le fichier smtp_tls.rb
(fichier pour pallier le problème de sécurité) et le copier dans :

‘C:\xampp\htdocs\redmine-3.4.4\lib’

ETAPE 2 / INSTALLER ACTIONMAILER

- Installer maintenant Actionmailer

Gem Install Actionmailer

ETAPE 3 / REMPLIR LE FICHIER ENVIRONNEMENT.RB

- -Aller ici : ‘C:\xampp\htdocs\redmine-3.4.4\config’ , vous trouvez le fichier

environnement.rb. Ouvrez le et à la fin copiez ces lignes

ETAPE 4 / CONFIGURATION DU SMTP

- Aller dans ‘C:\xampp\htdocs\redmine-3.4.4\config’ , vous trouverez le fichier

configuration.yml.example, renommer le en configuration.yml, ce fichier va ine
 installapermettre d’établir la connexion par smtp. Copiez ces lignes est rentrer les
valeurs correspondant à votre fichier environnement.rb

- production:

- delivery_method: :smtp

- smtp_settings:

- address: smtp.example.net

- port: 587

- domain: example.net

- authentication: :login

- user_name: redmine@example.net

- password: ‘PASSWORD’

ETAPE 5 / TEST

-Redémarrer votre serveur, rendez-vous dans : Administration  Configuration

Notification par mail

Renseignez votre adresse mail que vous avez noté dans vos fichier et effectuer le test
d’émission. Vous devriez alors recevoir un mail de redmine !
 Mémo :

Bundler = Gérer les dépendances entre les gem

Rmagick = permet de manipuler les images pour l’exportation pdf et png

Token = Génération d’une clé aléatoire utiliser par Rails pour encoder les coookies
stockant les données de session, empêchant ainsi leur falsification.

Qu'est ce qu'un Gem ?

Un Gem est un paquet fournit par la communauté de Ruby.
On peut comparer ça en quelque sorte a un "zip", il contient le module à installer, et
un descripteur qui est utiliser pour l'installer (et lu automatiquement par RubyGems).
le Gem peut être téléchargé manuellement ou automatiquement via RubyGems.

RubyGems , c'est quoi ?

RubyGems est un gestionnaire de Package Similaire a "apt-get", mais qui est codé en
"PureRuby", et sert a installer/supprimer/mettre à jour des modules Ruby.

Webrick : WEBrick est un serveur web libre intégré à Ruby depuis la version 1.8 et
utilisé par Ruby on Rails. Les auteurs initiaux de WEBrick sont Takahashi Masayoshi et
Gotou Yuuzou, avec les contributions d'autres développeurs selon le modèle du
logiciel libre.

Production = Là ou on va générer la base entiere, ici = redmine

 Annexe :
Fichier smtp_tls.rb
require "openssl"
require "net/smtp"

Net::SMTP.class_eval do
private
def do_start(helodomain, user, secret, authtype)
raise IOError, 'SMTP session already started' if @started
check_auth_args user, secret, authtype if user or secret

sock = timeout(@open_timeout) { TCPSocket.open(@address, @port) }

@socket = Net::InternetMessageIO.new(sock)
@socket.read_timeout = 60 #@read_timeout
@socket.debug_output = STDERR #@debug_output

check_response(critical { recv_response() })
do_helo(helodomain)

raise 'openssl library not installed' unless defined?(OpenSSL)

starttls
ssl = OpenSSL::SSL::SSLSocket.new(sock)
ssl.sync_close = true
ssl.connect
@socket = Net::InternetMessageIO.new(ssl)
@socket.read_timeout = 60 #@read_timeout
@socket.debug_output = STDERR #@debug_output
do_helo(helodomain)

authenticate user, secret, authtype if user

@started = true
ensure
unless @started
# authentication failed, cancel connection.
@socket.close if not @started and @socket and not @socket.closed?
@socket = nil
end
end

def do_helo(helodomain)
begin
if @esmtp
ehlo helodomain
else
helo helodomain
end
rescue Net::ProtocolError
if @esmtp
@esmtp = false
@error_occured = false
retry
end
raise
end
end

def starttls
getok('STARTTLS')
 end

def quit
begin
getok('QUIT')
rescue EOFError
end
end
end

Fichier à copier dans environnement.rb

# Initialize the rails application
RedmineApp::Application.initialize!
require "smtp_tls"
ActionMailer::Base.smtp_settings = {
:enable_starttls_auto => true,
:address => "smtp.example.fr",
:port => 587,
:domain => "smtp.example.fr",
:authentication => :plain,
:user_name => "yourmail@gmail.com",
:password => "YOUPASS"
}