Prérequis

Cette section contient les recommandations techniques nécessaires au bon fonctionnement de l’application.

Équipement matériel et configuration réseau

Les ressources matérielles dépendent bien sûr de la charge à gérer par l’application : nombre d’utilisateurs, nombre de connexions simultanées… . En raison de la diversité des contextes, Il n’existe pas de configuration standard.

Cependant nous pouvons vous fournir, à titre indicatif, les caractéristiques minimales recommandées pour un serveur ou une machine virtuelle (VM) :
• Processeur : Intel Core i5 ou équivalent
• RAM : 4Go
• Espace Disque : L’application stocke les pièces jointes des signalements sur le disque local du serveur. La taille du disque dépendra donc du nombre de personnes utilisant l’application et du nombre de pièces jointes déposées. Prévoyez un espace suffisamment grand ( > 100Go ) avec la possibilité de l’agrandir à l’avenir si nécessaire.
• Réseau : La machine doit être accessible aux utilisateurs via un navigateur web.

Systèmes d’exploitation

L’application est compatible avec les systèmes d’exploitation suivants :
• Linux (Debian 11 ou Ubuntu Server 22)
• Windows (Desktop v11 ou Serveur 2012 R2 minimum).

Navigateurs web

L’application fonctionne avec la plupart des navigateurs internet récents qui respectent les standards du w3c.

Les services et composants à configurer

Serveur web

L’application utilise le serveur web Apache.
• Apache doit disposer des droits d’écriture sur le dossier web
• Le mod_rewrite doit être activé (réécriture d’URL).
• Le dossier de publication web doit pointer vers le dossier « public / » de l’application (voir point important ci-dessous).

Important : le chemin du dossier de publication doit spécifiquement pointer vers le dossier
/public de l’application.
Exemple : si votre dossier de publication web par défaut est usr/var/www/ (sous Linux) ou c:\www (sous Windows) alors il faut que le chemin du dossier de publication web soit usr/var/www/public/ (sous Linux) ou c:\www\public (sous Windows).

Base de données

L’application a été validée avec les systèmes de gestion de bases de données suivants : MariaDB 10 et Mysql 5

PHP

Vous devez disposer de PHP Version 8.1 minimum.
• PHP doit être en déclaré dans le PATH du système (possibilité de lancer php via un terminal avec la commande :\ php)
• Extensions php installées et activées : curl, gd, intl, memcache, xml, xmlrpc, zip, mbstring, cli,,common, pdo, mysql, bcmath, dev, gmp, imagick, imap, intl, soap, sqlite3, opcache.
• Augmentez les valeurs par défaut des paramètres php suivants : max_execution_time, memory_limit, post_max_size, upload_max_filesize (au moins 200Mo pour le bon fonctionnent des mises à jour de l’application)

Serveur de mail (SMTP)

L’application envoie des notifications par e-mail, à certaines étapes de la gestion du traitement des signalements.

Pour les envois de notifications par e-mail, vous devez disposer des informations suivantes :

• Adresse du serveur d’envoi SMTP et le port.
• Le protocole de connexion chiffrée ( l’application prend en charge les protocoles suivants : Aucun, SSL/TLS et STARTTLS).
• Si une authentification est requise, vous aurez besoin d’un identifiant de connexion (sous forme d’adresse mail) et un mot de passe.

Environnement Linux

Sur un environnement Linux (Ex: Debian) vous devrez installer manuellement les services nécessaires (Apache, Mysql et PHP).

Vous pouvez suivre la procédure : Installation sous Linux Debian

Remarque : Cette procédure est donnée à titre indicatif. Elle nécessite d’avoir une bonne connaissance de l’environnement Linux Debian. En effet selon votre contexte ou vos contraintes techniques certains éléments de la procédure peuvent ne pas être adaptés.

Environnement Microsoft Windows

Sur un environnement Microsoft Window, vous avez la possibilité d’installer individuellement les services (Apache, Mysql et PHP) et de configurer manuellement les paramétrages nécessaires, ou bien d’opter pour l’installation d’un environnement web complet (tout-en-un) prêt à l’emploi via des applications telles que WampServer (https://www.wampserver.com/) ou Laragon (https://laragon.org/).

Quel que soit votre choix d’installation de l’environnement web (manuelle ou via un utilitaire) il faudra impérativement faire pointer le dossier racine web vers le dossier « /public » de l’application. Cette procédure peut être réalisée, par exemple via la création d’un « virtual host ».
—> Voici un exemple de procédure pour configurer un virtual host avec WampServer : https://blog.itgs-solutions.ch/wamp-comment-configurer-les-virtual-hosts/

Sauvegarde

Il est nécessaire de procéder à des sauvegardes régulières de votre application, afin de pouvoir la réinstaller en cas de défaillances (matérielles, logicielles). Vous pouvez utiliser la solution de sauvegarde de votre choix, à condition de sauvegarder les éléments suivants :

• Le dossier web contenant les fichiers de l’application (l’emplacement varie en fonction de l’environnement , que ce soit Linux ou Windows).
• La base de données (Mysql ou MariaDB)

Installation de l’application

Étape 1 : Lancement du programme d’installation

Création d’une base de données : Avant de commencer, vous devez créer une base de données (Pour les étapes suivantes, vous aurez besoin : de l’adresse du serveur de base de données, du nom de la base de données, de l’identifiant de l’utilisateur et le mot de passe associé) –> L’utilisateur doit disposer de tous les droits sur la base de données.

Décompression de l’archive zip : Décompressez l’archive .zip (paquet d’installation) à la racine de votre dossier web.

Lancement de l’application : Ouvrez votre navigateur web et saisissez l’URL correspondante. Ensuite, cliquez sur le bouton « Démarrer » sur l’écran suivant.

Étape 2 : Vérification de votre environnement système

Sur l’écran suivant, vous obtiendrez un rapport sur la conformité de votre installation.

Si aucune erreur n’est signalée, vous pouvez cliquer sur « Continuer ». Sinon, corrigez les erreurs et relancez l’installation.

Étape 3 : Connexion à la base de données.

A cette étape, vous devez renseigner les informations de connexion de la base de données.

Remarque : Assurez-vous que la base de données et l’utilisateur disposant des droits d’accès sont déjà créés.

Cliquez sur le bouton « Enregistrer » pour tester la connexion et enregistrer les paramètres. En cas d’erreur, veuillez corriger le problème. Si tout est correct, cliquez sur le bouton « Continuer ».

Étape 4 : Compte Administrateur

À cette étape, vous devez créer le compte administrateur principal.
Veuillez saisir les informations requises et enregistrez-les.

Important : Ce compte sera celui de l’administrateur principal de l’application. Il ne pourra pas être supprimé depuis la liste des utilisateurs.

Si tout s’est bien passé, le dernier écran vous invitera à vous connecter à l’application.

Connexion à l’application

Pour vous connecter à l’application, veuillez saisir l’adresse e-mail et le mot de passe du compte Administrateur que vous avez créé lors de la phase d’installation.