Voir la source de Installation sur un serveur GNU/Linux CentOS

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

== 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 [http://fr.wikipedia.org/wiki/Architecture_trois_tiers Architecture 3 tiers].
[[Fichier:Archi_3tiers.png|center|Architecture 3 tiers]]

== Prérequis ==
Vous devez connaitre les commandes de base d'un système GNU/Linux.<br />
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/CentOS CentOS 6.5] (de préférence fraichement installé) ;
* Apache 2.2 ;
* Ruby 1.9.3 ;
* Rails 3.2.18 ;
* Serveur PostgreSQL 8.4 ;

== Installation ==

L'installation du système d'exploitation n'est pas détaillée ici.<br />
Cependant, vous trouverez de nombreux guides d'installation sur Internet.<br />
À commencer par [http://www.tecmint.com/centos-6-5-installation-guide-with-screenshots/ celui-ci].<br />

Avant d'installer quoique ce soit, assurez-vous que votre système soit à jour :<br />
<code># yum update -y</code>

Pour des questions de simplicité, nous allons désactiver le firewall ''IPTABLES'' puis ''SELINUX'' :<br />
<code># vi /etc/selinux/config</code><br />
<code>SELINUX=disabled</code><br />

<code># rm -rf /etc/rc3.d/S08ip*</code><br />

Afin de prendre en compte les modifications, il faut redémarrer votre serveur.<br />
<code># reboot</code>

=== Serveur Web Apache ===
<br />
<code># yum install httpd httpd-devel -y</code><br />
<code># chkconfig httpd on</code><br />
<code># service httpd start</code><br />
<br />
À partir de ce moment, vous pouvez faire pointer votre navigateur préféré à l'adresse de votre serveur GNU/Linux.
[[Fichier:Install_CoRM_Apache_Test_Page.PNG|center|thumb|400px|Apache Test page]]
<br />

=== Serveur PostgreSQL ===
<br />
<code># yum install postgresql-server postgresql-devel -y</code><br />
<code># chkconfig postgresql on</code><br />
<code># service postgresql initdb</code><br />
<code># service postgresql start</code><br />
<br />
Initialiser le mot de passe administrateur de PostgreSQL :<br />
<code># su - postgres</code><br />
<code>-bash-4.1$ psql</code><br />
<code>postgres=# ALTER USER postgres WITH ENCRYPTED PASSWORD 'MyGreatPassword' ;</code><br />
<code>postgres=# \q</code><br />
<code>-bash-4.1$ logout</code><br />
<br />
Le nouveau mot de passe administrateur (postgres) est donc "MyGreatPassword".
<br />

<code># vi /var/lib/pgsql/data/pg_hba.conf</code><br />
<code>local   all         all                               password</code><br />

<code># service postgresql restart</code><br />

=== Language Ruby ===
La version de ruby fournie avec le système est trop ancienne (1.8.7).
Nous allons récupérer puis compiler une version plus récente.
<br /><br />
Présrequis :<br />
<code># yum groupinstall 'Development Tools' -y</code><br />
<code># yum install curl-devel openssl-devel zlib-devel apr-devel apr-util-devel readline-devel wget -y</code><br />
<br />
Libyaml :<br />
<code># cd /usr/local/src</code><br />
<code># wget http://pyyaml.org/download/libyaml/yaml-0.1.4.tar.gz</code><br />
<code># tar xzvf yaml-0.1.4.tar.gz</code><br />
<code># cd yaml-0.1.4</code><br />
<code># ./configure --prefix=/usr/local</code><br />
<code># make && make install</code><br />
<br />
Ruby :<br />
<code># cd /usr/local/src</code><br />
<code># wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p547.tar.gz</code><br />
<code># tar xzvf ruby-1.9.3-p547.tar.gz</code><br />
<code># cd ruby-1.9.3-p547</code><br />
<code># ./configure --prefix=/usr/local --enable-shared --disable-install-doc --with-opt-dir=/usr/local/lib</code><br />
<code># make && make install</code><br />
<br />
Création d'un lien symbolique :<br />
<code># ln -s /usr/local/src/ruby-1.9.3-p547/ruby /usr/bin</code><br />
<br />
Vérification :<br />
<code># ruby -v</code><br />
<code>ruby 1.9.3p547 (2014-05-14 revision 45962) [x86_64-linux]</code><br />

=== Framework Ruby-on-Rails ===

<code># gem update</code><br />
<code># gem install --no-rdoc --no-ri rails -v 3.2.18</code><br />

Pour vérifier si tout a fonctionné :<br />
<code># rails -v</code><br />
<code>Rails 3.2.18</code><br />

=== Passenger (mod_rails) ===
[https://www.phusionpassenger.com/ Passenger] sert de "passerelle" entre le serveur Apache et l'application Rails...

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

Attention à bien copier le code de configuration du serveur apache !<br />
Dans mon exemple : <br />
<code>LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.53/buildout/apache2/mod_passenger.so</code><br />
<code><IfModule mod_passenger.c></code><br />
<code>PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.53</code><br />
<code>PassengerDefaultRuby /usr/local/bin/ruby</code><br />
<code></IfModule></code><br />

== Récupération du code source ==

<code># cd /</code><br />
<code># mkdir webapps</code><br />
<code># cd webapps/</code><br />
<code># git clone https://github.com/SIGIRE/CoRM.git</code><br />
<code># chown apache:apache CoRM/ -R</code><br />
<code># cd CoRM/</code><br />

== Configuration du socle logiciel ==
=== Serveur Web ===
Ajouter les lignes suivantes au fichier de configuration du serveur web.

<code># vi /etc/httpd/conf/httpd.conf</code><br />
<code>LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.53/buildout/apache2/mod_passenger.so</code><br />
<code><IfModule mod_passenger.c></code><br />
<code>PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.53</code><br />
<code>PassengerDefaultRuby /usr/local/bin/ruby</code><br />
<code></IfModule></code><br />

==== VHOST ====
<code># vi /etc/httpd/conf.d/my_CoRM_Apps.conf</code><br />

<code><VirtualHost 192.168.1.55:80></code><br />
<code>      ServerName www.domain.tld</code><br />
<code>      # !!! Be sure to point DocumentRoot to 'public'!</code><br />
<code>      DocumentRoot /webapps/CoRM/public</code><br />
<code>      <Directory /webapps/CoRM/public></code><br />
<code>         # This relaxes Apache security settings.</code><br />
<code>         AllowOverride all</code><br />
<code>         # MultiViews must be turned off.</code><br />
<code>         Options -MultiViews</code><br />
<code>      </Directory></code><br />
<code></code><br />
<code>RailsEnv production</code><br />
<code></code><br />
<code># Activation de la compression</code><br />
<code>SetOutputFilter DEFLATE</code><br />
<code></code><br />
<code># Activation de l'expiration</code><br />
<code>ExpiresActive On</code><br />
<code><FilesMatch "\.(ico|gif|jpe?g|png|js|css)$"></code><br />
<code>  ExpiresDefault "access plus 1 year"</code><br />
<code>  Header append Cache-Control "public"</code><br />
<code></FilesMatch></code><br />
<code></code><br />
<code></VirtualHost></code><br />

=== 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.

<code># cd CoRM/config</code><br />
<code># cp database.yml.example database.yml</code><br />

<code># vi database.yml</code><br />
<code>development:</code><br />
<code>&nbsp;&nbsp;adapter: postgresql</code><br />
<code>&nbsp;&nbsp;encoding: unicode</code><br />
<code>&nbsp;&nbsp;database: db_corm_dev</code><br />
<code>&nbsp;&nbsp;pool: 5</code><br />
<code>&nbsp;&nbsp;username: postgres</code><br />
<code>&nbsp;&nbsp;password: MyGreatPassword</code><br />
<code></code><br />
<code>test:</code><br />
<code>&nbsp;&nbsp;adapter: postgresql</code><br />
<code>&nbsp;&nbsp;encoding: unicode</code><br />
<code>&nbsp;&nbsp;database: db_corm_test</code><br />
<code>&nbsp;&nbsp;pool: 5</code><br />
<code>&nbsp;&nbsp;username: postgres</code><br />
<code>&nbsp;&nbsp;password: MyGreatPassword</code><br />
<code></code><br />
<code>production:</code><br />
<code>&nbsp;&nbsp;adapter: postgresql</code><br />
<code>&nbsp;&nbsp;encoding: unicode</code><br />
<code>&nbsp;&nbsp;database: db_corm_prod</code><br />
<code>&nbsp;&nbsp;pool: 5</code><br />
<code>&nbsp;&nbsp;username: postgres</code><br />
<code>&nbsp;&nbsp;password: MyGreatPassword</code><br />

=== Fichier de sécurité ===

<code># cp application.yml.default application.yml</code><br />
<code># vi application.yml</code><br />
<code>CORM_SECRET_TOKEN: </code><br /><code>64a4aa0d52e1611fe17027ad78e5b55a1495fc2770b2fdb2e570eea6fc2c2c031f7de0e07ea4d2a8fce30237c696d92072ec7c94b7020a19bc52ba1734c09743 </code><br />
<code>DEVISE_SECRET_KEY: </code><br /><code>48af28f68a5a821b2e0c9f404130d8c566d47d43883c3460108137110013af4993ddc79f73f66e49c28ff866c329ffbe05aa7239f2b5d840c2b81471691ad9dc </code><br />

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

== Initialisation de l'application ==
<code># cd /webapps/CoRM</code><br />
<code># bundle install</code><br />
<code># rake db:setup RAILS_ENV=production</code><br />
<code># bundle exec rake assets:precompile:all RAILS_ENV=production</code><br />
<code># service httpd restart</code><br />

== Premier lancement ==
À ce stade vous devez visualiser cette page si vous pointez votre navigateur sur votre serveur.
[[Fichier:Install_CoRM_First_Start.PNG|center|thumb|400px|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'''.<br />
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.<br />
Attention, le mot de passe doit contenir au moins 6 caractères !
[[Fichier:Install_CoRM_Admin.PNG|center|thumb|400px|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.

[[Fichier:Install_CoRM_User.PNG|center|thumb|400px|Compte User]]

Puis affecter leur rôle adéquoit.

[[Fichier:CoRM_Roles.PNG|center|thumb|400px|Utilisateurs créés et rôles disponibles]]

=== Configuration générale ===

Votre application est presque prête.<br />
Il vous reste à personnaliser le logo d'accueil et éventuellement un serveur de messagerie POP afin d'activer la fonctionnalité "mail-to-event".
<br />
Menu Paramètres --> Administration --> Configuration --> Configuration de CoRM<br />
<br />
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 !<br />
La procédure d'installation est donc terminée.