1.

6
L'installeur est un outil pratique qui installe maarch sur le serveur en mode graphique. Il va permettre de :

- valider les pré-requis demandés

- créer la base de données

- Charger un jeu de test au choix

- Demander le mot de passe administrateur

- Désigner la zone de stockage des documents

- configurer le smtp

D'autres tâches sont réalisées en arrière-plan comme :

- la création du répertoire custom

- le paramétrage des notifications, sendmails, fulltext, thumbnails dans ce répertoire custom créé

- la mise en place des liens symboliques sous linux

Sommaire
• 1 Pré-requis
• 2 Installation de Maarch sous Linux et windows
♦ 2.1 Environnement de la machine d'installation
♦ 2.2 Installation de l'environnement nécessaire à Maarch Courrier sous Linux
♦ 2.3 Installation de l'environnement nécessaire à Maarch Courrier sous Windows
♦ 2.4 Téléchargement et installation de Maarch Courrier depuis les dépôts svn
♦ 2.5 Lancement de l'installeur
◊ 2.5.1 Choix de la langue
◊ 2.5.2 Les pré-requis
◊ 2.5.3 La base de données
◊ 2.5.4 Création des liens symboliques
⋅ 2.5.4.1 Sous linux
⋅ 2.5.4.2 Sous Windows
◊ 2.5.5 Création des tâches planifiées
⋅ 2.5.5.1 Sous linux
⋅ 2.5.5.2 Sous windows
◊ 2.5.6 Choix du jeu de données d'exemple à importer
◊ 2.5.7 Zone de stockage
◊ 2.5.8 Configuration du SMTP
◊ 2.5.9 Mot de passe du super utilisateur
◊ 2.5.10 Fin de l'installation
♦ 2.6 URL

Pré-requis
Dans un premier temps, vous devez configurer votre serveur. Pour ce faire suivez ce lien :

http://wiki.maarch.org/Maarch_Courrier/1.5/fr/Install/Prerequis

Cette étape permet d'apporter les éléments nécessaires pour le bon fonctionnement de l'application.

Installation de Maarch sous Linux et windows

Environnement de la machine d'installation
• Machine virtuelle VirtualBox
• OS : Debian 8
• Espace disque : 8GO
• Mémoire vive : 2GO
• Processeurs : 2

Veuillez prendre connaissance des pré-requis à l'installation de Maarch

Installation de l'environnement nécessaire à Maarch Courrier sous Linux

Pensez à vérifier l\'espace disque de votre environnement en tapant la commande : df -h
sudo apt-get install apache2 libapache2-mod-php5 php5 php5-cli php5-json postgresql imagemagick
sudo apt-get install php5-pgsql php5-gd subversion unzip p7zip p7zip-full php-pear xpdf-utils php5-svn ghostscript
sudo apt-get install php5-xsl php5-xmlrpc php5-imap php5-imagick
sudo pear install SOAP-0.12.0 MIME_Type
sudo pear channel-discover pear.maarch.org
sudo pear install maarch/CLITools-0.3.1

cd /var/www/html
sudo mkdir maarch_courrier
cd maarch_courrier

Sous debian 7 "stable", quelques paquets en plus:

php-gettext,php-mbstring

et des noms différents:

php-soap au lieu de pear SOAP-0.12.0

php-mime-type au lieu de pear MIME_Type

Les modules "php5-gettext" et "php5-mbstring" ne sont plus disponible pour les distributions récentes, penser à les enlever de la commande (si vous
avez copier/coller) autrement les autres modules ne s'installeront pas!

Vérifier l'application des paramètres suivants dans le PHP.ini (/etc/php5/apache2/php.ini)

php > 5.4 : error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT
display_errors = on
short_open_tag = On
magic_quotes_gpc = off
extension=php_pgsql.so (cette extension plus les autres installées plus haut si nécessaire)

Une fois les modifications effectuées, vous devez redémarrer apache :

sudo /etc/init.d/apache2 restart

Installation de l'environnement nécessaire à Maarch Courrier sous Windows

• Installer XAMPP (par défaut dans le répertoire C:\xampp)

• Installer PostgreSQL

• Installer SlickSVN

• Vérifier l'application des paramètres suivants dans le PHP.ini (C:\xampp\php\php.ini):

php > 5.4 error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT
display_errors = on
short_open_tag = On
magic_quotes_gpc = off
extension=php_fileinfo.dll (enlever le ';' au début)
extension=php_imap.dll (enlever le ';' au début)
extension=php_pgsql.dll (enlever le ';' au début)
extension=php_xsl.dll (enlever le ';' au début)
extension=php_pdo_pgsql.dll (enlever le ';' au début)

• Installer la librairie complémentaire Maarch pour le pilotage des batchs (via pear dans C:\xampp\php) :
C:\xampp\php\pear channel-discover pear.maarch.org
C:\xampp\php\pear install maarch/CLITools-0.3.1
C:\xampp\php\pear install MIME_Type

Après avoir activé l'extension php_pgsql.dll dans le php.ini, il se peut qu'Apache refuse de démarrer pour cause de librairie php_pgsql.dll non présente.

il faut ajouter la ligne suivante dans C:\xampp\apache\conf\httpd.conf :

LoadFile "C:/Program Files/PostgreSQL/x.x/bin/libpq.dll"

(remplacer les x.x par votre version)

Téléchargement et installation de Maarch Courrier depuis les dépôts svn
(copier-coller en une seule fois les lignes ci-dessous sans faire de modification).
cd /var/www/html/maarch_courrier/ ou cd maarch_courrier dans votre répertoire web
svn checkout http://svn.maarch.org/core/branches/1.6 .
svn checkout http://svn.maarch.org/maarch_entreprise/branches/1.6 apps/maarch_entreprise
svn checkout http://svn.maarch.org/attachments/branches/1.6 modules/attachments
svn checkout http://svn.maarch.org/avis/branches/1.6 modules/avis
svn checkout http://svn.maarch.org/basket/branches/1.6 modules/basket
svn checkout http://svn.maarch.org/cases/branches/1.6 modules/cases
svn checkout http://svn.maarch.org/content_management/branches/1.6 modules/content_management
svn checkout http://svn.maarch.org/entities/branches/1.6 modules/entities
svn checkout http://svn.maarch.org/fileplan/branches/1.6 modules/fileplan
svn checkout http://svn.maarch.org/folder/branches/1.6 modules/folder
svn checkout http://svn.maarch.org/full_text/branches/1.6 modules/full_text
svn checkout http://svn.maarch.org/ldap/branches/1.6 modules/ldap
svn checkout http://svn.maarch.org/life_cycle/branches/1.6 modules/life_cycle
svn checkout http://svn.maarch.org/notes/branches/1.6 modules/notes
svn checkout http://svn.maarch.org/notifications/branches/1.6 modules/notifications
svn checkout http://svn.maarch.org/reports/branches/1.6 modules/reports
svn checkout http://svn.maarch.org/sendmail/branches/1.6 modules/sendmail
svn checkout http://svn.maarch.org/tags/branches/1.6 modules/tags
svn checkout http://svn.maarch.org/templates/branches/1.6 modules/templates
svn checkout http://svn.maarch.org/thesaurus/branches/1.6 modules/thesaurus
svn checkout http://svn.maarch.org/thumbnails/branches/1.6 modules/thumbnails
svn checkout http://svn.maarch.org/visa/branches/1.6 modules/visa

Lancement de l'installeur
Ouvrez un navigateur FireFox, Chrome ou IE et allez à l'url http://127.0.0.1/maarch_courrier.

L'installation avec l'assistant dure moins de 2 mn.

Choix de la langue
Choisissez votre langue. Vous avez la possibilité de choisir entre français et anglais.
Une fois choisit, cliquez sur suivant. Vous arriverez sur la page de bienvenue de Maarch puis une page vous demandant d'accepter les termes de la
licence.

Les pré-requis
Dans cette page, vous pourrez vérifier si les pré-requis ont été respecté.

Un bouton rouge signifie que les pré-requis sont non conformes.

Un bouton orange signifie que les pré-requis sont non conformes mais optionnels.

Un bouton vert signifie qu'ils sont conformes.

La base de données
Ce formulaire permet de renseigner les informations de connexion à la base de données:
Serveur
Port
Utilisateur
Mot de passe
Une fois le formulaire remplit, cliquez sur tester la connexion, pour pouvoir passer à l'étape suivante.

Pour les connexions distantes: Sur le serveur distant, il faut indiquer à postgresql d'autoriser les connexions distante:

modification du pg_hba.conf
host all postgres 192.168.0.0/24 trust

Vous autorisez ici n?importe quelle machine du réseau local 192.68.0.x à vous connecter à votre serveur en tant que postgres et sans fournir de mot de
passe. On peut être plus restrictif et autoriser une seule machine, par exemple :
host all postgres 192.168.0.10/32 trust

modification du postgresql.conf Ici il faut changer le paramètre listen_addresses (par défaut il est sur localhost).
listen_addresses '*'

Cela signifie que si mon serveur à une adresse IP publique 88.89.90.91

Vous arrivez à ce formulaire:

Il vous permet de renseigner le nom de la base de données que vous utiliserez.
Lors de la création de la base de données, un répertoire custom sera créé avec pour nom : 'cs_' suivi du nom de votre base de données.
Par exemple: si vous créez la base de données : maarch_courrier, un répertoire custom sera créé avec comme nom : cs_maarch_courrier.

Lorsque vous avez choisi votre base, l'installeur va vérifier si elle n'est pas déjà utilisée ou si il n'existe pas déjà un répertoire custom

Création des liens symboliques

Sous linux

Lorsque vous créez votre base de données, un répertoire custom est créé. Il va contenir les données essentielles pour le fonctionnement de
l'application avec cette base de données. Un lien symbolique va être créé automatiquement et va permettre de se connecter à l'application
Sous Windows

Vous devez créer manuellement le lien symbolique à l'application.

Pour ce faire, vous devez être en mode administrateur dans la ligne de commande puis saisir:
mklink cs_le_nom_de_la_bdd le_chemin_de_votre_application

exemple :
mklink cs_maarch_courrier c:\xampps\www\htdocs\maarch_courrier\

Création des tâches planifiées

Sous linux

L'installeur créé les tâches planifiées durant l'installation de l'application. Pour ce faire, il édite le crontab de l'utilisateur www-data, copie le contenu (afin
de ne pas supprimer ce qui existe déjà) et ajoute le nécessaire pour le bon fonctionnement de l'application.

Si vous souhaitez y accéder vous devez saisir ceci:

crontab -e -u www-data

Voici ce que vous obtenez dans le fichier:

Sous windows

L'installeur n'a pas la capacité d'ajouter les tâches planifiées sous cet environnement. Vous devez le faire manuellement.

Choix du jeu de données d'exemple à importer

Dans cette page, vous avez la possibilité de choisir deux sortes de jeu de données. Ces jeux de données sont des jeux de démos:
- data_fr : jeu de démo normal
- data_fr_mini : jeu de démo léger

Zone de stockage
La zone de stockage est le répertoire où seront stockés les documents que vous enregistrez avec l'application.

Ce formulaire permet d'indiquer le chemin de ce répertoire.

Configuration du SMTP
La configuration SMTP permet de renseigner les fichiers de configuration des notifications et sendmails.

Ces derniers permettent d'envoyer des emails pour indiquer qu'ils ont des courriers à traiter ou pour simplement pour envoyer un courrier à partir de
l'application en elle-même.

Le formulaire ci-dessus va vous permettre de tester l'envoi d'email. Une fois le formulaire complété, appuyez sur le bouton "vérification", si la
configuration est bonne, vous recevrez un email à votre adresse email.
Mot de passe du super utilisateur
Le super utilisateur a accès à toute l'application. Il accède à l'administration et fait le paramétrage de l'application. Un mot de passe doit lui être donné.

Fin de l'installation
Après avoir défini le mot de passe du superadmin, vous visualisez un récapitulatif des données renseignées :

Cliquez sur suivant et vous avez fini l'installation de votre application. Les modules fulltext, imagette, sendmail et notifications sont déjà configurés.
URL
Une fois que vous avez terminé la procédure d'installation de l'installeur, vous arrivez sur l'application.

Notez bien l'URL car elle peut changer en fonction si vous avez des custom

ici cs_maarch correspond au custom maarch. Il change si vous relancez l'installeur et créez une nouvelle base de données.