Assistant d'installation en ligne

L'installeur est un outil pratique qui installe MaarchCourrier sur votre 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 données au choix ;
• définir le mot de passe administrateur ;
• désigner la zone de stockage des documents ;
• modifier l'image de la page de login ;
• 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.

La navigation dans l'installeur est simple. Pour passer à l'étape suivante, il suffit de cliquer sur le bouton "suivant".

En prérequis, installez votre serveur !

Dans un premier temps, vous devez configurer votre serveur. Pour ce faire, suivez un de ces liens en fonction de votre environnement :

• Guide d'installation pour Debian/Ubuntu ;
• Guide d'installation pour Centos/RedHat.

Lancement de l'installeur

Ouvrez un navigateur FireFox ou Chrome et allez à l'url http://127.0.0.1/MaarchCourrier.

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 choisi, cliquez sur suivant.

Page de bienvenue et listing des install déjà réalisées

Vous arriverez sur la page de bienvenue de Maarch.

	Mode multilocataire : Si pour ce serveur vous avez déjà réalisé au moins une installation, cette page vous récapitule l'ensemble des instances déjà déployées sur ce serveur.

Sur la page suivante on vous demande d'accepter les termes de la licence.

Contrôle des Prérequis

Tous les voyants doivent être au vert !

... Sinon, c'est que vous devez revoir la partie installation de votre serveur.

Base de donneés

Paramétrade de la connexion

Ce formulaire permet de renseigner les informations de connexion à la base de données:

• serveur ;
• port ;
• utilisateur ;
• mot de passe.

Une fois le formulaire rempli, 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, ex : host all postgres 192.168.0.0/24 trust ou host all postgres 192.168.0.10/32 trust selon les cas.

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

Création de la base de données

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.

Attention, ce choix important car il détermine l'identifiant de votre instance MaarchCourrier

Par exemple vous pourrez retrouverez cet identifiant dans l'url d'accès à votre application.

Chargement du jeu de données

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 sous ce nom.

Enfin l'application vous propose de sélectionner le jeu de données que vous souhaitez charger dans la base de données.

Comme nous vous l'avons explicités dans la procédure d'installation du serveur, il est possible de charger vos propres jeux de données.

Il suffit de les ajouter dans le répertoire sql de MaarchCourrier sous la forme : data_macollectivite.sql

ex : /var/www/html/MaarchCourrier/sql/data_olivet.sql

Paramétrage de votre espace de stockage

Tel que préconisé dans la procédure d'installation de votre serveur, il faut renseigner le chemin souhaité vers l'espace de stockage de vos documents MaarchCourrier.

L'installeur vous remontera une erreur si le chemin est inexistant ou que ses droits d'accès sont inapropriés.

Création des tâches planifiées

Cette partie est non visible depuis l'installeur graphique.

Par contre l'installeur, s'il a accès au planificateur de tâches de votre serveur (crontab), il se chargera des les paramétrer.

Pour résumer, 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 manuellement vous devez saisir ceci:

crontab -e -u www-data

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.

Si vous n'avez pas les informations ou si vous ne voulez pas configurer le smtp, vous pouvez cliquer directement sur "Suivant".

Paramétrage du mot de passe du "superadmin"

Le super utilisateur nommé "superadmin" 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é.

Image login et rappel configuration

La dernière étape consiste à définir une image de fond pour la page de login et contrôler les informations préalablement saisies.

Choix de l'image de la page de login

Vous pouvez soit charger une image depuis votre disque dur, soit en choisir une depuis des images libres de droits récupérées chez pixabay.

Rappel de la configuration

Cliquez sur suivant et vous avez fini l'installation de votre application. Les modules fulltext, imagette, sendmail et notifications sont déjà configurés.

Vous pouvez cliquer sur le bouton "Démarrer avec MaarchCourrier".

L'installeur vous renvoie alors sur l'instance MaarchCourrier que vous venez de créer.

Mutilocataires : installer une nouvelle instance

	Pour les environnements en mode multilocataires (un serveur pour plusieurs instances MaarchCourrier), il est possible de relancer l'installeur autant de fois que l'on souhaite pour installer de nouvelles instances.

Pour installer une nouvelle instance, il suffit de relancer l'installeur en tapant l'url d'accès à votre serveur web MaarchCourrier et d'y ajouter à la fin /install/ :

Ouvrez un navigateur Firefox ou Chrome et allez à l'url http://127.0.0.1/MaarchCourrier/install/.

Pour que votre instance MaarchCourrier soit déployée dans les règles de l'art, nous vous conseillons également de suivre le chapitre sur le déploiement d'instances MaarchCourrier.