wiki CoRM - Nouvelles pages [fr]

Déploiement à partir d'un template VMware

2015-01-13T08:53:49Z

Admin : /* Service CoRM */

Cette procédure montre pas à pas comment installer la solution CoRM sur un serveur GNU/Linux parmi ceux proposés.

== 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. 
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 de cités ci-dessous ;
* Apache 2.2 ;
* Ruby 1.9.3 ;
* Rails 3.2.18 ;
* Serveur PostgreSQL 9.3 ;

== Installation ==

=== Déploiement de la VM ===

Sous VMware, sélectionnez votre template, faites un clique droit, puis "Déployer la VM à partir de ce template".

[[Fichier:Wiki_VM_1.png|center|thumb|400px|Déploiement]]

Remplissez les champs demandés, notamment :

1.a - Donnez un nom à votre machine virtuelle et choisissez son emplacement.

1.b - Sélectionnez un cluster, un hôte, un vApp ou un pool de ressources pour exécuter cette machine virtuelle.

1.c - Ne vous aventurez pas dans les options, sélectionnez juste un espace de stockage.

1.d - Cochez toutes les cases pour pouvoir configurer votre VM comme vous le souhaitez.

Voilà votre VM est maintenant crée.

== Configuration sous CentOS 6.6 ==

=== Service Apache ===

Lancez votre machine nous allons commencer par configurer son interface réseau, tout d'abord si votre interface réseau n'est pas configurée sur Eth0(Ce qui peut arriver avec le clonage), voici la procédure à suivre :

<code>vi /etc/udev/rules.d/70-persistent-net.rules</code>

Nous avons plusieurs zones dans ce fichier. La première associe l'ancienne adresse Mac avec eth0, la dernière avec la nouvelle adresse Mac qui a pour eth "X".
Il faut supprimer les zones qui précèdent la dernière zone et modifier la dernière pour associer la nouvelle adresse Mac avec eth0, en clair changer le numéro sur eth à la fin et mettre 0.

Une fois cela fait rendez vous dans '''/etc/sysconfig/network-scripts/ifcfg-eth0''', si ifcfg-eth0 créez le, une fois dans ce fichier modifiez l'adresse ip et l'adresse Mac avec ceux désirés.

Pour que les changements soient pris en compte lancez :

<code>start_udev</code> 
<code>service network restart</code>

Vous pouvez mettre dans votre navigateur votre adresse IP afin de pointez sur la page de test Apache, voici ce que vous devriez obtenir :

[[Fichier:Install_CoRM_Apache_Test_Page.PNG|center|thumb|400px|Apache page]]

=== Service CoRM ===

Modification du VirtualHost avec votre IP

<code> vi /etc/httpd/conf.d/my_CoRM_Apps.conf </code> 

Puis modifiez cette ligne en changeant l'adresse IP par la votre

<VirtualHost "Votre adresse IP":80>

Enfin, vous pouvez ré-ouvrir un navigateur et pointer à votre adresse IP, vous aurez alors l'application CoRM.

[[Fichier:Install_CoRM_First_Start.PNG|center|thumb|400px|Premier démarrage]]

== Configuration sous Ubuntu ==

=== Service Apache ===

Lancez votre machine nous allons commencer par configurer son interface réseau, tout d'abord si votre interface réseau n'est pas configurée sur Eth0(Ce qui peut arriver avec le clonage), voici la procédure à suivre :

<code>vi /etc/udev/rules.d/70-persistent-net.rules</code>

Nous avons plusieurs zones dans ce fichier. La première associe l'ancienne adresse Mac avec eth0, la dernière avec la nouvelle adresse Mac qui a pour eth "X".
Il faut supprimer les zones qui précèdent la dernière zone et modifier la dernière pour associer la nouvelle adresse Mac avec eth0, en clair changer le numéro sur eth à la fin et mettre 0.

Ensuite rendez-vous dans '''/etc/network/interfaces''' et attribuez les modifications que vous voulez, une fois cela fait activez votre interface.

<code>ifup eth0</code>

Maintenant vous pouvez pointer sur votre navigateur à l'aide de votre adresse IP et vous obtenez cette page.

[[Fichier:Install_CoRM_Apache_Test_Page_Ubuntu.PNG|center|thumb|400px|Apache page]]

=== Service CoRM ===

Modification du VirtualHost avec votre IP

<code> vi /etc/apache2/sites-available/my_CoRM_Apps.conf </code> 

Puis modifiez cette ligne en changeant l'adresse IP par la votre

<VirtualHost "Votre adresse IP":80>

Redémarrez la machine.

Enfin, vous pouvez ré-ouvrir un navigateur et pointer à votre adresse IP, vous aurez alors l'application CoRM.

[[Fichier:Install_CoRM_First_Start.PNG|center|thumb|400px|Premier démarrage]]

== Configuration sous CentOS 7 ==

=== Service Apache ===

Pour configurer votre réseau, rendez-vous dans /etc/sysconfig/network-scripts/ifcfg-ens192 , puis modifiez les lignes comme ceci :

[[Fichier:Interface_Reseau.png|center|thumb|400px|Config]]

Faites ensuite les commandes :

<code>mv ifcfg-ens192 ifcfg-eth0</code> 
<code>systemctl restart network.service</code>

Maintenant vous pouvez pointer sur votre navigateur à l'aide de votre adresse IP et vous obtenez cette page.

[[Fichier:Apache_Test_Page.png|center|thumb|400px|Apache test]]

=== Service CoRM ===

Modification du VirtualHost avec votre IP

<code>vi /etc/httpd/conf.d/my_CoRM_Apps.conf </code> 
Puis modifiez cette ligne en changeant l'adresse IP par la votre

<VirtualHost "Votre adresse IP":80>

Enfin, vous pouvez ré-ouvrir un navigateur et pointer à votre adresse IP, vous aurez alors l'application CoRM.

[[Fichier:Install_CoRM_First_Start.PNG|center|thumb|400px|Premier démarrage]]

Installation sur un serveur GNU/Linux CentOS 7

2015-01-08T11:00:40Z

Admin : /* Initialisation de l'application */

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

== 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. 
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 7] (de préférence fraichement installé) ;
* Apache 2.4.6 ;
* Ruby 1.9.3 ;
* Rails 3.2.19 ;
* Serveur PostgreSQL 9.2.7 ;

== 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. 
À commencer par [https://www.howtoforge.com/centos-7-server// celui-ci]. 

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

Présrequis : 
<code># yum install curl-devel openssl-devel zlib-devel apr-devel apr-util-devel readline-devel gcc gcc-c++ wget unzip vim -y</code> 

Pour des questions de simplicité, nous allons désactiver ''SELINUX'' puis ''IPTABLES'' : 
<code># vi /etc/selinux/config</code> 
<code>SELINUX=disabled</code> 
[[Fichier:Fichier Conf Selinux.png|center|thumb|400px|Selinux]]

Cette commande permet l’arrêt du firewall IpTables et l’empêche de se relancer après un reboot. 
<code># systemctl disable firewalld </code> 

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

=== Serveur Web Apache ===
 
Permet d'installer le service httpd. 
<code># yum install httpd httpd-devel -y</code> 

Permet de relancer le service après chaque redémarrage. 
<code># systemctl enable httpd.service</code> 

Lancer le service httpd. 
<code># systemctl start httpd.service</code> 
 
À partir de ce moment, vous pouvez faire pointer votre navigateur préféré à l'adresse de votre serveur GNU/Linux.
[[Fichier:Apache Test Page.png|center|thumb|400px|Apache Test page]]
 

=== Serveur PostgreSQL ===
 
Permet d'installer le service postgresql. 
<code># yum install postgresql-server postgresql-devel -y</code> 

Permet de redémarrer le service après un reboot. 
<code># systemctl enable postgresql</code> 

<code># postgresql-setup initdb</code> 
Vous devez obtenir un rélutat :Initializing database ... OK 

Démarrer le service postgresql: 
<code># systemctl start postgresql.service </code> 
 
Initialiser le mot de passe administrateur de PostgreSQL : 
<code># su - postgres</code> 
<code>-bash-4.1$ psql</code> 
<code>postgres=# ALTER USER postgres WITH ENCRYPTED PASSWORD 'MyGreatPassword' ;</code> 
<code>postgres=# \q</code> 
<code>-bash-4.1$ logout</code> 
 
Le nouveau mot de passe administrateur (postgres) est donc "MyGreatPassword".
 

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

<code># systemctl restart postgresql.service</code> 

=== Language Ruby (via RVM) ===
 
<code># gpg2 --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3</code> 
<code># curl -sSL https://get.rvm.io | bash -s stable</code> 
<code># source /etc/profile.d/rvm.sh</code> 
<code># rvm install 1.9.3</code> 
<code># rvm use 1.9.3 --default </code> 

 
Tester la version : 
<code># ruby --version</code> 
ruby 1.9.3p551 (2014-11-13 revision 48407) [x86_64-linux]

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

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

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

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

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

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

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

<code># cd /</code> 
<code># mkdir webapps</code> 
<code># cd webapps/</code> 
<code># wget https://github.com/SIGIRE/CoRM/archive/master.zip</code> 
<code># unzip master.zip</code> 
<code># mv CoRM-master/ CoRM</code> 
<code># chown apache:apache /webapps/CoRM/ -R</code> 

== Configuration du socle logiciel ==
=== Serveur Web ===
Ajouter les lignes suivantes en toute fin du fichier de configuration du serveur web. 
'''Attention ceci est un exemple de code, il faut bien copier/coller le code généré par l'installation de Passenger !'''

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

==== VHOST ====

On crée ici un fichier VHOST.

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

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

=== 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># cp /webapps/CoRM/config/database.yml.example /webapps/CoRM/config/database.yml</code> 

<code># vi /webapps/CoRM/config/database.yml</code> 

<code>development:</code> 
<code>  adapter: postgresql</code> 
<code>  encoding: unicode</code> 
<code>  database: db_corm_dev</code> 
<code>  pool: 5</code> 
<code>  username: postgres</code> 
<code>  password: MyGreatPassword</code> 
<code></code> 
<code>test:</code> 
<code>  adapter: postgresql</code> 
<code>  encoding: unicode</code> 
<code>  database: db_corm_test</code> 
<code>  pool: 5</code> 
<code>  username: postgres</code> 
<code>  password: MyGreatPassword</code> 
<code></code> 
<code>production:</code> 
<code>  adapter: postgresql</code> 
<code>  encoding: unicode</code> 
<code>  database: db_corm_prod</code> 
<code>  pool: 5</code> 
<code>  username: postgres</code> 
<code>  password: MyGreatPassword</code> 

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

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

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

== Initialisation de l'application ==
<code># cd /webapps/CoRM</code> 
<code># gem install debugger-ruby_core_source</code> 
<code># bundle install</code> 
<code># bundle update rake</code> 
<code># rake db:setup RAILS_ENV=production</code> 
<code># bundle exec rake assets:precompile:all RAILS_ENV=production</code> 
<code># chown apache:apache /webapps/CoRM/log/production.log</code> 
<code># systemctl restart httpd.service</code> 

== Premier lancement ==
À ce stade vous devez visualiser cette page si vous pointez votre navigateur sur votre serveur.
[[Fichier:Interface CoRM.png|center|thumb|400px|Premier démarrage]]

== Configuration de l'application ==
=== Création du compte Administrateur ===
Vous devez créer un compte administrateur ! 
Pour ce faire, pointez votre navigateur à l'adresse suivante : http://ADRESSE_IP_DU_SERVEUR/user/new 

Attention, le mot de passe doit contenir au moins 6 caractères !
[[Fichier:Interfaces Compte.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équat.

[[Fichier:CoRM_Roles.PNG|center|thumb|400px|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.

InstallationRadRails

2014-11-12T13:44:44Z

Admin : /* Installation de CoRM */

Installation d'un environnement de développement sur une machine locale

== Installation de RailsInstaller ==

L'installation se fait à partir de RailsInstaller, téléchargeable à l'adresse :
http://railsinstaller.org/fr-FR

RailsInstaller installe les composants suivants :
Ruby 1.9.3
Rails 3.2
Bundler
[http://fr.wikipedia.org/wiki/Git Git]
Sqlite
TinyTDS
Support SQL Server
DevKit

Une fois l'installation terminée, vous devez configurer [http://fr.wikipedia.org/wiki/Git Git] en ligne de commande (la console vous le propose automatiquement) :
entrez votre nom d'utilisateur, validez et entrez votre adresse email.

Une clé SSH est alors générée est copiée dans le presse papier. Vous pouvez conserver cette clé en collant directement dans le bloc-note par exemple.

== Installation de l'IDE RadRails ==

l'installation se fait via le lien ci-dessous :
http://aptana.com/products/radrails/download

Au lancement de RadRails, l'environnement propose l'installation de plusieurs Plugins. Si vous ne savez pas quoi installer, laissez toutes les cases cochées.

Installation de Postgre
installation à partir du lien ci-dessous :
http://www.postgresql.org/download/windows/

== Installation de CoRM ==

lancer la console Rails (vous la trouverez dans Programm/RailsInstaller)
à l'invite de commande se placer dans le dossier ou l'on souhaite installer les fichiers de CoRM

C:\Sites> git clone [https://github.com/SIGIRE/CoRM.git https://github.com/SIGIRE/CoRM.git]

Dans le dossier CoRM éditer le fichier gemfile avec un éditeur de texte et commenter la ligne :
gem 'therubyracer'

ligne commentée :
\#gem 'therubyracer'

dans la console Rails, se positionner dans le dossier CoRM et exécuter bundle install
C:\Sites\CoRM>bundle install

dans CoRM/config, renommer le fichier application.yml.default en application.yml
renommer le fichier database.yml.example en database.yml

Editer le fichier et modifier username en postgres

Installation sur un serveur Microsoft Windows Server 2008

2014-11-12T11:13:49Z

Admin : Page blanchie

Installation sur un serveur Windows 2012 R2

2014-11-12T08:44:53Z

Admin :

Installation de Postgre / Apache :

lien pour le téléchargement : http://www.postgresql.org/download/windows/
cliquer sur le lien en fonction de votre version de Windows (64 bits ou 32 bits). (pour savoir quelle est votre version de Windows faites un clic droit sur 'ordinateur', propriétés)

une fois l'installation terminée, cocher la case : exécuter Stack-Builder

sélectionner PostgreSQL dans la liste déroulante

Dans la liste des applications, sélectionner :
- dans web développement : Apache/PHP

cocher éventuellement tous les 'Database Drivers'

Installation sur un serveur GNU/Ubuntu

2014-11-03T15:36:51Z

Admin :

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 [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. 
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 : 
<code># apt-get update</code> 
<code># apt-get install git</code>

=== Serveur Web Apache ===
 
<code># apt-get install apache2</code> 

 
À 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_Ubuntu.PNG|center|thumb|400px|Apache Test page]]
 

=== Serveur PostgreSQL ===
 
<code># apt-get install postgresql postgresql-contrib</code> 
 
Initialiser le moteur de base de données (avec le bon encoding) 
<code> pg_dropcluster --stop 9.3 main</code> 
<code> pg_createcluster --start -e UTF-8 9.3 main</code> 
 
Initialiser le mot de passe administrateur de PostgreSQL : 
<code># su - postgres</code> 
<code>-bash-4.1$ psql</code> 
<code>postgres=# ALTER USER postgres WITH ENCRYPTED PASSWORD 'MyGreatPassword' ;</code> 
<code>postgres=# \q</code> 

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

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

<code># service postgresql restart</code> 

=== Language Ruby ===
 
<code># apt-get install ruby ruby-dev make</code> 

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

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

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

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

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

Pré-requis : 
<code># apt-get install openssl libssl-dev apache2-dev curl libcurl4-openssl-dev</code> 

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

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

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

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

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

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

==== VHOST ====
<code># vi /etc/apache2/sites-available/my_CoRM_Apps.conf</code> 

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

Activation du Vhost : 
<code>a2ensite my_CoRM_Apps.conf</code> 
<code>service apache2 restart</code> 

=== 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 /webapps/CoRM/config</code> 
<code># cp database.yml.example database.yml</code> 

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

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

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

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

=== Fichier de paramètres ===

<code># cp CORM.json.example CORM.json</code> 
<code># vi CORM.json</code> 
<code>
 
{
"protocol": "http",
"host": "localhost",
"mail": {
"type": ":smtp",
"host": "localhost",
"port": 25,
"from": "no_reply@corm.fr"
}
}
</code>

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 ==
<code># cd /webapps/CoRM</code> 
<code># bundle install</code> 
<code># rake db:setup RAILS_ENV=production</code> 
<code># bundle exec rake assets:precompile:all RAILS_ENV=production</code> 
<code># chown www-data:www-data /webapps/CoRM/ -R</code> 
<code># service apache2 restart</code> 

== 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'''. 
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 !
[[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équat.

[[Fichier:CoRM_Roles.PNG|center|thumb|400px|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.

Installation sur un serveur GNU/Linux CentOS

2014-07-29T09:45:35Z

Admin : /* Configuration du socle logiciel */

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. 
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. 
Cependant, vous trouverez de nombreux guides d'installation sur Internet. 
À commencer par [http://www.tecmint.com/centos-6-5-installation-guide-with-screenshots/ celui-ci]. 

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

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

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

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

=== Serveur Web Apache ===
 
<code># yum install httpd httpd-devel -y</code> 
<code># chkconfig httpd on</code> 
<code># service httpd start</code> 
 
À 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]]
 

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

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

<code># service postgresql restart</code> 

=== 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.
 
Présrequis : 
<code># yum install curl-devel openssl-devel zlib-devel apr-devel apr-util-devel readline-devel gcc gcc-c++ wget unzip git -y</code> 
 
Libyaml : 
<code># cd /usr/local/src</code> 
<code># wget http://pyyaml.org/download/libyaml/yaml-0.1.4.tar.gz</code> 
<code># tar xzvf yaml-0.1.4.tar.gz</code> 
<code># cd yaml-0.1.4</code> 
<code># ./configure --prefix=/usr/local</code> 
<code># make && make install</code> 
 
Ruby : 
<code># cd /usr/local/src</code> 
<code># wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p547.tar.gz</code> 
<code># tar xzvf ruby-1.9.3-p547.tar.gz</code> 
<code># cd ruby-1.9.3-p547</code> 
<code># ./configure --prefix=/usr/local --enable-shared --disable-install-doc --with-opt-dir=/usr/local/lib</code> 
<code># make && make install</code> 
 
Création d'un lien symbolique : 
<code># ln -s /usr/local/src/ruby-1.9.3-p547/ruby /usr/bin</code> 
 
Vérification : 
<code># ruby -v</code> 
<code>ruby 1.9.3p547 (2014-05-14 revision 45962) [x86_64-linux]</code> 

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

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

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

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

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

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

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

<code># cd /</code> 
<code># mkdir webapps</code> 
<code># cd webapps/</code> 
<code># wget https://github.com/SIGIRE/CoRM/archive/master.zip</code> 
<code># unzip master.zip</code> 
<code># mv CoRM-master/ CoRM</code> 
<code># chown apache:apache /webapps/CoRM/ -R</code> 

== 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> 
<code>LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.53/buildout/apache2/mod_passenger.so</code> 
<code><IfModule mod_passenger.c></code> 
<code>PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.53</code> 
<code>PassengerDefaultRuby /usr/local/bin/ruby</code> 
<code></IfModule></code> 

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

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

=== 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> 
<code># cp database.yml.example database.yml</code> 

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

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

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

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

=== Fichier de paramètres ===

<code># cp CORM.json.example CORM.json</code> 
<code># vi CORM.json</code> 
<code>
 
{
"protocol": "http",
"host": "localhost",
"mail": {
"type": ":smtp",
"host": "localhost",
"port": 25,
"from": "no_reply@corm.fr"
}
}
</code>

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 ==
<code># cd /webapps/CoRM</code> 
<code># bundle install</code> 
<code># rake db:setup RAILS_ENV=production</code> 
<code># service httpd restart</code> 

== 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 ===
Vous devez créer un compte administrateur ! 
Pour ce faire, pointez votre navigateur à l'adresse suivante : http://ADRESSE_IP_DU_SERVEUR/user/new 
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équat.

[[Fichier:CoRM_Roles.PNG|center|thumb|400px|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.

Procédures d'installation

2014-07-29T09:38:34Z

Admin :

'''Procédures d'installation de CoRM'''

Cette page regroupe les différentes procédures d'installation de CoRM.

[[Installation_sur_un_serveur_GNU/Linux_CentOS]] (Plateforme de référence) 
[[Installation_sur_un_serveur_GNU/Linux_CentOS_7]] 
[[Installation_sur_un_serveur_GNU/Linux_Ubuntu]]

Accueil

2014-07-29T07:57:51Z

Admin : /* Installation de CoRM */

'''Bienvenue sur le Wiki de la solution Open Source et gratuite CoRM.'''

CoRM, créé par [http://www.sigire.fr SIGIRE] est l’aboutissement d’un constat simple : malgré la pléthore de solution, il est difficile d’une trouver un outil de [http://fr.wikipedia.org/wiki/Gestion_de_la_relation_client CRM] qui soit simple et abordable…

Fort de ce constat, nous avons créé un outil complètement nouveau, qui se veut simple, rapide et intuitif.
CoRM est donc une application web ne nécessitant aucun paramétrage ou installation de votre côté, accessible via votre navigateur Internet habituel ou votre tablette.

N'hésitez pas à consulter le [//www.corm.fr Site officiel] pour plus d’informations sur cette application...

== Bien démarrer avec CoRM ==
* [//www.corm.fr/presentation/ Présentation de la solution CoRM]
* [//www.corm.fr/demonstration/ Instance de démonstration]
* [//www.corm.fr/captures-decrans/ Captures d’écrans]
* [//www.corm.fr/telechargement/ Tarifs pour le support et l'hébergement]
* [//forum.corm.fr/ Forum communautaire]
* [https://github.com/SIGIRE/CoRM/archive/master.zip Lien direct de téléchargement]
* [//www.corm.fr/contact/ Formulaire de contact]

<center>
<gallery>
Image:Rapidite.png
Image:Gratuit.png
Image:Simplicite.png
Image:Compatible.png
</gallery>
</center>

== Les points forts ==
=== Rapidité d’exécution ===
Création de contacts, prospects, devis ou tous autres évènements en quelques secondes.

=== Gratuit ===
Pas de coût de licence, [https://github.com/SIGIRE/CoRM code source disponible]. Support et offre SaaS en option.

=== Simplicité ===
Une interface simple, mais puissante, pour une prise en main rapide et intuitive.

=== 100% compatible ===
Pas d’installation, un simple accès Internet. Compatible smartphones et tablettes.

=== Sécurité avancée ===
Notre [//www.corm.fr/tarifs/ offre d'hébergement] inclue un serveur dédié, chiffrement SSL inclus, sauvegarde automatique quotidienne…

=== Assistance de proximité ===
L’assistance en option vous accompagne au quotidien, afin de profiter au mieux de cet outil !

=== Modernité ===
Une [http://fr.wikipedia.org/wiki/Ruby_on_Rails technologie open source], moderne et parfaitement maitrisé.

=== Productivité ===
Améliorez votre productivité et augmentez ainsi votre chiffre d’affaires.

<center>
<gallery>
Image:Securite.png
Image:Assistance.png
Image:Moderne.png
Image:Productivite.png
</gallery>
</center>

== [[Installation]] de CoRM ==
* [[Installation sur un serveur GNU/Linux CentOS]] (plateforme de référence)
* [[Installation_sur_un_serveur_GNU/Linux_Ubuntu]]