Vous êtes sur la page 1sur 154

Sommaire

Installation ......................................................................................................................................... 1
Installation - Package SCOQI (Apache) ......................................................................................... 2
Installation du package SCOQI_FULLWEB ..................................................................................... 2
Installation des services : Apache - MySQL ................................................................................ 3
Bases de données ............................................................................................................................. 4
Nom des Bases de données en fonction des logiciels ......................................................... 5
Compte Administrateur des bases de données .................................................................... 5
Compléments ............................................................................................................................ 5
Installation des applications QALITEL ........................................................................................... 6
Liens de lancement des applications ............................................................................................ 8
Scripts de sauvegarde ..................................................................................................................... 8
Scripts de création des tâches planifiées ..................................................................................... 9
Scripts de déclenchement automatique des G.A.E. .................................................................. 10
Erreurs .............................................................................................................................................. 10
Fichier msvcrxxx.dll manquant ............................................................................................ 11
Port 80 utilisé .......................................................................................................................... 11
Installation - Package SCOQI (IIS) ............................................................................................... 12
Installation du package SCOQI_FULLWEB ................................................................................... 13
Installation du service MySQL ..................................................................................................... 13
Bases de données ........................................................................................................................... 14
Nom des Bases de données en fonction des logiciels ....................................................... 14
Compte Administrateur des bases de données .................................................................. 15
Compléments .......................................................................................................................... 15
Installation des applications QALITEL ......................................................................................... 16
Scripts de sauvegarde ................................................................................................................... 18
Scripts de création des tâches planifiées ................................................................................... 18
Scripts de déclenchement automatique des G.A.E. .................................................................. 19
Erreurs .............................................................................................................................................. 20
Mise en place du PHP ..................................................................................................................... 21
Installation de PHP - Package pré-configuré ............................................................................ 21
Extensions PHP propres aux applications QALITEL .................................................................. 22
Extension ChartDirector ......................................................................................................... 22
Paramétrage du fichier PHP.INI ................................................................................................... 22
Fichier des erreurs PHP .......................................................................................................... 22
Magic Quotes ............................................................................................................................ 23
Répertoire des extensions ..................................................................................................... 23
Répertoire des sessions ......................................................................................................... 23
Téléchargement des fichiers ................................................................................................. 23
Divers ........................................................................................................................................ 23
Extensions ................................................................................................................................ 24
Internet Information Service (IIS) version 8 .............................................................................. 26
Répertoire virtuels sous IIS 7 - IIS8 ............................................................................................. 31
PHP avec IIS8 .................................................................................................................................. 33
Mode CGI .......................................................................................................................................... 33
Autres paramétrages ..................................................................................................................... 35
Augmentation de la taille autorisée pour l'envoi de fichiers ........................................... 35
Augmentation du délai de déconnexion d'IIS ..................................................................... 35
Redémarrage d'IIS8 ........................................................................................................................ 36
Installation du PHP (pour IIS) ....................................................................................................... 38
Installation du package PHP ......................................................................................................... 38
Configuration d'IIS .......................................................................................................................... 38
Apache 2.4. sous Windows ........................................................................................................... 41
Répertoire virtuels sous Apache .................................................................................................. 44
Répertoire Virtuel ........................................................................................................................... 44
Hôte Virtuel ..................................................................................................................................... 44
Apache 2.4 - Configuration de PHP ............................................................................................. 47
Certificats SSL - Paramétrage sous Apache ............................................................................... 48
Certificat auto-signé ...................................................................................................................... 48
Création et paramétrage d'un certificat auto-signé (sans autorité de certification)
.............................................................................................................................................. 48
Création d'une autorité de certification et d'un certificat auto-signé ........................... 50
Certificat Let's Encrypt sous Apache ........................................................................................... 54
Téléchargement de Win-acme ...................................................................................................... 54
Lancement de Win-acme ............................................................................................................... 55
Configuration d'Apache ................................................................................................................. 61
Paramétrage du certificat ...................................................................................................... 61
MSSQL .............................................................................................................................................. 63
Connexion Authentification mixte ............................................................................................... 63
Choix du classement ...................................................................................................................... 63
Rôle de l'utilisateur SQL ................................................................................................................ 64
Paramétrage du port de connexion ............................................................................................. 64
MySQL ............................................................................................................................................... 66
Installation de MySQL ................................................................................................................... 66
.......................................................................................................................................................... 66
Installation de phpMyAdmin ......................................................................................................... 73
.......................................................................................................................................................... 73
Installation de MySQL Administrator .......................................................................................... 73
.......................................................................................................................................................... 74
Création d'un plan de maintenance avec MySQL Administrator ........................................... 77
.......................................................................................................................................................... 77
Création d'une connexion stockée ....................................................................................... 77
Mise en place du stockage de mot de passe pour la connexion .................................... 79
Mise en place de la sauvegarde ........................................................................................... 80
Test de la sauvegarde planifiée ........................................................................................... 82
Installation QALITEL - Mode opératoire ...................................................................................... 84
Mode opératoire d'installation ..................................................................................................... 84
Copie du ZIP d'installation ..................................................................................................... 84
..................................................................................................................................................... 84
Décompression du fichier ZIP d'installation ....................................................................... 85
Lancement de l'interface d'installation ............................................................................... 86
Processus d'installation ......................................................................................................... 86
Problèmes pouvant survenir ........................................................................................................ 90
Installation - Générateur Automatique d'Emails ....................................................................... 91
Informations importantes ............................................................................................................ 91
Structure des répertoires ............................................................................................................. 91
Copie et décompression du fichier ZIP d'installation ............................................................... 92
Processus d'installation ................................................................................................................ 92
Paramétrage du lancement du G.A.E. ......................................................................................... 94
Paramétrage des tâches planifiées ............................................................................................. 95
Sauvegarde des répertoires ....................................................................................................... 101
Copie simple d'un répertoire ..................................................................................................... 102
........................................................................................................................................................ 102
Copie compressée d'un répertoire ............................................................................................ 102
........................................................................................................................................................ 102
Copie compressée incrémentale d'un répertoire .................................................................... 103
........................................................................................................................................................ 103
Suppression des fichiers dont la date est supérieure à 15 jours ......................................... 103
........................................................................................................................................................ 103
Création d'une tâche planifiée en script ................................................................................... 104
........................................................................................................................................................ 104
Sauvegardes complètes (Exemples de scripts) ....................................................................... 105
QALITEL doc : Script de sauvegarde complet .......................................................................... 105
QALITEL amélioration (QALITEL audit - QALITEL conform - QALITEL progrès) : Script de
sauvegarde complet ..................................................................................................................... 106
QALITEL compar : Script de sauvegarde complet ................................................................... 107
QALITEL courrier : Script de sauvegarde complet ................................................................. 108
Sauvegarde (Dump) MySQL ........................................................................................................ 111
Backup d'une base de données .................................................................................................. 111
........................................................................................................................................................ 111
Backup de toutes les bases de données ................................................................................... 111
........................................................................................................................................................ 111
Backup incrémental sous Windows ........................................................................................... 112
Changement de version de PHP ................................................................................................. 113
Environnement IIS (Internet Information Service) ................................................................. 113
1°) Validation du contexte ................................................................................................... 113
2°) Installation du package PHP ......................................................................................... 113
3°) Substitution des versions PHP ...................................................................................... 113
4°) Configuration d'IIS .......................................................................................................... 113
Environnement APACHE .............................................................................................................. 114
1°) Installation du package PHP ......................................................................................... 114
2°) Substitution des versions PHP ...................................................................................... 114
3°) Modification du fichier de configuration d'Apache : httpd.conf (version 2.4) ...... 114
CHANGEMENT DES FICHIERS DE CONFIG DES APPLICATIONS QALITEL / Epistolaire (Pour IIS
et Apache) ..................................................................................................................................... 114
Changement de package SCOQI (WAMP) ................................................................................. 116
Sauvegarde des bases de données ........................................................................................... 116
Arrêt des services Package SCOQI - WAMP .............................................................................. 118
Installation du package SCOQI ................................................................................................... 119
Restauration des bases de données ......................................................................................... 120
Copies des répertoires ................................................................................................................. 120
Changement des paramètres dans les applications QALITEL ............................................... 121
Nom de la base de données dans le fichier CONFIG.PHP ............................................... 121
Préférences dans le logiciel QALITEL ................................................................................. 121
Installation d'OnlyOffice .............................................................................................................. 123
Configurations techniques possibles ........................................................................................ 123
Installations préalables ............................................................................................................... 123
Installation d'Erlang .............................................................................................................. 123
Installation de RabbitMQ ...................................................................................................... 123
Installation de PostgreSQL .................................................................................................. 123
Installation d'OnlyOffice DocumentServer ........................................................................ 127
Configuration de QALITEL ........................................................................................................... 131
Erreurs - Fichiers de Log ...................................................................................................... 132
Environnement OCR - Elasticsearch .......................................................................................... 133
Installation des différents modules .......................................................................................... 133
Installation de Poppler ......................................................................................................... 133
Installation de Tesseract ...................................................................................................... 133
Installation d'ElasticSearch ................................................................................................. 135
Installation d'Elasticsearch comme service Windows ..................................................... 138
Paramétrage de QALITEL ............................................................................................................ 139
Serveur FTP ................................................................................................................................... 141
Filezilla FTP Server ....................................................................................................................... 141
IIS FTP Server ................................................................................................................................ 142
Paramétrage au niveau de votre scanner ................................................................................ 146
WebDav - Apache .......................................................................................................................... 148
Création de l'utilisateur WebDav ............................................................................................... 148
Modification du fichier httpd.conf ............................................................................................. 148
Paramétrage des modules WebDav .................................................................................. 148
Paramétrage de l'alias WebDav : ....................................................................................... 149
SCOQI

Installation

Cette rubrique couvre tous les aspects liés à l'installation des applications des gammes QALITEL et
Epistolaire.

Vous y trouverez :

Les pré-requis techniques selon les environnements d'installation. Cette partie est à bien
prendre en compte car malgré une très large portabilité, les applications QALITEL /
Epistolaire peuvent être soumises à certaines contriantes (version de PHP, Type de base de
données,...)
Les modes opératoires d'installation de tous les composants nécessaires : Serveur Web, Base
de données, PHP,...
Les scripts / tâches planifiées à mettre en oeuvre pour les sauvegardes, synchronisation LDAP,
déclenchement Générateur Automatique d'Emails,...

Les menus présentés à gauche :

Menu installation : Propose tous les modes opératoires d'installation selon l'environnement de
votre serveur (Serveur sous Windows, Linux ou Mac)
Menu Thématiques communes : Vous trouverez à ce niveau toutes les informations techniques
non liées à l'environnement de votre serveur
Menu Pré-requis techniques : Ce sont tous les pré-requis techniques liés aux différents types
d'installation possible.

Page 1
SCOQI

Installation - Package SCOQI (Apache)

Le fonctionnement des applications QALITEL nécessite l'installation de tout un environnement


technique préalable. Celui-ci se compose des éléments suivants :

Serveur Web
Base de données
PHP (Language d'exploitation des applications)
Sauvegardes
Tâches planifiées

Il est possible d'installer indépendamment chacun de ces éléments comme cela est décrit dans la
rubrique "installation" de cette F.A.Q selon votre environnement serveur (Windows, Linux ou Mac).

SCOQI a élaboré un package pré-paramétré regroupant les différents éléments afin de vous faire
gagner du temps dans l'installation des applications QALITEL.

Ce package se compose des éléments suivants :

Serveur Web : Apache 2.4.39


Base de données : MySQL 5.7.26
Administration de la base de données : PHPMyAdmin 4.4.11
PHP : 7.3.13
Sauvegardes : scripts pré-paramétrés
Tâches planifiées : scripts d'installation pré-paramétrés des tâches planifiées à mettre en
oeuvre.

Ce package se présente sous la forme d'un fichier compressé SCOQI_FULLWEB.ZIP

Vous pouvez télécharger le package en cliquant sur ce lien.

Installation du package SCOQI_FULLWEB

Page 2
SCOQI
Téléchargez le fichier SCOQI_FULLWEB.ZIP à partir du lien ci-dessus puis décompressez le sur le
disque C de votre serveur (directement dans la racine de votre disque C). Vous devez alors obtenir
l'arborescence de répertoires suivante :

Installation des services : Apache - MySQL

Dans le répertoire "C:\scoqi_fullweb\scripts", vous trouverez le fichier "services_install_scoqi.bat". Il


est nécessaire de l'exécuter en mode Administrateur, aussi faites un clic droit "Exécuter en tant
qu'adminstrateur" sur ce fichier comme montré ci-dessous :

Page 3
SCOQI

Vous trouverez alors à l'issue de l'exécution de ce script, les 2 services suivants :

scoqi-apache2.4.39 ==> Serveur Web Apache


scoqi-mysql5.7.26 ==> Base de données MySQL

Attention : Il peut être nécessaire d'installer des modules "Microsoft Visual C++ Redistribuable" si
vos rencontrez des erreurs sur les "msvcp*.dll". Ceux-ci ont été placés si besoin dans le répertoire
\scoqi_fullweb\modules_complementaires\

pour Apache (erreur sur la msvcp140.dll) ==> VC_redist_.x64.exe


pour MySQL (erreur sur la msvcp120.dll) ==> vcredist_VC2013_x64.exe

Bases de données

Toujours dans un objectif de simplification de l'installation, les bases de données ainsi qu'un compte
Amdinistrateur de la base de données sont pré-configurés. Vous trouverez ci-dessous les paramètres
des bases de données nécessaires lors de l'installation de l'application (chapitre suivant).

Page 4
SCOQI
Nom des Bases de données en fonction des logiciels

QALITEL doc ==> qdoc


QALITEL conform ==> qca
QALITEL progrès ==> qca
QALITEL audit ==> qca
QALITEL compar ==> qcompar
QALITEL courrier ==> qcourrier

Compte Administrateur des bases de données

Utilisateur : root
Mot de passe : scoqi

Compléments

Pour information, une interface d'administration de la base de données est également installée dans
le cas où vous auriez le besoin d'intervenir directement dans celle-ci.

L'accès à l'interface d'administration de la base de données MySQL se fait au travers de l'application


PHPMyAdmin accessible à partir de votre poste par l'adresse :
http://localhost/phpmyadmin/index.php

Vous accédez alors à l'écran d'authentification suivant (Utilisez les paramètres du compte
Administrateur ci-dessus pour vous connecter) :

Page 5
SCOQI

Installation des applications QALITEL

L'installation des applications QALITEL se fait simplement en décompressant le fichier .ZIP de


l'application téléchargée à partir de votre portail client dans le répertoire "C:\scoqi_fullweb\www\"
de manière à avoir une structure de répertoires comme montré ci-dessous :

Page 6
SCOQI

Il vous suffit alors de lancer le programme d'installation par l'adresse :


http://localhost/scoqi/qdoc/install.php

Vous trouverez ci-dessous le nommage des répertoires (à respecter pour que les scripts de
sauvegardes et autres paramétrages fonctionnent naturellement) ainsi que le lien de lancement de
l'installation pour les différents logiciels :

QALITEL doc
Répertoire : C:\scoqi_fullweb\www\qdoc
Lien de lancement de l'installation : http://localhost/scoqi/qdoc/install.php

QALITEL conform
Répertoire : C:\scoqi_fullweb\www\qca
Lien de lancement de l'installation : http://localhost/scoqi/qca/install.php

QALITEL progrès
Répertoire : C:\scoqi_fullweb\www\qca
Lien de lancement de l'installation : http://localhost/scoqi/qca/install.php

QALITEL audit
Répertoire : C:\scoqi_fullweb\www\qca
Lien de lancement de l'installation : http://localhost/scoqi/qca/install.php

QALITEL compar
Répertoire : C:\scoqi_fullweb\www\qcompar
Lien de lancement de l'installation : http://localhost/scoqi/qcompar/install.php

QALITEL courrier
Répertoire : C:\scoqi_fullweb\www\qcourrier
Lien de lancement de l'installation : http://localhost/scoqi/qcourrier/install.php

Le détail de l'installation est décrit sur cette page de la F.A.Q.

Page 7
SCOQI

Liens de lancement des applications

A l'issue de l'installation, les liens de lancement des applications seront les suivants :

(Remplacer nom-machine par l'adresse IP du serveur ou son nom)

QALITEL doc : http://nom-machine/scoqi/qdoc

QALITEL amélioration (QALITEL conform - QALITEL audit - QALITEL progrès) :


http://nom-machine/scoqi/qca

QALITEL compar : http://nom-machine/scoqi/qcompar

QALITEL courrier : http://nom-machine/scoqi/qcourrier

Scripts de sauvegarde

Pour les applications QALITEL, il est nécessaire de sauvegarder quotidiennement les éléments
suivants de manière à pourvoir restituer l'applicaiton sans perte de données en cas de crash du
serveur :

Base de données
Fichiers / documents associés
Modèles d'impression

Vous pouvez réaliser ces sauvegardes avec les utilitaires propres à la base de données ou avec vos
propres logiciels de sauvegarde.

Des scripts de sauvegarde opérationnels vous sont proposés dans le répertoire


C:\scoqi_fullweb\scripts :

Pour QALITEL doc ==> backup_qdoc.bat


Pour QALITEL compar ==> backup_qcompar.bat
Pour QALITEL amélioration (QALITEL conform, QALITEL audit QALITEL progrès) ==>
backup_qca.bat
Pour QALITEL courrier ==> backup_qcourrier.bat

Page 8
SCOQI
Ces scripts permettent de réaliser dans le répertoire C:\scoqi_fullweb\sauvegardes\ des sauvegardes
quotidiennes et historisées sur 30 jours glissants de la base de données ainsi que des répertoires
contenant les fichiers associés et les modèles d'impression. Si vous avez affecté des noms de
répertoires ou de base de données différents de ceux spécifiés dans ce didactitiel, il sera alors
nécessaire d'adapter les scripts de sauvegarde.

IMPORTANT : Il est de votre responsabilité de vérifier le bon fonctionnement des sauvegardes et


de leurs contenus et ceci lors de leur mise en oeuvre et ensuite périodiquement.

Le déclenchement automatique des sauvegardes se fait en créant une tâche planifiée dans Windows
exécutant quotidiennement le fichier .BAT associé à votre application (chapitre suivant)

Scripts de création des tâches planifiées

Comme mentionné précédemment, les scripts de sauvegarde doivent être déclenchés


quotidiennement et automatiquement. Pour cela, il est nécessaire de créer une tâche planifiée via le
planificateur de tâches de Windows.

Des scripts de création de ces tâches planifiées vous sont proposés dans le répertoire
C:\scoqi_fullweb\scripts :

Pour QALITEL doc ==> creation_tache_backup_qdoc.bat


Pour QALITEL compar ==> creation_tache_backup_qcompar.bat
Pour QALITEL amélioration (QALITEL conform, QALITEL audit QALITEL progrès) ==>
creation_tache_backup_qca.bat
Pour QALITEL courrier ==> creation_tache_backup_qcourrier.bat

Sur le script que vous souhaitez déclencher, faites un clic droit "Exécuter en tant qu'administrateur"
comme montré ci-dessous :

Page 9
SCOQI

Scripts de déclenchement automatique des G.A.E.

Vous trouverez à partir de cette page le mode opératoire pour créer les différentes tâches planifiées
notamment pour le déclenchement des G.A.E.

Erreurs

Vous pouvez rencontrer une erreur au démarrage du service Apache (Erreur 1).

Page 10
SCOQI
Les causes peuvent en être les suivantes :

Fichier msvcrxxx.dll manquant

Ceci peut être du au fait qu'il manque les bibliothèques Visual C++ 2015. Aussi, vous pouvez
installer le package redistribuable Microsoft Visual C++ 2015 (VC_redist.x64.exe) présent dans le
répertoire "\scoqi_fullweb\modules_complementaires\".

Ce module est disponible en téléchargement à partir des liens ci-dessous :

En .exe : cliquez ici


En .zip : cliquez ici

Port 80 utilisé

Par défaut le package est configuré pour le port 80. Si celui-ci est utilisé par une autre serveur Web
(IIS ou Nginx par exemple) alors vous aurez ce type de message d'erreur.

Vous pouvez tester en faisant un http://localhost à partir de votre navigateur pourvous assurer que
ce port est disponible.

Si ce n'est pas le cas, vous pouvez alors changer le port 80 paramétré dans le package
"scoqi_fullweb". Pour cela, ouvrez le fichier "\scoqi_fullweb\Apache2.4.39Win64\conf\httpd.conf".

Remplacez alors la valeur 80 par un autre port disponible, 8080 par exemple sur les 2 lignes
suivantes que vous trouverez dans ce fichier httpd.conf :

Listen 80

ServerName localhost:80

Page 11
SCOQI

Installation - Package SCOQI (IIS)

Ce package est configuré pour être utilisé avec le serveur Web de Microsoft IIS (Internet
Information Service)

Attention : Ce package n'intègre pas le serveur Web

Le fonctionnement des applications QALITEL nécessite l'installation de tout un environnement


technique préalable. Celui-ci se compose des éléments suivants :

Serveur Web
Base de données
PHP (Language d'exploitation des applications)
Sauvegardes
Tâches planifiées

Il est possible d'installer indépendamment chacun de ces éléments comme cela est décrit dans la
rubrique "installation" de cette F.A.Q selon votre environnement serveur (Windows, Linux ou Mac).

SCOQI a élaboré un package pré-paramétré regroupant les différents éléments afin de vous faire
gagner du temps dans l'installation des applications QALITEL.

Ce package se compose des éléments suivants :

Base de données : MySQL 5.7.26


Administration de la base de données : PHPMyAdmin 4.4.11
PHP : 7.3.13
Sauvegardes : scripts pré-paramétrés
Tâches planifiées : scripts d'installation pré-paramétrés des tâches planifiées à mettre en
oeuvre.

Rappel : Le serveur Web devant être utilisé pour ce package est IIS. , comme cela est mentionné
plus haut,

Vous pouvez télécharger ce package en cliquant sur ce lien. Ce package se présente


sous la forme d'un fichier compressé SCOQI_FULLWEB_IIS.ZIP.

Page 12
SCOQI

Installation du package SCOQI_FULLWEB

Téléchargez le fichier SCOQI_FULLWEB_IIS.ZIP à partir du lien ci-dessus puis décompressez le sur


le disque C de votre serveur (directement dans la racine de votre disque C). Vous devez alors obtenir
l'arborescence de répertoires suivante :

Installation du service MySQL

Dans le répertoire "C:\scoqi_fullweb\scripts", vous trouverez le fichier "services_install_scoqi.bat". Il


est nécessaire de l'exécuter en mode Administrateur, aussi faites un clic droit "Exécuter en tant
qu'adminstrateur" sur ce fichier comme montré ci-dessous :

Page 13
SCOQI

Vous trouverez alors à l'issue de l'exécution de ce script, le service suivant :

scoqi-mysql5.7 ==> Base de données MySQL

Bases de données

Toujours dans un objectif de simplification de l'installation, les bases de données ainsi qu'un compte
Amdinistrateur de la base de données sont pré-configurés. Vous trouverez ci-dessous les paramètres
des bases de données nécessaires lors de l'installation de l'application (chapitre suivant).

Nom des Bases de données en fonction des logiciels

QALITEL doc ==> qdoc


QALITEL conform ==> qca
QALITEL progrès ==> qca
QALITEL audit ==> qca
QALITEL compar ==> qcompar
QALITEL courrier ==> qcourrier

Page 14
SCOQI

Compte Administrateur des bases de données

Utilisateur : root
Mot de passe : scoqi

Compléments

Pour information, une interface d'administration de la base de données est également installée dans
le cas où vous auriez le besoin d'intervenir directement dans celle-ci.

L'accès à l'interface d'administration de la base de données MySQL se fait au travers de l'application


PHPMyAdmin accessible à partir de votre poste par l'adresse :
http://localhost/phpmyadmin/index.php

Vous accédez alors à l'écran d'authentification suivant (Utilisez les paramètres du compte
Administrateur ci-dessus pour vous connecter) :

Page 15
SCOQI

Installation des applications QALITEL

L'installation des applications QALITEL se fait simplement en décompressant le fichier .ZIP de


l'application téléchargée à partir de votre portail client dans le répertoire "C:\scoqi_fullweb\www\"
de manière à avoir une structure de répertoires comme montré ci-dessous :

Page 16
SCOQI

Il vous suffit alors de lancer le programme d'installation par l'adresse :


http://localhost/scoqi/qdoc/install.php

Vous trouverez ci-dessous le nommage des répertoires (à respecter pour que les scripts de
sauvegardes et autres paramétrages fonctionnent naturellement) ainsi que le lien de lancement de
l'installation pour les différents logiciels :

QALITEL doc
Répertoire : C:\scoqi_fullweb\www\qdoc
Lien de lancement de l'installation : http://localhost/scoqi/qdoc/install.php

QALITEL conform
Répertoire : C:\scoqi_fullweb\www\qca
Lien de lancement de l'installation : http://localhost/scoqi/qca/install.php

QALITEL progrès
Répertoire : C:\scoqi_fullweb\www\qca
Lien de lancement de l'installation : http://localhost/scoqi/qca/install.php

QALITEL audit
Répertoire : C:\scoqi_fullweb\www\qca
Lien de lancement de l'installation : http://localhost/scoqi/qca/install.php

QALITEL compar
Répertoire : C:\scoqi_fullweb\www\qcompar
Lien de lancement de l'installation : http://localhost/scoqi/qcompar/install.php

QALITEL courrier
Répertoire : C:\scoqi_fullweb\www\qcourrier
Lien de lancement de l'installation : http://localhost/scoqi/qcourrier/install.php

Le détail de l'installation est décrit sur cette page de la F.A.Q.

Page 17
SCOQI

Scripts de sauvegarde

Pour les applications QALITEL, il est nécessaire de sauvegarder quotidiennement les éléments
suivants de manière à pourvoir restituer l'applicaiton sans perte de données en cas de crash du
serveur :

Base de données
Fichiers / documents associés
Modèles d'impression

Vous pouvez réaliser ces sauvegardes avec les utilitaires propres à la base de données ou avec vos
propres logiciels de sauvegarde.

Des scripts de sauvegarde opérationnels vous sont proposés dans le répertoire


C:\scoqi_fullweb\scripts :

Pour QALITEL doc ==> backup_qdoc.bat


Pour QALITEL compar ==> backup_qcompar.bat
Pour QALITEL amélioration (QALITEL conform, QALITEL audit QALITEL progrès) ==>
backup_qca.bat
Pour QALITEL courrier ==> backup_qcourrier.bat

Ces scripts permettent de réaliser dans le répertoire C:\scoqi_fullweb\sauvegardes\ des sauvegardes


quotidiennes et historisées sur 30 jours glissants de la base de données ainsi que des répertoires
contenant les fichiers associés et les modèles d'impression. Si vous avez affecté des noms de
répertoires ou de base de données différents de ceux spécifiés dans ce didactitiel, il sera alors
nécessaire d'adapter les scripts de sauvegarde.

IMPORTANT : Il est de votre responsabilité de vérifier le bon fonctionnement des sauvegardes et


de leurs contenus et ceci lors de leur mise en oeuvre et ensuite périodiquement.

Le déclenchement automatique des sauvegardes se fait en créant une tâche planifiée dans Windows
exécutant quotidiennement le fichier .BAT associé à votre application (chapitre suivant)

Scripts de création des tâches planifiées

Page 18
SCOQI
Comme mentionné précédemment, les scripts de sauvegarde doivent être déclenchés
quotidiennement et automatiquement. Pour cela, il est nécessaire de créer une tâche planifiée via le
planificateur de tâches de Windows.

Des scripts de création de ces tâches planifiées vous sont proposés dans le répertoire
C:\scoqi_fullweb\scripts :

Pour QALITEL doc ==> creation_tache_backup_qdoc.bat


Pour QALITEL compar ==> creation_tache_backup_qcompar.bat
Pour QALITEL amélioration (QALITEL conform, QALITEL audit QALITEL progrès) ==>
creation_tache_backup_qca.bat
Pour QALITEL courrier ==> creation_tache_backup_qcourrier.bat

Sur le script que vous souhaitez déclencher, faites un clic droit "Exécuter en tant qu'administrateur"
comme montré ci-dessous :

Scripts de déclenchement automatique des G.A.E.

Vous trouverez à partir de cette page le mode opératoire pour créer les différentes tâches planifiées
notamment pour le déclenchement des G.A.E.

Page 19
SCOQI

Erreurs

Vous pouvez rencontrer une erreur au démarrage du service Apache (Erreur 1). Ceci peut être dû
au fait qu'il manque les bibliothèques Visual C++ 2015. Aussi, vous pouvez installer le package
redistribuable Microsoft Visual C++ 2015 (VC_redist.x64.exe) présent dans le répertoire
"\scoqi_fullweb\modules_complementaires\".

Ce module est disponible en téléchargement à partir des liens ci-dessous :

En .exe : cliquez ici


En .zip : cliquez ici

Page 20
SCOQI

Mise en place du PHP

Le processus d'installation de PHP est simple et consiste généralement à décompresser un fichier


ZIP avec sa structure de répertoires.

Ce fichier peut être téléchargé sur le site officiel de PHPou bien vous être fourni par SCOQI.

Attention : Les applications QALITEL sont compatibles uniquement avec les versions 5.3.7,
5.4x, 5.5x,5.6x et 7.x de PHP

Les versions de PHP antérieures à 7 ne sont plus maintenues par PHP. Il est donc
fortement déconseillé de réaliser de nouvelles installations avec des versions 5.X de PHP

L'installation d'une version 7.x est donc fortement préconisée. Ce mode opératoire
s'appuie sur une version PHP 7.3.13

Installation de PHP - Package pré-configuré

De manière à vous simplifier la mise en oeuvre de PHP sur votre serveur, un package pré-configuré
est à votre disposition en cliquant sur ce lien. Il s'appuie sur une version PHP 7.3.13. Ce package
comprend les extensions ChartDirector, SQLSRV (MSSQL), LDAP et un PHP.INI pré-configuré.

Selon le serveur Web utilisé, prenez la version de PHP correspodante :

Apache 2.4.x (mode Thread Safe - TS) : cliquez ici pour télécharger le ZIP
Internet Information System - IIS (mode Non Thread Safe - NTS) : cliquez ici pour
télécharger le ZIP

Une fois téléchargé, décompressez le fichier ZIP dansla racine de votre disque C

Note : Ci-dessous vous trouverez le détail des extensions PHP nécessaires au fonctionnement des
applications QALITEL ainsi que le paramétrage du PHP.INI. Ces informations vous seront utiles dans
le cas d'une installation manuelle du PHP (sans utilisation du package pré-configuré présenté
précédemment ou si vous placez votre répertoire PHP dans une autre structure que le disque C: ).

Dans le cas de l'utilisation du package, tous les paramétrages présentés ci-dessous sont réalisés.

Page 21
SCOQI

Extensions PHP propres aux applications QALITEL

Extension ChartDirector

Vous trouverez dans le fichier ZIP téléchargeable ci-dessous les différentes DLL de ChartDirector
selon votre version de PHP.

ChartDirector pour Windows : Cliquez ici

Décompressez le fichier téléchargé puis copiez les fichiers mentionnés ci-dessous présents dans le
répertoire \ChartDirector\lib\ dans le répertoire des extensions de PHP, par exemple
: C:\php-7.3.13-nts-VC15-x64\EXT\.

chartdir.dll
phpchartdir.php
phpchartdir7xx.dll

(Selon votre version de PHP, vous dezvez prendre la phpchartdirxx.dll correspondante - Rappel, les
nts (Non Thread Safe) ne sont nécessaires que pour IIS)

Paramétrage du fichier PHP.INI

Editez le fichier PHP.INI (avec un éditeur de texte du type NOTEPAD par exemple). Recherchez les
lignes suivantes et si nécessaire les compléter comme mentionné (adaptez les chemins et noms de
certains fichiers selon votre installation).

Fichier des erreurs PHP

error_reporting = E_ALL & E_DEPRECATED & ~E_STRICT


display_errors = Off
log_errors = On
error_log = C:\php-7.3.13-nts-VC15-x64\logs\php.log

(Attention : le répertoire où vous indiquez à PHP de placer son fichier d'erreurs doit exister. PHP ne
le crée pas)

Page 22
SCOQI

Magic Quotes

magic_quotes_gpc = Off

Répertoire des extensions

extension_dir = "C:\php-7.3.13-nts-VC15-x64\ext"

(Attention : Le répertoire à spécifier à ce niveau dépend de l'endroit où vous aurez installé votre
PHP)

Répertoire des sessions

session.save_path = "c:\php-7.3.13-nts-VC15-x64\temp"

(Attention, ce répertoire doit exister).

Téléchargement des fichiers

Ce sont des paramétrages nécessaires pour permettre le téléchargement de fichiers via PHP.

file_uploads = On
upload_tmp_dir = C:\php-5.6.22\temp\
upload_max_filesize = 50M

En fonction de la taille des fichiers qui pourraient être uploadés, vous pouvez être amené à changer
cette valeur de 10Mo pour l'augmenter. Attention de prendre également en compte dans ce cas les
éventuelles limitations inhérentes à votre serveur Web dans ce domaine.

Divers

Vous trouverez ci-dessous d'autres paramètres à fixer.

safe_mode = Off
post_max_size = 50M
max_execution_time = 120
memory_limit = 512M
max_input_vars = 1500

Page 23
SCOQI

Extensions

L'activation des extensions se fait en supprimant le ; placé en début de ligne. Dans la rubrique
Dynamic Extensions, décommentez les lignes suivantes :

extension=gd2
extension=gettext
extension=php_mbstring.dll
extension=php_openssl

Si vous utilisez le LDAP avec les applications :

extension=php_ldap.dll

L'extension MSSQL pour PHP n'est pas fournie avec PHP, il est alors nécessaire de la télécharger
sur le site de Microsoft. Le fichier .ZIP que vous téléchargez avec le lien précédent contient un
programme d'installation SQLSRVxx.EXE que vous devez lancer. Indiquez lui le répertoire des
extensions de votre PHP, soit le répertoire C:\PHP-5.6.22\EXT\ dans notre exemple. Les différentes
extensions "php_sqlsrv_5x.dll" y seront alors copiées. Référencez alors votre extension dans le
PHP.INI selon l'exemple ci-dessous :

extension=php_sqlsrv_73_nts.dll

Si vous utilisez une base de données MySQL :

extension=php_mysqli.dll

De manière à activer les graphiques dans les applications, ajoutez la ligne suivante à la fin des
extensions :

extension=phpchartdir730nts.dll

Page 24
SCOQI

(Visualisation de l'extension dans le phpinfo)

(Extrait du fichier PHP.INI)

Page 25
SCOQI

Internet Information Service (IIS) version 8

L'installation d'IIS8 sous Windows 2012 Server consiste à ajouter un rôle et définir les
fonctionnalités dont nous aurons besoin ultérieurement pour le fonctionnement de PHP. Vous
trouverez le paramétrage de PHP sous IIS8 sur cette page.

Nous opterons pour l'installation de PHP en mode CGI.

Il est nécessaire d'installer les rôles IIS et CGI. Pour cela, accédez au Gestionnaire de serveur.

Cliquez sur la rubrique "Ajouter un rôle".

Page 26
SCOQI

Cochez la case "Web server (IIS)" pour installer le rôle du serveur Web.

Page 27
SCOQI

Sous la branche IIS, accédez à la rubrique "Application Dévelopment" et cochez la case "CGI".

Si vous souhaitez mettre en place d'authentification "Active Directory", vous devez activer l'option
"Windows Authentification" dans la rubrique "Sécurity" comme montré dans la copie d'écran ci-
dessous :

Page 28
SCOQI

Une fois le paramétrages effectués, cliquez sur le bouton "Next" pour valider les rôles et
fonctionnalités qui seront installées.

Page 29
SCOQI

Procédez à l'installation en cliquant sur le bouton "Install".

Page 30
SCOQI

Répertoire virtuels sous IIS 7 - IIS8

Le paramétrage des répertoires virtuels sous IIS7 / IIS8 se fait en se positionnant sur le site Web
puis en faisant un clic droit Ajouter un répertoire virtuel. Vous accédez alors à l'écran suivant :

Renseignez alors l'alias que vous souhaitez puis indiquez sur la ligne Chemin d'accès physique le
répertoire racine de l'application QALITEL / Epistolaire ou un répertoire en amont dans le cas où
vous ne souhaitez pas paramétrer plusieurs alias pour vos différentes applications Web.

Vous pouvez ensuite effectuer des paramétrages complémentaires sur votre Alias avec les
différentes icones proposées.

Nous allons par exemple définir une page par défaut ce qui nous permettra d'avoir à éviter de
spécifier la page index.php lors du lancement des applications QALITEL / Epistolaire.

Sous votre site Web, apparait le répertoire virtuel que vous avez créé. Placez-vous dessus pour
accéder aux paramétrages complémentaires. Faites alors un clic droit Ouvrir la fonctionnalité sur
l'icone Document par défaut. Vous accez à l'écran suivant :

Page 31
SCOQI

Supprimez tous les éléments présents dans la liste puis ajoutez index.php.

Ce paramétrage permettra de lancer directement l'application en ne mentionnant que le répertoire


virtuel sans avoir à indiquer le nom de la page .PHP de démarrage.

Le lien de lancement de l'application sera alors du type : http://mon_serveur/conform

Page 32
SCOQI

PHP avec IIS8

La configuration de PHP dans IIS8 se fera en mode CGI. Vous trouverez ci-dessous le détail des
différentes étapes à suivre.

Les paramétrages qui suivent se réalisent dans le Gestionnaire des services Internet (IIS). Vous
pouvez y accéder en recherchant "inetmgr". Positionnez-vous ensuite sur le nom de votre serveur
qui vous donnera accès à la page d'accueil de votre serveur avec les différentes icones nécessaires
au paramétrage que nous allons maintenant détailler.

Mode CGI

Double cliquez sur l'option "Mappages de gestionnaires".

Ensuite, dans le groupe "Actions", sélectionnez l'option "Ajouter un mappage de modules".

Dans le formulaire proposé, renseignez les champs de la manière suivante :

Chemin des demandes : *.php


Module : Sélectionnez FastCgiModule dans la liste déroulante
Exécutable : Dans votre répertoire d'installation de PHP, sélectionnez le programme "php-
cgi.exe"
Nom : Spécifiez par exemple, "PHP-FastCGI"

Page 33
SCOQI

Cliquez ensuite sur le bouton "Restrictions des demandes". Cochez la case "Appeler le gestionnaire
seulement si une demande est mappée à :" puis cochez l'option "Fichier ou dossier".

Validez les formulaires avec le bouton "OK".

Une fois ce paramétrage effectué, le PHP est opérationnel.

Page 34
SCOQI

Autres paramétrages

En dehors des paramétrages présentés précédemment, les parapétrages complémentaires suivants


sont nécessaires.

1. Augmentation de la taille d'envoi des fichiers (upload)


2. Augmentation du temps de déconnexion (timeout)

Augmentation de la taille autorisée pour l'envoi de fichiers

Pour le paramétrage de la taille d'upload d'IIS, vous pouvez vous référer à cette page de la F.A.Q.
sur les serveurs Web.

Augmentation du délai de déconnexion d'IIS

Pour le paramétrage du timeout d'IIS au travers de l'interface graphique, accédez comme montré ci-
dessous à l'éditeur de configuration par un double clic sur l'icone correspondante ou un clic droit
"Ouvrir la fonctionnalité".

Sélectionnez ensuite dans la liste déroulante des sections l'item "system.WebServer" puis "CGI" :

Page 35
SCOQI

Une fois l'option CGI sélectionnée, vous accéderez à la ligne "Timemout" vous permetant de définir
le timeout en minutes. Vous pouvez l'initialiser à "15 minutes".

Pour un paramétrage dans le fichier de configuration (plutôt que par l'interface graphique),
reportez-vous à cette rubrique de la F.A.Q. sur les serveurs Web.

Redémarrage d'IIS8

Maintenant que les paramétrages ont été effectués, il ne reste plus qu'à redémarrer IIS8 pour leur
prise en compte. Pour cela, dans le gestionnaire des services Internet, faites un clic droit sur le
serveur puis Arrêter comme montré ci-dessous :

Page 36
SCOQI

Ensuite faites un clic droit Démarrer pour relancer IIS.

Page 37
SCOQI

Installation du PHP (pour IIS)

Rappels :

Les applications QALITEL ne sont pas compatibles avec les versions PHP inférieures à PHP
5.3.7.
Pour IIS, la version de PHP à utiliser est la version Non Thread Safe car le PHP fonctionne
sous IIS en mode Fast CGI.

Tenant compte des rappels précédents, la configuration la plus récente proposée sous IIS 7.x et
ultérieurs est une version PHP 7.3.13 nts VC15 x64.

Installation du package PHP


Vous pouvez télécharger un ZIP préconfiguré pour les applications QALITEL de cette version de PHP
à partir de ce lien.

Décompressez alors ce fichier ZIP directement dans votre disque C

P.S. : Si vous souhaitez mettre le PHP dans une autre strucuture de répertoires ou sur un autre
disque, il vous faudra alors modifier le fichier PHP.INI pour remplacer les chemins y figurant.

Configuration d'IIS
Pour rappel, PHP sous IIS fonctionne en mode CGI. Aussi, est-il nécessaire d'installer le rôle CGI au
niveau d'IIS. Si besoin, reportez vous à cette section de la F.A.Q qui en détaille le paramétratge.

Ouvrez la console d'IIS pour commencer le paramétrage.

Dans la page d'accueil de votre site Web, double cliquez sur le bouton "Mappage de Gestionnaire".

Page 38
SCOQI

Vous accédez alors la liste des scripts déjà mappés. Cliquez alors sur le lien "Ajouter un mappage de
modules" présent sur la droite de votre écran pour y configurer PHP.

Rrenseignez ensutie le formulaire proposé de la manière suivante :

Page 39
SCOQI

Cliquez enfin sur le bouton "Restrictions des demandes" pour compléter le dernier formulaire
comme montré ci-dessous.

Redémarrez ensuite IIS pour la prise en compte de PHP.

Page 40
SCOQI

Apache 2.4. sous Windows

Apache est un serveur Web issu d'un projet de développement libre. Il est donc librement
téléchargeable à l'adresse https://httpd.apache.org/download.cgi.

Pöur le téléchargement des versions Windows d'Apache, il est possible de se référer au site
: https://www.apachehaus.com/cgi-bin/download.plx

Apache 2.4.39 : De manière à vous simplifier la mise en place d'Apache sous Windows, vous pouvez
télécharger un ZIP à partir de ce lien.

La version proposée d'Apache est la 2.4.39.

ATTENTION : Toutes les versions de PHP ne supportent pas la version 2.4.x d'Apache. Avant de
vous lancer dans la configuration d'Apache, assurez-vous de disposer dans votre répertoire PHP de
la DLL : php5apache2_4.dll

Décompressez le fichier ZIP téléchargé directement dans votre disque C de manière à avoir la
structure de répertoires comme montré dans la copie d'écran ci-dessous :

Page 41
SCOQI

Il vous est possible bien entendu de mettre Apache sur un autre disque et/ou dans un autre
répertoire mais il vous faudra alors changer les répertoires mentionnés dans le fichier de
configuration httpd.conf ainsi que dans le fichier .bat qui permettra de monter le service Apache.

Paramètres du fichier de configuration : httpd.conf

Le fichier de configuration se trouve dans le répertoire : C:\Apache2.4.39Win64\conf

Les paramètres suivants sont à valider selon votre répertoire d'installation d'Apache, du port utilisé
ainsi que du répertoire de stockage de votre PHP

# Répertoire d'Apache
Define SRVROOT "C:/Apache2.4.39Win64"

# Port d'ecoute d'Apache


Listen 80

Page 42
SCOQI
ServerName localhost:80

# Repertoire de PHP avec reference a la DLL


LoadModule php7_module "C:/php-7.3.13-VC15-x64/php7apache2_4.dll"

Installation du service Apache

Pour monter le service Apache, faites un clic droit sur le fichier


"C:\Apache2.4.39Win64\services_insert_apache.bat" et sélectionnez l'option "Démarrer en tant
qu'Administrateur"

A l'issue de l'exécution de ce script, Apache sera monté en tant que service avec démarrage
Automatique en cas de reboot du serveur.

Note : Si vous avez changé le disque et/ou répertoire d'installation d'Apache, modifiez en
conséquence le fichier : services_insert_apache.bat

Page 43
SCOQI

Répertoire virtuels sous Apache

Au sein de cette page, nous verrons comment créer un répertoire virtuel (VirtualDirectory) et un
hôte virtuel (VirtualHost)

Répertoire Virtuel
Accédez au fichier httpd.conf pour paramétrer les Alias désirés. Les Alias sont des répertoires
virtuels qui permettent de pointer directement dans un répertoire donné.

Dans le fichier HTTPD.CONF fourni avec le ZIP que nous mettons à disposition, l'alias est déjà
configuré.

Il sera alors nécessaire de placer les applications QALITEL dans le répertoire C:\scoqi_fullweb\www

Le paramétrage d'un alias se fait de la façon suivante :

Alias /scoqi"c:/scoqi_fullweb/www"
<Directory "c:/scoqi_fullweb/www">
Options FollowSymLinks
DirectoryIndex index.php
AllowOverride all
Require all granted
</Directory>

L'URL de lancement des applications QALITEL se fera par une URL du type :

http://nom-du-serveur/scoqi/qdoc

Attention, si vous avez changé le port dans le fichier de configuraiton d'Apache : httpd.conf en
mettant par exemple 8080, votre URL sera alors de la forme :

http://nom-du-serveur:8080/scoqi/qdoc

Hôte Virtuel
Dans le cas où l'on souhaite accéder par un nom de domaine et éventuellement avoir plusieurs noms

Page 44
SCOQI
de domaines qui pointent sur notre serveur Apache, alors nous pouvons configurer des Virtual
Hosts.

Nous travaillerons sur le nom de domaine exemple : scoqi.qalitel.fr

Nous enregistrerons le fichier de conf. de notre VirtualHost "scoqi.qalitel.fr.conf" dans le répertoire


: C:\scoqi_fullweb\Apache2.4.39Win64\conf\extra

Le contenu de notre fichier de configuration contiendra les commandes suivantes :

<VirtualHost scoqi.qalitel.fr:80>
ServerName scoqi.qalitel.fr

#############################################################
##################
# QALITEL doc
#############################################################
##################

Alias /doc C:/scoqi_fullweb/www/qdoc/

<Directory C:/scoqi_fullweb/www/qdoc/>
DirectoryIndex index.php
Options -Indexes
AllowOverride All
Require all granted
</Directory>

ErrorLog C:/scoqi_fullweb/Apache2.4.39Win64/logs/error_scoqi_qalitel_fr.log

</VirtualHost>

Page 45
SCOQI

Page 46
SCOQI

Apache 2.4 - Configuration de PHP

Sous Apache, il est nécessaire d'utiliser une version Thread Safe de PHP. Sauf cas spécifique, nous
utiliserons une version 7.3.13 TS de PHP dont vous pouvez télécharger un ZIP préconfiguré en
cliquant sur ce lien.

La configuration de PHP sous Apache Windows nécessite une modification du fichier de


configuration httpd.conf. Ce fichier se trouve dans le répertoire CONF d'Apache (tel que précisé
lors de l'installation) soit par exemple : C:\Apache2.4.39Win64\conf.

2 lignes sont à ajouter dans le fichier httpd.conf (si ces lignes sont présentes, assurez-vous que le
chemin mentionné pour le PHP est correct).

Chargement du module PHP

Dans le fichier httpd.conf, recherchez la ligne de commande LoadModule. A la fin du paragraphe


spécifiant tous les modules chargés, ajoutez la ligne suivante :

Apache 2.4.x

LoadModule php7_module "C:/php-7.3.13-VC15-x64/php7apache2_4.dll"

Paramétrage du type MIME via la directive AdddType

Dans le fichier httpd.conf, recherchez la chaine de carcatères AddType application. Sous les lignes
AddType application paramétrées, ajoutez la ligne suivante :

AddType application/x-httpd-php .php

Page 47
SCOQI

Certificats SSL - Paramétrage sous Apache

Dans cette page nous allons décrire la mise en place de certificats auto-signés et de certificats
générés par Let'sEncrypt et leur paramétrage au sein d'Apache.

Certificat auto-signé
Plusieurs cas de figure sont envisageables et décrits dans cette page :

Paramétrage d'un certificat existant


Création et paramétrage d'un certificat auto-signé (sans autorité de certification)
Création d'une autorité de certification et d'un certificat auto-signé

Note 1 : Dans le cas d'un certificat auto-signé sans autorité de certification, l'application
fonctionnera via HTTPS mais le navigateur Web indiquera que le site n'est pas un site de confiance.
Il faudra alors valider l'exception au niveau de la page du navigateur pour accéder à l'application
QALITEL.

Note 2 : Pour l'exemple, nous considérerons le package SCOQI_FULLWEB contenant l'ensemble de


l'environnement nécessaire au fonctionnement des applications QALITEL. Les chemins seront donc à
adapter selon la version de ce package ou si vous disposez d'un Apache installé séparément.

Toutes les lignes de commande seront à saisir dans la console DOS de votre serveur.

Le répertoire d'apache contenant OpenSSL.EXE est le suivant


: C:\scoqi_fullweb\Apache2.4.39Win64\bin

On se placera donc dans ce répertoire pour y exécuter les commandes qui vont suivre.

On créera un répertoire "certificats" dans le répertoire d'Apache


(C:\scoqi_fullweb\Apache2.4.39Win64\certificats) pour y stocker les différents fichiers qui seront
créés.

Création et paramétrage d'un certificat auto-signé (sans autorité de


certification)

Génération de la clé RSA

Pour générer une clé avec mot de passe

openssl genrsa -aes256 -out ..\certificats\qalitel.key 4096

Page 48
SCOQI
Si vous souhaitez retirer la demande de mot de passe, entrez la commande ci-dessous :

openssl rsa -in qalitel.key -out ..\certificats\qalitel.key

Pour générer une clé sans mot de passe (solution que nous adoptons) :

openssl genrsa -out ..\certificats\qalitel.key 4096

Génération du certificat auto-signé

openssl req -new -x509 -nodes -sha1 -key ..\certificats\qalitel.key -out ..\certificats\qalitel.crt -days
36500 -config ..\conf\openssl.cnf

Modification des fichiers de configuration d'Apache

Dans le fichier HTTPD.CONF (C:\scoqi_fullweb\Apache2.4.39Win64\conf\httpd.conf), décommentez


les 2 lgines mentionnées ci-dessous (supprimez le signe #) :

LoadModule ssl_module modules/mod_ssl.so


Include conf/extra/httpd-ssl.conf

Dans le fichier HTTPD-SSL.CONF (C:\scoqi_fullweb\Apache2.4.39Win64\conf\extra\httpd-ssl.conf),


effectuez les modificaitons suivantes :

DocumentRoot "c:/scoqi_fullweb/www/"
ServerName localhost:443
ServerAdmin scoqi@scoqi.fr
ErrorLog "C:/scoqi_fullweb/Apache2.4.39Win64/logs/ssl_error.log"
TransferLog "C:/scoqi_fullweb/Apache2.4.39Win64/logs/ssl_access.log"
SSLCertificateFile "C:/scoqi_fullweb/Apache2.4.39Win64/certicats/qalitel.crt"
SSLCertificateKeyFile "C:/scoqi_fullweb/Apache2.4.39Win64/certificats/qalitel.key"

puis paramétrez dans ce même fichier la balise <Directory> ou l'Alias correspondant à votre
installation :

Page 49
SCOQI
alias /scoqi "c:/scoqi_fullweb/www"
<Directory "c:/scoqi_fullweb/www">
AllowOverride all
Options FollowSymLinks
directoryindex index.php
Require all granted
</Directory>

Pour vérifier la configuration (erreurs de syntaxe notamment), entrez la commande suivante :

httpd -t

Rédémarrez Apache puis lancez l'application QALITEL. Vous aurez alors un message vous informant
que la connexion n'est pas sécurisée.

Il vous faudra alors autoriser l'exception

Création d'une autorité de certification et d'un certificat auto-signé

Il est nécessaire d'initialiser la variable d'environnement suivante :

OPENSSL_CONF C:\scoqi_fullweb\Apache2.4.39Win64\conf\openssl.cnf

Page 50
SCOQI

Ouvrir ensuite un Terminal et se placer dans le répertoire contenant le programme OpenSSL

cd C:\scoqi_fullweb\Apache2.4.39Win64\bin

Lancer ensuite le programme "openssl"

Génération de la clé RSA 4096 pour le ROOT CA. Cette clé sera stockée dans certificats/ca.key

(Pour protéger cette clé avec un mot de passe, il faut ajouter -des3 )

Page 51
SCOQI
genrsa -out ..\certificats\ca.key 4096

Création du certificat auto-signé ROOT CA qui sera stocké dans le fichier ca.crt

req -new -x509 -days 1826 -key ..\certificats\ca.key -out ..\certificats\ca.crt

(Le nombre de jours 1826 correspond à une durée de validité de 5 ans)

Création du subordonate CA

genrsa -out ..\certificats\ia.key 4096

Sortir d'OpenSSL (avec la commande "exit") et y ré-entrer pour la poursuitedes commandes sinon
avec la version 1.1.0 d'OpenSSL il y a une erreur "Problem créeating object tsa_ploicy1=1.2.3.4.1"

Page 52
SCOQI

Faire la demande de certificat pour le subordonate CA :

req -new -key ..\certificats\ia.key -out ..\certificats\ia.csr

(Ne rien entrer dans les 2 derniers "extra" attributes)

Page 53
SCOQI

Certificat Let's Encrypt sous Apache

2ème méthode : La méthode présentée dans le menu "Certificats SSL Let'sEncrypt" est plus simple
et rapide que celle décrite ci-dessous grâce à l'application Certbot utilisée. Cette méthode est
antérieure à la mise à disposition de Certbot.

Note : Avant de commencer ce tutorial, assurez-vous de disposer d'un nom de domaine pointant sur
votre serveur

Téléchargement de Win-acme
La première étape consistera à installer l'application "win-acme" qui sera utilisée pour la génération
du certificat avec Let's Encrypt.

Téléchargez l'application en cliquant sur ce lien. Décompressez ensuite le fichier téléchargé sur
votre disque (dans notre exemple nous décompresserons dans le répertoire : C:\win-
acme.v2.1.20.1185.x64)

Avant de passer à la création du certificat, nous allons créer un script utilisé par Win-acme
permettant de redémarrer le service Apache.

Pour cela, créez un fichier "RedemarrageApache.bat" dans le répertoire "C:\win-


acme.v2.1.20.1185.x64\Scripts"

Dans ce fichier "RedemarrageApache.bat" placez le code suivant :

net stop "scoqi-apache2.4.39" & sc start "scoqi-apache2.4.39"

Page 54
SCOQI

Lancement de Win-acme
Vous trouverez dans le répertoire "C:\win-acme.v2.1.20.1185.x64" le programme "wacs.exe".
Sélectionnez le et faites un clic droit "Exécuter en tant qu'Administrator".

L'exécution du programme sera bloquée par Microsoft Defender. Vous accéderez à cet écran :

Page 55
SCOQI

Cliquez sur le lien "Informations complémentaires" pour poursuivre l'installation.

Page 56
SCOQI

Cliquez enfin sur le bouton "Exécuter quand même". Vous accéderez à l'application win-acme où
commencera le paramétrage du certificat.

Dans notre exemple, nous allons créer un certificat pour le domaine : scoqi.qalitel.fr

Sur le premier écran proposé, nous l'option "M" pour la création d'un nouveau certificat :

A la question suivante, nous sélectionnerons l'option "2" pour une saisie manuelle :

Page 57
SCOQI

Ensuite il nous sera demandé d'entrer le host name. Dans notre exemple, nous entrerons
"scoqi.qalitel.fr".

Pour le "Friendly name", nous laisserons la ligne vide en validerons la saisie avec la touche "Entrée".

Pour la question suivante, nous choisirons l'option "1 - Save verification files on (network) path" :

Il nous sera ensuite demandé d'entrer le chemin où seront stockés les fichiers. Nous indiquerons le
répertoire "C:\scoqi_fullweb\Apache2.4.39Win64\htdocs" :

Page 58
SCOQI

Pour les quesitons suivantes, on répondra "N" pour la copie du "defaut web.config" pour puis on
sélectrionnera le choix "2" pour une clé RSA :

En suite nous choisirons le choix "2" et spécifierons le répetoire pur le stockage des fichiers.

Enfin, nous ne mettrons pas de mot de passe sur la clé privée :

Page 59
SCOQI

On indique ensuite le script qui sera lancé lors du renouvellement du certificat (script créé plus
haut) :

Pour la suite, on entre les 3 paramètres suivants :

{StoreType} {StorePath} {RenewalId}

Page 60
SCOQI

Enfin il vous sera demandé de saisir votre adresse EMail utilisée pour vous prévenir notamment lors
du renouvellement du certificat :

Configuration d'Apache
Paramétrage du certificat

Accédez au fichier de configuration d'Apache "httpd.conf" (présent dans notre exemple dans le
répertoire : "C:\scoqi_fullweb\Apache2.4.39Win64\conf") et décommentez les lignes ci-dessous (en
supprimant le signe # ) :

Loadmodule ssl_module modules/mod_ssl.so


Include conf/extra/httpd-default.conf
Include conf/extra/httpd-ssl.conf

Dans le fichier "httpd-ssl.conf" présent dans le répertoire


"C:\scoqi_fullweb\Apache2.4.39Win64\conf\extra" changez les lignes suivantes :

Paramétrage du Certificat :
SSLCertificateFile "${SRVROOT}/conf/scoqi.qalitel.fr-chain.pem"

Page 61
SCOQI

Paraémtrage de la clé publique


SSLCertificateKeyFile "${SRVROOT}/conf/scoqi.qalitel.fr-key.pem"

Rédémarrez ensuite le serveur Apache pour la prise en compte des modifications

Page 62
SCOQI

MSSQL

L'installation de la base de données MSSQL ne sera pas détaillée dans cette page. Seuls seront
abordés les points spécifiques.

Connexion Authentification mixte

Il est nécessaire que l'authentification du serveur soit en Mode d'authentification SQL Server et
Windows. Pour accéder à ce paramétrage, vous devez lancer la console d'administration de MSSQL
Microsoft SQL Server management Studio. Faites ensuite un clic droit Propriétés sur le serveur
SQL.

Vous accédez alors à la fenêtre ci-dessous.

L'onglet Sécurité vous permet de définir le mode d'authentification. Il est nécessaire de redémarrer
le serveur SQL pour la prise en compte de ce paramétrage.

Choix du classement

De manière à rendre les recherches au sein de l'application insensible à la casse et aux caractères
accentués, il est souhaitable de sélectionner le classement "French_CI_AI" comme montré ci-
dessous.

Page 63
SCOQI

Rôle de l'utilisateur SQL

Il n'est pas nécessaire d'attribuer le rôle "db_owner" à l'utilisateur au niveau de la base de données
QALITEL.

On peut spécifier les rôles ci-dessous pour être plus strict sur la sécurité :

db_datareader
db_datawriter
db_ddladmin
public

Paramétrage du port de connexion

Le port de connexion par défaut à une instance MSSQL Server est le 1433.

Dans la chaîne de connexion à la base de données renseignée au moment de l'installation de


l'application QALITEL, si l'instance MSSQL utilise le port par défaut, il n'est pas nécessaire de le
spécifier.

Page 64
SCOQI
Si toutefois, le port utilisé n'est pas celui par défaut, alors il est nécessaire de l'indiquer dans la
chaîne de connexion au niveau de l'instance. On aura alors une syntaxe sous la forme suivante (Port
51395 pris pour exemple) :

DESKTOP-JEROME\SQL2017, 51395

Le fichier de configuration contenant la chaîne de connexion "../app/config/config.php" se présente


alors sous la forme suivante :

Page 65
SCOQI

MySQL

Installation de MySQL

Le serveur de base de données MySQL est téléchargeable sur le site officiel de MySQL. Une fois le
programme téléchargé, double-cliquez dessus pour le lancer.

Cliquez sur Next pour commencer le processus d'installation.

Page 66
SCOQI

Vous pouvez choisir l'option Typical qui est suffisante pour les applications QALITEL et Epistolaire.
Cliquez sur Next puis Install pour débuter l'installation.

Cochez la case Configure the MySQL Server now afin de procéder au paramétrage de votre serveur
MySQL. Vous pouvez également procéder à l'enregistrement auprès de Sun. Cliquez ensuite sur
Next.

Page 67
SCOQI

Nous choisirons l'option Detail Configuration afin de spécifier si besoin des paramètres
personnalisés pour l'installation du serveur MySQL. Cliquez sur Next.

Nous opterons dans le choix du type d'installation pour une installation Server Machine. Cette
option convient le mieux à une installation sur une machine hébergeant d'autres applications
/services tels que le serveur Web par exemple.

On choisirait Dedicated MySQL Server Machine dans le cas d'un serveur dédié à MySQL. Si tel n'est
pas le cas, on s'abstiendra de ce choix car MySQL peut dans le cas de certains traitements lourds

Page 68
SCOQI
monopoliser toutes les ressources et bloquer ainsi les autres applications.

Le mode de stockage à privilégier pour les applications QALITEL / Epistolaire est InnoDB. Aussi,
nous opterons pour le second choix, à savoir Transactional Database Only.

Le choix par défaut permet de placer le fichier InnoDB contenant la base de données dans la
structure de répertoires de MySQL. Si vous souhaitez placer la base de données sur un autre disque,
vous pouvez modifier le paramétrage à ce niveau. Le fonctionnement ultérieur de MySQL n'en sera
bien évidemment aucunement impacté.

Page 69
SCOQI

fonction de la charge présumée de votre serveur MySQL (accès simultanés), sélectionnez l'option de
votre choix. Dans la grande majorité des cas, la première option convient.

Cet écran vous permet de spécifier un port pour le serveur MySQL. Par défaut, le port utilisé est
3306. Vous pouvez indiquer tout autre port disponible. Dans le cas d'un port autre que le port
standard, il vous sera ensuite nécessaire de le spécifier lors de vos connexions à MySQL notamment
dans le fichier de connexion des applications QALITEL / Epistolaire - CONFIG/CONFIGPHP.

Page 70
SCOQI

La table de caractères par défaut pour les applications QALITEL / Epistolaire doit être le Latin1.
Aussi le premier choix Standard Character Set convient-il.

Nous installerons MySQL en tant que service en cochant la case Install As Windows Service. Le
service sera alors paramétré en démarrage automatique ce qui vous garantira le redémarrage de
MySQL après chaque reboot du serveur.

La case Include Bin Directory in Windows PATH vous permet, lorsque vous souhaitez accéder à
MySQL en ligne de commande, de ne pas être contraint de vous placer dans le répertoire /BIN/ de

Page 71
SCOQI
MySQL. L'accès au programme MYSQL.EXE est alors possible à tout endroit car placé dans le PATH
de WIndows.

A ce niveau, indiquez le mot de passe pour le compte Root. Il est souhaitable pour des questions de
sécurité, sauf besoin contraire, de ne pas permettre des accès root par des machines distantes. On
ne cochera donc pas la case Enable root access from remote machines.

Dans le même esprit, les connexions anonymes ne seront pas autorisées. On ne cochera pas la case
Create An Anonymous Account.

Page 72
SCOQI
Ce dernier écran valide l'installation selon les paramètres renseignés préalablement et monte le
service MySQL. A l'issue, MySQL est opérationnel. Si vous rencontrez une erreur durant ce
processus, reportez-vous à la F.A.Q. Base de données

Installation de phpMyAdmin

phpMyAdmin est une interface PHP permettant de gérer les bases de données MySQL. Vous pouvez
télécharger l'application directement sur le site de phpMyAdmin.

Le programme est téléchargeable dans un fichier .ZIP qu'il vous suffit ensuite de décompresser sur
votre disque dans une structure de répertoires accessible par votre serveur Web ou bien si ce n'est
pas le cas, il vous faudra alors paramétrer un répertoire virtuel pour pouvoir lancer l'application.

Celle-ci se lance donc en appelant la page index.php située dans la racine de la structure de
répertoires du .ZIP de phpMyAdmin.

Vous accédez alors à la page suivante :

Un écran d'authentification vous est alors proposé. Saisissez les login / mot de passe paramétrés lors
de l'installation de la base de données MySQL.

Installation de MySQL Administrator

Page 73
SCOQI

MySQL fournit sur son site différents outils pour administrer ou se connecter à ses bases de données
(Nous l'utilisaerons notamment pour la réalisation des backups des bases MySQL et la planification
de ces backups). Vous trouverez tous les éléments sur le site de MySQL et plus spécifiquement à
cette adresse pour le module MySQL Administrator. Celui-ci peut être téléchargé indépendamment
ou bien intégré au MySQL GUI Tools qui installe les applications suivantes :

MySQL Administrator
MySQL Query Browser
MySQL Migration Toolkit

Nous allons détailler ci-dessous l'installation de ce package qui ne présente par ailleurs pas de
difficultés puisque l'on est guidé par l'assistant d'installation.

Une fois le téléchargement du programme d'installation du MySQL GUI Tools, double cliquez sur le
fichier pour lancer l'installation.

Faites Next pour accéder à l'écran des choix d'installation.

Page 74
SCOQI

Si vous souhaitez installer l'ensemble des modules de ce package, cliquez sur Complete puis faites
Next sinon sélectionnez Custom puis cliquez ensuite sur Next pour choisir les programmes à
installer.

Désactivez les modules que vous ne souhaitez pas installer puis cliquez sur Next pour finir le
processus d'installation.

Une fois le package installé, vous pouvez lancer MySQL Administrator via le bouton Démarrer puis
Tous les programmes - MySQL. Vous trouverez alors dasn ce groupe de programmes l'icone

Page 75
SCOQI
permettant de lancer l'application.

Le programme MySQL Administrator vous demande de vous authentifier pour accéder à l'interface
d'administration. Entrez alors le nom du serveur ainsi que votre Login / Mot de passe correposndant
au compte MySQL créé lors de l'installation de la base de données. Vous pourrez par la suite créer
bien entendu d'autres utilsateurs de la base de données avec des droits plus ou moins étendus et
pouvant accéder via cette interface MySQL Administrator à l'administration de toute ou partie des
bases de données gérées par votre serveur MySQL.

Une fois les paramètres saisis, cliquez sur le bouton OK.

Page 76
SCOQI

Création d'un plan de maintenance avec MySQL


Administrator

Il est possible de planifier la sauvegarde de base de données MySQL via l'outil MySQL
Administrator. Celui-ci crée alors une tâche planifiée dans le planificateur de tâche de Windows.

Vous trouverez ci-dessous le mode opératoire à suivre pour la mise en place de votre plan de
sauvegarde.

Création d'une connexion stockée

Cette étape est impérative pour le bon fonctionnement de la tâche planifiée.

Dans le menu Tools cliquez sur Options, puis allez dans la partie Connections

Page 77
SCOQI

Une fois dans la partie Connections cliquez sur Add new connection
a Donnez un nom à votre connexion c'est celui qui apparaîtra dans le gestionnaire des tâches
planifiées de Windows.

Remplissez les champs suivants

Username =
password =
(C’est le compte qui est propriétaire de la base de données de l'application que vous devez
renseigner. Vous pouvez trouver ces informations dans le rapport d'installation si celle a été faite
par un technicien de notre société ou alors dans le fichier connexion.php de votre application, il se
trouve dans le répertoire de l'application sous l'arborescence suivante \app\parametrage\)
Hostname = localhost

Validez en appuyant sur Apply.

Page 78
SCOQI

Mise en place du stockage de mot de passe pour la connexion

Allez dans le menu Tools => Options

Dans General Options , cochez Store passwords et sélectionnez Obscured puis validez en
cliquant sur Apply

Page 79
SCOQI

Une fois cette étape réalisée, quittez l'application MySQL Administrator puis relancez là en
choisissant maintenant la connection stockée réalisée précédemment.

Mise en place de la sauvegarde

Dans la partie Backup, cliquez sur New Project. Ensuite faites passer votre base de données de la

Page 80
SCOQI
gauche vers la droite en cliquant sur >.

Une fois la base passée à droite, selectionnez l'onglet Schedule, cochez la case Schedule this
backup project.

Renseignez Target folder par votre répertoire de destination où vous souhaitez mettre la
sauvegarde et au niveau de Filename saisissez le nom que vous souhaitez attribuer au fichier .sql
(MySQL Administrator ajoutera automatiquement au nom de fichier spécifié à ce niveau la date -
heure complète ainsi que l'extension .sql).

Dans la partie inférieure choisissez la fréquence de sauvegarde.

Page 81
SCOQI

Validez le projet en cliquant sur Save Project. Une fenêtre vous demandera d'entrer le compte
Windows sous lequel sera exécutée la tâche planifiée de sauvegarde. Cette information vous sera
demandée à chaque modification du projet de sauvegarde.

Test de la sauvegarde planifiée

Allez dans le gestionnaire des tâches planifiées de windows, vous devriez voir votre tâche apparaitre

Page 82
SCOQI
dans la liste. Faites un clic droit "Exécuter".

En cas de soucis nous vous invitons à cliquer sur ce lien : F.A.Q. Base de données

Page 83
SCOQI

Installation QALITEL - Mode opératoire

Mode opératoire d'installation


Ce mode opératoire s'applique aux nouvelles installations. Dans le cas des mises à jour,
vous disposez au sein des logiciels QALITEL d'une fonctionnalité de Live Update qui réalise
automatiquement la montée de version. Cette page vous décrit les différentes options de
mises à jour disponibles. Vous pouvez néanmoins appliquer ce mode opératoire dans le cas
d'une mise à jour manuelle.

Le processus d'une installation complète ou d'une mise à jour (manuelle) des applications QALITEL
est similaire et se fait au travers d'un assistant qui vous guidera dans les différentes étapes.

Dans le cas d'une toute première installation des applications QALITEL, il est nécessaire de
commencer par les étapes d'installation et de configuration de PHP, de la base de données,...

Vous trouverez le détail de ces installations dans les rubriques correspondant à votre
environnement. Cliquez ici pour accéder au sommaire des installations des applications FullWeb.

Cas particulier des GAE : Pour l'installation des GAE, vous devez respecter les points suivants :
• Le GAE se connecte sur la base de données de l'application principale à laquelle il se rattache. Vous devez donc spécifier les mêmes paramètres de connexion (serveur, base
de données et identifiants). L'installation du GAE ajoutera des tables spécifiques dans la base de données de l'application principale.
• Le GAE s'installe dans son propre répertoire au même titre que l'application principale. Il ne doit en aucun cas être installé en sous niveau d'une application comme le
montre les copies d'écran ci-dessous :
• Le GAE est donc une application à part entière, aussi vous devez opter, lors de l'installation initiale, pour le type d'installation "Installation complète".

Installation incorrecte - Le répertoire du GAE a été placé dans la structure de


répertoires de l'application principale.
Installation correcte - Le GAE a été placé dans un répertoire spécifique au même
niveau que le répertoire contenant l'application principale.

Copie du ZIP d'installation

Vous devez télécharger le fichier ZIP d'installation via votre portail client. Copiez le fichier ZIP
téléchargé dans le répertoire de l'application (dans le cas d'une mise à jour, au même niveau
que le répertoire APP, là où se trouve le fichier index.php).

Page 84
SCOQI

Vous pouvez opter pour la structure de répertoires ci-dessous selon le logiciel à installer :

QALITEL doc ==> C:\scoqi\qdoc


QALITEL conform - QALITEL progrès / QALITEL audit ==> C:\scoqi\qca
QALITEL compar ==> C:\scoqi\qcompar
QALITEL courrier ==> C:\scoqi\qcourrier

Décompression du fichier ZIP d'installation

Décompressez le fichier ZIP d'installation directement dans le répertoire où vous l'avez placé. Un
fichier install.php ainsi qu'un répertoire INSTALL se trouveront alors au même niveau que votre
fichier ZIP.

Vous trouverez ci-dessous une copie d'écran de l'explorateur de fichiers vous montrant la structure
de répertoires après décompression du fichier ZIP d'installation.

Page 85
SCOQI

Lancement de l'interface d'installation

Maintenant que le ZIP d'installation a été décompressé, vous allez pouvoir lancer l'interface
d'installation. Pour cela, ouvrez votre navigateur Web puis entrez l'adresse de lancement de votre
application : http://adresse_serveur/scoqi/qca/install.php. (Adresse à adapter selon le paramétrage
de votre serveur Web - Répertoires virtuels réalisés lors de l'installation de l'environnement
technique)

Processus d'installation

L'interface d'installation vous propose d'effectuer une mise à jour ou une installation complète du
logiciel. dans le cas d'une première installation, nous optons pour le choix "Installation complète" :

Il est ensuite nécessaire d'entrer les paramètres de connexion à la base de données, créée
préalablement dans l'application d'administration de la base (Par exemple : PHPMyAdmin pour
MySQL, SQL Server Management Studio pour MSSQL)

Ces informations sont alors stockées dans le fichier config.php situé dans le répertoire /CONFIG

Page 86
SCOQI
(répertoire qui sera créé lors du processus d'installation).

Le processus d'installation ne se poursuit que si la connexion à la base de données a été réalisée


avec succès. Dans ce cas, un écran vous rappelle les paramètres de connexion.

Page 87
SCOQI

Vous pouvez à l'issue de cet écran cliquer sur le bouton Suivant pour procéder à l'installation.
ATTENTION, l'installation de l'application peut durer plusieurs minutes. Veuillez laisser le processus
se dérouler jusqu'à son terme. A l'issue, la fenêtre suivante vous est proposée :

Page 88
SCOQI

Vous pouvez alors lancer l'application en cliquant sur le lien Lancer l'application.

A l'issue de l'installation, votre structure de répertoires sera la suivante :

Page 89
SCOQI

Problèmes pouvant survenir

Erreurs lors de la copie des fichiers PHP

principalement sous Linux, il est possible, lors d'une mise à jour de rencontrer des erreurs de
copie des fichiers PHP. Cela provient du fait que l'application d'installation étant en PHP, elle
tourne sous le compte d'Apache (généralement www-data sous Debian et Apache sous
RedHat). L'installation initiale a pu être installée sous un autre compte utilisateur. Il est alors
nécessaire de donner les droits nécessaires à www-data ou apache pour l'écriture des PHP.
Vous pouvez faire un changement de propriétaire sur le répertoire de l'application QALITEL.

Vous pouvez vous reporter aux différentes F.A.Q. de ce site selon le problème rencontré.

Page 90
SCOQI

Installation - Générateur Automatique d'Emails

Informations importantes
L'installation du G.A.E. (Générateur Automatique d'Emails) est spécifique. Pour bien comprendre le
processus d'installation décrit ci-après, il est nécessaire de préciser les points suivants :

1. Le G.A.E. est une applicaiton à part entière et doit donc s'installer dans son prorpre répertoire
au même titre que les applications principales.
2. La base de données du G.A.E. est commune à celle de l'application principale à laquelle il se
rattache. Aussi, lors de l'installation, il sera nécessaire d'indiquer les mêmes paramètres de
connexion à la base SQL que ceux spécifiés pour l'application principale
3. Le G.A.E . ne se lance pas directement de manière autonome mais à partir de l'application
principale car le profil utilisateur est passé en paramètres afin de s'assurer que l'utilisateur
souhaitant se connecter y est autorisé. Ainsi, il est nécessaire de paramétrer le lien de
lancement du G.A.E. dans les "Préférences" de l'application principale.

Structure des répertoires


Tout comme pour les applications, vous avez toute liberté pour le nom du répertoire où vous
installerez le G.A.E. Vous pouvez par exemple opter pour la structure de répertoires proposées ci-
dessous :

G.A.E. QALITEL doc ==> c:\scoqi_fullweb\www\gae_doc


G.A.E. QALITEL amélioration (QALITEL conform - QALITEL audit - QALITEL progrès) ==>
c:\scoqi_fullweb\www\gae_qca
G.A.E. QALITEL compar==> c:\scoqi_fullweb\www\gae_compar
G.A.E. QALITEL courrier ==> c:\scoqi_fullweb\www\gae_courrier

Votre structure de répertoires sera alors de la forme suivante (selon les logiciels en votre
possession)

Page 91
SCOQI

Copie et décompression du fichier ZIP d'installation


A partir de votre portail client, téléchargez le fichier .ZIP d'installation et copiez le dans son
répertoire de destination (ci-après à titre d'information la correspondance des noms des fichiers
d'installation ZIP avec les logiciels) :

G.A.E. QALITEL doc ==> gae_doc.zip


G.A.E. QALITEL conform ==> gae_conform.zip
G.A.E. QALITEL audit ==> gae_audit.zip
G.A.E. QALITEL progrès ==> gae_progres.zip
G.A.E. QALITEL compar ==> gae_compar.zip
G.A.E. QALITEL courrier ==> gae_courrier.zip

Décompressez ensuite le fichier directement dans son répertoire. Vous devez à l'issue disposer des
éléments suivants (selon votre G.A.E.)

Processus d'installation
Une fois le programme d'installation du G.A.E. décompressé, vous pouvez lancer le programme
d'installation en procédant de manière similaire à l'installation des applications principales. Pour
cela, ouvrez votre navigateur Web et entrez l'URL de lancement
http://adresse_serveur/scoqi/gae_qca/install.php (Adresse à adapter selon le paramétrage de votre
serveur Web - Répertoires virtuels créés lors de l'installation de l'environnement technique).

Page 92
SCOQI

Sélectionnez "Installation complète" puis cliquez sur le bouton "Suivant".

Page 93
SCOQI

Saisissez ensuite les paramètres de connexion à la base de données qui doivent être les mêmes que
ceux de l'application principale à laquelle se rattache votre G.A.E. En effet, les tables nécessaires au
fonctionnement du G.A.E. s'ajouteront dans la base de données à celles déjà présentes de
l'application principale.

Note : Dans le cas particulier de QALITEL amélioration (qui regroupe, rappelons le, les 3 logiciels
QALITEL conform - QALITEL audit et QALITEL progrès), les paramètres SQL sont les mêmes pour
tous les G.A.E. de QALITEL amélioration et tous les G.A.E. de QALITEL amélioration s'installent
successivement dans le même répertoire C:\scoqi\gae_qca dans notre exemple.

Paramétrage du lancement du G.A.E.


Comme mentionné en haut de cette page, le G.A.E. ne peut être lancé directement de manière
autonome. Il est nécessaire de le lancer via l'application principale par le menu "Outils - Générateur
Automatique d'Emails".

Pour que cela fonctionne, il faut préalablement, à l'issue de l'installation du G.A.E. configurer les
"Préférences" de l'application principale. Pour cela, lancez l'application principale puis accédez au
menu "Outils - Préférences".

Une fois dans l'écran des "Préférences", accédez à l'onglet "Emails". Vous y trouverez alors une
rubrique "Adresse du générateur automatique d'Email" où il vous faudra paramétrer l'URL de
lancement de votre G.A.E. Déconnectez vous puis relancer l'application principale pour la prise en
compte de ce paramétage. Vous serez alors en mesure d'accéder au G.A.E.

Page 94
SCOQI

Paramétrage des tâches planifiées

Il est possible de planifier différentes tâches afin de les déclencher périodiquement de manière
automatique. Les différentes tâches pouvant être planifiées sont les suivantes :

* Déclenchement du GAE (Générateur Automatique d'Emails)


* Synchronisation LDAP
* Sauvegardes

Déclenchement du GAE : Permet de déclencher les campagnes d'envoi d'Emails pour informer /
relancer les utilisateurs par Emails sur les informations les concernant.

Synchronisation LDAP : Permet de synchroniser les données de la liste du Personnel /


Interlocuteurs internes des applications QALITEL /Epistolaire avec l'annuaire LDAP. SI des éléments
ont été ajoutés ou modifiés, alors la liste correspondante des applications FullWeb en bénéficie. En
cas de suppression d'éléments de l'annuaire LDAP, les éléments sont également supprimés de la
liste QALITEL / Epsitolaire.

Sauvegardes : Permet d'effectuer des sauvegardes de la baes de données de l'application ainsi que
des répertoires où peuvent être envoyés des documents par les utilisateurs.

Ces tâches planifiées sont des pages .PHP exécutées au sein d'un navigateur Web ou des fichiers
.BAT exécutés enb ligne de commande. Pour créer une tâche planifiée sous Windows, accédez au
menu Démarrer - Tous les programmes - Accessoires - Outils système - Taches planifiées.

Pour créer une tâche planifiée, double-cliquez sur le libellé Création d'une tâche planifiée afin
d'accéder à l'assistant.

Page 95
SCOQI
Sélectionnez dans la liste des applications votre navigateur Internet comme montré ci-dessous :

L'écran suivant permet de spécifier le nom de la tâche planifiée ainsi que la fréquence de
déclenchement :

Ensuite on spécifie l'heure ainsi que le ou les jours de déclenchement.

Page 96
SCOQI

Le déclenchement des tâches planifiée se font sous un compte Utilisateur dont vous devez entrer à
ce niveau l'identifiant et le mot de passe.

Enfin le dernier écran de cet assistant, vous permet d'ouvrir l'écran des propriétés avancées que
nous utiliserons pour définir la page devant être lancée par le navigateur Internet.

Page 97
SCOQI

A l'issue de l'assistant, vous accédez à l'écran des Propriétés de la tâche planifiée. Cet écran peut
également être appelé par un clic droit Propriétés sur la tâche planifiée.

L'appel de la page PHP devant être exécutée périodiquement se fait en plaçant à la fin de la ligne
Exécuter l'adresse URL de cette page comme montré dans la copie d'écran ci-dessous :

Page 98
SCOQI

ATTENTION : Dans certains cas il est nécessaire de mettre les " autour du chemin d'accès
au navigateur WEb (Internet Explorer) et dans d'autres cas autour de l'url de lancement.

* Synchronisation LDAP : http://serveur/..../app/query/import_ldap.php


* Déclenchement du GAE :
http://serveur/..../gae/app/campagne/planning_campagne.php

Dans l'onglet Paramètres, vous pouvez définir un délai au delà duquel Windows arrêtera la tâche. Il
est intéressant de définir un délai à ce niveau de l'ordre d'une demi heure par exemple. En effet, lors
de l'exécution de la tâche planifiée, le navigateur va se lancer et exécuter la page mentionnée ci-
dessus. A l'issue de l'exécution de cette page, le navigateur va rester ouvert. L'arrêt de la tâche va
permettre de fermer cette session du navigateur et libérer ainsi la mémoire prise par son
chargement.

Page 99
SCOQI

Vous pouvez à tout moment modifier l'ensemble des paramètres de la tâche planifiée dans cet écran
des Propriétés.

Pour une création de la tâche planifiée en ligne de commande, reportez-vous à cette rubrique

Page 100
SCOQI

Sauvegarde des répertoires

Les applications QALITEL / Epistolaire indexent des documents envoyés par les utilisateurs. Il est
donc impératif de les intégrer dans les processus de sauvegarde.

Les répertoires à sauvegarder pour les différentes applications sont les suivants :

QALITEL :

Répertoire des documents : /APP/DOCUMENTS/


Répertoire des états (modèles d'impression) : /APP/ETATS/

Epistolaire :

Répertoire des documents en attente d'indexation : /APP/ATTENTE/


Répertoire des documents : /APP/DOCUMENTS/
Répertoire des états (modèles d'impression) : /APP/ETATS/
Répertoire des bases archivées : /APP/ARCHIVES_BASE/

Vous trouverez ci-dessous des exemples de scripts permettant d'effectuer des copies de répertoires.
Ces scripts sont à copier dans un fichier texte d'extension .BAT.

Vous pouvez ensuite créer une tâche planifiée lançant périodiquement ce fichier .BAT. le processus
de création de la tâche planifiée est similaire à celui décrit pour les planifications des tâches GAE et
Synchronisation LDAP. Vous devez simplement choisir comme application la commande prompt
comme le montre la copie d'écran ci-dessous :

Ensuite dans la fenêtre des Propriétés de la tâche planifiée, complétez la ligne Exécuter en
saisissant le chemin et le nom complet du fichier .BAT tel que montré ci-dessous :

Page 101
SCOQI
C:\WINDOWS\system32\cmd.exe /K "c:\scoqi\scripts\copie.bat"

Vous trouverez ci-dessous des exemples de scripts permettant d'effectuer des sauvegardes de
répertoires.

Copie simple d'un répertoire

Cette ligne de commande permet d'effectuer une copie d'un répertoire sans notion d'incrémentation.
Les exécutions successives de ces scripts remplaçant les données copiées préalablement.

:: Copie non compressee d un répertoire


set rep_source=C:\scoqi\qalitel\app\documents
set rep_sauvegarde=C:\scoqi\backup_documents
xcopy %rep_source% %rep_sauvegarde% /E /H /I /V

Script permettant la copie d'un répertoire avec gestion des erreurs :

:: Copie non compressee d un répertoire avec gestion des erreurs


@echo off
set rep_source=C:\scoqi\qalitel\app\documents
set rep_sauvegarde=C:\scoqi\backup_documents
xcopy %rep_source% %rep_sauvegarde% /E /H /I /V
if errorlevel 4 goto pbmemoireif errorlevel 2 goto annuler
if errorlevel 0 goto fin
:pbmemoire
echo Memoire insuffisante pour copier les fichiers ou
echo lecteur non valide ou erreur de syntaxe.
goto fin
:annuler
echo Copie annulee par utilisateur - Ctrl C
goto fin
:fin

Copie compressée d'un répertoire

Sous Windows, il est nécessaire, pour pouvoir réaliser un ZIP en ligne de commande, d'installer un
utilitaire le permettant. L'application 7-Zip le permet. Vous pouvez la télécharger sur le site officiel

Page 102
SCOQI
http://www.7-zip.org ou sur notre site : Version 32 bits - Version 64 bits

Après installation, il est nécessaire de mettre le répertoire 7-zip dans le PATH de Windows si vous
souhaitez entrer les commandes telles que montrées ci-dessous sinon il vous faudra indiquer le
répertoire de stockage de 7-zip.

La ligne de commande à intégrer à votre fichier .BAT est :

:: Compression d un repertoire dans un fichier ZIP


set nom_fichier=backup.zip
set rep_source=C:\scoqi\qalitel\app\documents
set rep_sauvegarde=C:\scoqi\backup_documents
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

Copie compressée incrémentale d'un répertoire

Ce script permet de compresser un répertoire et d'intégrer dans le nom du fichier ZIP la date de
manière à disposer d'une sauvegarde incrémentale.

Les lignes de commandes à intégrer à votre fichier .BAT seraient alors :

set nom_fichier=backup%DATE%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=C:\scoqi\qalitel\app\documents
set rep_sauvegarde=C:\scoqi\backup_documents
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

Suppression des fichiers dont la date est supérieure à 15


jours

Ce script va permettre de supprimer les vieux fichiers dont la date de création est antérieure à 15
jours. De ce fait, dans notre répertoire /backup, il n'y aura que les backups des 15 derniers jours.

Ce script s'appuie sur l'utilitaire FORFILES. Des informations détaillées sur cet utilitaire sont
disponibles ici

set rep_sauvegarde=c:\scoqi\backup_documents
set nb_jours=15

Page 103
SCOQI
FORFILES /p %rep_sauvegarde% /s /m *.* /d -%nb_jours% /c "cmd /c del @FILE"

Création d'une tâche planifiée en script

La création des tâches planifiées peut se faire en utilisant l'interface graphique (raccourci Création
d'une tâche planifiée à partir de la liste des tâches planifiées). Il est également possible de les créer
en script. Ci-dessous un exemple de script créant la tâche planifiée pour l'exécution d'un .BAT (cette
commande peut bien sûr s'appliquer aux tâches du GAE ou de la synchronisation LDAP) :

schtasks /create /tn "sauvegarde_sql" /tr c:\scoqi\scripts\backup_sql.bat /sc


daily /st 23:00 /ru nom_utilisateur /rp mot_de_passe

/tn
Nom de la tâche planifiée
/tr
Ligne de commande complète
/sc
Périodicité
/st
Heure de déclenchement
/ru
Nom du compte Windows sous lequel sera exécutée la tâche planifiée
/rp
Mot de passe du compte Windows précédemment mentionné

Page 104
SCOQI

Sauvegardes complètes (Exemples de scripts)

Cette page regroupe les scripts de sauvegarde pour les différentes applications QALITEL. Ces
scripts sont fournis avec le package SCOQI_FULLWEB mais peuvent être repris et adaptés selon
votre configuration. Ces scripts sont à copier dans des fichiers .BAT qu'il est ensuite possible de
faire exécuter dans une tâche planifiée.

Remarques :

Dans le package SCOQI_FULLWEB, les scripts sont placés dansle répertoire


\SCXOQI_FULLWEB\SCRIPTS
Le résultat des sauvegardes
Dans la dernière ligne du script, indiquez le compte MySQL tel que vous l'avez défini (-u :
Utilisateur MySQL | -p : Mot de passe MySQL)
L'application 7-Zip doit être installée. Se référer à cette rubrique pour son installation (Elle est
présente avec le package SCOQI_FULLWEB).

Remarques (bis) : Répertoires spécifiés dans les exemples de scripts :

Dans les exemples de scripts ci-dessous, les applications sont par défaut installées dans le répertoire
C:\SCOQI_FULLWEB\WWW\

Les programmes de la base de données MySQL sont installés dans le répertoire


C:\scoqi_fullweb\MySQL\MySQLxx\bin

Ces répertoires sont à adapter en fonction de votre installation.

Les sauvegardes sont écrites dans le répertoire \scoqi_fullweb\sauvegardes\ et historisées


sur 30 jours glissants

QALITEL doc : Script de sauvegarde complet

REM #################################################
REM # Suppression des fichiers #de + de 30 jours
REM #################################################
Page 105
SCOQI
set rep_sauvegarde=c:\scoqi\sauvegardes
set nb_jours=30
FORFILES /p %rep_sauvegarde% /s /m *.* /d -%nb_jours% /c "cmd /c del @FILE"

REM #################################################
REM # Sauvegarde du repertoire \Mes_Donnees
REM #################################################
set nom_fichier=Qdoc_MES_DONNEES_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=c:\scoqi\Qdoc\app\mes_donnees
set rep_sauvegarde=c:\scoqi\sauvegardes
cd c:\scoqi\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Sauvegarde du repertoire \Etats
REM #################################################
set nom_fichier=Qdoc_ETATS_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=c:\scoqi\Qdoc\app\etats
set rep_sauvegarde=c:\scoqi\sauvegardes
cd c:\scoqi\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Backup MySQL
REM #################################################
set nom_fichier=Qdoc_MYSQL_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.sql
set nom_fichier=%nom_fichier:/=%
cd "C:\Program Files\MySQL\MySQL Server 5.5\bin"
mysqldump -u scoqi -pscoqi Qdoc> c:\scoqi\sauvegardes\%nom_fichier%

QALITEL amélioration (QALITEL audit - QALITEL conform -


QALITEL progrès) : Script de sauvegarde complet

REM #################################################
REM # Suppression des fichiers de + de 30 jours

Page 106
SCOQI
REM #################################################
set rep_sauvegarde=c:\scoqi\sauvegardes
set nb_jours=30
FORFILES /p %rep_sauvegarde% /s /m *.* /d -%nb_jours% /c "cmd /c del @FILE"

REM #################################################
REM # Sauvegarde du repertoire \Mes_Donnees
REM #################################################
set nom_fichier=QCA_MES_DONNEES_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=C:\scoqi\qca\app\mes_donnees
set rep_sauvegarde=C:\scoqi\sauvegardes
cd C:\scoqi\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Sauvegarde du repertoire \Etats
REM #################################################
set nom_fichier=QCA_ETATS_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=C:\scoqi\qca\app\etats
set rep_sauvegarde=C:\scoqi\sauvegardes
cd C:\scoqi\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Backup MySQL
REM #################################################
set nom_fichier=QCA_MYSQL_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.sql
set nom_fichier=%nom_fichier:/=%
cd "C:\Program Files\MySQL\MySQL Server 5.5\bin"
mysqldump -u scoqi -pscoqi qca> c:\scoqi\sauvegardes\%nom_fichier%

QALITEL compar : Script de sauvegarde complet

REM #################################################
REM # Suppression des fichiers de + de 30 jours
REM #################################################
set rep_sauvegarde=c:\scoqi\sauvegardes
set nb_jours=30
Page 107
SCOQI
FORFILES /p %rep_sauvegarde% /s /m *.* /d -%nb_jours% /c "cmd /c del @FILE"

REM #################################################
REM # Sauvegarde du repertoire \Mes_Donnees
REM #################################################
set nom_fichier=Qcompar_MES_DONNEES_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=C:\scoqi\Qcompar\app\mes_donnees
set rep_sauvegarde=C:\scoqi\sauvegardes
cd C:\scoqi\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Sauvegarde du repertoire \Etats
REM #################################################
set nom_fichier=Qcompar_ETATS_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=C:\scoqi\Qcompar\app\etats
set rep_sauvegarde=C:\scoqi\sauvegardes
cd C:\scoqi\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Backup MySQL
REM #################################################
set nom_fichier=Qcompar_MYSQL_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.sql
set nom_fichier=%nom_fichier:/=%
cd "C:\Program Files\MySQL\MySQL Server 5.5\bin"
mysqldump -u scoqi -pscoqi Qcompar> c:\scoqi\sauvegardes\%nom_fichier%

QALITEL courrier : Script de sauvegarde complet

REM #################################################
REM # Positionnement sur le disque

Page 108
SCOQI
REM #################################################
c:
set disque=c:

REM #################################################
REM # Suppression des fichiers de + de 30 jours
REM #################################################
set rep_sauvegarde=%disque%\scoqi_fullweb\sauvegardes
set nb_jours=30
FORFILES /p %rep_sauvegarde% /s /m *.* /d -%nb_jours% /c "cmd /c del @FILE"

REM #################################################
REM # Sauvegarde du repertoire \Attente
REM #################################################
set nom_fichier=Qcourrier_ATTENTE_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=%disque%\scoqi_fullweb\www\Qcourrier\app\attente
set rep_sauvegarde=%disque%\scoqi_fullweb\sauvegardes
cd %disque%\scoqi_fullweb\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Sauvegarde du repertoire \Mes_Donnees
REM #################################################
set
nom_fichier=Qcourrier_MES_DONNEES_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=%disque%\scoqi_fullweb\www\Qcourrier\app\mes_donnees
set rep_sauvegarde=%disque%\scoqi_fullweb\sauvegardes
cd %disque%\scoqi_fullweb\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Sauvegarde du repertoire \Etats
REM #################################################
set nom_fichier=Qcourrier_ETATS_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.zip
set nom_fichier=%nom_fichier:/=%
set rep_source=%disque%\scoqi_fullweb\www\Qcourrier\app\etats
set rep_sauvegarde=%disque%\scoqi_fullweb\sauvegardes
cd %disque%\scoqi_fullweb\7-Zip
7z a %rep_sauvegarde%\%nom_fichier% %rep_source%

REM #################################################
REM # Backup MySQL
REM #################################################
set nom_fichier=Qcourrier_MYSQL_backup_%DATE:~6,4%%DATE:~3,2%%DATE:~0,2%.sql
set nom_fichier=%nom_fichier:/=%
cd %disque%\scoqi_fullweb\mysql5.7.26\bin

Page 109
SCOQI
mysqldump -u root -pscoqi Qcourrier > %disque%\scoqi_fullweb\sauvegardes\%nom_fichier%

Page 110
SCOQI

Sauvegarde (Dump) MySQL

Le backup de la base MySQL peut se faire en utilisant l'outil MySQL Administrator et la planification
d'une tâche de sauvegarde tel que cela a été décrit dans cette page (valable pour Windows et Linux).

Il est toutefois possible de réaliser un dump de la base MySQL directement en ligne de commande.
Le fichier .BAT ou le script peut alors être intégré à une tâche planifiée ou à un CRON pour un
déclenchement périodique.

La syntaxe est alors la suivante :

Backup d'une base de données

mysqldump -u scoqi -pscoqi QCONFORM > c:\scoqi\backup_mysql\backup.sql

où :

-u
Identifiant de connexion à la base MySQL

-p
Mot de passe correspondant (attention, il n'y a pas d'espaces entre le -p et le mot de passe)

QCONFORM
Nom de la base de données à sauvegarder

c\scoqi\backup_mysql\backup.sql
Répertoire et nom du fichier backup SQL

Backup de toutes les bases de données

mysqldump -u scoqi -pscoqi -A > c:\scoqi\backup_mysql\backup.sql

Le fichier backup.sql regroupera alors toutes les bases de données du serveur MySQL pour
l'identifiant de connexion saisi.

Page 111
SCOQI

Backup incrémental sous Windows


Le script ci-dessous permet de réaliser un backup de la base de données QCONFORM. Le nom du
fichier de sortie contient la date ce qui permet d'historiser les sauvegardes.

set nom_fichier=backup%DATE%.sql
set nom_fichier=%nom_fichier:/=%
mysqldump -u scoqi -pscoqi QCONFORM> c:\scoqi\backup_mysql\%nom_fichier%

Pour la suppression des fichiers au delà d'un nombre de jours, se reporter à cette rubrique

Page 112
SCOQI

Changement de version de PHP

Cette page propose un mode opératoire pour le changement de votre version de PHP sur un
environnement d'exploitation.

Une interruption de service de quelques minutes est à prévoir.

Environnement IIS (Internet Information Service)


Suivez les différentes étapes décrites ci-dessous pour changer de version PHP :

1°) Validation du contexte

Les versions de PHP récentes fonctionnent sous IIS en mode FastCGI. Aussi, il est nécessaire de
s'assurer que le rôle CGI est bien installé sous IIS sinon il est nécessaire de procéder à son
installation. Selon votre version d'IIS, suivez le mode opératoire décrit sur les pages suivantes :
Windows 2008 - IIS7 / Windows 2012 (et ultérieurs) - IIS8.

2°) Installation du package PHP

Sous IIS, PHP fonctionne en mode Non Thread Safe (NTS). Vous trouverez sur ce lien une
version 7.3.13 de PHP configurée. Téléchargez le fichier "php-7.3.13-nts-VC15-x64.zip" et
décompressez dans la racine de votre disque C.

3°) Substitution des versions PHP

Assurez-vous de ne pas avoir de fichier PHP.INI dans le répertoire C:\WINDOWS. Si c'est le cas,
supprimez le ou déplacez le. Vérifiez également que l'ancien répertoire PHP ne soit pas
référencé dans le PATH de Windows. Si c'est le cas, supprimez cette référence.

4°) Configuration d'IIS

Il ne vous reste plus qu'à configurer le PHP en mode FastCGI dans IIS. Selon votre version de
Windows / IIS, référrez-vous aux pages suivantes (Mode CGI) : Windows 2008 - IIS7 / Windows
2012 (et ultérieurs) - IIS8.

Page 113
SCOQI

Environnement APACHE

1°) Installation du package PHP

Sous Apache, PHP fonctionne en mode Thread Safe (TS). Vous trouverez sur ce lien une version
7.3.13 de PHP configurée. Téléchargez le fichier "php-7.3.13-VC15-x64.zip" et décompressez le
dans la racine de votre disque C.

2°) Substitution des versions PHP

Assurez-vous de ne pas avoir de fichier PHP.INI dans le répertoire C:\WINDOWS. Si c'est le cas,
supprimez le ou déplacez le. Vérifiez également que le'ancien répertoire PHP ne soit pas
référencé dans le PATH de Windows. Si c'est le cas, supprimez cette référence.

3°) Modification du fichier de configuration d'Apache : httpd.conf (version


2.4)

Le fichier de configuration d'Apache HTTPD.CONF se trouve dans la configuration Apache


fournie en téléchargement sur ce site dans le répertoire : C:\Apache2.4.39Win64\conf

Ouvrez ce fichier avec le bloc note puis changez le chemin d'accès au fichier
"php5apapche2.4.dll" comme montré dans la copie d'écran ci-dessous.

Redémarrez ensuite le service Apache pour la prise en compte de ces modifications.

CHANGEMENT DES FICHIERS DE CONFIG DES


APPLICATIONS QALITEL / Epistolaire (Pour IIS et Apache)
Selon la version de PHP que vous remplacez, ce paramétrage est peut être déjà présent dans le
fichier de connexion utilisé par les applications QALITEL / Epistolaire.

Pour chacune de vos applications, accédez au répertoire .../CONFIG. Vous y trouverez le fichier
CONFIG.PHP. Ouvrez le avec un éditeur de texte et ajoutez la ligne suivante :

$cfg_versionSQL="2";

Vous aurez alors un fichier CONFIG.PHP similaire à celui présenté ci-dessous (les valeurs des
variables vous étant bien entendu spécifiques) :

Page 114
SCOQI
<?php

// Type de serveur SQL, les choix possibles sont : mssql, mysql ou oracle
$cfg_typeSQL="mysql";
// Nom du serveur SQL
$cfg_serveurSQL="localhost";
// Nom de la database SQL
$cfg_databaseSQL="xxxxxx";
// Login de connexion SQL
$cfg_loginSQL="yyyy";
// mot de passe de connexion SQL
$cfg_passeSQL="zzzzz";

// version du driver php


$cfg_versionSQL="2";

?>

A l'issue de ces manipulations, vos applications sont fonctionnelles sous une nouvelle version de
PHP.

Page 115
SCOQI

Changement de package SCOQI (WAMP)

Ce mode opératoire s'applique aussi bien aux changements de versions des packages
SCOQI que du passage d'une version de WAMP au package SCOQI
(Le mode opératoire décrit ci-dessous s'applique également dans le cas où vous disposeriez
d'installations autonomes d'Apache - MySQL - PHP - et que vous souhaiteriez remettre
l'ensemble à jour. Il vous faudra alors adapter les chemins proposés à ceux de votre
installation)

Dans le cas où vous disposez d'un package SCOQI préconfiguré ou d'un environnement WAMP et
que vous souhaitez faire évoluer votre système (Version de PHP, d'Apache ou de MySQL), suivez ce
mode opératoire.

Nous allons décrire le processus pour migrer votre environnement actuel (SCOQI_FULLWEB ou
WAMP) vers la dernière version du package SCOQI_FULLWEB.

Ce mode opératoire sera composé des étapes suivantes :

1. Sauvegarde des bases de données


2. Arrêt des services SCOQI_FULLWEB - WAMP
3. Installation du package SCOQI
4. Restauration des bases de données
5. Copie des répertoires
6. Changement des paramètres dans les applications QALITEL

Sauvegarde des bases de données


Pour effectuer la sauvegarde des bases de données, nous allons ouvrir une invite de commande pour
accéder au terminal Windows. Pour cela faites un clic droit sur le bouton Windows de votre barre
des tâches.

Sélectionnez ensuite le menu "Exécuter" :

Page 116
SCOQI

Dans le champ de saisie, tapez : "cmd" puis cliquer sur le bouton "OK".

Il est nécessaire de se placer dans le répertoire BIN de MySQL pour utiliser ensuite l'application de
sauvegarde MYSQLDUMP

Pour le package SCOQI_FULLWEB

Tapez alors la commande suivante puis validez par la touche "Entrée" :

cd C:\scoqi_fullweb-PHP5.6.32\mysql-5.6.32-win32\bin

(Le chemin est à adapter bien entendu en fonction de votre package SCOQI)

Pour WAMP

Tapez alors la commande suivante puis validez par la touche "Entrée" :

cd C:\wamp64\bin\mysql\mysql5.7.19\bin

(Ce chemin est à adpater bien entendu en fonction de votre version de WAMP)

Réalisation des sauvegardes

La sauvegarde des bases de données se fait par la commande suivante (L'utilisateur MySQL et le
mode passe sont à adapter) :

mysqldump -u scoqi -p qdoc > c:\temp\qdoc.sql

Il sera nécessaire d'effectuer une sauvegarde pour chaque base de données (chaque application). Le
nom de le base de données est bien entendu là aussi à adapter.

(La base de données du GAE est inclue dans la base de données du logiciel correspondant. Il n'est
donc pas nécessaire d'effectuer une sauvegarde spécifique pour le GAE)

Pour information : Vous pouvez trouver ces informations (Nom de vos bases de données, utilisateur

Page 117
SCOQI
et mot de passe MySQL) dans le fichier CONFIG.PHP se trouvant dans le répertoire de chacune de
vos applications : C:\SCOQI_FULLWEB\WWW\QDOC\CONFIG\CONFIG.PHP

Arrêt des services Package SCOQI - WAMP


Une fois les sauvegardes des bases de données effectuées, nous allons arrêter les services Apache et
MySQL.

Pour accéder à la liste des services, comme précédemment, faites un clic droit sur le bouton
Windows et sélectionnez le menu "Exécuter".

Cette fois sur le champ de saisie, tapez "services.msc" puis cliquez sur le bouton "OK".

Pour le package SCOQI_FULLWEB

Dans la liste des services, descendez jusqu'à trouver les services scoqi.

Pour le package SCOQI, un fichier .BAT vous permet de désinstaller les 2 services.

Accédez au répertoire C:\scoqi_fullweb\scripts\ puis faites un clic droit "Exécuter en tant


qu'Administrateur" sur le fichier "services_supp_scoqi.bat".

Pour WAMP

Dans la liste des services, descendez jusqu'à trouver les services WAMP.

Page 118
SCOQI

Il y a 2 services à arrêter. Le service relatif au serveur Web (Apache) et le service relatif à MySQL
qui sont actuellement "En cours". Pour cela, double-cliquez sur l'un des services pour accéder à
l'écran de paramétrage.

Dans la liste déroulante "Type de démarrage", sélectionné "Désactivé" puis cliquez sur le bouton
"Arrêter".Enfin validez vos choix avec le bouton "OK".

Effectuez ensuite les mêmes opérations pour le second service.

(Il peut être nécessaire de forcer le rafraîchissement de la liste des services soit par la touche F5
soit en fermant puis en réouvrant cet écran.)

Installation du package SCOQI


Le mode opératoire d'installation de ce package est décrit sur cette page de la F.A.Q.

Information : Arrêtez vous au point N°3. Il n'est pas nécessaire de faire le point N°4 qui concerne

Page 119
SCOQI
l'installation des applications car nous allons dans les points suivants restaurer les applications
existantes.

Restauration des bases de données


Dans le point précédent, les services liés au serveur Web Apache et à la base de données MySQL ont
été démarrés. Aussi, nous allons pouvoir restaurer les bases de données sauvegardées
précédemment.

Pour cela, faites un clic droit sur le bouton Windows et sélectionnez le menu "Exécuter". Tapez
ensuite "cmd" dans le champ de saisie pour accéder à l'invite de commande.

Il nous faut maintenant nous placer dans le répertoire de MySQL contenant le programme de
restauration des sauvegardes.

Tapez alors la commande suivante :

cd C:\scoqi_fullweb\mysql-5.7.26\bin

Puis tapez la commande suivante pour restaurer la base de données :

mysql -u scoqi -p qdoc < c:\temp\qdoc.sql

Effectuez la restauration pour chacune de vos bases de données.

Pour information le nom des bases de données dans SCOQI_FULLWEB est rappelé à ce niveau.

Copies des répertoires


Maintenant que les bases de données sont restaurées, nous allons copier les différents répertoires
des applications QALITEL de l'ancienne version du package SCOQI ou du WAMP

Dans le package SCOQI, les applications QALITEL étaient stockées dans


C:\SCOQI_FULLWEB\WWW\.

Dans WAMP, les applications QALITEL étaient stockées dans C:\WAMP\WWW\.

Copiez les répertoires des applications dans C:\SCOQI_FULLWEB\WWW\

Page 120
SCOQI

Changement des paramètres dans les applications QALITEL


Dernière étape, il est nécessaire de valider quelques paramètres.

Nom de la base de données dans le fichier CONFIG.PHP

Pour chacune de vos applications, ouvrez le


fichier C:\SCOQI_FULLWEB\WWW\xxxx\CONFIG\CONFIG.PHP

Si le nom de la base de données (ligne : $cfg_databaseSQL) est différent de celui mentionné pour
SCOQI_FULLWEB, changez le.

Assurez vous également de la présence de la ligne :

$cfg_versionSQL="2";

Si ce n'est pas le cas, ajoutez la.

Préférences dans le logiciel QALITEL

Répertoire de stockage des documents :

Il faut enfin changer le répertoire de stockage des documents paramétré dans les "Préférences".

Le lien de lancement de vos applications sera de la forme :

http://votreserveur/scoqi/qdoc/index.php

Lancez maintenant vos applications puis accédez au menu "Outils - Préférences" puis à l'onglet
"Documents".

Vous disposez à ce niveau d'un chemin correspondant à l'ancienne structure du package SCOQI ou

Page 121
SCOQI
de WAMP.

Changez le par : C:\SCOQI_FULLWEB\WWW\-----

Redémarrez l'application pour la prise en compte des modifications.

Lien de lancement du G.A.E.

Pour ceux disposant du module complémentaire d'envoi des EMails (G.A.E. : Générateur
Automatique d'EMails), il peut être nécessaire de redéfinir l'URL de lancement du G.A.E. au niveau
des "Préférences".

Page 122
SCOQI

Installation d'OnlyOffice

Pour l'intégration à QALITEL, il est possible d'installer la version gratuite d'OnlyOffice Docs
Community Edition.

Cette version est téléchargeable à partir du site de l'éditeur (OnlyOfficeDocs). Au cours cette
présentation, nous utiliserons la version "Community Edition".

Configurations techniques possibles


La suite OnlyOffice peut être installée sur le même serveur que les applications QALITEL ou sur un
serveur différent. Comme cela sera détaillé ultérieurement, au sein de QALITEL il faudra configurer
l'URL de lancement d'OnlyOffice.

Installations préalables
Pour le bon fonctionnement d'OnlyOffice, il est nécessaire d'installer les modules suivants :

Erlang
RabbitMQ
PostgreSQL

Installation d'Erlang
Vous pouvez télécharger la version d'Erlang en cliquant sur ce lien

Une fois téléchargé, exécutez le programme d'installation et suiivez les directives proposées.

Installation de RabbitMQ
Vous pouvez télécharger la version de RabbitMQ en cliquant sur ce lien

Une fois téléchargé, exécutez le programme d'installation et suiivez les directives proposées.

Installation de PostgreSQL
Vous pouvez télécharger la version de PostgreSQL en cliquant sur ce lien

Une fois téléchargé, exécutez le programme d'installation et suiivez les directives proposées.

Page 123
SCOQI
Il vous sera demandé de saisir un mot de passe Super Utilisateur. POur les autres écrans, vous
pouvez laisser les choix proposés par défut qui correspondent à l'utilisation faite par QALITEL

Une fois l'installation terminée, il sera alors nécessaire de créer une base de données qui sera
ensuite utilisée par OnlyOffice. Deux méthodes sont alors possibles.

Création de la base données - Interface graphique

Vous trouverez dans le répertoire "C:\Program Files\PostgreSQL\14\pgAdmin 4\bin" le programme


"pgAdmin4.exe" qui vous permettra de disposer d'une interface graphique selon le même principe
que PHPMyAdmin

Il vous sera demandé de vous connecter en entrant le mot de passe saisi lors de l'intallation pour le
Super Utilisateur.

Nous allons créer dans un premier temps un nouvel identifiant.

Une fois dans l'interface, faites un clic droit sur la branche "Login/Group Roles" puis sélectionnez le
sous-menu "Create - Login/Group Roles" comme montré ci-dessous.

Vous accédez ci-dessous où vous pourrez spécifier le nom de l'utilisateur dans le champ "Name".

Cliquez ensuite sur l'onglet "Definition" pour y saisir le mot de passe de votre utilisateur

Page 124
SCOQI

Enfin accédez à l'onglet "Privileges". Cochez la case "Can login ?" puis cliquez sur le bouton "Save"
pour enregistrer votre paramétrage.

Dans l'interface, faites un clic droit sur la branche "Databases" puis sélectionnez le sous-menu
"Create - Database".

Page 125
SCOQI
Dans la fenêtre proposée, entrez le nom de la database ("scoqioffice" dans notre exemple) puis
sélectionnez dans la liste déroulante "Owner" l'utilisateur créé précédemment et validez votre saisie
avec le bouton "Save".

Création de la base données - Ligne de commande

Ouvrez une session "Command Prompt" et placez vous dans le répertoire "C:\Program
Files\PostgreSQL\14\bin"

Entrez ensuite consécutivement les différentes commandes présentées ci-dessous :

cd C:\Program Files\PostgreSQL\14\bin

psql -U postgres -c "CREATE DATABASE scoqioffice;"

psql -U postgres -c "CREATE USER scoqioffice WITH password 'scoqioffice';"

psql -U postgres -c "GRANT ALL privileges ON DATABASE scoqioffice TO scoqioffice;"

Page 126
SCOQI

Installation d'OnlyOffice DocumentServer

Préambule : Le port 80 qui est normalement le port d'écoute par défaut d'OnlyOffice sera dans
notre cas occupé par le serveur Web pour l'exécution de l'application QALITEL. Aussi, nous allons
devoir changer le port d'écoute d'OnlyOffice pour le faire écouter le port 8080. (Vous êtes bien
entendu libre d'utiliser le port de votre choix)

Le paramétrage du port d'écoute peut se faire soit au lancement du programme d'installation soit
ultérieurement. Les 2 méthodes seront montrées.

Changement du port d'écoute au lancement du programme d'installation

Lancez le programme d'installation d'OnlyOffice en passant le paramètre DS_PORT=8080 :

onlyoffice-documentserver-version7.exe /DS_PORT=8080

Déroulement de l'installation

Une fois le programme d'installation téléchargé (onlyoffice-documentserver.exe), double-cliquez sur


le fichier pour démarrer l'installation.

Page 127
SCOQI

Page 128
SCOQI

Page 129
SCOQI

Changement du port d'écoute à l'issue de l'installation

P.S. : A effectuer uniquement si vous n'avez pas lancé le programme d'installation avec le paramètre
DS_PORT

Le paramétrage du port se faire dans le fichier "\Program


Files\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf"

Vous trouverez les lignes suivants dans ce fichier :

include includes/http-common.conf;
server {
listen 0.0.0.0:80;
listen [::]:80 default_server;
server_tokens off;

include includes/ds-*.conf;
}

Changez les 2 lignes où figure le port 80 en spécifiant 8080 :

include includes/http-common.conf;
server {
listen 0.0.0.0:8080;
listen [::]:8080 default_server;

Page 130
SCOQI
server_tokens off;

include includes/ds-*.conf;
}

Redémarrez ensuite le service "ONLYOFFICE DocumentServer Proxy" pour la prise en compte de


vos modifications :

Tester ensuite la prise en compte du paramétrage en lançant OnlyOffice sur le port 8080
(http://localhost:8080 si vous êtes en local sur le serveur sinon http://nom-serveur:8080) :

Configuration de QALITEL
Une fois OnlyOffice installé, il est nécessaire de le configurer au sein de QALITEL. Pour cela,
accédez aux "Préférences Globales" (menu "Configuration") puis à la rubrique "Configuration du
logiciel".

Sur la ligne "Lien d'accès à SCOQI Office online", indiquez le chemin d'accès à OnlyOffice sans
oublier de mentionner le port.

Page 131
SCOQI

Cas particulier d'un accès externe de QALITEL

Dans la copie d'écran précédente, seul le lien de l'application sur le réseau Intranet est configuré.
Cela implique don un usage de QALITEL uniquement sur le réseau local.

Dans le cas où QALITEL peut être accessible également de l'extérieur, il est alors nécessaire de
renseigner également le champ "Lien de l'application sur le réseau externe (Internet)". Dans ca cas,
iol faut sur la ligne "Liend 'accès à SCOQI Office online" mentionner également l'accès extérieur à
OnlyOffice. Vous auriez alors un paramétrage de ce type :

Erreurs - Fichiers de Log


En cas de dysfonctionnement, vous trouverez les fichiers de Logs suivants qui pourront vous
apporter des éléments de réponse :

Pour OnlyOffice : Les logs sont stockés dans le répertoire \ONLYOFFICE\DocumentServer\Log\


Pour QALITEL : /app/log/

Page 132
SCOQI

Environnement OCR - Elasticsearch

Pour le fonctionnement de l'OCR et de la recherche plein texte au sein de QALITEL, il sera


nécessaire d'installer les modules suivants :

Poppler (PDFtoText et PDFtoImages)


Tesseract
Elasticsearch

Installation des différents modules

Installation de Poppler

Vous pouvez télécharger la version de Poppler à partir de ce lien

C'est un fichier ZIP que vous pouvez décompresser sur votre disque dur

Installation de Tesseract

Vous pouvez télécharger la version de Tesseract à partir de ce lien

Exécutez le programme d'installation téléchargé et suivez les directives ci-dessous :

Page 133
SCOQI

Passez ensutie les différents écrans. Une fois sur la fenêtre présentant les composants, ouvrez la
branche "Additional language data (optional)"

Sélectionnez alors les langues dont vous souhaitez la prise en charge par le module OCR

Page 134
SCOQI

Installation d'ElasticSearch

Vous pouvez télécharger la version d'Elasticsearch à partir de ce lien

Décompressez le fichier téléchargé sur votre disque dur.

Elasticsearch nécessite OpenJDK. Une version est inclue par défaut dans le ZIP d'Elasticsearch

Si vous ne disposez d'OpenJDK, vous devez alors configurer la variable d'environnement


ES_JAVA_HOME.

Accédez à la fenêtre des Propriétés système pour configurer la variable :

Page 135
SCOQI

Accédez à l'éran de paramétrage pour configurer la variable ES_JAVA_HOME en la faisant pointer


sur le répertoire /JDK contenu dans la structure de répertoires d'Elasticsearch (Soit
C:\elasticsearch-7.16.3\jdk dans notre exemple)

Page 136
SCOQI

Pour démarrer Elasticsearch, ouvrez une fenêtre command prompt , placez vous dans le répertoire
d'Elasticsearch puis lancez la commande ".\bin\elasticsearch.bat"

Pour tester le bon fonctionnement, ouvrez votre navigateur puis entrez : http://localhost:9200

(Le localhost peut bien entendu être remplacé par le nom de votre serveur. Elasticsearch
communique par défaut sur le port 9200)

Page 137
SCOQI

Installation d'Elasticsearch comme service Windows

Une fois validé le bon fonctinnement d'Elasticsearch, il est alors nécessaire de l'installer c omme
service pour qu'il soit démarré automatiquement en cas de redémarrage du serveur.

Pour cela, on utilisera le script "elasticsearch-service.bat" présent dans le répertoire /bin


d'Elasticsearch. Dans un command prompt, exécutez le script en spécifiant la commande "install"

P.S. : Si vous souhaitez supprimer le service, utilisez le même script en passant la commande
"remove" à la place de la commande "install"

Accédez ensuite à la liste des services. Vous y trouverez votre servvice Elasticsearch :

Page 138
SCOQI
Pour le configurer en démarrage automatique, faites un clic droit "Propriétés" sur la liste
"Elasticsearch". Sélectionnez "Automatique" dans la liste de choix "Type de démarrage" puis cliquez
sur le bouton "Démarrer" pour démarrer le service

Paramétrage de QALITEL
Le paramétrage des modules OCR - Recherche plein texte au sein de QALITEL se fait dans les
"Préférences Globales" au niveau du groupe "Archivage numérique".

Page 139
SCOQI

Page 140
SCOQI

Serveur FTP

Pour la réception de documents envoyés via le protocole FTP sur le serveur QALITEL, il est
nécessaire d'installer un serveur FTP.

Nous présenterons ici la mise en place de 2 serveurs FTP :

Filezilla FTP Server


IIS FTP Server

Filezilla FTP Server


Dans cette partie nous détaillerons l'installation du serveur FTP "FileZilla Server" que vous pouvez
télécharger en cliquant sur l'un des liens suivants : Fichier . exe ou Fichier .ZIP

Exécutez le programme d'installation et suivez les directives. A l'issue de l'installation, vous


trouverez les raccourcis ci-dessous dans votre menu Windows :

Utilisez le raccourci "Start FileZilla Server" pour monter le service. Vous retrouverez le service dans
votre console des services où vous pourrez définir le démarrage en Automatique si vous le souhaitez.

Ensuite il nous faut configurer FileZilla.

Pour cela utilisez le raccourci "Administrer FileZilla Server". Une fois entré dans la console
d'administration, accédez au menu "Server - Configure" :

Page 141
SCOQI

Pour un paramétrage rapide, il est nécessaire de configurer un utilisateur avec un répertoire de


destination.

Dans l'exemple ci-dessus, nous avons défini un utilisateur "jerome" avec un mot de passe.

La partie "Mount points" nous permet de déinifir des répertoires virtuels qui seront en
correspondance avec des répertoires physiques de l'application QALITEL afin de pouvoir regrouper
les fichiers scannés selon leur type. Cette répertition n'est évidemment pas obligatoire mais peut
être aventageusement utilisée pour une meilleure automatisation de l'indexation dans QALITEL.

IIS FTP Server


IIS (Internet Information Service) fournit un serveur FTP dont nous allons détailler l'installation.

Si cette fonctionnalité n'a pas été installée lors de l'installation d'IIS, retournez dans l'écran de
paramtrage des fonctionnalités Windows pour y ajouter la fonctionnalité "Serveur FTP"

Page 142
SCOQI

Une fois l'installation terminée, accédez à la console de paramétrage d'IIS ( "Démarrer - Excécuter"
puis tapez "inetmgr").

Pour créer un nouveau site FTP, faites un clic droit "Ajouter un site FTP" :

Indiquez dans l'écran suivant le nom de votre site FTP ainsi que le répertoire racine. Vous pourrez
ensuite si besoin définir des répertoires virtuels pour un adressage direct.

Page 143
SCOQI

Une fois les informations saisies, cliquez sur le bouton "Suivant". Dans ce paramétrage simple, on
optera pour "Toutes nopn attribuées" au niveau de la sélection d'adresse IP.

Pour le port on laissera la valeur par défaut 21. Enfin à ne fera pas de chiffrage SSL dans cet
exemple.

Page 144
SCOQI

Après avoir cliqué sur le bouton "Suivant", on accède au dernier écran de paramétrage.

Sur cet écran on pour choisir une authentification anonyme ou une authentification de base
(préférable) si vous disposez d'un compte Windows pouvant être configuré sur les scanners pour
l'accès FTP

Enfin, selon le type d'authentification, vous pourrez opter pour autoriser "Tous les utilisateurs" ou
seulement certains

Page 145
SCOQI

Vous retrouverez tous les paramétrages réalisés et bien d'autres encore dans la console
d'administration "Gestionnaire des services Internet (IIS)".

Paramétrage au niveau de votre scanner


Le paramétrage au niveau de votre scanner FTP sera par exemple pour un copieur Brother
MFC-9970-CDW :

Page 146
SCOQI

Page 147
SCOQI

WebDav - Apache

Cette page détaille la configuraiton d'un serveur WebDav sous Apache.

Création de l'utilisateur WebDav


Ouvrez une fenêtre Prompt Command et placez vous dans le répertoire Bin d'Apache.

Entrez la commande suivante pour créer un compte "webdav" qui sera placé dans le fichier
user.passwd :

htpasswd.exe -c "C:\Apache2.4.39Win64\user.passwd" webdav

Modification du fichier httpd.conf


Paramétrage des modules WebDav

Dans un premier temps il convient d'activer les modules nécessaires au fonctionnement de WebDav.
Vérifiez sur votre configuration que les modules ci-dessous sont bien activés sinon supprimer le
signe # en début de ligne.

LoadModule dav_module modules/mod_dav.so


LoadModule dav_fs_module modules/mod_dav_fs.so

Il convient de placer disposant de droits suffisants car ce fichier devra être lu par l'utilisateur
WebDav. Ajoutez les lignes ci-dessous (en adaptant le répertoire) à la fin du fichier httpd.conf

<IfModule mod_dav_fs.c>

Page 148
SCOQI
DAVLockDB c:/scoqi_fullweb/webdav/lockdb
</IfModule>

Paramétrage de l'alias WebDav :

alias /webdav "c:/scoqi_fullweb/www/qdoc/app/mes_donnees/archivage_numerique

<Directory "c:/scoqi_fullweb/www/qdoc/app/mes_donnees/archivage_numerique">

Options Indexes
AllowOverride AuthConfig
DAV On
Options None
AuthType Basic
AuthName WebDAV
AuthUserFile "C:\Apache2.4.39Win64\user.passwd"
<RequireAny>
Require method GET POST OPTIONS
Require valid-user
</RequireAny>

</Directory>

Page 149
SCOQI

Page 150

Vous aimerez peut-être aussi