Installation pour Debian / ubuntu

	Veuillez prendre connaissance des pré-requis à l'installation de Maarch. Nous allons également utiliser PHP 7 qui propose des performances accrues non négligeables.

Installation de l'environnement nécessaire à Maarch Courrier

	Pensez à vérifier l'espace disque de votre environnement en tapant la commande :
	df -h

Installation de quelques utilitaires

apt-get update && apt-get upgrade && apt-get dist-upgrade -y
apt-get install nano
apt-get install mlocate
apt-get install wget
apt-get install net-tools
apt-get install apache2

Création d'un utilisateur et d'un groupe dédié à l'application

groupadd --gid 1001 maarch
useradd --uid 1001 --gid 1001 maarch --shell /bin/bash

Positionner l’utilisateur « maarch » comme membre du groupe d’exécution d’Apache www-data :

usermod --groups www-data maarch

L’instruction « useradd » ne permettant pas de spécifier le mot de passe de l’utilisateur, spécifier le avec l’instruction suivante :

passwd maarch

Installation des prerequis

Apache

Faire en sorte qu'Apache se lance automatiquement au démarrage du système

systemctl start apache2
systemctl enable apache2

Activer le mode de ré-écriture d'Apache, et la gestion des headers :

a2enmod rewrite
a2enmod headers

Autoriser la lecture / écriture dans les répertoires web

cd /var/www/html/
chown -R maarch. .
find . -type f -exec chmod 0644 {} \;
find . -type d -exec chmod 0755 {} \;

Préparation de la conf apache, éditer seulement les éléments nécessaires du fichier apache2.conf

mkdir /var/www/html/MaarchCourrier

nano /etc/apache2/conf/apache2.conf
User maarch
Group maarch
<Directory "/var/www/html/MaarchCourrier">
    AllowOverride All
    Options -Indexes 
    Options FollowSymLinks Includes ExecCGI
    <FilesMatch ".*">
        Order deny,allow
        Deny from all
    </FilesMatch>
    # Root to allow index.php
    <FilesMatch "^$">
        Order allow,deny
        Allow from all
    </FilesMatch>
    # Core root
    <FilesMatch "^(index|ws_server|static|merged_js|merged_css|reopen|applet_launcher|applet_controller|log)\.php$">
        Order allow,deny
        Allow from all
    </FilesMatch>
    # App static files
    <FilesMatch "\.(css|js|jpg|jpeg|png|gif|ttf|woff|woff2|svg)$">
        Order allow,deny
        Allow from all
    </FilesMatch>
    # App tools files
    <FilesMatch "\.(htm|html|jar|jnlp)$">
        Order allow,deny
        Allow from all
    </FilesMatch>
</Directory>

service apache2 restart
ps -aux | grep apache2

Installation de Postgresql

apt-get install postgresql postgresql-server postgresql-contrib
postgresql-setup initdb
systemctl start postgresql
systemctl enable postgresql

Modifier le mot de passe du compte postgres

su postgres
psql
ALTER USER postgres WITH PASSWORD 'maarch';
\q

Créer l'utilisateur Maarch

psql
CREATE USER maarch WITH ENCRYPTED PASSWORD 'maarch';
ALTER ROLE maarch WITH CREATEDB;
ALTER USER maarch WITH SUPERUSER;
\q
exit

Modifier le mode de connexion au serveur postgres

su
nano /var/lib/pgsql/data/pg_hba.conf
# modifier local all all peer 
# par local all all md5 
# et host all all 127.0.0.1/32 peer
# par host all all 127.0.0.1/32 md5
# et host all all ::1/128 peer
# par host all all ::1/128 md5
systemctl reload postgresql

Installation de php 7

echo "deb http://packages.dotdeb.org jessie all" > /etc/apt/sources.list.d/dotdeb.list (Ne pas faire si l'OS est une debian 9)

wget https://www.dotdeb.org/dotdeb.gpg && apt-key add dotdeb.gpg (Ne pas faire si l'OS est une debian 9)

apt-get update

apt-get --purge remove php5*

	Cela va supprimer toutes les autres versions de php !

Installons les paquets nécessaires à l'environnement MaarchCourrier

apt-get install php7.0 php7.0-fpm libapache2-mod-php7.0 php7.0-cli php7.0-json php7.0-pgsql php7.0-gd

apt-get install php7.0-xsl php7.0-xmlrpc php7.0-imap php7.0-soap php7.0-mbstring php7.0-zip  php7.0-curl php-pear php-imagick

Installation de pear

apt-get install pear
pear channel-discover pear.maarch.org
pear install maarch/CLITools-0.3.1
pear install SOAP-0.13.0
pear install MIME_Type

Installation des paquets complémentaires à MaarchCourrier

apt-get install unzip p7zip p7zip-full 
apt-get install ghostscript imagemagick
apt-get install xpdf-utils poppler-utils
apt-get install openjdk-8-jre
apt-get install git

Vérifier l'application des paramètres suivants dans le php.ini

/etc/php/7.0/apache2/php.ini et /etc/php/7.0/cli/php.ini

max_execution_time = 300
max_input_time = 300
memory_limit = 1024M
error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT
display_errors = On
short_open_tag = On
post_max_size = 128M
upload_max_filesize = 128M
max_file_uploads = 100
error_log = php_errors.log

Convertir les html en imagettes

cd /tmp
wget https://downloads.wkhtmltopdf.org/0.12/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
tar xvf wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
mv wkhtmltox/bin/wkhtmlto* /usr/bin
chown maarch:maarch /usr/local/bin/wkhtmltopdf
chown maarch:maarch /usr/local/bin/wkhtmltoimage

Installation de phpPgAdmin pour administrer la base de données

apt-get install phpPgAdmin
nano /etc/apache2/conf.d/phpPgAdmin.conf 
# ajouter Require all granted
nano /etc/phpPgAdmin/config.inc.php
# éditer $conf['servers'][0]['host'] = 'localhost';
# et $conf['owned_only'] = true;)

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

service php7.0-fpm restart
service apache2 restart

Extraction de Maarch Courrier depuis les dépôts GIT

cd /var/www/html
mkdir MaarchCourrier
cd MaarchCourrier
git clone -b 18.04.9 https://labs.maarch.org/maarch/MaarchCourrier .

	Si vous utilisez un proxy, il faut exécuter cette commande en l'adaptant selon votre environnement : git config --global http.proxy http://proxyuser:proxypwd@proxy.server.com:8080

Comme le serveur Apache devra écrire des fichiers dans les dossiers de l'application, nous allons devoir mettre l'utilisateur Apache comme propriétaire de ces dossiers, et n'autoriser que lui à accéder à ces dossiers.

Selon les distributions de Linux, l'utilisateur Apache peut avoir plusieurs noms. Ici, nous prendrons maarch.

chown -R maarch. /var/www/html/MaarchCourrier
cd /var/www/html/MaarchCourrier
find . -type f -exec chmod 0644 {} \;
find . -type d -exec chmod 0755 {} \;

Création d'un répertoire dédié pour les applicatifs Maarch

Nous vous proposons de créer un nouveau répertoire qui permettra d'installer des programmes complémentaires à MaarchCourrier et de stocker les documents et indexes de MaarchCourrier

mkdir -p /opt/maarch/docservers/
cd /opt/maarch
chown -R maarch:maarch .
find . -type f -exec chmod 0644 {} \;
find . -type d -exec chmod 0755 {} \;

Personnaliser le jeu de données SQL de l'application avant son installation

Vous pouvez si vous le souhaiter ajouter un jeu de données qui servira lors de l'installation de l'application.

Un jeu de données SQL contient généralement :

• les utilisateurs
• les groupes
• les entités
• le paramétrage des workflows

Ce jeu de données pourra être utilisé lors de l'intallation en remplacement du fichier ./sql/data_fr.sql.

Pour se faire, il faut déposer dans le répertoire ./sql à la racine de MaarchCourrier un ou des fichiers commençant par data_ et ayant pour extension .sql, ex :

data_monparam.sql

Dans le cas d'une installation de MaarchCourrier en mode mutualisé (plusieurs instances MaarchCourrier sur le même serveur, vous pouvez préparer plusieurs fichiers data_*.sql. Ex pour un serveur multicollectivités :

• ./sql/data_orleans.sql
• ./sql/data_sainthilaire.sql
• ./sql/data_saintjeanbraye.sql

Créer le crontab pour l'utilisateur Maarch

Afin que l'installeur puisse éditer le crontab de l'utilisateur maarch, il faut au préalable le créer

su maarch
crontab -e
#écrire en entête 
MAILTO=""
#et quitter avec la commande echap+ :wq si vous êtes dans vi

Création du paramétrage de log par défaut

cp /var/www/html/MaarchCourrier/apps/maarch_entreprise/xml/log4php.default.xml /var/www/html/MaarchCourrier/apps/maarch_entreprise/xml/log4php.xml

Lancement de l'installeur en ligne

Etape 1

Ouvrez un navigateur FireFox ou Chrome (Firefox est recommandé)

Etape 2

Dans la zone url, écrivez : http://127.0.0.1/MaarchCourrier

Etape 3

Suivez les instructions de l'asssistant d'installation en ligne.

Voilà, votre MaarchCourrier est installé !

	Si vous n'arrivez pas à exécuter l'installeur dans son intégralité, vous pouvez opter pour une installation manuelle