Installation sur un serveur GNU/Linux Ubuntu

De wiki CoRM
Aller à : navigation, rechercher

Cette procédure montre pas à pas comment installer la solution CoRM sur un serveur GNU/Linux Ubuntu.

Introduction

Il est recommandé d'utiliser un serveur dédié afin d'installer CoRM. Cependant, si vous savez ce que vous faites, ce n'est nullement obligatoire.

Pour information, notre solution s'appuie sur une Architecture 3 tiers.

Architecture 3 tiers

Prérequis

Vous devez connaitre les commandes de base d'un système GNU/Linux.
Les prérequis afin d'installation la solution CoRM sont les suivants.

Matériel

  • CPU : au moins 1 cœur ;
  • Architecture CPU : 64 bits ;
  • Mémoire vive : au moins 1Go ;
  • Espace disque : au moins 15Go ;

Logiciel

  • Système d'exploitation GNU/Linux [http://fr.wikipedia.org/wiki/Ubuntu Ubuntu 14.04 LTS (de préférence fraichement installé) ;
  • Apache 2.2 ;
  • Ruby 1.9.3 ;
  • Rails 3.2.18 ;
  • Serveur PostgreSQL 9.3 ;

Installation

L'installation du système d'exploitation n'est pas détaillée ici.
Cependant, vous trouverez de nombreux guides d'installation sur Internet.

Avant d'installer quoique ce soit, assurez-vous que votre système soit à jour :
# apt-get update
# apt-get install git


Serveur Web Apache


# apt-get install apache2


À partir de ce moment, vous pouvez faire pointer votre navigateur préféré à l'adresse de votre serveur GNU/Linux.

Apache Test page


Serveur PostgreSQL


# apt-get install postgresql postgresql-contrib

Initialiser le moteur de base de données (avec le bon encoding)
pg_dropcluster --stop 9.3 main
pg_createcluster --start -e UTF-8 9.3 main

Initialiser le mot de passe administrateur de PostgreSQL :
# su - postgres
-bash-4.1$ psql
postgres=# ALTER USER postgres WITH ENCRYPTED PASSWORD 'MyGreatPassword' ;
postgres=# \q


Le nouveau mot de passe administrateur (postgres) est donc "MyGreatPassword".

# vi /etc/postgresql/9.3/main/pg_hba.conf
local all postgres password

# service postgresql restart

Language Ruby


# apt-get install ruby ruby-dev make

Vérification :
# ruby -v
ruby 1.9.3p484 (2013-11-22 revision 43786) [arm-linux-eabihf]

Framework Ruby-on-Rails

# gem update
# gem install --no-rdoc --no-ri rails -v 3.2.18

Pour vérifier si tout a fonctionné :
# rails -v
Rails 3.2.18

Passenger (mod_rails)

Passenger sert de "passerelle" entre le serveur Apache et l'application Rails...

Pré-requis :
# apt-get install openssl libssl-dev apache2-dev curl libcurl4-openssl-dev

# gem install passenger
# passenger-install-apache2-module
> (*) Ruby
( ) Python
( ) Node.js
( ) Meteor

Attention à bien copier le code de configuration du serveur apache !
Dans mon exemple :
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>

Récupération du code source

# cd /
# mkdir webapps
# cd webapps/
# git clone https://github.com/SIGIRE/CoRM.git
# cd CoRM/

Configuration du socle logiciel

Serveur Web

Ajouter les lignes suivantes au fichier de configuration du serveur web.

# vi /etc/apache2/apache2.conf
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>

VHOST

# vi /etc/apache2/sites-available/my_CoRM_Apps.conf

<VirtualHost 192.168.0.63:80>
ServerName www.domain.tld
# !!! Be sure to point DocumentRoot to 'public'!
DocumentRoot /webapps/CoRM/public
<Directory /webapps/CoRM/public>
# This relaxes Apache security settings.
AllowOverride all
# MultiViews must be turned off.
Options -MultiViews
Require all granted
</Directory>

RailsEnv production

# Activation de la compression
SetOutputFilter DEFLATE

</VirtualHost>

Activation du Vhost :
a2ensite my_CoRM_Apps.conf
service apache2 restart

Base de données

Pour des questions de simplicité, nous utilisons l'utilisateur administrateur afin de créer la connexion avec la base de données. En environnement de production, il est préférable de créer un utilisateur dédié avec des droits uniquement sur sa base.

# cd /webapps/CoRM/config
# cp database.yml.example database.yml

# vi database.yml
development:
  adapter: postgresql
  encoding: unicode
  database: db_corm_dev
  pool: 5
  username: postgres
  password: MyGreatPassword

test:
  adapter: postgresql
  encoding: unicode
  database: db_corm_test
  pool: 5
  username: postgres
  password: MyGreatPassword

production:
  adapter: postgresql
  encoding: unicode
  database: db_corm_prod
  pool: 5
  username: postgres
  password: MyGreatPassword

Fichier de sécurité

# cp application.yml.default application.yml
# vi application.yml
CORM_SECRET_TOKEN:
64a4aa0d52e1611fe17027ad78e5b55a1495fc2770b2fdb2e570eea6fc2c2c031f7de0e07ea4d2a8fce30237c696d92072ec7c94b7020a19bc52ba1734c09743
DEVISE_SECRET_KEY:
48af28f68a5a821b2e0c9f404130d8c566d47d43883c3460108137110013af4993ddc79f73f66e49c28ff866c329ffbe05aa7239f2b5d840c2b81471691ad9dc

Pour des questions de sécurité, vous devez modifier les deux valeurs ci-dessus.

Fichier de paramètres

# cp CORM.json.example CORM.json
# vi CORM.json

{
 "protocol": "http",
 "host": "localhost",
 "mail": {
   "type": ":smtp",
   "host": "localhost",
   "port": 25,
   "from": "no_reply@corm.fr"
 }
}

Remplacez les valeurs correspondant à votre configuration ("host" : le nom de votre serveur, "protocol" : "http" ou "https", "from" : l'adresse e-mail servant à expédier les messages).

Initialisation de l'application

# cd /webapps/CoRM
# bundle install
# rake db:setup RAILS_ENV=production
# bundle exec rake assets:precompile:all RAILS_ENV=production
# chown www-data:www-data /webapps/CoRM/ -R
# service apache2 restart

Premier lancement

À ce stade vous devez visualiser cette page si vous pointez votre navigateur sur votre serveur.

Premier démarrage

Configuration de l'application

Création du compte Administrateur

Un compte administrateur existe déjà : admin@domain.tld avec comme mot de passe password.
Si ce n'est pas le cas, pointez votre navigateur à l'adresse suivante : http://192.168.1.55/user/new Vous pourrez alors configurer le compte administrateur de l'application.
Attention, le mot de passe doit contenir au moins 6 caractères !

Compte Admin

Remarque : le compte administrateur est à utiliser uniquement pour les tâches d'administration.

Création des comptes Utilisateurs

Une fois votre compte administrateur créé, il faut bien entendu créer les comptes propres à vos utilisateurs : Menu Paramètres --> Administration --> Configuration --> Utilisateurs.

Remarque : Seul l'Administrateur peut créer un utilisateur.

Compte User

Puis affecter leur rôle adéquat.

Utilisateurs créés et rôles disponibles

Configuration générale

Votre application est presque prête.
Il vous reste à personnaliser le logo d'accueil et éventuellement un serveur de messagerie POP afin d'activer la fonctionnalité "mail-to-event".
Menu Paramètres --> Administration --> Configuration --> Configuration de CoRM

Enfin ultime configuration : le modèle des devis. Menu Paramètres --> Administration --> Configuration --> Modèles devis.

Félicitation

Bravo, votre application est à présent configurée !
La procédure d'installation est donc terminée.