Procédure d`installation

Procédure d'installation
Cette procédure va vous guider pas à pas dans l'installation de Maarch RM.
L'application est livrée avec une configuration et un jeu de données par défaut qui permettent de faire fonctionner le système d'archivage en mode
"démonstration". Pour une installation personnalisée, nous vous invitons à prendre connaissance des documentations dédiées à l'architecture technique
du logiciel et à sa configuration.
Cette procédure a été réalisée sur un système Debian GNU Linux 8 64 bit vierge (télécharger ici) avec une base de données PostgreSQL 9.4. La
plupart des commandes qui seront exécutées nécessiteront des droits administrateur (root) sur le système.
Sommaire
• 1 Prérequis
♦ 1.1 Serveur applicatif
♦ 1.2 Utilisateur système pour l'application
♦ 1.3 Serveur base de données
♦ 1.4 Serveur de fichiers
♦ 1.5 Client
• 2 Récupération des sources
♦ 2.1 Framework Laabs
♦ 2.2 Application Maarch RM
♦ 2.3 Dépendances, bundles et présentation
• 3 Accès et droits
♦ 3.1 Le lien symbolique
♦ 3.2 Changement des droits
• 4 Administration de PostgreSQL
♦ 4.1 Création d'un utilisateur
♦ 4.2 Structure de données et données
• 5 Configuration
♦ 5.1 Publication
◊ 5.1.1 Apache
♦ 5.2 Application Maarch RM
• 6 Connexion à l'application
♦ 6.1 Fichier hosts
Prérequis
Serveur applicatif
• Serveur Apache 2.4 ou supérieur
• Module Apache rewrite_module
a2enmod rewrite
• Module Apache env_module
a2enmod env
• PHP 5.4 ou supérieur
apt-get install php5
• Extension PHP fileinfo
• Extension PHP mcrypt
apt-get install php5-mcrypt
• Extension PHP pdo
apt-get install php5-pgsql
• Extension PHP pdo_pgsql
• Extension PHP xsl
apt-get install php5-xsl
• Application 7z
apt-get install p7zip-full
• Environnement d'exécution JAVA 1.7 (JRE)
apt-get install default-jre
• Subversion
apt-get install subversion
• Espace disque à définir selon la volumétrie des échanges, 1Go conseillé.
Utilisateur système pour l'application
Sur le serveur, créer un utilisateur "maarch" ayant un répertoire "home" avec le groupe "www-data" :
useradd -m -g www-data maarch
Afin que cet utilisateur puisse lancer les conversions et les batchs, il faut qu'il puisse lancer le serveur Apache2. Pour cela il faut éditer le fichier de
configuration d'Apache2 (/etc/apache2/envvars). Modifier le fichier avec la valeur :
export APACHE_RUN_USER=maarch
Il est possible de tester la configuration du serveur Apache avec l'une des deux commandes suivantes :
apache2ctl configtest
service apache2 configtest
Serveur base de données
• Serveur PostgreSQL 9.3 ou supérieur
apt-get install postgresql-9.4
Serveur de fichiers
• Espace disque à définir selon la volumétrie des archives
Client
• Navigateur internet HTML5 / CSS3
Récupération des sources
Maarch RM est livré par téléchargement des sources à partir du serveur SVN (subversion) de Maarch, en récupérant les composants suivants :
• le framework Laabs
• les données livrées par défaut pour la configuration, les référentiels, les jeux de test
• les paquets (bundles) qui contiennent la couche de service et la couche de logique du métier
• les dépendances techniques
• la couche de présentation pour la publication de l'interface homme-machine à destination des clients internet
Framework Laabs
À partir du répertoire web du serveur (habituellement /var/www), récupérer les sources du framework Laabs.
Un dossier laabs se crée automatiquement.
cd /var/www
svn checkout http://svn.laabs-framework.in/framework/branches/1 laabs
Application Maarch RM
À partir du répertoire contenant les données livrables pour le framework (/var/www/laabs/data), récupérer les sources de données par défaut de
Maarch RM.
Un répertoire maarchRM se crée automatiquement.
cd /var/www/laabs/data
svn checkout http://svn.laabs-framework.in/data_maarchRM/branches/1 maarchRM
Dépendances, bundles et présentation
À partir du répertoire contenant les scripts développées pour l'application Maarch RM (/var/www/laabs/data/maarchRM/batch), exécuter
checkout.linux.sh :
cd /var/www/laabs/data/maarchRM/batch
/bin/bash checkout.linux.sh
Accès et droits
Le lien symbolique
À partir du répertoire public des dépendances (/var/www/laabs/web/public/dependency), créer un lien symbolique de la dépendance html
cd /var/www/laabs/web/public/dependency
ln -s ../../../dependency/html/public/ html
Pour les systèmes autre que windows, un lien symbolique du binaire de 7z est nécessaire dans la dépendance fileSystem
(/var/www/laabs/dependency/fileSystem/plugins/zip/bin/). Ce lien doit porter le nom "7z"
cd /var/www/laabs/web/public/dependency
ln -s /usr/bin/7z 7z
Changement des droits
À partir de la zone web (/var/www), remettre si nécessaire les droits et autorisation sur l'ensemble de la zone :
cd /var/www
chown -R maarch:www-data laabs/
chmod -R 775 laabs/
Administration de PostgreSQL
Création d'un utilisateur
(Optionnel si vous possédez déjà un utilisateur avec les droits pour gérer la base de données de l'application)
Se connecter en tant qu'utilisateur postgres (depuis l'utilisateur administrateur, aucun mot de passe n'est nécessaire) et exécuter la commande
suivante :
psql
CREATE USER maarch;
ALTER ROLE maarch WITH CREATEDB;
ALTER ROLE maarch WITH SUPERUSER;
ALTER USER maarch WITH ENCRYPTED PASSWORD 'maarch';
CREATE DATABASE "maarchRM" WITH OWNER maarch;
\q
exit
Structure de données et données
Attention, la commande suivante doit être exécutée en root ! À partir du répertoire contenant les scripts développées pour l'application Maarch RM
(/var/www/laabs/data/maarchRM/batch), exécuter sql.linux.sh.
cd /var/www/laabs/data/maarchRM/batch
/bin/bash sql.linux.sh
Configuration
Publication
La publication d'une instance de l'application Maarch RM nécessite de positionner un certain nombre de valeurs pour des variables d'environnement.
Apache
Les instances sont publiées par le serveur http sous la forme d'hôtes virtuels possédant un nom, une configuration spécifique et positionnant les
variables d'environnement pour l'exécution.
Editer la configuration d'apache (en général /etc/apache2/sites-available/000-default.conf) pour directement inclure le fichier de
configuration de l'hôte virtuel livré :
# Application Maarch RM
Include /var/www/laabs/data/maarchRM/conf/vhost.conf
Éditer le fichier de configuration /var/www/laabs/data/maarchRM/conf/vhost.conf et définir les valeurs si différent par défaut.
# Chemin vers le répertoire public web de Laabs
DocumentRoot /var/www/laabs/web/
# Nom du vhost (identique au nom associé à l'adresse IP dans le fichier host)
ServerName maarchrm
Le fichier contient aussi toutes les variables d'environnement de l'instance publiée, notamment :
• le nom de l'instance (unique ou identique à d'autres instance pour une répartition de charge)
• le chemin du fichier de configuration de l'application
• la clé secrète de chiffrement des jetons de sécurité
• la gestion du cache
• etc.
Se reporter à l'article (ici) concernant la configuration pour une description complète des variables pour personnaliser ces valeurs.
Relancer Apache :
service apache2 restart
Application Maarch RM
Cette étape permet de configurer la couche de logique métier et les dépendances techniques nécessaires au fonctionnement de l'application.
La configuration se trouve dans un fichier principal dont le nom est défini pour l'environnement d'exécution :
• dans la configuration du ou des hôtes virtuels http pour la publication par le serveur internet (IHM et service)
• dans chaque script pour les exécutions en mode ligne de commande (batch, sh)
Le fichier principal nommé est livré avec des inclusions d'autres fichiers de configuration pour les variables propres à l'environnement et pour chaque
dépendance technique.
Les fichiers par défaut se trouvent dans le répertoire de configuration de l'application Maarch RM
cd /var/www/laabs/data/maarchRM/conf
Éditer le fichier de configuration "confvars.ini" qui contient les variables propres à l'environnement de données, et définir les valeurs des directives pour
la connexion à la base de données et le chemin répertoire d'installation :
@var.dsn = "pgsql:host=localhost;dbname=maarchRM;port=5432"
@var.username = maarch
@var.password = maarch
Le fichier de configuration principal est nommé "configuration.ini". Voir l'article consacré à la configuration (ici) pour une description détaillée des
directives.
Connexion à l'application
Fichier hosts
Ajouter dans le fichier hosts du système qui doit accéder à l'application les coordonnées du serveur :
127.0.0.1
maarchrm
• Sous Linux: /etc/hosts
• Sous Windows : C:\windows\system32\drivers\etc\hosts
Bravo !
L'installation est terminée, et l'application est accessible depuis un navigateur internet.
Avec notre exemple :
http://maarchrm/
L'administrateur fonctionnel est 'superadmin', mot de passe 'superadmin'.
Tous les autres utilisateurs livrés dans les données d'exemple ont pour mot de passe par défaut 'maarch'.
Se reporter aux guides de visite accessibles depuis le wiki pour le test des grandes fonctionnalités de Maarch RM.