gathering tools...droits d’utilisateur avec pouvoir. ce compte est utilisé pour lancer le service...

81
Calame Software S.A.S Version 2020 Gathering Tools Guide d’installation

Upload: others

Post on 27-Aug-2021

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Calame Software SAS

Version 2020

Gathering Tools Guide drsquoinstallation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

2

Versions

Date Description 05032020

Portage

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

3

Table des matiegraveres 1 Description de la plateforme Gathering Toolsreg 6

11 Rocircles et responsabiliteacutes 7

12 Scheacutema drsquoarchitecture 8

121 Architecture laquo On Premise raquo 8

122 Architecture laquo Cloud raquo 8

13 Description des modules 9

2 Preacute-requis drsquoinstallation 10

21 Poste serveur module GTServer 10

211 Versions requises des serveurs et des clients pour les SGBD 12

212 Droits de lrsquoutilisateur de connexion agrave la base GT 13

213 Droits de lrsquoutilisateur de connexion agrave la base Client 15

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees 16

22 Poste serveur web deacutedieacute module GTWeb 18

23 Poste client deacuteveloppeur modules Design et GTAnswer 19

24 Poste client gestionnaire ou valideur module GTAnswer 20

25 Poste de reacutepondant aux campagnes module GTAnswer 20

3 Proceacutedures drsquoinstallation et de configuration 21

31 Poste serveur module GTServer 21

311 Proceacutedure drsquoinstallation 21

312 Configuration du serveur 22

313 Configuration drsquoune instance 24

314 Installerdeacutemarrer le service drsquoune instance 37

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019 38

32 Poste serveur web deacutedieacute module GTWeb 39

321 Installation des scripts GTWeb dans un serveur Web 39

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer) 44

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design 45

331 Installation de GTAnswer et Design 45

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance 46

4 Deacuteploiement de GTAnswer 48

41 Geacuteneacuteraliteacutes 48

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

4

42 GTAnswer modes drsquoinstallation et configuration 49

421 Modes drsquoinstallation 49

422 GTAnswer Installation en ligne de commande 50

423 Droits neacutecessaires lors de lrsquoinstallation 50

424 GTAnswer Installation et configuration en ligne de commande 51

43 Reacuteponse Answer par mail vs Reacuteponse http 53

5 Maintenance 53

51 Journaux drsquoexeacutecution description et preacuteconisations 53

52 Flux reacuteseau Seacutecuriteacute 54

521 Matrices des flux reacuteseaux 54

522 Seacutecurisation des flux 57

523 Authentification agrave partir du module GTAnswer 59

524 Rappels seacutecurisation de GTWeb 63

525 Restriction drsquoaccegraves au questionnaire 64

53 Surveillance 64

531 Service GTServer 64

532 Service du serveur Web heacutebergeant GTWeb 65

54 Sauvegardes 65

541 Sauvegarde des objets GTServer 65

542 Sauvegarde de la base de donneacutees GTServer et de la base client 66

55 Gestion des changements 66

551 Ajouter un utilisateur 66

552 Modifier les droits de lrsquoutilisateur 66

553 Changer le mot de passe drsquoun utilisateur 67

554 Modifier la configuration drsquoune instance 67

555 Modifier la cleacute de licence de GTServer et affecter les instances 67

556 Supprimer une instance 68

557 Ajouter une instance 68

56 Gestion des incidents 68

561 Geacuteneacuteraliteacutes 68

562 Impossible de deacutemarrer le service GTServer 69

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling 69

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

5

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer 69

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web) 74

566 Si des reacuteponses tombent en Failed lors drsquoun polling 74

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client 74

568 Si GTAnswer ne peut se connecter agrave GTServer 74

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution) 75

57 Ameacutelioration du fonctionnement 76

571 Arrecirct et redeacutemarrage du service GTServer 76

572 Purge des historiques de la base du serveur 76

573 Suppression des anciennes campagnes 76

574 Nettoyage de la boicircte mail du compte GTServer 76

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux 77

576 Configuration de la machine heacutebergeant GTServer 77

577 Mise agrave jour de la suite Gathering Tools 78

6 Virtualisation 78

7 Reacutesumeacute des preacuterequis techniques 80

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

6

1 Description de la plateforme Gathering Toolsreg

Gathering Toolsreg est une plateforme logicielle permettant drsquoalimenter le systegraveme drsquoinformation de donneacutees preacutealablement collecteacutees sous forme de documents de type classeur Excelreg Gathering Tools effectue cette tacircche en remplaccedilant les dits fichiers bureautiques par des documents proposant une ergonomie et des fonctionnaliteacutes extrecircmement proches des documents drsquoorigine

Les principaux beacuteneacutefices de Gathering Tools sont

bull Lrsquoameacutelioration de la qualiteacute et de la gouvernance des donneacutees bull La diminution des coucircts de deacuteveloppement et de maintenance bull Une faible gestion du changement pour les utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

7

11 Rocircles et responsabiliteacutes

Le tableau ci-apregraves donne la liste des rocircles pouvant ecirctre attribueacutes dans un projet Gathering Tools Chaque rocircle doit disposer drsquoun compte correspondant agrave son peacuterimegravetre

Rocircle Responsabiliteacute Profil-Type Modules GT agrave installer

Administrateur bull Creacuteation et parameacutetrage des instances o Connexion aux bases o Connexion au compte de

messagerie o Connexion au serveur

Web o Certificats de seacutecurisation

des flux bull Creacuteation et gestion des utilisateurs

o AjoutSuppression des utilisateurs

o Strateacutegie de mot de passe

Equipe drsquoinfrastructure correspondant IT

GtServer GtAdmin

Deacuteveloppeur bull Gestion des utilisateurs o Creacuteation et maintien des

groupes drsquoutilisateurs o Creacuteation et maintien des

filtres drsquoaccegraves des gestionnaires aux modegraveles

bull Creacuteation et maintien des modegraveles (formulaires et tableaux de bord)

bull Creacuteation et maintien de la base de donneacutees sous-tendant les transactions au sein drsquoune instance

bull Creacuteation et maintien des actions mises agrave disposition des gestionnaires

Deacuteveloppeur DBA MOA

Design GTAnswer

Gestionnaire bull Exeacutecution des actions creacuteeacutees par les deacuteveloppeurs

bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

bull Modification des messages de la campagne

Responsable fonctionnel drsquoune entiteacute de reporting

GTAnswer

Valideur bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

Supeacuterieur hieacuterarchique des utilisateurs

GTAnswer

Reacutepondant bull Alimentation des formulaires en donneacutees

bull Consultation des tableaux de bord

GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

8

12 Scheacutema drsquoarchitecture

Le scheacutema ci-dessous deacutecrit lrsquoarchitecture technique de Gathering Tools les modules agrave installer pour chaque rocircle ainsi que les modaliteacutes de transactions entre eux

121 Architecture laquo On Premise raquo

122 Architecture laquo Cloud raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 2: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

2

Versions

Date Description 05032020

Portage

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

3

Table des matiegraveres 1 Description de la plateforme Gathering Toolsreg 6

11 Rocircles et responsabiliteacutes 7

12 Scheacutema drsquoarchitecture 8

121 Architecture laquo On Premise raquo 8

122 Architecture laquo Cloud raquo 8

13 Description des modules 9

2 Preacute-requis drsquoinstallation 10

21 Poste serveur module GTServer 10

211 Versions requises des serveurs et des clients pour les SGBD 12

212 Droits de lrsquoutilisateur de connexion agrave la base GT 13

213 Droits de lrsquoutilisateur de connexion agrave la base Client 15

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees 16

22 Poste serveur web deacutedieacute module GTWeb 18

23 Poste client deacuteveloppeur modules Design et GTAnswer 19

24 Poste client gestionnaire ou valideur module GTAnswer 20

25 Poste de reacutepondant aux campagnes module GTAnswer 20

3 Proceacutedures drsquoinstallation et de configuration 21

31 Poste serveur module GTServer 21

311 Proceacutedure drsquoinstallation 21

312 Configuration du serveur 22

313 Configuration drsquoune instance 24

314 Installerdeacutemarrer le service drsquoune instance 37

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019 38

32 Poste serveur web deacutedieacute module GTWeb 39

321 Installation des scripts GTWeb dans un serveur Web 39

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer) 44

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design 45

331 Installation de GTAnswer et Design 45

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance 46

4 Deacuteploiement de GTAnswer 48

41 Geacuteneacuteraliteacutes 48

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

4

42 GTAnswer modes drsquoinstallation et configuration 49

421 Modes drsquoinstallation 49

422 GTAnswer Installation en ligne de commande 50

423 Droits neacutecessaires lors de lrsquoinstallation 50

424 GTAnswer Installation et configuration en ligne de commande 51

43 Reacuteponse Answer par mail vs Reacuteponse http 53

5 Maintenance 53

51 Journaux drsquoexeacutecution description et preacuteconisations 53

52 Flux reacuteseau Seacutecuriteacute 54

521 Matrices des flux reacuteseaux 54

522 Seacutecurisation des flux 57

523 Authentification agrave partir du module GTAnswer 59

524 Rappels seacutecurisation de GTWeb 63

525 Restriction drsquoaccegraves au questionnaire 64

53 Surveillance 64

531 Service GTServer 64

532 Service du serveur Web heacutebergeant GTWeb 65

54 Sauvegardes 65

541 Sauvegarde des objets GTServer 65

542 Sauvegarde de la base de donneacutees GTServer et de la base client 66

55 Gestion des changements 66

551 Ajouter un utilisateur 66

552 Modifier les droits de lrsquoutilisateur 66

553 Changer le mot de passe drsquoun utilisateur 67

554 Modifier la configuration drsquoune instance 67

555 Modifier la cleacute de licence de GTServer et affecter les instances 67

556 Supprimer une instance 68

557 Ajouter une instance 68

56 Gestion des incidents 68

561 Geacuteneacuteraliteacutes 68

562 Impossible de deacutemarrer le service GTServer 69

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling 69

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

5

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer 69

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web) 74

566 Si des reacuteponses tombent en Failed lors drsquoun polling 74

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client 74

568 Si GTAnswer ne peut se connecter agrave GTServer 74

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution) 75

57 Ameacutelioration du fonctionnement 76

571 Arrecirct et redeacutemarrage du service GTServer 76

572 Purge des historiques de la base du serveur 76

573 Suppression des anciennes campagnes 76

574 Nettoyage de la boicircte mail du compte GTServer 76

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux 77

576 Configuration de la machine heacutebergeant GTServer 77

577 Mise agrave jour de la suite Gathering Tools 78

6 Virtualisation 78

7 Reacutesumeacute des preacuterequis techniques 80

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

6

1 Description de la plateforme Gathering Toolsreg

Gathering Toolsreg est une plateforme logicielle permettant drsquoalimenter le systegraveme drsquoinformation de donneacutees preacutealablement collecteacutees sous forme de documents de type classeur Excelreg Gathering Tools effectue cette tacircche en remplaccedilant les dits fichiers bureautiques par des documents proposant une ergonomie et des fonctionnaliteacutes extrecircmement proches des documents drsquoorigine

Les principaux beacuteneacutefices de Gathering Tools sont

bull Lrsquoameacutelioration de la qualiteacute et de la gouvernance des donneacutees bull La diminution des coucircts de deacuteveloppement et de maintenance bull Une faible gestion du changement pour les utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

7

11 Rocircles et responsabiliteacutes

Le tableau ci-apregraves donne la liste des rocircles pouvant ecirctre attribueacutes dans un projet Gathering Tools Chaque rocircle doit disposer drsquoun compte correspondant agrave son peacuterimegravetre

Rocircle Responsabiliteacute Profil-Type Modules GT agrave installer

Administrateur bull Creacuteation et parameacutetrage des instances o Connexion aux bases o Connexion au compte de

messagerie o Connexion au serveur

Web o Certificats de seacutecurisation

des flux bull Creacuteation et gestion des utilisateurs

o AjoutSuppression des utilisateurs

o Strateacutegie de mot de passe

Equipe drsquoinfrastructure correspondant IT

GtServer GtAdmin

Deacuteveloppeur bull Gestion des utilisateurs o Creacuteation et maintien des

groupes drsquoutilisateurs o Creacuteation et maintien des

filtres drsquoaccegraves des gestionnaires aux modegraveles

bull Creacuteation et maintien des modegraveles (formulaires et tableaux de bord)

bull Creacuteation et maintien de la base de donneacutees sous-tendant les transactions au sein drsquoune instance

bull Creacuteation et maintien des actions mises agrave disposition des gestionnaires

Deacuteveloppeur DBA MOA

Design GTAnswer

Gestionnaire bull Exeacutecution des actions creacuteeacutees par les deacuteveloppeurs

bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

bull Modification des messages de la campagne

Responsable fonctionnel drsquoune entiteacute de reporting

GTAnswer

Valideur bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

Supeacuterieur hieacuterarchique des utilisateurs

GTAnswer

Reacutepondant bull Alimentation des formulaires en donneacutees

bull Consultation des tableaux de bord

GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

8

12 Scheacutema drsquoarchitecture

Le scheacutema ci-dessous deacutecrit lrsquoarchitecture technique de Gathering Tools les modules agrave installer pour chaque rocircle ainsi que les modaliteacutes de transactions entre eux

121 Architecture laquo On Premise raquo

122 Architecture laquo Cloud raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 3: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

3

Table des matiegraveres 1 Description de la plateforme Gathering Toolsreg 6

11 Rocircles et responsabiliteacutes 7

12 Scheacutema drsquoarchitecture 8

121 Architecture laquo On Premise raquo 8

122 Architecture laquo Cloud raquo 8

13 Description des modules 9

2 Preacute-requis drsquoinstallation 10

21 Poste serveur module GTServer 10

211 Versions requises des serveurs et des clients pour les SGBD 12

212 Droits de lrsquoutilisateur de connexion agrave la base GT 13

213 Droits de lrsquoutilisateur de connexion agrave la base Client 15

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees 16

22 Poste serveur web deacutedieacute module GTWeb 18

23 Poste client deacuteveloppeur modules Design et GTAnswer 19

24 Poste client gestionnaire ou valideur module GTAnswer 20

25 Poste de reacutepondant aux campagnes module GTAnswer 20

3 Proceacutedures drsquoinstallation et de configuration 21

31 Poste serveur module GTServer 21

311 Proceacutedure drsquoinstallation 21

312 Configuration du serveur 22

313 Configuration drsquoune instance 24

314 Installerdeacutemarrer le service drsquoune instance 37

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019 38

32 Poste serveur web deacutedieacute module GTWeb 39

321 Installation des scripts GTWeb dans un serveur Web 39

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer) 44

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design 45

331 Installation de GTAnswer et Design 45

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance 46

4 Deacuteploiement de GTAnswer 48

41 Geacuteneacuteraliteacutes 48

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

4

42 GTAnswer modes drsquoinstallation et configuration 49

421 Modes drsquoinstallation 49

422 GTAnswer Installation en ligne de commande 50

423 Droits neacutecessaires lors de lrsquoinstallation 50

424 GTAnswer Installation et configuration en ligne de commande 51

43 Reacuteponse Answer par mail vs Reacuteponse http 53

5 Maintenance 53

51 Journaux drsquoexeacutecution description et preacuteconisations 53

52 Flux reacuteseau Seacutecuriteacute 54

521 Matrices des flux reacuteseaux 54

522 Seacutecurisation des flux 57

523 Authentification agrave partir du module GTAnswer 59

524 Rappels seacutecurisation de GTWeb 63

525 Restriction drsquoaccegraves au questionnaire 64

53 Surveillance 64

531 Service GTServer 64

532 Service du serveur Web heacutebergeant GTWeb 65

54 Sauvegardes 65

541 Sauvegarde des objets GTServer 65

542 Sauvegarde de la base de donneacutees GTServer et de la base client 66

55 Gestion des changements 66

551 Ajouter un utilisateur 66

552 Modifier les droits de lrsquoutilisateur 66

553 Changer le mot de passe drsquoun utilisateur 67

554 Modifier la configuration drsquoune instance 67

555 Modifier la cleacute de licence de GTServer et affecter les instances 67

556 Supprimer une instance 68

557 Ajouter une instance 68

56 Gestion des incidents 68

561 Geacuteneacuteraliteacutes 68

562 Impossible de deacutemarrer le service GTServer 69

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling 69

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

5

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer 69

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web) 74

566 Si des reacuteponses tombent en Failed lors drsquoun polling 74

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client 74

568 Si GTAnswer ne peut se connecter agrave GTServer 74

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution) 75

57 Ameacutelioration du fonctionnement 76

571 Arrecirct et redeacutemarrage du service GTServer 76

572 Purge des historiques de la base du serveur 76

573 Suppression des anciennes campagnes 76

574 Nettoyage de la boicircte mail du compte GTServer 76

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux 77

576 Configuration de la machine heacutebergeant GTServer 77

577 Mise agrave jour de la suite Gathering Tools 78

6 Virtualisation 78

7 Reacutesumeacute des preacuterequis techniques 80

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

6

1 Description de la plateforme Gathering Toolsreg

Gathering Toolsreg est une plateforme logicielle permettant drsquoalimenter le systegraveme drsquoinformation de donneacutees preacutealablement collecteacutees sous forme de documents de type classeur Excelreg Gathering Tools effectue cette tacircche en remplaccedilant les dits fichiers bureautiques par des documents proposant une ergonomie et des fonctionnaliteacutes extrecircmement proches des documents drsquoorigine

Les principaux beacuteneacutefices de Gathering Tools sont

bull Lrsquoameacutelioration de la qualiteacute et de la gouvernance des donneacutees bull La diminution des coucircts de deacuteveloppement et de maintenance bull Une faible gestion du changement pour les utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

7

11 Rocircles et responsabiliteacutes

Le tableau ci-apregraves donne la liste des rocircles pouvant ecirctre attribueacutes dans un projet Gathering Tools Chaque rocircle doit disposer drsquoun compte correspondant agrave son peacuterimegravetre

Rocircle Responsabiliteacute Profil-Type Modules GT agrave installer

Administrateur bull Creacuteation et parameacutetrage des instances o Connexion aux bases o Connexion au compte de

messagerie o Connexion au serveur

Web o Certificats de seacutecurisation

des flux bull Creacuteation et gestion des utilisateurs

o AjoutSuppression des utilisateurs

o Strateacutegie de mot de passe

Equipe drsquoinfrastructure correspondant IT

GtServer GtAdmin

Deacuteveloppeur bull Gestion des utilisateurs o Creacuteation et maintien des

groupes drsquoutilisateurs o Creacuteation et maintien des

filtres drsquoaccegraves des gestionnaires aux modegraveles

bull Creacuteation et maintien des modegraveles (formulaires et tableaux de bord)

bull Creacuteation et maintien de la base de donneacutees sous-tendant les transactions au sein drsquoune instance

bull Creacuteation et maintien des actions mises agrave disposition des gestionnaires

Deacuteveloppeur DBA MOA

Design GTAnswer

Gestionnaire bull Exeacutecution des actions creacuteeacutees par les deacuteveloppeurs

bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

bull Modification des messages de la campagne

Responsable fonctionnel drsquoune entiteacute de reporting

GTAnswer

Valideur bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

Supeacuterieur hieacuterarchique des utilisateurs

GTAnswer

Reacutepondant bull Alimentation des formulaires en donneacutees

bull Consultation des tableaux de bord

GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

8

12 Scheacutema drsquoarchitecture

Le scheacutema ci-dessous deacutecrit lrsquoarchitecture technique de Gathering Tools les modules agrave installer pour chaque rocircle ainsi que les modaliteacutes de transactions entre eux

121 Architecture laquo On Premise raquo

122 Architecture laquo Cloud raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 4: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

4

42 GTAnswer modes drsquoinstallation et configuration 49

421 Modes drsquoinstallation 49

422 GTAnswer Installation en ligne de commande 50

423 Droits neacutecessaires lors de lrsquoinstallation 50

424 GTAnswer Installation et configuration en ligne de commande 51

43 Reacuteponse Answer par mail vs Reacuteponse http 53

5 Maintenance 53

51 Journaux drsquoexeacutecution description et preacuteconisations 53

52 Flux reacuteseau Seacutecuriteacute 54

521 Matrices des flux reacuteseaux 54

522 Seacutecurisation des flux 57

523 Authentification agrave partir du module GTAnswer 59

524 Rappels seacutecurisation de GTWeb 63

525 Restriction drsquoaccegraves au questionnaire 64

53 Surveillance 64

531 Service GTServer 64

532 Service du serveur Web heacutebergeant GTWeb 65

54 Sauvegardes 65

541 Sauvegarde des objets GTServer 65

542 Sauvegarde de la base de donneacutees GTServer et de la base client 66

55 Gestion des changements 66

551 Ajouter un utilisateur 66

552 Modifier les droits de lrsquoutilisateur 66

553 Changer le mot de passe drsquoun utilisateur 67

554 Modifier la configuration drsquoune instance 67

555 Modifier la cleacute de licence de GTServer et affecter les instances 67

556 Supprimer une instance 68

557 Ajouter une instance 68

56 Gestion des incidents 68

561 Geacuteneacuteraliteacutes 68

562 Impossible de deacutemarrer le service GTServer 69

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling 69

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

5

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer 69

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web) 74

566 Si des reacuteponses tombent en Failed lors drsquoun polling 74

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client 74

568 Si GTAnswer ne peut se connecter agrave GTServer 74

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution) 75

57 Ameacutelioration du fonctionnement 76

571 Arrecirct et redeacutemarrage du service GTServer 76

572 Purge des historiques de la base du serveur 76

573 Suppression des anciennes campagnes 76

574 Nettoyage de la boicircte mail du compte GTServer 76

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux 77

576 Configuration de la machine heacutebergeant GTServer 77

577 Mise agrave jour de la suite Gathering Tools 78

6 Virtualisation 78

7 Reacutesumeacute des preacuterequis techniques 80

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

6

1 Description de la plateforme Gathering Toolsreg

Gathering Toolsreg est une plateforme logicielle permettant drsquoalimenter le systegraveme drsquoinformation de donneacutees preacutealablement collecteacutees sous forme de documents de type classeur Excelreg Gathering Tools effectue cette tacircche en remplaccedilant les dits fichiers bureautiques par des documents proposant une ergonomie et des fonctionnaliteacutes extrecircmement proches des documents drsquoorigine

Les principaux beacuteneacutefices de Gathering Tools sont

bull Lrsquoameacutelioration de la qualiteacute et de la gouvernance des donneacutees bull La diminution des coucircts de deacuteveloppement et de maintenance bull Une faible gestion du changement pour les utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

7

11 Rocircles et responsabiliteacutes

Le tableau ci-apregraves donne la liste des rocircles pouvant ecirctre attribueacutes dans un projet Gathering Tools Chaque rocircle doit disposer drsquoun compte correspondant agrave son peacuterimegravetre

Rocircle Responsabiliteacute Profil-Type Modules GT agrave installer

Administrateur bull Creacuteation et parameacutetrage des instances o Connexion aux bases o Connexion au compte de

messagerie o Connexion au serveur

Web o Certificats de seacutecurisation

des flux bull Creacuteation et gestion des utilisateurs

o AjoutSuppression des utilisateurs

o Strateacutegie de mot de passe

Equipe drsquoinfrastructure correspondant IT

GtServer GtAdmin

Deacuteveloppeur bull Gestion des utilisateurs o Creacuteation et maintien des

groupes drsquoutilisateurs o Creacuteation et maintien des

filtres drsquoaccegraves des gestionnaires aux modegraveles

bull Creacuteation et maintien des modegraveles (formulaires et tableaux de bord)

bull Creacuteation et maintien de la base de donneacutees sous-tendant les transactions au sein drsquoune instance

bull Creacuteation et maintien des actions mises agrave disposition des gestionnaires

Deacuteveloppeur DBA MOA

Design GTAnswer

Gestionnaire bull Exeacutecution des actions creacuteeacutees par les deacuteveloppeurs

bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

bull Modification des messages de la campagne

Responsable fonctionnel drsquoune entiteacute de reporting

GTAnswer

Valideur bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

Supeacuterieur hieacuterarchique des utilisateurs

GTAnswer

Reacutepondant bull Alimentation des formulaires en donneacutees

bull Consultation des tableaux de bord

GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

8

12 Scheacutema drsquoarchitecture

Le scheacutema ci-dessous deacutecrit lrsquoarchitecture technique de Gathering Tools les modules agrave installer pour chaque rocircle ainsi que les modaliteacutes de transactions entre eux

121 Architecture laquo On Premise raquo

122 Architecture laquo Cloud raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 5: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

5

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer 69

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web) 74

566 Si des reacuteponses tombent en Failed lors drsquoun polling 74

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client 74

568 Si GTAnswer ne peut se connecter agrave GTServer 74

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution) 75

57 Ameacutelioration du fonctionnement 76

571 Arrecirct et redeacutemarrage du service GTServer 76

572 Purge des historiques de la base du serveur 76

573 Suppression des anciennes campagnes 76

574 Nettoyage de la boicircte mail du compte GTServer 76

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux 77

576 Configuration de la machine heacutebergeant GTServer 77

577 Mise agrave jour de la suite Gathering Tools 78

6 Virtualisation 78

7 Reacutesumeacute des preacuterequis techniques 80

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

6

1 Description de la plateforme Gathering Toolsreg

Gathering Toolsreg est une plateforme logicielle permettant drsquoalimenter le systegraveme drsquoinformation de donneacutees preacutealablement collecteacutees sous forme de documents de type classeur Excelreg Gathering Tools effectue cette tacircche en remplaccedilant les dits fichiers bureautiques par des documents proposant une ergonomie et des fonctionnaliteacutes extrecircmement proches des documents drsquoorigine

Les principaux beacuteneacutefices de Gathering Tools sont

bull Lrsquoameacutelioration de la qualiteacute et de la gouvernance des donneacutees bull La diminution des coucircts de deacuteveloppement et de maintenance bull Une faible gestion du changement pour les utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

7

11 Rocircles et responsabiliteacutes

Le tableau ci-apregraves donne la liste des rocircles pouvant ecirctre attribueacutes dans un projet Gathering Tools Chaque rocircle doit disposer drsquoun compte correspondant agrave son peacuterimegravetre

Rocircle Responsabiliteacute Profil-Type Modules GT agrave installer

Administrateur bull Creacuteation et parameacutetrage des instances o Connexion aux bases o Connexion au compte de

messagerie o Connexion au serveur

Web o Certificats de seacutecurisation

des flux bull Creacuteation et gestion des utilisateurs

o AjoutSuppression des utilisateurs

o Strateacutegie de mot de passe

Equipe drsquoinfrastructure correspondant IT

GtServer GtAdmin

Deacuteveloppeur bull Gestion des utilisateurs o Creacuteation et maintien des

groupes drsquoutilisateurs o Creacuteation et maintien des

filtres drsquoaccegraves des gestionnaires aux modegraveles

bull Creacuteation et maintien des modegraveles (formulaires et tableaux de bord)

bull Creacuteation et maintien de la base de donneacutees sous-tendant les transactions au sein drsquoune instance

bull Creacuteation et maintien des actions mises agrave disposition des gestionnaires

Deacuteveloppeur DBA MOA

Design GTAnswer

Gestionnaire bull Exeacutecution des actions creacuteeacutees par les deacuteveloppeurs

bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

bull Modification des messages de la campagne

Responsable fonctionnel drsquoune entiteacute de reporting

GTAnswer

Valideur bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

Supeacuterieur hieacuterarchique des utilisateurs

GTAnswer

Reacutepondant bull Alimentation des formulaires en donneacutees

bull Consultation des tableaux de bord

GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

8

12 Scheacutema drsquoarchitecture

Le scheacutema ci-dessous deacutecrit lrsquoarchitecture technique de Gathering Tools les modules agrave installer pour chaque rocircle ainsi que les modaliteacutes de transactions entre eux

121 Architecture laquo On Premise raquo

122 Architecture laquo Cloud raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 6: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

6

1 Description de la plateforme Gathering Toolsreg

Gathering Toolsreg est une plateforme logicielle permettant drsquoalimenter le systegraveme drsquoinformation de donneacutees preacutealablement collecteacutees sous forme de documents de type classeur Excelreg Gathering Tools effectue cette tacircche en remplaccedilant les dits fichiers bureautiques par des documents proposant une ergonomie et des fonctionnaliteacutes extrecircmement proches des documents drsquoorigine

Les principaux beacuteneacutefices de Gathering Tools sont

bull Lrsquoameacutelioration de la qualiteacute et de la gouvernance des donneacutees bull La diminution des coucircts de deacuteveloppement et de maintenance bull Une faible gestion du changement pour les utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

7

11 Rocircles et responsabiliteacutes

Le tableau ci-apregraves donne la liste des rocircles pouvant ecirctre attribueacutes dans un projet Gathering Tools Chaque rocircle doit disposer drsquoun compte correspondant agrave son peacuterimegravetre

Rocircle Responsabiliteacute Profil-Type Modules GT agrave installer

Administrateur bull Creacuteation et parameacutetrage des instances o Connexion aux bases o Connexion au compte de

messagerie o Connexion au serveur

Web o Certificats de seacutecurisation

des flux bull Creacuteation et gestion des utilisateurs

o AjoutSuppression des utilisateurs

o Strateacutegie de mot de passe

Equipe drsquoinfrastructure correspondant IT

GtServer GtAdmin

Deacuteveloppeur bull Gestion des utilisateurs o Creacuteation et maintien des

groupes drsquoutilisateurs o Creacuteation et maintien des

filtres drsquoaccegraves des gestionnaires aux modegraveles

bull Creacuteation et maintien des modegraveles (formulaires et tableaux de bord)

bull Creacuteation et maintien de la base de donneacutees sous-tendant les transactions au sein drsquoune instance

bull Creacuteation et maintien des actions mises agrave disposition des gestionnaires

Deacuteveloppeur DBA MOA

Design GTAnswer

Gestionnaire bull Exeacutecution des actions creacuteeacutees par les deacuteveloppeurs

bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

bull Modification des messages de la campagne

Responsable fonctionnel drsquoune entiteacute de reporting

GTAnswer

Valideur bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

Supeacuterieur hieacuterarchique des utilisateurs

GTAnswer

Reacutepondant bull Alimentation des formulaires en donneacutees

bull Consultation des tableaux de bord

GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

8

12 Scheacutema drsquoarchitecture

Le scheacutema ci-dessous deacutecrit lrsquoarchitecture technique de Gathering Tools les modules agrave installer pour chaque rocircle ainsi que les modaliteacutes de transactions entre eux

121 Architecture laquo On Premise raquo

122 Architecture laquo Cloud raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 7: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

7

11 Rocircles et responsabiliteacutes

Le tableau ci-apregraves donne la liste des rocircles pouvant ecirctre attribueacutes dans un projet Gathering Tools Chaque rocircle doit disposer drsquoun compte correspondant agrave son peacuterimegravetre

Rocircle Responsabiliteacute Profil-Type Modules GT agrave installer

Administrateur bull Creacuteation et parameacutetrage des instances o Connexion aux bases o Connexion au compte de

messagerie o Connexion au serveur

Web o Certificats de seacutecurisation

des flux bull Creacuteation et gestion des utilisateurs

o AjoutSuppression des utilisateurs

o Strateacutegie de mot de passe

Equipe drsquoinfrastructure correspondant IT

GtServer GtAdmin

Deacuteveloppeur bull Gestion des utilisateurs o Creacuteation et maintien des

groupes drsquoutilisateurs o Creacuteation et maintien des

filtres drsquoaccegraves des gestionnaires aux modegraveles

bull Creacuteation et maintien des modegraveles (formulaires et tableaux de bord)

bull Creacuteation et maintien de la base de donneacutees sous-tendant les transactions au sein drsquoune instance

bull Creacuteation et maintien des actions mises agrave disposition des gestionnaires

Deacuteveloppeur DBA MOA

Design GTAnswer

Gestionnaire bull Exeacutecution des actions creacuteeacutees par les deacuteveloppeurs

bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

bull Modification des messages de la campagne

Responsable fonctionnel drsquoune entiteacute de reporting

GTAnswer

Valideur bull Suivi des campagnes bull Validation des reacuteponses bull Gestion de la communication aupregraves

des destinataires (relances versions etc)

Supeacuterieur hieacuterarchique des utilisateurs

GTAnswer

Reacutepondant bull Alimentation des formulaires en donneacutees

bull Consultation des tableaux de bord

GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

8

12 Scheacutema drsquoarchitecture

Le scheacutema ci-dessous deacutecrit lrsquoarchitecture technique de Gathering Tools les modules agrave installer pour chaque rocircle ainsi que les modaliteacutes de transactions entre eux

121 Architecture laquo On Premise raquo

122 Architecture laquo Cloud raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 8: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

8

12 Scheacutema drsquoarchitecture

Le scheacutema ci-dessous deacutecrit lrsquoarchitecture technique de Gathering Tools les modules agrave installer pour chaque rocircle ainsi que les modaliteacutes de transactions entre eux

121 Architecture laquo On Premise raquo

122 Architecture laquo Cloud raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 9: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

9

Note 1 la communication entre GTServer et ses clients (GTAnswer GTWeb Automatisation) utilise un protocole proprieacutetaire au niveau de la couche Application (modegravele Internet Protocol Suite ou modegravele OSI) Le protocole SSLTLS peut ecirctre utiliseacute pour seacutecuriser les communications

Note 2 seuls les verbes GET et POST sont utiliseacutes pour le protocole HTTPHTTPS

13 Description des modules

bull GTAdmin permet agrave lrsquoadministrateur de creacuteer et geacuterer les instances Pour chaque instance il permet de

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base GT (repository qui gegravere le fonctionnement interne de lrsquoapplication) Initialiser la base GT

o Configurer lrsquoaccegraves de lrsquoinstance agrave la Base client (base de donneacutees qui supporte les transactions de donneacutees meacutetier)

o Creacuteer les utilisateurs o Deacutemarrer Arrecircter le service Serveur de lrsquoapplication o Geacuterer la seacutecuriteacute

bull GTServer est le serveur de lrsquoapplication Il permet o Drsquoexeacutecuter toutes les transactions sur la base de donneacutees client o De geacuterer les entreacutees sorties de donneacutees entre la Base GT et les

destinataires (envois de mails collecte des donneacutees transmises par les destinataires creacuteation de tableaux de bord)

o De publier pour le module GTAnswer les statuts des diffeacuterentes campagnes (reacutepondants versions de reacuteponse historique etc)

bull Design permet aux deacuteveloppeurs de creacuteer les formulaires et de mettre agrave jour les formulaires publieacutes sur le serveur

bull GTAnswer permet o Pour les deacuteveloppeurs gestionnaires et valideurs suivant leurs droits

respectifs de Creacuteer les modegraveles (stockage de modegraveles de formulaires et de

tableaux de bord) Creacuteer les actions (lancement de campagne inteacutegration de donneacutees

diffusion de tableaux de bord) Exeacutecuter les actions Consulter les statuts de campagnes (reacuteponses versions historiques

etc) Communiquer aupregraves des destinataires (relances demande de

corrections etc) o Pour les reacutepondants de consulter les tableaux de bord drsquoalimenter les

documents en donneacutees puis de renvoyer ces derniegraveres vers le serveur bull GTWeb est lrsquoapplication Web permettant lrsquoeacutechange synchrone drsquoinformation

(publication synchronisation et reacuteponse via le protocole httphttps)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 10: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

10

2 Preacute-requis drsquoinstallation

21 Poste serveur module GTServer

Modules installeacutes GTServer et GTAdmin via SetupGTServerexe

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull NET Framework 472

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour ce compte soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes)

bull Compte de service Windows avec des droits administrateurs (preacutefeacuterable) ou des droits drsquoutilisateur avec pouvoir Ce compte est utiliseacute pour lancer le service du serveur de GTServer Ce compte peut ecirctre le mecircme que le compte de lrsquoinstallation Il est recommandeacute que la langue de lrsquointerface Windows pour le compte de service soit la mecircme que la langue du systegraveme Windows installeacute (nrsquoest agrave prendre en compte que si des language pack sont installeacutes) Il est eacutegalement recommandeacute de configurer lrsquoinstance avec ce compte Windows (via le module GTAdmin installeacute avec GTServer)

bull Base de donneacutees GT (repository) sur SQL Server Oracle Postgres ou DB2 la base de donneacutees GT ou le scheacutema de base de donneacutees GT est une base de donneacutees proprieacutetaire utiliseacutee uniquement par GTServer Elle devra ecirctre creacuteeacutee vierge avant lrsquoinstallation de GTServer sur le poste serveur

bull Utilisateur et scheacutema de base de donneacutees pour la base GTServer Lrsquoutilisateur et le scheacutema doivent exister au moment de lrsquoinstallation de GTServer Un scheacutema de base de donneacutees est suffisant pour la base GT si le SGBD autorise plusieurs scheacutemas Le scheacutema de la base de donneacutees GT ne doit pas contenir des objets creacuteeacutes autrement que par lrsquoinstallation de GT (via lrsquoinitialisation ou la mise agrave jour avec GTAdmin) Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 212

bull Base de donneacutees Client sur SQL Server Oracle Postgres ou DB2 la base de donneacutees Client ou le scheacutema de base de donneacutees Client contient toutes les donneacutees en entreacutee et sortie des questionnaires ainsi que les filtres utiliseacutes pour les accegraves GTAnswer Cette base doit exister au moment de lrsquoinstallation de GTServer La conception des objets de cette base est laisseacutee agrave la liberteacute du deacuteveloppeur Calame etou du client

bull Utilisateur et scheacutema de base de donneacutees pour la base client Lrsquoutilisateur et le

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 11: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

11

scheacutema doivent exister pour la base client au moment de lrsquoinstallation de GTserver Les droits de lrsquoutilisateur se connectant agrave ce scheacutema de base de donneacutees sont deacutecrits dans le sect 213

bull Pour des raisons de seacutecuriteacute la base GT et la base Client doivent ecirctre des bases distinctes Les utilisateurs de connexions agrave la base GT et agrave la base Client devraient ecirctre des utilisateurs distincts avec des droits distincts (pas drsquoaccegraves agrave la base GT pour lrsquoutilisateur de la base Client et reacuteciproquement) Ceci est drsquoautant plus important dans le cas ougrave la base GT et la base Client sont heacutebergeacutees sur le mecircme serveur de base de donneacutees

bull Une mecircme base GT ne peut ecirctre utiliseacutee par deux instances GT diffeacuterentes qursquoelles soient de la mecircme version ou non

bull SGBD preacute-installeacutes Le(s) SGBD (systegravemes de base de donneacutees heacutebergeant la base GT et la base Client ne sont pas installeacutes par GT Ce ou ces SGBD doivent ecirctre installeacutes en preacutealable agrave lrsquoinstallation de GT Ces SGBD peuvent se trouver sur le mecircme poste que GTServer

bull Clientdriver de base de donneacutees pour la base GTserver et la base Client les clients de base de donneacutees ou drivers de connexion requis pour chaque SGBD sont deacutecrits dans le sect 211

bull Respecter les speacutecificiteacutes requises pour chaque SGBD (cf sect 214)

bull Compte de messagerie deacutedieacute Calame Une connexion POPSMTP ou IMAPSMTP (seacutecuriseacute SSL ou non) vers ce compte est preacutefeacuterable Une connexion SMTP est obligatoire pour lrsquoenvoi de mails Une connexion vers un serveur Exchange (respectivement un serveur Notes) est possible pour la reacuteception des mails dans ce cas un client de messagerie (Outlook ou respectivement Lotus Notes) devra ecirctre installeacute sur le serveur ce client devra ecirctre configureacute et testeacute sous le compte Windows lanccedilant le service

bull Ouverture de connexions vers la messagerie agrave partir du serveur les connexions de lrsquoexeacutecutable GTServerexe vers le serveur de messagerie doivent ecirctre autoriseacutees dans le cas de connexions POPSMTP ou IMAPSMTP

bull Ouverture de ports entrants les modules GTAnswer et GTWeb communiquent avec GTServer en TCPIP au moyen des ports speacutecifieacutes lors de la configuration des instances (port 3000 par deacutefaut pour la premiegravere instance de GTServer) Ces ports doivent ecirctre ouverts sur le serveur pour les connexions entrantes Une autre option est drsquoautoriser les connexions entrantes pour le module GTServerexe (situeacute dans CProgram FilesCalame bin par deacutefaut)

bull Droits de lecture-eacutecriture pour le compte de service sur le reacutepertoire de lrsquoinstance GTServer le reacutepertoire temporaire du profil et les reacutepertoires speacutecifieacutes dans la configuration de lrsquoinstance (cf 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 12: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

12

bull Droits de lecture eacutecriture pour le compte de service sur les reacutepertoires drsquoextraction des piegraveces jointes incluses dans les questionnaires ces reacutepertoires sont speacutecifieacutes dans les actions drsquointeacutegration Les documents GT comprenant des composants de piegraveces jointes ont besoin pour ecirctre inteacutegreacutes dans une base de donneacutees drsquoun reacutepertoire de deacutepocirct pour le stockage des fichiers (piegraveces jointes) fournis par les utilisateurs

bull Droits de lecture pour le compte de service sur les reacutepertoires speacutecifieacutes dans les chemins de piegraveces jointes dans les donneacutees utiliseacutees pour preacute-remplir les questionnaires Geacuteneacuteralement ces chemins de piegraveces jointes seront speacutecifieacutes avec des emplacements reacuteseau Si aucun questionnaire ne contient de composant de piegravece jointe ce preacute-requis nrsquoa pas lieu drsquoecirctre respecteacute

211 Versions requises des serveurs et des clients pour les SGBD

Les SGBD supporteacutes par GTServer et les clients de base de donneacutees agrave installer pour une base GTServer (repository) ou une base Client sont les suivants

Serveur de base de donneacutees

Client de base de donneacutees Remarques

SQL Server 2005 ou supeacuterieur

Provider Ole DB pour SQL Server 2005 2008 2008 R2 2012

Les versions SQL Server Express sont supporteacutees Pour SQL Server 2014 utiliser le driver client Ole DB pour SQL server 2012

Oracle 10 ou supeacuterieur

ODPNET Installeacute avec ODAC (Oracle Data Access Components) version 11g minimum

La version Oracle XE est supporteacutee Le client doit ecirctre configureacute (tnsnamesora et sqlnamesora)

Postgres 83 ou supeacuterieur

NpgSql Le client est installeacute avec GTServer

DB2 UDB 9 ou supeacuterieur

IBM Data Server Runtime Client DB2 AS400 nrsquoest pas supporteacute

Les bases GT et Client peuvent se trouver sur des serveurs de bases de donneacutees diffeacuterents Ces serveurs peuvent se trouver sur des machines diffeacuterentes de la machine sur laquelle sera exeacutecuteacute le service GTServer

Les sauvegardes de la base de donneacutees GTServer ou de la base Client doivent ecirctre effectueacutees par les outils de sauvegardes utiliseacutes habituellement par le service informatique geacuterant les serveurs pour le ou les SGBD concerneacute(s)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 13: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

13

212 Droits de lrsquoutilisateur de connexion agrave la base GT

Des utilisateurs diffeacuterents peuvent ecirctre speacutecifieacutes lors de lrsquoinitialisation de la base GT (pour lrsquoinitialisation ou la mise agrave jour de la base GT) puis lorsque le service doit ecirctre lanceacute

A lrsquoinitialisation de la base GT ou agrave sa mise agrave jour des droits suppleacutementaires seront demandeacutes concernant la creacuteation drsquoobjetsLes droits des utilisateurs de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 14: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

14

peuvent srsquoappliquer uniquement aux objets du scheacutema speacutecifieacute dans la connexion agrave la base GT

Droits neacutecessaires Serveur de base de

donneacutees A la creacuteationmise agrave jour de la

base GT (creacuteation drsquoinstance)

agrave lrsquoutilisation de la base GT

SQL Server CREATE TABLE CREATE TYPE CREATE PROCEDURE ALTER ON SCHEMA REFERENCES ON SCHEMA SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_ddladmin db_datareader et db_datawriter) EXECUTE ON SCHEMA

SELECT UPDATE INSERT DELETE ON SCHEMA (ou appartenance aux rocircles db_datareader et db_datawriter) EXECUTE ON SCHEMA

Oracle CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) SELECT (sur chacune des seacutequences creacuteeacutees par GTServer)

Postgres CREATE ON SCHEMA USAGE ON SCHEMA

USAGE ON SCHEMA SELECT UPDATE INSERT DELETE (sur chacune des tables creacuteeacutees par GTServer) USAGE (sur chacune des seacutequences creacuteeacutees par GTServer) Postgres 9 SELECT INSERT UPDATE DELETE ON ALL TABLES IN SCHEMA USAGE ON ALL SEQUENCES IN SCHEMA

DB2 UDB CREATE TABLE CREATE INDEX CREATE SEQUENCE ALTER TABLE SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE (sur chacun des objets creacuteeacutes par GTServer)

Firebird embarqueacute La base GT est creacuteeacutee lors de la configuration de lrsquoinstance Aucun droit speacutecifique nrsquoest neacutecessaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

15

213 Droits de lrsquoutilisateur de connexion agrave la base Client

Les droits de connexion agrave la base client deacutependent essentiellement de la conception des actions drsquointeacutegration

Pour les actions de lancement des questionnaires ou de creacuteation de classeurs Excel de restitution un SELECT sur les tablesvues concerneacutees est suffisant

Dans le cas des actions drsquointeacutegration GTServer a besoin de creacuteer des tables intermeacutediaires (temporaires) dans la base client pour stocker et manipuler les donneacutees issues des questionnaires Neacuteanmoins le deacuteveloppeur Calame peut construire des tables que GTServer utilisera comme tables intermeacutediaires lors de lrsquointeacutegration lrsquoeacutelaboration de telles actions drsquointeacutegration implique alors que pour chaque table de destination (dans laquelle des donneacutees sont inteacutegreacutees) deux tables suppleacutementaires (une table intermeacutediaire drsquointeacutegration et une table des cleacutes) soient creacuteeacutees avec une structure similaire

Droits neacutecessaires Serveur de base

de donneacutees Sans utiliser de tables

intermeacutediaires drsquointeacutegration et de cleacutes

En utilisant les tables intermeacutediaires drsquointeacutegration et

de cleacutes SQL Server CREATE TABLE

CREATE INDEX SELECT UPDATE INSERT DELETE (db_ddladmin db_datareader et db_datawriter)

SELECT UPDATE INSERT DELETE (db_datareader et db_datawriter)

Oracle CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Postgres CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

DB2 UDB CREATE TABLE CREATE INDEX SELECT UPDATE INSERT DELETE

SELECT UPDATE INSERT DELETE

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

16

Les SELECT UPDATE INSERT DELETE srsquoappliquent agrave toutes les tablesvues deacutesigneacutees dans les actions de lancement de questionnaires de restitutions et actions drsquointeacutegrations ainsi qursquoagrave toutes les tables temporaires creacuteeacutees par GTServer lors de lrsquointeacutegration

214 Speacutecificiteacutes suivant les bases de donneacutees utiliseacutees

Quel que soit le SGBD choisi pour la base client un seul scheacutema est accessible par GT toutes les tables et les vues utiliseacutees doivent se trouver dans le mecircme scheacutema

Les vues se trouvant dans le scheacutema speacutecifieacute pour la connexion agrave la base client peuvent cependant exploiter des donneacutees drsquoautres scheacutemas ou bases (les droits de lrsquoutilisateur de connexion devront ecirctre adapteacutes en conseacutequence)

Le nom du scheacutema est sensible agrave la casse

Dans lrsquointerface de configuration des paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

2141 SQL Server

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT Si aucun scheacutema nrsquoest speacutecifieacute dans la connexion agrave la base le scheacutema dbo sera utiliseacute

Le scheacutema speacutecifieacute est sensible agrave la casse aussi bien pour la base GT que pour la base client

Le scheacutema de la base de donneacutees si diffeacuterent du scheacutema dbo doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client

Dans le cas de la connexion agrave une base GT sous SQL Server un GRANT EXECUTE sur toutes les proceacutedures stockeacutees est neacutecessaire Ce droit nrsquoest pas inclus dans les rocircles de bases de donneacutees installeacutes par deacutefaut avec SQL Server Il peut ecirctre accordeacute sur toutes les proceacutedures drsquoun scheacutema en utilisant lrsquoinstruction suivante

grant execute ON SCHEMANom_Du_Schema to Nom_Utilisateur_Ou_Role

Ce droit est cependant inclus dans le rocircle de base de donneacutees db_owner

Si la collation utiliseacutee pour la base de donneacutees GT est une collation insensible agrave la casse ou aux accents des objets GT diffeacuterents (modegraveles actions ou messages) ne pourront avoir des noms se diffeacuterenciant uniquement par la casse ou les accents

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

17

2142 Oracle

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en majuscules sans espace ni autre caractegravere que a-z 0-9 et _

2143 Postgres

Le scheacutema doit ecirctre speacutecifieacute aussi bien pour la connexion agrave la base GT que la connexion agrave la base client Le scheacutema est sensible agrave la casse

Le scheacutema GT doit avoir eacuteteacute creacuteeacute en minuscules sans espace ni autre caractegravere que a-z 0-9 et _

Le scheacutema speacutecifieacute pour la base GT devrait ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

Si ce nrsquoest pas le cas il faudra inclure lrsquoentreacutee suivante dans les paramegravetres suppleacutementaires de la connexion agrave la base GT

SearchPath=nom_du_schema

La version 9 de Postgres a induit un changement de comportement par deacutefaut Lrsquoentreacutee laquo bytea_output raquo doit ecirctre speacutecifieacutee agrave escape dans le fichier de configuration de Postgres

bytea_output = escape

2144 DB2 UDB

Le scheacutema doit ecirctre speacutecifieacute dans la configuration de la connexion de lrsquoinstance GTServer

Le scheacutema speacutecifieacute pour la connexion agrave la base GT doit ecirctre le scheacutema par deacutefaut de lrsquoutilisateur speacutecifieacute pour la creacuteationinitialisation de la base GT

2145 Firebird embarqueacute

Firebird nrsquoest supporteacute comme SGBD que pour la base GT

Lorsque laquo Embedded Firebird raquo est choisi pour la base GT lors de la configuration de lrsquoinstance GTServer une base Firebird est creacuteeacutee dans le reacutepertoire de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

18

GTServer possegravede tous les droits sur cette base Firebird

Lrsquoaccegraves agrave cette base est autoriseacute pour un seul processus Windows lorsque le service GTServer est deacutemarreacute GTAdmin devrait ecirctre fermeacute Reacuteciproquement si GTAdmin doit acceacuteder agrave la base (pour creacuteer des utilisateurs par exemple) le service GTServer devrait ecirctre arrecircteacute

22 Poste serveur web deacutedieacute module GTWeb

Module installeacute GTWeb par copie des scripts contenus dans un zip

Preacute-requis pour le serveur Web destineacute agrave heacuteberger GTWeb

bull Machine Windows ou Unix permettant de faire fonctionner le serveur Web et les modules associeacutes qui suivent

bull Serveur Apache version 24 minimum OU Serveur IIS version 75 minimum

bull Moteur PHP installeacute et opeacuterationnel sur le serveur Web version 56 minimum

bull Compte utilisateur (sur le systegraveme Windows ou Unix heacutebergeant le serveur Web) permettant de faire des arrecircts redeacutemarrages du serveur Web et des modifications de configurations du serveur Web

bull Accegraves agrave la machine (si diffeacuterente de la machine heacutebergeant GTWeb) ougrave sont installeacutes les scripts du module GTWeb

bull Ouverture de port entrant GTAnswer et Design communiquent avec le serveur web heacutebergeant GTWeb en ouvrant une connexion http sur un flux TCPIP sur le ou les ports du serveur Web Ce port doit ecirctre ouvert sur la machine du serveur web deacutedieacute pour les connexions entrantes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

19

23 Poste client deacuteveloppeur modules Design et GTAnswer

Modules installeacutes Design et GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie pour effectuer une recette sur les questionnaires reccedilus

bull Accegraves agrave un compte de messagerie pour la recette par GTAnswer OU utiliser la reacuteponse HTTP GTAnswer est utiliseacute pour reacutepondre aux formulaires Dans le cadre drsquoune recette drsquoun projet GT avec des questionnaires auxquels les reacuteponses ne sont pas transmises par HTTP GTAnswer communiquera avec le serveur de messagerie pour transmettre la reacuteponse (connexion de secours)

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

bull Ecran avec une reacutesolution de 1024x768 minimum

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en HTTP sont envoyeacutes

Le deacuteveloppeur devrait avoir accegraves agrave un outil de conception drsquoobjets dans la base de donneacutees Client pour la reacutealisation des tables et vues en entreacutee et sortie des documents GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

20

24 Poste client gestionnaire ou valideur module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (si crsquoest le mode drsquoenvoi) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Compte Windows avec des droits administrateurs pour lrsquoinstallation

bull Les ports de communication vers le serveur GT doivent ecirctre ouverts

25 Poste de reacutepondant aux campagnes module GTAnswer

Module installeacute GTAnswer via SetupGatheringToolsexe

SetupGatheringTools Deux versions 32 bits et 64 bits La version installeacutee doit correspondre aux versions (32 ou 64) drsquoOutlook (pour la connexion de secours) Si le mode drsquoenvoi nrsquoest pas drsquoOutlook il est fortement conseilleacute de ne pas utiliser la version 64 bits (plus lente et plus gourmande en RAM)

bull Windows 7 Windows 8 Server 2008 Server 2012 ou Server 2012 R2 Windows 10 avec les derniers Service Pack Server 2016

bull Client de messagerie utiliseacute pour recevoir les mails envoyeacutes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

21

bull Accegraves agrave un compte de messagerie par GTAnswer pour les questionnaires demandant une reacuteponse par mail (connexion de secours)

bull Si un client de messagerie est deacutejagrave installeacute les informations seront reacutecupeacutereacutees et le mot de passe sera demandeacute pour les messageries Lotus Notes et SMTP Dans le cas de connexions vers un serveur Exchange ou un serveur Notes un client de messagerie (Outlook ou Lotus Notes) doit ecirctre installeacute sur le poste

bull Si aucun client de messagerie nrsquoest installeacute (WebMail hellip) ou que la configuration du client de messagerie nrsquoest pas deacutetecteacutee par Answer des informations de connexions vers un compte de messagerie agrave accegraves SMTP seront neacutecessaires pour configurer Answer

bull Accegraves au serveur web fournissant la reacuteponse HTTP (publication) si des questionnaires avec une reacuteponse en http ou une synchronisation HTTP sont envoyeacutes

3 Proceacutedures drsquoinstallation et de configuration

31 Poste serveur module GTServer

Le Setup va installer GTServer et les modules associeacutes

Plusieurs instances de GTServer peuvent coexister sur le mecircme poste

A chaque instance de GTServer est associeacute un service Windows

311 Proceacutedure drsquoinstallation

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

Lancer SetupGTServerexe

Suivre lrsquoassistant drsquoinstallation

Le reacutepertoire drsquoinstallation peut ecirctre speacutecifieacute au choix de lrsquoinstallateur via le panneau correspondant de lrsquoassistant

Deacuterouler ensuite lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

22

312 Configuration du serveur

3121 Preacuteambules

Une fois lrsquoinstallation termineacutee ouvrir une session sur le poste avec le compte utilisateur Windows lanccedilant le service (compte de service)

Il est preacutefeacuterable de pouvoir se connecter avec ce compte de service pour terminer linstallation afin de pallier les difficulteacutes lieacutees aux droits (sous Windows 7 8 10 et Windows Server 2008 2012 ou 2012 R2 et 2016) sur les reacutepertoires creacuteeacutes lors de la configuration de linstance GTServer avec un autre compte que le compte de service

Lors de lrsquoinscription de la cleacute GTAdminexe tente de dialoguer avec le site Gathering Tools pour valider cette cleacute (via httpswwwgathering-toolscom) Si cette communication nrsquoest pas possible (pare-feu utilisation drsquoun proxy ou absence de connexion agrave internethellip) une proceacutedure manuelle de validation est possible (cf 3123)

3122 Installation de la cleacute de licence

La cleacute de licence en version 2019 est deacutefinie au niveau serveur

Si vous nrsquoavez pas reccedilu cleacute de licence pour votre installation contactez le support (supportgathering-toolscom) en preacutecisant

bull si vous reacutealisez une nouvelle installation

bull si vous souhaitez que lrsquoinstance de recette et lrsquoinstance de production soient installeacutees sur la mecircme machine ou sur deux machines seacutepareacutees Preacuteciser dans votre mail au support les noms des machines pour la recette et la production (dans le cas drsquoune reacutepartition sur deux machines) vous permettra de mieux les distinguer lors de lrsquoinstallation

Une fois en possession de votre cleacute de licence lancer GTAdmin et acceacuteder agrave la commande Licence rarr Installer

Entrer votre cleacute de licence

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

23

Cliquer sur le bouton Valider Si un bouton Geacuteneacuterer remplace le bouton Valider se reporter agrave la validation manuelle de la cleacute (sect 3123)

Puis cliquer sur le bouton Installer qui sera alors disponible si la cleacute est valide Une eacuteleacutevation de droits temporaire peut ecirctre requise sur les systegravemes Windows 7 et suivants

Une fois valideacutee la cleacute de licence ne pourra pas ecirctre utiliseacutee pour une autre machine

3123 Validation manuelle de la cleacute pour GTServer

A partir de la boicircte drsquoinstallation de la cleacute de licence le programme GTAdminexe tente de dialoguer avec le site httpswwwgathering-toolscom pour veacuterifier la validiteacute de la cleacute de licence

Si GTAdminexe ne peut dialoguer avec le site httpswwwgathering-toolscom un message apparaicirct informant de cette impossibiliteacute

- Fermer la boicircte de dialogue avec le message informant de lrsquoeacutechec de la connexion

- Entrer la cleacute de licence reccedilue du support

- Cliquer sur le bouton Geacuteneacutererhellip Le texte proposeacute dans la zone de texte (commenccedilant par (----- BEGIN GTLIC DATA1 TO SEND ----- ) du panneau est agrave envoyer dans un mail au support (supportgathering-toolscom)

- En retour le support vous fait parvenir un mail contenant un nouveau texte commenccedilant par ----- BEGIN GTLIC DATA2 RECV -----

- Le texte de retour du support est agrave inscrire dans le panneau suivant de lrsquoassistant de configuration

- Cliquer sur le bouton Valider

- Poursuivre alors lrsquoinstallation en cliquant sur le bouton Installer de la boicircte preacuteceacutedente demandant la cleacute de licence

3124 Affectation des instances

Une fois la cleacute de licence installeacutee allez dans le menu laquo LicenceInformationhellip raquo

Cette boicircte permet drsquoassocier les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence et de visualiser les caracteacuteristiques de chaque licence drsquoinstance (nombre drsquoadministrateurs de deacuteveloppeurs de licences drsquoautomatisation de gestionnaires et de valideurs)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

24

Pour affecter une instance

- Seacutelectionner un numeacutero drsquoinstance de la cleacute

- Cliquer sur laquo Affecter agrave une instancehellip raquo Une boicircte de dialogue vous permet drsquoaffecter ce numeacutero drsquoinstance de la cleacute agrave une instance deacuteclareacutee dans GTAdmin

Pour deacutesaffecter les instances il est neacutecessaire de reacuteinstaller la cleacute de licence (cf 3122)

313 Configuration drsquoune instance

La configuration drsquoune instance est effectueacutee avec le compte utilisateur Windows lanccedilant le service (compte de service) Les preacuteambules de la configuration du serveur devraient ecirctre avoir eacuteteacute mis en œuvre (cf 3121)

Une fois lrsquoinstance creacuteeacutee dans GTAdmin elle doit ecirctre affecteacutee agrave un numeacutero drsquoinstance deacutefini dans la cleacute (cf 3124)

Lancer GTAdmin

Choisir Fichier-gtNouvelle Instance pour creacuteer et configurer une nouvelle instance

Entrer le nom de la nouvelle instance dans la boicircte (le nom doit respecter les regravegles de nommage de fichier avec la contrainte suppleacutementaire drsquoabsence drsquoespaces de caractegraveres accentueacutes et de caractegraveres unicode)

Un assistant deacuteroule les diffeacuterentes eacutetapes de la configuration de lrsquoinstance pour sa creacuteation

Une fois lrsquoinstance creacuteeacutee (lorsque lrsquoassistant a eacuteteacute deacuterouleacute complegravetement) la modification de la configuration de lrsquoinstance demande agrave ecirctre effectueacutee en utilisant la commande Enregistrer la configuration de lrsquoinstance XXX du menu fichier lorsque le service de lrsquoinstance est arrecircteacute

Lrsquoinstance deacuteclareacutee dans GTAdmin doit ensuite ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence pour pouvoir installer le service et ecirctre deacutemarreacutee (cf 3124)

3131 Paramegravetres geacuteneacuteraux

Dans la boicircte des paramegravetres geacuteneacuteraux speacutecifier le port de communication qui sera utiliseacute sur le poste serveur pour les communications avec les utilisateurs de GTAnswer Ce port doit ecirctre ouvert pour les communications avec GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

25

A chaque instance GTServer est associeacute un reacutepertoire de fichiers journaux et un journal drsquoeacutevegravenements Windows

Choisir les niveaux de journalisation preacuteciseacutes dans la copie drsquoeacutecran ci-dessus pour un niveau drsquoinformation optimal dans les journaux fichier et systegraveme sans surcharge

Le reacutepertoire de lrsquoinstance doit ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service GTServer Ce reacutepertoire est le suivant

ProgramDataCalameGTServerNom_De_L_Instance

(sous Windows 7 ou 8 ou 10 Windows Server 2008 2012 2012 R22016)

Les reacutepertoires des journaux des restitutions et le reacutepertoire temporaire doivent ecirctre accessible en lecture-eacutecriture par lrsquoutilisateur du compte de service

Les reacutepertoires des journaux peuvent ecirctre speacutecifieacutes ougrave vous voulez (leurs emplacements sont modifiables dans lrsquoonglet laquo Geacuteneacuteral raquo de lrsquoinstance dans GTAdmin)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

26

Par deacutefaut ces reacutepertoires sont les suivants

Reacutepertoire Emplacement par deacutefaut

Reacutepertoire des journaux

hellipReacutepertoire_de_lrsquoinstanceLog

Reacutepertoire des restitutions

hellipReacutepertoire_de_lrsquoinstanceRestit

Reacutepertoire temporaire

hellipReacutepertoire_de_lrsquoinstanceTmp

Choisir Suivant pour passer agrave lrsquoeacutetape suivante de configuration

3132 Seacutecuriteacute utilisation drsquoun certificat

Si un certificat est souhaiteacute pour chiffrer les communications entre GTServer et GTAnswer ou pour authentifier les documents GT envoyeacutes et pour le cryptage des donneacutees transmises par Answer ce panneau permet de renseigner le certificat et les informations affeacuterentes

Choisir Suivant pour passer agrave lrsquoeacutetape de configuration de la connexion agrave la base GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

27

Strateacutegie de mot de passe

- Mot de passe oublieacute GTServer envoie un mail contenant un nouveau mot de passe agrave lrsquoutilisateur qui a indiqueacute agrave GTAnswer qursquoil avait oublieacute son mot de passe

- Ne contient pas le login Veacuterifie que le mot de passe ne contient pas le login de lrsquoutilisateur La comparaison nrsquoest pas sensible agrave la casse

- Contraintes de caractegraveres

o Contraintes utilisateur (pour les deacuteveloppeurs gestionnaires valideurs)

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

o Contraintes administrateur

Taille mini et taille maxi nombre de caractegraveres minimum ou maximum autoriseacutes

Au moins une majuscule requise

Au moins une minuscule requise

Au moins un caractegravere numeacuterique requis

Au moins un symbole requis

- Verrouiller apregraves xx eacutechec(s) agrave la connexion si lrsquoutilisateur se trompe dans le mot de passe le compte est verrouilleacute apregraves le nombre de tentatives indiqueacutees Une fois le deacutelai deacutepasseacute seul un administrateur peut deacutebloquer le compte

- Dureacutee de vie entre xx et yy jours une fois le mot de passe expireacute lrsquoutilisateur doit en changer mecircme si on change ces paramegravetres Le minimum nrsquoest pas pris en compte si lrsquoutilisateur doit changer son mot de passe agrave la prochaine connexion

- Diffeacuterents des xx dernier(s) mot(s) de passe lors du changement de mot de passe lrsquoutilisateur ne peut pas utiliser un de ses xx derniers mots de passe

- Dictionnaire Veacuterifie que le mot de passe ne contient pas un des mots preacutesents dans le fichier texte (txt csvhellip) Ce fichier comporte un mot par ligne La comparaison nrsquoest pas sensible agrave la casse Le fichier doit ecirctre accessible par le compte du service de lrsquoinstance

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

28

3133 Configuration de la connexion agrave la base GT

La base GT est une base donneacutees (ou un scheacutema dans une base) ne contenant que des donneacutees appartenant agrave GTServer Elle nrsquoest pas agrave confondre avec la base client qui est une base ouverte (eacutelaboreacutee par le concepteur Calame et ne contenant pas de donneacutees proprieacutetaires)

Ce panneau permet de configurer la connexion agrave cette base

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees GT peut ecirctre reacutealiseacutee en suivant la mecircme proceacutedure que pour la base client (cf 3134)

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

29

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Si aucune base de donneacutee GT nrsquoa eacuteteacute deacutetecteacutee lors de lrsquoexeacutecution du test de connexion choisir laquo Initialiser la base GT raquo

Attention lrsquoinitialisation ne pourra srsquoeffectuer correctement que si les preacuterequis (notamment au niveau des droits et des scheacutemas par deacutefaut de lrsquoutilisateur de connexion pour creacuteer la base GTServer) sont remplis (cf 212 et 214)

Une fois la base GT initialiseacutee lrsquoutilisateur de connexion speacutecifieacute peut ecirctre modifieacute pour basculer agrave un utilisateur posseacutedant des droits plus restreints

Les utilisateurs ne pourront ecirctre creacuteeacutes qursquoune fois lrsquoinstance affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence

3134 Configuration de la connexion agrave la base client

Choisir en premier lieu le type de base de donneacutees puis inscrire les informations de connexion

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

30

Dans le cas drsquoOracle il est preacutefeacuterable de speacutecifier comme serveur le SID deacutecrit dans le tnsnamesora du client Oracle

La speacutecification de ports diffeacuterents des ports standards pour la connexion agrave lrsquoinstance de la base de donneacutees Client peut ecirctre reacutealiseacutee de la faccedilon suivante

SGBD Ecriture drsquoun port speacutecifique SQL Server Changer le nom du serveur

Adresse_ipnumeacutero_de_port Oracle Changer le nom du serveur ou modifier le SID dans

tnsnamesora Le nom du serveur peut ecirctre lrsquoentreacutee tnsnamesora correspondante OU adresse_ipnumeroportinstance_SID

Postgres Utiliser la zone de texte du port dans lrsquointerface graphique DB2 Changer le nom du serveur

Adresse_ipnumeacutero_de_port

Les paramegravetres suppleacutementaires de la connexion agrave la base de donneacutees permettent de speacutecifier sous forme de texte les informations compleacutementaires agrave envoyer au driver de base de donneacutees utiliseacute par GTServer

Une fois que tous les paramegravetres sont entreacutes tester la connexion agrave la base de donneacutees

Cliquer sur le bouton Suivant pour passer agrave lrsquoeacutetape de configuration de connexion agrave la messagerie

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

31

3135 Configuration de la connexion agrave la messagerie (envoi et reacuteception)

Speacutecifier lrsquoadresse de consolidation Lrsquoadresse de consolidation doit ecirctre lrsquoadresse mail associeacutee agrave GTServer Crsquoest cette adresse agrave laquelle le module Answer enverra les mails de reacuteponse lors que la reacuteponse aux campagnes GT est effectueacutee par mail (et non en reacuteponse http via GTWeb)

La configuration de lrsquoenvoi et la configuration du polling sont accessibles avec les boutons laquo hellip raquo correspondants

Deacutefinir tout drsquoabord le mode de configuration drsquoenvoi des messages avec le bouton laquo hellip raquo correspondant

Le mode drsquoenvoi par SMTP est obligatoire il permet lrsquoenvoi des notifications

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

32

Deacutefinir ensuite la configuration de polling reacuteception des reacuteponses Answer par messagerie (bouton hellip correspondant)

La configuration de polling nrsquoest pas neacutecessaire si tous les questionnaires envoyeacutes reccediloivent une reacuteponse drsquoAnswer en HTTP (paramegravetre deacutefini lors de la creacuteation de lrsquoaction si une url de publication existe pour la campagne)

Speacutecificiteacutes de configuration de polling pour IMAP

Un dossier IMAP doit ecirctre deacutesigneacute dans la rubrique laquo Boicircte aux lettres raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

33

Le nom INBOX est geacuteneacuteralement utiliseacute pour deacutesigner le dossier de la boicircte de reacuteception accueillant les mails agrave lrsquoarriveacutee

Speacutecificiteacutes de configuration de polling pour Exchange (Outlook)

Un client Outlook doit ecirctre installeacute sur le poste

Un profil de courrier Outlook doit ecirctre configureacute dans le profil du compte de service

Ce profil doit ecirctre speacutecifieacute dans la configuration de connexion de lrsquoinstance Calame

Informations agrave deacutefinir

URL de publication

LrsquoURL de publication permet de speacutecifier lrsquoURL de GTWeb utiliseacutee pour faire dialoguer une instance GTWeb et une instance GTServer (cf installation de GTWeb sect 321)

Le bouton laquo hellip raquo vous permet de veacuterifier la bonne eacutecriture de lrsquourl de publication Ce bouton lance le navigateur par deacutefaut avec lrsquourl de publication

En fonction de la version utiliseacutee la page drsquoarriveacutee contient soit le logo Gathering Tools soit un message (cf Tests drsquoURL)

Pour utiliser le nouveau GTWeb dans la version 2018 il faudra cocher la case

LrsquoURL de publication est partageacutee par toutes les instances et ne contient plus que le serveur web Il faut cocher la case pour utiliser le nouveau GTWeb

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

34

3136 Affectation de lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute

Valider votre configuration de lrsquoinstance

Affecter lrsquoinstance agrave un numeacutero drsquoinstance de la cleacute de licence voir sect 3124

Une fois lrsquoinstance creacuteeacutee et affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence les utilisateurs peuvent ecirctre creacuteeacutes

3137 Creacuteation drsquoutilisateurs

Lrsquoinstance doit avoir eacuteteacute affecteacutee agrave un numeacutero drsquoinstance dans la cleacute de licence voir sect 3124

A partir de lrsquoonglet Base GT de configuration de lrsquoinstance cliquez sur le bouton Utilisateurs pour creacuteer un nouvel utilisateur Calame

Les modificationsajoutssuppressions drsquoutilisateurs sont enregistreacutes dans la base GT de lrsquoinstance et ne deacutependent pas de la sauvegarde de la configuration de lrsquoinstance effectueacutee dans GTAdmin

Cliquer sur le bouton laquo Nouvel Utilisateurhellip raquo pour creacuteer un nouvel utilisateur

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

35

Donner un nom (login) de connexion et un mot de passe agrave cet utilisateur

Cocher lrsquooption laquo Doit changer de mot de passe agrave la prochaine connexion raquo pour forcer lrsquoutilisateur agrave modifier le mot de passe agrave la prochaine utilisation Cette option est indeacutependante de la dureacutee de vie minimale des mots de passe

Speacutecifier le privilegravege Administrateur pour ce nouvel utilisateur

Il est preacutefeacuterable de creacuteer au moins un administrateur pour chaque instance

Seul un administrateur peut creacuteer de nouveaux utilisateurs

La creacuteation de nouveaux utilisateurs peut ecirctre effectueacutee via GTAdmin (sur le poste serveur) ou via GTAnswer les autres utilisateurs du projet pourront ecirctre creacuteeacutes avec GTAnswer par un utiliseacute connecteacute avec un compte drsquoadministrateur

Lrsquoidentifiant est utiliseacute pour filtrer les droits des utilisateurs gestionnaires sur telles ou telles entiteacutes interrogeacutees avec les documents GT (ce filtre est reacutealiseacute gracircce agrave une vue ou une table de la base client)

Il est possible drsquoimposer des contraintes aux mots de passe des utilisateurs en activant lrsquooption correspondante pour lrsquoinstance dans lrsquoonglet laquo Seacutecuriteacute raquo via GTAdmin

Valider la creacuteation du nouvel utilisateur administrateur

Creacuteer au besoin drsquoautres utilisateurs

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

36

Valider la creacuteation des utilisateurs puis cliquer sur le bouton Suivant dans la configuration agrave la base GT pour passer agrave lrsquoeacutetape suivante de configuration

Lorsque la base GT est une base Firebird embarqueacute le service GTServer doit ecirctre arrecircteacute pour que GTAdmin puisse creacuteer des utilisateurs Reacuteciproquement GTAdmin doit ecirctre fermeacute pour que le service GTServer puisse acceacuteder agrave la base GT et fonctionner correctement

3138 Licences drsquoutilisateurs Gestionnaire et Valideurs

Pour chaque instance peut ecirctre deacutefini un nombre drsquoadministrateurs de deacuteveloppeurs de gestionnaires et de valideurs suivant les licences acquises pour la suite Gathering Tools

Les utilisateurs creacuteeacutes avec le privilegravege Administrateur consomment une licence Administrateur

Les utilisateurs creacuteeacutes avec le privilegravege Deacuteveloppeur consomment une licence Deacuteveloppeur

La consommation de licences pour les utilisateurs Gestionnaires et Valideurs deacutependent des droits accordeacutes agrave un utilisateur pour lrsquoensemble des questionnaires de lrsquoinstance

Les droits qui peuvent ecirctre affecteacutes agrave un utilisateur (via un Groupe) peuvent ecirctre visualiseacutes dans les groupes (via GTAnswer bouton laquo Geacuterer les Groupes raquo) La liste complegravete des droits pour un gestionnaire est visualisable la boicircte laquo Geacuterer les groupes raquo

Un utilisateur consommera une licence Valideur srsquoil nrsquoest associeacute qursquoagrave des groupes ne contenant que tout ou partie des 5 droits suivants

- Lister les campagnes (bloc Liste)

- Lister les reacuteponses (bloc Liste)

- ValiderInvalider une reacuteponse (bloc Reacuteponse)

- Visualiser une reacuteponse (bloc Visualisation)

- Visualiser un questionnaire envoyeacute (bloc Visualisation)

Un utilisateur consommera une licence Gestionnaire si lui est affecteacute un groupe contenant un quelconque droit en dehors des droits Valideurs ci-dessus

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

37

3139 Cas des utilisateurs reacutepondants

Le nombre de reacutepondants est illimiteacute et nrsquoest pas soumis agrave licence Le nombre de reacutepondants nrsquoest pas pris en compte dans le coucirct des licences

314 Installerdeacutemarrer le service drsquoune instance

A chaque instance GTServer est associeacute un service Windows distinct

Un service GTServer est nommeacute

Calame GTServer Nom_De_L_Instance

Les services GTServer srsquoadministrent de la mecircme maniegravere que les autres services Windows

Pour chaque service GTServer est creacuteeacute un journal drsquoeacutevegravenement Windows agrave lrsquoinstallation du service correspondant dans GTAdmin

Apregraves la creacuteation drsquoune instance dans GTAdmin celle-ci doit ecirctre affecteacutee agrave un numeacutero drsquoinstance de la cleacute de licence (cf 3124)

Le service GTServer pour cette instance doit ecirctre installeacute

Seacutelectionner lrsquoinstance nouvellement creacuteeacutee dans GTAdmin (dans la liste des instances agrave gauche)

Afficher le menu contextuel et choisir laquo Installer le service raquo

Renseigner les informations du compte de service et valider lrsquoinstallation du service

Sous Windows des demandes drsquoeacuteleacutevation de droits peuvent ecirctre formuleacutees par le systegraveme pour lrsquoinstallation le deacutemarrage et lrsquoarrecirct du service via GTAdmin

Une fois le service creacuteeacute celui-ci peut ecirctre deacutemarreacute ou arrecircteacute en utilisant le menu contextuel sur lrsquoinstance correspondante ou en utilisant les outils habituels de gestion des services Windows (net start net stop sc hellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

38

315 Migration drsquoune installation GTServer 30 31 35 37 ou 39 vers GTServer 2019

3151 Preacuteparation de la migration Sauvegarde des modegraveles et des actions fermeture des campagnes

La premiegravere eacutetape consiste agrave effectuer une sauvegarde des modegraveles et des actions en lanccedilant GTAnswer en se connectant sur chaque instance GTServer et en sauvegardant les modegraveles et les actions avec la commande Fichier-gtExporter

Lors de lrsquoinstallation de la version 2019 sur une version anteacuterieure (30 agrave 37) toutes les campagnes des instances deacutejagrave existantes seront supprimeacutees

Les campagnes seront supprimeacutees lors de la mise agrave jour des bases GT

Il est impeacuteratif de consulter le gestionnaire des campagnes pour srsquoassurer que les campagnes sont closes et ont eacuteteacute inteacutegreacutees

3152 Mise agrave jour de GTServer

Les services GTServer en cours de fonctionnement doivent tout drsquoabord ecirctre arrecircteacutes

Lancer lrsquoexeacutecutable SetupGTServerexe qui mettra agrave jour le module GTServer installeacute sur le poste

Une fois lrsquoinstallation termineacutee lancer GTAdmin

Pour chacune des instances veacuterifier que le service est arrecircteacute puis dans lrsquoonglet laquo Base GT raquo puis cliquer sur le bouton laquo Tester raquo

Un message apparaicirct speacutecifiant que la base doit ecirctre mise agrave jour

Cliquer sur le nouveau bouton laquo Mettre agrave jour raquo

Si la version drsquoorigine est anteacuterieure agrave la 37 il vous faudra speacutecifier la cleacute de licence du serveur si cela nrsquoa pas deacutejagrave eacuteteacute fait et affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute de licence (cf 3122 et 3124)

Le service de lrsquoinstance peut maintenant ecirctre deacutemarreacute

3153 Compleacutements de deacuteploiement

GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

39

SetupGTServerexe met agrave jour GTServerexe et les modules associeacutes qui sont utiliseacutes pour toutes les instances fonctionnant sur le serveur

Les questionnaires envoyeacutes avec cette version de GTServer devront ecirctre ouverts par les correspondants avec un Answer dont la version est la mecircme que GTServer Les correspondants pourront toujours ouvrir les anciens questionnaires 37 et y reacutepondre

Tous les GTAnswer pointant vers les instances mises agrave jour doivent ecirctre eacutegalement mis agrave jour en utilisant la mecircme version que GTServer

GTAnswer

Lorsque Answer 2020 est installeacute et associeacute aux fichiers qstx un exeacutecutable AnswerLegacyexe (version 37 drsquoAnswer) est installeacute en mecircme temps cet exeacutecutable 37 est associeacute aux anciens fichiers qst

Ainsi lrsquoinstallation de GTAnswer 2020 permet aux correspondants drsquoouvrir les anciens questionnaires 37 qst exactement de la mecircme maniegravere qursquoavec la 37 (puisque crsquoest le mecircme exeacutecutable Answer version 37 qui les ouvre) et drsquoouvrir les nouveaux questionnaires qstx 2019

32 Poste serveur web deacutedieacute module GTWeb

Il nrsquoy a pas de setup agrave lancer mais uniquement des fichiers agrave copier Le dossier compresseacute laquo new_gtwebzip raquo contient tous les scripts pour le fonctionnement du nouveau GTWeb

321 Installation des scripts GTWeb dans un serveur Web

Se connecter avec le compte administrateur preacutevu pour lrsquoinstallation

La premiegravere eacutetape de la configuration sera de copier les fichiers vers la machine Linux ou Windows heacutebergeant le serveur Web drsquoaccueil

3211 Geacuteneacuteraliteacutes de lrsquoinstallation du module GTWeb

Les fichiers seront copieacutes dans le reacutepertoire drsquoinstallation de votre site Web

Si votre site Web a pour nom (wwwTest) la structure sera comme ci-dessous apregraves la copie des fichiers

Le fichier indexphp est dans laquo public raquo La racine de laquo app raquo contient lrsquoapplication (functionsphp et processphp)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

40

La configuration des instances est dans laquo config raquo

Nous suggeacuterons avant drsquoinstaller et de configurer GTWeb de faire des tests de fonctionnement afin de srsquoassurer que votre serveur Web est opeacuterationnel accessible au moins via le navigateur depuis les postes des reacutepondants et que le moteur PHP est opeacuterationnel

- Dans le phpini il y a trois valeurs agrave augmenter

max_execution_time (Fixe le temps maximal dexeacutecution dun script en secondes Cela permet deacuteviter que des scripts en boucles infinies saturent le serveur La configuration par deacutefaut est de 30 secondes)

post_max_size (Deacutefinit la taille maximale des donneacutees reccedilues par meacutethode POST Pour charger de gros fichiers cette valeur doit ecirctre plus grande que la valeur de upload_max_filesize)

upload_max_filesize (Taille maximale dun fichier agrave charger)

3212 Tests preacutealables de fonctionnement du serveur Web

Serveur Web opeacuterationnel et accessible

bull Creacuteer une page Web sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de page web minimale (agrave inscrire dans un fichier texte renommeacute en TestAcceshtml par exemple)

ltDOCTYPE htmlgtlthtmlgtltbodygt ACCESS WEB PAGE OK ltbodygtlthtmlgt

Vous pouvez eacutegalement utiliser la page Web exemple nommeacutee TestWeb_01_Acceshtml figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine ougrave fonctionne le serveur Web (avec un accegraves en http(s) et non en file)

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Les deux tests drsquoaccegraves doivent afficher dans le navigateur le texte contenu dans la page exemple

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

41

Moteur PHP opeacuterationnel

bull Creacuteer une page php sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en Testphp par exemple)

ltphp echo PHP ACCESS OK ltbrgtltbrgt phpinfo() gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_02_PHPOnphp figurant dans les fichiers de tests de lrsquoinstallation de GT

bull Essayer drsquoacceacuteder agrave cette page Web depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoaccegraves doit laisser voir le contenu de la page PHP sans erreur

Moteur PHP permettant drsquoutiliser lrsquoupload de fichiers

bull Creacuteer une page php drsquoupload de fichier sur le site Web srsquoil nrsquoen existe pas

Exemple de contenu de script PHP minimal (agrave inscrire dans un fichier texte renommeacute en TestWeb_03_PHPUploadphp)

ltphp

if (isset($_POST[submit]))

echo ltform action=TestWeb_03_PHPUploadphp method=post

enctype=multipartform-datagt

Select file to upload

ltinput type=file name=userfile id=fileToUploadgt

ltinput type=submit value=Upload File name=submitgt

ltformgt

exit

if (is_uploaded_file($_FILES[userfile][tmp_name]))

echo Upload OKltbrgtltbrgt

else

echo ltspan style=background-colorred gtERROR

Uploadltspangtltbrgtltbrgt

echo Debug Infos ltbrgt

print_r($_FILES)

gt

Vous pouvez eacutegalement utiliser la page PHP exemple nommeacutee TestWeb_03_PHPUploadphp figurant dans les fichiers de tests de lrsquoinstallation de GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

42

bull Essayer drsquouploader un fichier en acceacutedant agrave cette page PHP depuis un navigateur fonctionnant sur la machine drsquoun reacutepondant

Le test drsquoupload de fichier doit aboutir agrave une page commenccedilant par le texte Upload OK

Accegraves TCPIP vers GTServer

Si vous nrsquoecirctes pas certain des accegraves TCPIP depuis le poste GTWeb vers le serveur installez GTAnswer sur la machine sur laquelle fonctionne GTWeb et configurez un alias vers le serveur GTServer (cf sect 33)

Veacuterifiez que vous pouvez vous connecter avec GTAnswer

3213 Installation de GTWeb dans un serveur Apache

La racine du virtual host doit ecirctre le reacutepertoire laquo public raquo

Exemple (Apache 24)

ltVirtualHost 80gt

ServerName localhost

DocumentRoot Dsiteapppublic

ltDirectory Dsiteapppublicgt

Options +Indexes +Includes +FollowSymLinks +MultiViews

AllowOverride All

Require all granted

ltDirectorygt

ltVirtualHostgt

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias (si vous souhaitez ajouter des alias ou nrsquoen avez pas creacuteeacute lors de lrsquoexeacutecution de SetupGTWebScriptsexe)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

43

3214 Installation de GTWeb dans un serveur IIS existant

Sur IIS effectuer les opeacuterations suivantes

- Ajouter un site qui pointe vers public (ici wwwTest = site)

Lrsquoeacutetape suivante consiste en la creacuteation de fichiers drsquoalias deacutesignant les instances GTServer (essentiellement ipnom de la machine GTServer et port) agrave contacter par les scripts GTWeb Se reporter au sect 322 pour la creacuteation de ces fichiers drsquoalias

3215 Tests drsquoURL

Dans un navigateur entrer lrsquoURL

http[server]indexphpalias=[instance]ampt=1

On peut mettre nrsquoimporte quelle valeur agrave la place de 1 pour le paramegravetre t Si votre serveur Web eacutecoute sur le port par deacutefaut 80 il faudra uniquement indiquer son nom par contre srsquoil eacutecoute sur un autre port il faudra rajouter le numeacutero de port agrave la suite du nom du serveur par exemple si 81 est le numeacutero de port lrsquoURL sera deacutefinie ainsi

http[server81]indexphpalias=[instance]ampt=1

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

44

Exemple de sortie

- Pas de fichier de conf

- GTServer pas deacutemarreacute

- URL et serveurs OK

322 Description drsquoun fichier conf (instance GTWeb vers une instance GTServer)

Les fichiers conf sont des fichiers texte deacutefinissent des aliasinstances GTWeb pointant chacun vers une instance GTServer

Le nom du fichier doit ecirctre laquo nom_instanceconf raquo Le nom du fichier est sensible agrave la casse

Ces fichiers conf doivent ecirctre creacuteeacutes et placeacutes dans le reacutepertoire laquoconfig raquo

Le contenu est compatible avec lrsquoancien GTWeb Il doit contenir au moins 2 entreacutees

IPADD=IP du serveur de lrsquoinstance

PORT=Port de lrsquoinstance

Optionnellement il peut contenir les paramegravetres SSL via SSLMODE

SSLMODE=tls

Et le paramegravetre de timeout de reacuteception TCPIP entre GTWeb et GTServer (en secondes)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

45

TIMEOUT=60

Il nrsquoy a plus besoin drsquoindiquer la version du protocole

Exemple de fichier conf pour acceacuteder agrave une instance GTServer version 2019

IPADD=127001

PORT=3000

33 Poste deacuteveloppeurgestionnaire modules GTAnswer Design

331 Installation de GTAnswer et Design

Lancer SetupGatheringToolsexe ou SetupGatheringTools64exe

Suivre lrsquoinstallation

Cliquer sur le bouton Suivant pour seacutelection dans la liste le profil agrave installer

Dans le cas drsquoune installation pour un poste Deacuteveloppeur le setup va installer Design et GTAnswer

Dans le cas drsquoune installation pour un poste Reacutepondant seul GTAnswer est installeacute

GTAnswer est installeacute par deacutefaut dans les tous les cas

Poste Deacuteveloppeur Design + GTAnswer

Poste Reacutepondant Answer

Poste GestionnaireValideur GTAnswer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

46

Dans le cas drsquoune installation pour un poste GestionnaireValideur seul GTAnswer est installeacute

Deacuterouler lrsquoassistant drsquoinstallation en choisissant les options par deacutefaut qui conviendront agrave la plupart des cas

332 Configurer dans GTAnswer les paramegravetres de connexion agrave une instance

GTAnswer est le module client de la suite Gathering Tools il se connecte agrave une instance GTServer existante

Lancer GTAnswer

Choisir la commande laquo Geacuterer les instances raquo sur la page de connexion

Cliquer sur le bouton Ajouter pour deacuteclarer une nouvelle instance ou le bouton Modifier pour modifier une deacuteclaration drsquoinstance deacutejagrave existante

Connexion HTTP(S)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

47

Le nom de lrsquoalias doit ecirctre le mecircme que le nom de lrsquoinstance avec la mecircme casse

LrsquoURL est celle du site Web Elle est partageacutee par toutes les instances sur ce site (crsquoest diffeacuterent des GTWeb preacuteceacutedents)

Connexion TCPIP

Nom de lrsquoinstance (sensible agrave la

casse)

URL du site Web

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

48

Une fois la connexion agrave lrsquoinstance parameacutetreacutee la connexion peut ecirctre effectueacutee sur lrsquoeacutecran de connexion

4 Deacuteploiement de GTAnswer

41 Geacuteneacuteraliteacutes

GTAnswer comme tous les autres modules nrsquoinstalle aucun exeacutecutable ou fichier associeacute dans le reacutepertoire de Windows

Les configurations des applications sont speacutecifieacutees dans la base de registre (entreacutees HKLM ou HKCU) etou dans le reacutepertoire associeacute agrave lrsquoapplication (cProgramDataCalameGTServer par exemple pour GTServer)

Nom de lrsquoinstance (sensible agrave la

casse)

Nom ou adresse IP du serveur

Numeacutero de port sur le serveur (par deacutefaut 3000) cette information doit ecirctre fourni par lrsquoadministrateur Calame (information accessible agrave partir de GTAdmin)

Utiliser un chiffrement pour la communication client-serveur si Seacutecuriteacute GTAdmin

Certificat et son mot de passe

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

49

42 GTAnswer modes drsquoinstallation et configuration

421 Modes drsquoinstallation

Mode Description Modaliteacutes Remarques

Local Exeacutecutables installeacutes localement

Setup A) Setup manuel B) Setup ligne de commande Configuration A) manuelle B) copie des fichiers

Remote App Ms Citrixhellip

Partagevirtualisation drsquoapplications

Cf infrastructure choisie pour partage drsquoapplications

Lors de lrsquoinstallation le Setup

bull copie les exeacutecutables par deacutefaut dans Program FilesGatheringTools si le setup est lanceacute avec des droits administrateurs Dans le cas de droits drsquoutilisateurs standards lrsquoinstallation se fait soit dans CUsersnameAppDataRoamingGatheringTools ou soit dans CUsersnameAppDataLocalProgramsGatheringTools selon le systegraveme drsquoexploitation

bull associe lrsquoexeacutecutable Answerexe agrave deux extensions de fichier laquo qstx raquo et laquo checkmail raquo Les fichiers drsquoextension laquo qst raquo (fichiers des versions lt=37) sont associeacutes agrave lrsquoexeacutecutable AnswerLegacyexe

bull inscrit des entreacutees dans la base de registre dans HKLMSoftwareCalameAnswer (lors de lrsquoinstallation avec des droits administrateur) ou HKCUSoftwareCalameAnswer Si une entreacutee existe dans HKCU elle sera consideacutereacutee par Answer en prioriteacute sur lrsquoentreacutee eacutequivalente dans HKLM Ces entreacutees doivent ecirctre preacuteserveacutees entre deux sessions Windows pour un mecircme utilisateur

La configuration de GTAnswer consiste uniquement en

bull Un fichier deacutecrivant les caracteacuteristiques de chaque alias drsquoinstance

bull Les fichiers de certificats clients lorsque des instances ont besoin de certificats clients

bull Lrsquoinscription drsquoAnswer dans lrsquoenvironnement Windows (association de fichiers et inscription dans la base de registre) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

bull La configuration drsquoAnswer (connexion au serveur de messagerie dans le cas drsquoune reacuteponse mail) peut ecirctre reacutealiseacutee en ligne de commande (cf 424)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

50

Pour deacuteployer les fichiers de configuration et les fichiers associeacutes

1) Installer GTAnswer sur une machine drsquoinitialisation (manuellement ou en ligne de commande)

2) Creacuteer agrave partir de GTAnswer les alias dont les utilisateurs auront besoin en testant agrave chaque fois la connexion mais sans conserver le mot de passe Chaque alias correspond agrave un fichier conf dans le reacutepertoire AppDataCalameInstances de lrsquoutilisateur (par deacutefaut CUsers Nom de lrsquoutilisateur AppDataLocalCalameInstances)

3) Copier les fichiers conf creacuteeacutes sur cette machine drsquoinitialisation (ainsi que les fichiers des certificats) vers le reacutepertoire eacutequivalent de la machine sur laquelle agrave configurer pour GTAnswer

422 GTAnswer Installation en ligne de commande

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

Emplacement fichier SetupGatheringToolsexe SetupGatheringToolsexe VERYSILENT

423 Droits neacutecessaires lors de lrsquoinstallation

Le module GTAnswer peut ecirctre installeacute

bull Avec des droits administrateurs (fichiers copieacutes dans Program Files et inscription dans HKLM)

bull Ou avec des droits drsquoutilisateur standard (fichiers copieacutes dans Mes Documents et inscription dans HKCU)

Dans le cas drsquoune installation avec un utilisateur standard GTAnswer sera installeacute dans le profil de lrsquoutilisateur et les associations de fichier seront disponibles uniquement pour cet utilisateur de la machine

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

51

Si GTAnswer est installeacute avec des droits administrateurs il sera installeacute par deacutefaut dans le reacutepertoire des programmes de Windows et les associations de fichiers seront disponibles pour tous les utilisateurs

Dans le contexte geacuteneacuteral du deacuteploiement et de la maintenance si GTAnswer est installeacute avec des droits administrateurs toutes les mises agrave jour drsquoGTAnswer devront ecirctre effectueacutees avec des droits administrateurs

Enfin si GTAnswer est drsquoabord installeacute avec des droits drsquoutilisateur standard puis agrave nouveau avec des droits drsquoadministrateur Lrsquoutilisateur standard de la premiegravere installation continuera agrave utiliser sa propre version de GTAnswer Il est donc tregraves fortement conseilleacute dans le cas drsquoune installation avec droits standards puis droits drsquoadministrateurs de deacutesinstaller GTAnswer du profil de lrsquoutilisateur standard

424 GTAnswer Installation et configuration en ligne de commande

La configuration drsquoAnswer est renseigneacutee dans la base de registre

Les paramegravetres de configuration de GTAnswer via la ligne de commande seront renseigneacutes dans les entreacutees HKCU de la base de registre correspondant agrave lrsquoutilisateur ayant exeacutecuteacute la ligne de commande Si lrsquoinstallation est effectueacutee avec un compte administrateur crsquoest le profil (entreacutees de la base de registre) de ce compte qui sera configureacute

Lrsquoinstallation en ligne de commande est effectueacutee avec la commande suivante

cxxxx SetupGatheringToolsexe VERYSILENT [arguments optionnels]

Les paragraphes suivants deacutecrivent les arguments optionnels suppleacutementaires pour lrsquoinstallation et la configuration Lorsqursquoun argument demande un paramegravetre il est entreacute dans la ligne de commande suivant la syntaxe type Microsoft en preacutefixant par un et en seacuteparant argument et valeur par un caractegravere =

NomArgument=ValeurArgument

4241 Paramegravetres drsquoinstallation

Paramegravetre Description Valeurs Remarques

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

52

TYPE= lsquorsquo Module installeacutersquorsquo

GTAnswer

GTAnswer

GTAnswer + Design

Answer

Manager

Developper

LANG=langue Langue de lrsquoinstallation (lrsquoutilisateur peut changer ce paramegravetre via lrsquointerface de GTAnswer)

fr

en

La langue est choisie par deacutefaut en fonction de la langue du systegraveme

NOICONS Si preacutesent les raccourcis ne sont pas creacuteeacutes

GROUP=nom du

groupe

Groupe drsquoicocircnes du menu deacutemarrer ougrave installer les raccourcis de GTAnswer

LOG=chemin du

fichier de log

drsquoinstallation

Chemin complet du fichier de log drsquoinstallation

SUPPRESSMSGBOXES Pas drsquoaffichage des boites de dialogue

4242 Paramegravetres de mise agrave jour

Commande pour mettre agrave jour GTAnswer sur le poste sans changement de configuration

cxxxx SetupGatheringToolsexe VERYSILENT

Pour rappel GTAnswer devrait ecirctre mis agrave jour avec les mecircmes droits que pour lrsquoinstallation Si GTAnswer a eacuteteacute installeacute avec des droits administrateur il ne pourra ecirctre mis agrave jour qursquoavec des droits administrateurs

4243 Paramegravetres de configuration

La configuration la plus importante concerne le mode de transfert de la reacuteponse

bull Par deacutefaut les reacuteponses aux questionnaires sont transmises par une connexion http (ou si la synchronisation est utiliseacutee) GTAnswer peut ecirctre configureacute pour utiliser un proxy http au besoin

bull Si la reacuteponse aux questionnaires est transmise par mail (connexion de secours) GTAnswer doit configureacute pour se connecter au serveur de messagerie ou au client de messagerie local (cf flux 5212)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

53

43 Reacuteponse Answer par mail vs Reacuteponse http

Il existe deux modes de transmission de la reacuteponse pour Answer

bull Reacuteponse par mail Answer envoie la reacuteponse agrave GTServer dans un mail

bull Reacuteponse http Answer envoie la reacuteponse agrave GTServer via GTWeb dans un flux http

Le tableau suivant reacutesume les avantages et les contraintes de chaque mode

Reacuteponse HTTP Reacuteponse MAIL

Avantages

Configuration de GTAnswer minimale (uniquement les paramegravetres du proxy si diffeacuterents du proxy systegraveme)

Permet la synchronisation de donneacutees la veacuterification de la validiteacute du questionnaire

Ne neacutecessite que lrsquoinfrastructure de mail existante

Contraintes

Copie des scripts GTWeb

Answerexe doit pouvoir ouvrir un flux http vers le serveur GTWeb

Seacutecurisation du serveur Web heacutebergeant GTWeb

Rappel des flux reacuteseaux cf 5211

Connexion POPIMAP de GTServer vers le serveur de messagerie (en sus de la connexion SMTP obligatoire dans tous les cas) Ou installation drsquoun client Outlook ou Notes GTAnswer doit ecirctre configureacute sur chacun des postes de reacutepondants pour dialoguer avec un serveur SMTP ou le client de messagerie local Outlook ou Notes (lrsquoassistant de configuration est geacuteneacuteralement suffisant si un client de messagerie est deacutejagrave configureacute) Rappel des flux reacuteseaux cf 5212

5 Maintenance

Ce chapitre deacutecrit les journaux drsquoexeacutecution et rappelle quelques-unes des opeacuterations de maintenance agrave reacutealiser

51 Journaux drsquoexeacutecution description et preacuteconisations

GTServer inscrit les informations drsquoexeacutecution dans deux types de journaux diffeacuterents

bull des fichiers journaux (situeacutes dans le reacutepertoire des logs de lrsquoapplication)

bull dans les journaux Windows des applications (un journal Windows est creacuteeacute pour chaque instance GTServer lors de lrsquoinstallation du service)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

54

Les informations sont deacuteposeacutees dans les fichiers journaux suivant un cycle Le premier eacutecran de configuration de lrsquoinstance dans GTAdmin permet de deacutefinir le nombre maximum de fichiers journaux ainsi que leur taille lorsqursquoun fichier journal est plein les informations sont deacuteposeacutees dans le fichier journal suivant non existant ou celui qui a eacuteteacute utiliseacute le plus anciennement

Les informations deacuteposeacutees dans chacun des types de journaux sont parameacutetrables pour chaque instance via le dialogue de configuration de lrsquoinstance dans GTAdmin (listes de cases agrave cocher du premier eacutecran)

Description des informations deacuteposeacutees dans les journaux

Libelleacute dans GTAdmin

Description Preacuteconisation pour les jounaux

fichiers

Preacuteconisation pour les journaux Windows

drsquoapplication

Erreurs Messages drsquoerreurs Oui Oui

Avertissements Messages drsquoavertissements Oui Oui

Informations Messages descriptifs geacuteneacuteraux

Oui

Commandes Trace des lancements des process externes

Requecirctes SQL Phrases SQL envoyeacutees agrave la base client

Debug Informations agrave usage de Calame

Temps drsquoexeacutecution

Temps drsquoexeacutecution pour les process externes et certaines opeacuterations internes

Oui

Communications Trace des connexions TCP reccedilues (de la part des clients)

52 Flux reacuteseau Seacutecuriteacute

521 Matrices des flux reacuteseaux

5211 Cas avec GTWeb sans reacuteponse par mail

Le module GTWeb est utiliseacute pour acheminer la reacuteponse depuis le poste des correspondants vers GTServer ou pour la synchronisation des donneacutees (reacutecupeacuteration de

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

55

la derniegravere version des donneacutees depuis Answer) ou pour la veacuterification http ou pour la diffusion http

Aucune reacuteponse nrsquoest transmise par mail

Destination

Ports par deacutefaut 80 aucun 3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

source

GTWeb

Serveur(s) de

messagerie pour

GTAnswer

GTServer Base de Donneacutees client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTWeb

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTAnswer en http (ou client

Automatisation)

http ou https Proxy possible (auth basic digest)

GTAnswer en TCPIP

(ou client Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

via le client NET de base de donneacutees sur le poste GTServer (OLE DB ou client NET direct)

SMTP (+SSLTLS)

5212 Cas sans GTWeb avec reacuteponse par mail (connexion de secours)

Le module GTWeb nrsquoest pas utiliseacute ni pour la reacuteponse par mail ni pour la synchronisation ni pour la veacuterification http ni pour la diffusion http (diffusion drsquourl drsquoaccegraves aux qstx)

Si le module GTWeb est utiliseacute pour la synchronisation ou pour le transfert de la reacuteponse par certains correspondants (dans le cas drsquoenvironnements non homogegravene) cette matrice peut ecirctre superposeacutee avec la matrice preacuteceacutedente

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

56

Destination

Ports par deacutefaut 80

25 ou 465 (SMTP)

ou aucun (client

messagerie)

3000 Suivant SGBD Suivant SGBD

25 ou 465 (SMTP)

+ 110 ou 995

(POP) ou 143 ou 995

(IMAP) ou aucun autre

(client messagerie)

source

GTWeb

Serveur(s) de messagerie

pour GTAnswer

GTServer Base de Donneacutees

client

Base de Donneacutees GT

Serveur de messagerie

pour GTServer

GTAnswer

SMTP (+SSLTLS) OU utilisation du client de messagerie Outlook ou Notes (si client utiliseacute aucun accegraves direct par Answer)

GTWeb

GTAnswer (ou client

Automatisation)

TCPIP (+SSLTLS) protocole proprieacutetaire pour la couche application (OSI)

GTServer

via le client de BD sur le poste GTServer (OLE DB ou client NET)

via le client de BD sur le poste GTServer (OLE DB ou client NET)

SMTP (+SSLTLS) dans tous les cas

+ POP (+SSLTLS) OU IMAP (+SSLTLS) OU passage par le client de messagerie Outlook ou Notes (si client utiliseacute seul accegraves en SMTP par GTServer)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

57

522 Seacutecurisation des flux

5221 Accegraves entrants vers les modules GT

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

58

Via modules GT Hors modules GT

Flux (Src-gtDest)

Cryptage flux Restriction accegraves Cryptage Restriction accegraves

GTAnswer

-gt

GTWeb

Via http

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

GTAnswer

-gt

GTServer

Via TCPIP

-Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTServer et GTAnswer)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTWeb

-gt

GTServer

- Certificat serveur par instance (via onglet seacutecuriteacute de GTAdmin)

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et GTWeb)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

Automatisation

-gt

GTServer

Idem GTAnswer -gtGTServer

- Mots de passe forts pour les utilisateurs GT (via contraintes de mots de passe)

- Veacuterification des certificats clients (via GTserver et applicationscript utilisant automatisation)

Outils de cryptage de connexion (VPN etchellip)

Restriction IP autoriseacutees sur serveur GTServer

GTAnswer

-gt

GTWeb

- HTTPS pour lrsquourl de GTWeb (configuration sur serveur Web)

- Restriction IP autoriseacutees sur serveur Web heacutebergeant GTWeb

- Reverse proxy avant GTWeb

- Restriction par mot de passe sur le script indexphp de GTWeb (du type htaccess authentification BASIC et DIGEST la source peut ecirctre un fichier texte un annuaire LDAP une base de donneacutees)

Notes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

59

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

bull GTServer pour ses clients La configuration est reacutealiseacutee via GTServer en installant le certificat puis en speacutecifiant dans le client que le type de chiffrement et optionnellement le certificat client si GTServer veacuterifie les certificats clients

5222 Accegraves entrants vers les modules hors GT

Via modules GT Hors modules GT

Flux (Src-gtDest) Cryptage flux Restriction accegraves

Cryptage Restriction accegraves

GTServer

-gt

Bases de donneacutees

- Certificat serveur et configuration client de base de donneacutees

- Restriction IP autoriseacutees sur serveur de bases de donneacutees

- Mot de passe fort pour compte drsquoaccegraves agrave la base de donneacutees

- Restrictions du compte GT aux seules bases repository et client

GTServer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie et pour compte mail deacutedieacute GTServer

GTAnswer

-gt

Serveur de messagerie

- configuration de la connexion au serveur de messagerie

SSLTLS sur le serveur de messagerie

- Restriction IP autoriseacutees sur serveur de messagerie si connexion directe au serveur de messagerie par Answer

Notes

bull Les modes de seacutecurisation hors modules GT ne sont donneacutees qursquoagrave titre indicatif

523 Authentification agrave partir du module GTAnswer

2 cas se preacutesentent

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

60

bull Si lrsquoutilisateur dispose drsquoun compte alors il utilise lrsquoauthentification proprieacutetaire GT bull Si lrsquoutilisateur ne dispose pas drsquoun compte alors il recevra des documents GT

(extension qstx) agrave remplir Lors de lrsquoouverture des documents 3 modes drsquoauthentificationidentification peuvent ecirctre utiliseacutes

o La validation drsquoadresse mail (process speacutecifique GT)

o Lrsquoauthentification dans lrsquoActive Directory du correspondant Answer

o Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par Answer

Ces modes drsquoauthentificationidentification peuvent ecirctre cumuleacutes

5231 Descriptions

bull La validation drsquoadresse mail (process speacutecifique GT)

Lorsque le questionnaire demande la validation drsquoadresse mail GTAnswer va demander au correspondant agrave configurer son adresse mail et va envoyer un mail agrave cette adresse avec une piegravece jointe drsquoextension checkmail (celle-ci contient une information crypteacutee concernant lrsquoadresse mail et le profil utilisateur source lrsquoextension checkmail est associeacutee agrave GTAnswer lors de lrsquoinstallation) cette piegravece jointe devra ecirctre ouverte par le correspondant de cette faccedilon GTAnswer srsquoassure que lrsquoutilisateur Windows a bien accegraves agrave lrsquoadresse mail speacutecifieacutee dans la configuration GTAnswer

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail valideacutee et du contenu du questionnaire

bull Lrsquoauthentification dans lrsquoActive Directory du correspondant

A lrsquoouverture drsquoun questionnaire demandant lrsquoauthentification dans lrsquoAD (option de lrsquoaction de lancement de campagne) GTAnswer va demander agrave lrsquoutilisateur drsquoentrer le mot de passe de la session Windows active (ou le mot de passe du compte Windows associeacute agrave lrsquoadresse mail du correspondant initial du questionnaire) Une option permet de veacuterifier que lrsquoadresse mail associeacutee dans lrsquoAD au compte Windows de la session active soit la mecircme que lrsquoadresse mail du destinataire initial du questionnaire (lors de lrsquoenvoi par GTServer)

Des contraintes peuvent ecirctre construites dans le questionnaire pour interdire la transmission de la reacuteponse (ou bloquer certaines cellules de saisie) en fonction de lrsquoadresse mail de lrsquoAD (lue dans lrsquoActive Directory pour la session Windows active) et du contenu du questionnaire

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

61

bull Lrsquoauthentification http lors de lrsquoaccegraves agrave GTWeb par GTAnswer

Lrsquoaccegraves au site Web peut ecirctre proteacutegeacute par une authentification http (deacutefinie dans la configuration du site Web hors modules GT) Les deux modes BASIC et DIGEST sont autoriseacutes pour lrsquoauthentification http

La source de lrsquoauthentification peut ecirctre un fichier texte une base de donneacutees un annuaire LDAP ou toute autre source compatible avec votre serveur Web

Lors de tout accegraves GTAnswer vers GTWeb (notamment pour la veacuterification http la synchronisation ou la transmission de la reacuteponse) lrsquoauthentification http sera mise en œuvre Les informations drsquoauthentification (login et mot de passe) seront demandeacutees agrave lrsquoutilisateur dans une boicircte de dialogue (de la mecircme maniegravere que si lrsquourl eacutetait acceacutedeacutee via un navigateur) Au cours de la mecircme session GTAnswer cette authentification ne sera pas redemandeacutee

Ce mode drsquoauthentification permet de limiter lrsquoaccegraves agrave lrsquoouverture (via lrsquooption Veacuterification http) agrave la synchronisation ou au transfert de la reacuteponse

Ce mode ne permet pas de limiter la transmission de la reacuteponse (ou lrsquoouverture ou la synchronisation) ou lrsquoaccegraves agrave certaines cellules de saisie en fonction du contenu du questionnaire et du login pour cette authentification

5232 Tableau reacutecapitulatif

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

62

Mode Activation Blocage Remarques

Validation drsquoadresse mail

(speacutecifique Calame

Option du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Plus une identification qursquoune authentification

Nrsquoempecircche pas lrsquoouverture du questionnaire

Authentification dans lrsquoActive Directory du

correspondant

Option de lrsquoaction de lancement de campagne

Bloque lrsquoouverture du questionnaire

Peut bloquer la transmission de la reacuteponse (ou certaines cellules de saisie) en fonction du contenu du questionnaire

Requiert lrsquoexistence drsquoun AD

Requiert que les adresses mails de lrsquoAD soient correctes pour un blocage en fonction du contenu des questionnaires drsquoune instance

Dans les 2 sous-modes ougrave lrsquoouverture du questionnaire est limiteacutee aux comptes associeacutes agrave lrsquoadresse mail du destinataire initial la transmission du questionnaire agrave un tiers nrsquoest possible qursquoaux personnes pouvant se connecter aux comptes citeacutes preacuteceacutedemment

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

63

Authentification http pour

lrsquoaccegraves agrave GTWeb

Configuration du site Web et de lrsquoaccegraves aux script de GTWeb

+ options Veacuterification http Synchronisation http ou Reacuteponse http de lrsquoaction de lancement de campagne

Peut bloquer lrsquoouverture du questionnaire (en utilisant lrsquooption Veacuterification http) etou la synchronisation etou la transmission de la reacuteponse http

Requiert hors suite GT de configurer le site Web pour acceacuteder agrave un annuaire des personnes autoriseacutees globalement pour lrsquoinstance GT

Ne permet pas de limiter lrsquoaccegraves en fonction du contenu du questionnaire

Aucun mode ne permet drsquointerdire lrsquoouverture du questionnaire en fonction des informations drsquoauthentification et drsquoun contenu dynamique du questionnaire Seules les informations drsquoauthentification et lrsquoadresse mail initiale du correspondant (utiliseacute par lrsquoenvoi par GTServer) peuvent restreindre lrsquoouverture dans le cas de lrsquoauthentification via lrsquoAD et dans ce cas la transmission du questionnaire agrave une tierce personne ne sera pas possible

524 Rappels seacutecurisation de GTWeb

Il est fortement conseilleacute de configurer le serveur Web heacutebergeant GTWeb pour imposer une connexion seacutecuriseacutee https A fortiori si le serveur GTWeb est utiliseacute pour dialoguer avec des correspondants en dehors du reacuteseau intranet laquo proteacutegeacute raquo de lrsquoentreprise

Lrsquoinstance GTServer devra ecirctre configureacute (via lrsquoonglet laquo Messagerie raquo de GTAdmin) avec cette nouvelle url utilisant le protocole https

Si vous souhaitez seacutecuriser le transfert de la reacuteponse par GTAnswer utilisez la reacuteponse http(s) plutocirct que la reacuteponse par mail (agrave configurer dans lrsquoaction de lancement) avec une url GTWeb utilisant le protocole https (dans lrsquoonglet Messagerie de lrsquoinstance GTServer via GTAdmin)

Lrsquoinstallation drsquoun serveur Web suppleacutementaire utiliseacute comme reverse proxy pour le serveur Web heacutebergeant GTWeb pourra ecirctre une bonne pratique permettant de filtrer les connexions avant qursquoelles ne parviennent au serveur GTWeb si les correspondants se trouvent en-dehors du reacuteseau intranet de lrsquoentreprise

Lorsque lrsquourl GTWeb est accessible agrave un grand nombre il est impeacuteratif que les mots de passe des utilisateurs GT soient des mots de passe forts pour eacuteviter les accegraves non deacutesireacutes aux donneacutees GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

64

525 Restriction drsquoaccegraves au questionnaire

Le concepteur drsquoactions peut demander agrave ce que lrsquoaccegraves aux questionnaires soit restreint par une authentification dans Active Directory (avec veacuterification ou non de lrsquoadresse mail speacutecifieacutee dans lrsquoAD en concordance avec lrsquoadresse mail du destinataire du questionnaire)

Lorsque le module GTAnswer ouvre le questionnaire sur le poste du correspondant ce dernier devra speacutecifier login et mot de passe pour srsquoauthentifier dans lrsquoAD avec veacuterification ou non de son adresse mail inscrite dans lrsquoAD suivant les options choisies dans lrsquoaction de lancement des questionnaires

53 Surveillance

531 Service GTServer

A effectuer pour chacun des services GTServer en fonctionnement sur le serveur

bull Veacuterifier que le service GTServer est deacutemarreacute

bull Veacuterifier que le service GTServer peut acceacuteder aux bases de donneacutees base GT et base client (un test peut ecirctre effectueacute via GTAdmin en se connectant avec le compte de service avec le bouton Tester dans chacun des onglets Base GT et Base client)

bull Veacuterfier que le service GTServer peut dialoguer avec la messagerie pour lrsquoenvoi (un test peut ecirctre effectueacute en utilisant le bouton Tester de la configuration drsquoenvoi dans lrsquoonglet Messagerie de GTAdmin) et peut dialoguer avec la messagerie pour la reacuteception (en utilisant le bouton Tester de la configuration de reacuteception dans lrsquoonglet Messagerie de GTAdmin)

bull Veacuterifier la connexion clientserveur en se connectant avec le module GTAnswer agrave partir drsquoune autre machine que le serveur

bull Veacuterifier le journal Windows du service (preacutesence drsquoentreacutee de type erreur)

bull Veacuterifier le journal drsquoexeacutecution fichier du service (preacutesence drsquoentreacutee de type [ERR] ou [WARN])

bull Lancer via lrsquoautomatisation les tacircches de lancement de polling lancement de campagne action drsquoexeacutecution SQL et lancement de restitution fournies dans le jeu de tests de lrsquoinstance Des scripts powershell exemple sont fournis Ces scripts doivent ecirctre reconfigureacutes (cf commentaires dans les scripts) pour se connecter agrave lrsquoinstance GTServer dont vous voulez vous assurer le fonctionnement Attention dans le cas drsquoexeacutecutions reacutepeacuteteacutees des actions de lancement de campagne et de restitution des mails sont envoyeacutes agrave une adresse mail ces mails devraient ecirctre purgeacutes de la boicircte de mail destinatrice

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

65

bull Lancer via lrsquoautomatisation le script de polling agrave partir drsquoune autre machine que le serveur pour veacuterifier le dialogue clientserveur GTAnswer doit ecirctre installeacute sur la machine cliente pour pouvoir utiliser lrsquoassembly drsquoautomatisation

Remarque le dialogue avec lrsquoassembly NET drsquoautomatisation (via des scripts Powershell ou tout programme NET) requiert une licence drsquoautomatisation deacuteclareacutee dans la licence de lrsquoinstance GTServer

532 Service du serveur Web heacutebergeant GTWeb

La surveillance de ce module ne devrait ecirctre mise en place que si le module GTWeb est installeacute et utiliseacute (pour la transmission des reacuteponses pour la synchronisation pour la transmission du SetupAnswer et pour la communication entre GTserver et GTAnswer)

bull Veacuterifier le deacutemarrage du service de votre serveur Web

bull Veacuterifier lrsquoaccegraves agrave laquo lrsquourl de publication raquo du service Cette url est speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin et vous donne accegraves via un navigateur internet agrave lrsquointerface Web client de GTServer Cette url est sensible agrave la casse

54 Sauvegardes

541 Sauvegarde des objets GTServer

Les modegraveles ainsi que les actions et messages lieacutes agrave ce modegravele peuvent ecirctre sauvegardeacutes via un export dans GTAnswer

Lancer GTAnswer

Se connecter agrave lrsquoinstance avec un compte disposant au moins des droits de deacuteveloppeur

Dans le menu principal choisir la commande laquo Export raquo

Speacutecifier le fichier drsquoexport

Choisir les modegraveles et les actions agrave exporter

Valider lrsquoexport

Un import de ce fichier gtexport dans une instance GTServer peut ecirctre reacutealiseacute pour recreacuteer les modegraveles de documents ainsi que les actions et messages lieacutes agrave ces modegraveles

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

66

542 Sauvegarde de la base de donneacutees GTServer et de la base client

Ces deux bases doivent ecirctre sauvegardeacutees par lrsquoeacutequipe de gestion des serveurs de bases de donneacutees de lrsquoentreprise

Note importante sur la restauration Une restauration de la base GT va restaurer lrsquoeacutetat de lrsquoinformation du service GTServer au moment de la sauvegarde Toutes les actions effectueacutees depuis cette sauvegarde devront ecirctre accomplies agrave nouveau si le service GTServer a deacutejagrave accompli ces actions transmission drsquoune reacuteponse avec GTAnswer lancement drsquoune campagne relance etchellip De la mecircme faccedilon les reacuteponses transmises par mail ou GTWeb et deacutejagrave laquo consommeacutees raquo par lrsquoinstance GT devront ecirctre renvoyeacutees

Dans le cas drsquoune base GT sous Firebird la base Firebird est un fichier repofdb dans le reacutepertoire de lrsquoinstance Afin drsquoeffectuer une sauvegarde de la base crsquoest ce fichier qui devra ecirctre sauvegardeacute avec le service de lrsquoinstance correspondante arrecircteacute

Dans le cas drsquoune base GT sous SQL Server la sauvegarde ne doit pas ecirctre reacutealiseacutee sous la forme drsquoun script SQL

55 Gestion des changements

551 Ajouter un utilisateur

3 solutions

bull Lancer GTAdmin sur le serveur dans lrsquoonglet laquo Base GT raquo cliquer sur le bouton laquo Utilisateurs raquo puis Ajouter ou supprimer les utilisateurs Si la base GT est une base Firebird embarqueacute il peut ecirctre neacutecessaire drsquoarrecircter au preacutealable le servie de lrsquoinstance

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles

bull Si lrsquoutilisateur agrave ajouter ne doit disposer que des droits de reacutepondants il est possible drsquoutiliser lrsquoaction de creacuteation de compte Cette action permet de creacuteer automatiquement des comptes utilisateurs en se basant sur des donneacutees provenant drsquoune table ou drsquoune vue de la base client

552 Modifier les droits de lrsquoutilisateur

bull Lancer GTAnswer en se connectant avec un utilisateur ayant le privilegravege Administrateur Le bouton laquo Geacuterer les utilisateurs raquo permet de modifierajoutersupprimer les utilisateurs et leur attribuer des droits sur les modegraveles en associant agrave chaque utilisateur et chaque modegravele un ou plusieurs groupes de droits

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

67

553 Changer le mot de passe drsquoun utilisateur

GTServer ne stockant pas les mots de passe mais seulement un hash de ceux-ci il nrsquoest pas possible de retrouver le mot de passe oublieacute drsquoun utilisateur il est neacutecessaire de se connecter avec GTAnswer en tant qursquoadministrateur GT (ou drsquoacceacuteder agrave GTAdmin sur le serveur) pour redeacutefinir un mot de passe

Si lrsquoinstance a eacuteteacute configureacutee pour laquo Activer la reacutecupeacuteration de mots de passe oublieacutes raquo (onglet laquo Seacutecuriteacute raquo de GTAdmin) lrsquoutilisateur peut lui-mecircme demander via GTAnswer agrave ce que GTServer reacuteinitialise son mot de passe (commande laquo Mot de passe oublieacute raquo dans le bouton de parameacutetrage sur lrsquoeacutecran de connexion) Lrsquoutilisateur GT doit pour ce faire avoir une adresse mail associeacutee agrave son compte (lrsquoadresse mail drsquoun utilisateur GT est deacutefinie par un administrateur GT) Il lui sera demandeacute lors de la reacuteinitialisation de speacutecifier son login ainsi que lrsquoadresse mail associeacutee agrave son login (qui sera veacuterifieacutee par GTServer pour srsquoassurer que la reacuteinitialisation puisse avoir lieu)

Il est possible drsquoimposer des contraintes aux mots de passe en activant lrsquooption correspondante dans lrsquoonglet laquo Seacutecuriteacute raquo de lrsquoinstance dans GTAdmin

554 Modifier la configuration drsquoune instance

bull Se connecter en utilisant le compte du service GTServer

bull Arrecircter le service de lrsquoinstance pour laquelle une modification doit ecirctre effectueacutee

bull Modifier la configuration de lrsquoinstance Si la modification porte sur des connexions aux bases de donneacutees au serveur de messagerie (envoi ou reacuteception) utiliser les boutons laquo Tester raquo correspondants Si la modification porte sur lrsquourl de publication tester lrsquourl de publication dans un navigateur

bull Une fois toutes les opeacuterations de tests effectueacutees enregistrer la configuration via le menu Fichier Tant que la configuration nrsquoest pas enregistreacutee vous pouvez recharger la configuration actuellement enregistreacutee en utilisant la commande laquo Recharger la configuration de lrsquoinstance xxx raquo du menu Fichier de GTAdmin

555 Modifier la cleacute de licence de GTServer et affecter les instances

La cleacute de licence de GTServer peut ecirctre modifieacutee via GTAdmin

Si vous avez plusieurs instances en fonctionnement sur le mecircme serveur notez les affectations des instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstances de la cleacute

La proceacutedure de modification de la cleacute est deacutecrite au sect 3122

Une fois la cleacute de licence installeacutee il vous faut affecter les instances deacuteclareacutees dans GTAdmin aux numeacuteros drsquoinstance de la cleacute La proceacutedure est deacutecrite au sect 3124

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

68

Une modification du nombre drsquoutilisateurs autoriseacutes (deacuteveloppeurs gestionnaires valideurs) pour une instance demande une modification de la cleacute de licence

556 Supprimer une instance

- Arrecircter le service de lrsquoinstance

- Le service de lrsquoinstance devrait ecirctre deacutesinstalleacute (seacutelectionner lrsquoinstance et choisir Deacutesinstaller le service via le clic droit)

- La base GT peut ecirctre supprimeacutee

- Le compte mail de lrsquoinstance peut ecirctre supprimeacute srsquoil nrsquoest pas utiliseacute pour drsquoautres besoins

- La base client peut ecirctre supprimeacutee si elle nrsquoest pas utiliseacutee pour drsquoautres besoins

- Seacutelectionner lrsquoinstance puis supprimer lrsquoinstance via la commande laquo Supprimer lrsquoinstance xxx raquo du menu Fichier

- Le reacutepertoire de lrsquoinstance peut ecirctre supprimeacute ainsi que tous les reacutepertoires speacutecifieacutes dans lrsquoinstance srsquoils ne sont pas utiliseacutes agrave drsquoautres fins

557 Ajouter une instance

Suivre le sect 313 en veacuterifiant au preacutealable les preacuterequis (cf 21)

56 Gestion des incidents

561 Geacuteneacuteraliteacutes

Vous pouvez obtenir plus drsquoinformations sur les erreurs en effectuant les opeacuterations suivantes

- Parcourir lrsquohistorique drsquoexeacutecution des actions de GTAnswer (Menu principal Historique des actions)

- Parcourir les fichiers de logs de GTServer

- Parcourir le journal Windows du service

Les fichiers de logs sont situeacutes dans le sous-reacutepertoire Log du reacutepertoire de lrsquoinstance (cf 3131) Les fichiers de logs sont reacuteutiliseacutes (logs laquo circulaires raquo) il faut donc les trier par date de modification pour repeacuterer les derniers laquo en date raquo

Si aucun fichier de log nrsquoest eacutecrit dans le reacutepertoire veacuterifier les droits de lectureeacutecriture du compte de service sur ce reacutepertoire et les autres reacutepertoires de lrsquoinstance (cf21 et 3131)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

69

Via GTAdmin dans le premier panneau de configuration de lrsquoinstance vous pouvez speacutecifier les informations inscrites dans les fichiers de log de GTServer et les journaux drsquoeacutevegravenements Windows

Les opeacuterations de surveillance devraient ecirctre reacutealiseacutees au preacutealable afin de veacuterifier le bon fonctionnement du systegraveme

562 Impossible de deacutemarrer le service GTServer

- Veacuterifier la date de validiteacute de la cleacute de licence

- Veacuterifier que lrsquoinstance associeacutee au service est affecteacutee agrave un numeacutero drsquoinstance valide de la cleacute de licence

- Veacuterifier le nombre drsquoutilisateurs deacutefini dans lrsquoinstance en comparaison du nombre drsquoutilisateurs deacutefini dans lrsquoinstance (deacutefinition des utilisateurs via le bouton Utilisateurs de lrsquoonglet Base GT de GTAdmin)

563 Si GTServer ne peut recevoir les reacuteponses aux questionnaires ou se connecter au serveur de messagerie pour lrsquoenvoi ou le polling

bull Tester dans GTAdmin chacune des connexions avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception)

bull Veacuterifier qursquoun firewall (ou un firewall dans un antivirus) ou tout autre logiciel ne protegravege les accegraves au serveur de messagerie pour lrsquoenvoi et pour la reacuteceptionpolling Tester les ouvertures de ports avec un outil comme telnet

bull Tester les accegraves agrave la messagerie en utilisant un autre client de messagerie agrave partir du mecircme poste

bull Dans le cas drsquoune connexion vers Exchange (via Outlook) ou Notes veacuterifier qursquoen se connectant avec le compte Windows sous lequel le service GTServer est lanceacute le lancement des clients locaux comme Outlook ou Notes est possible ainsi que la visualisation des mails de la boicircte mail deacutedieacutee agrave GTServer dans le client Outlook et Notes

564 Si une reacuteponse GTAnswer ne peut ecirctre transmise ou nrsquoest pas reccedilue par GTServer

bull Veacuterifier que la campagne nrsquoest pas fermeacutee et que le questionnaire nrsquoest pas fermeacute Veacuterifier les reacuteponses refuseacutees Une campagne ayant des reacuteponses refuseacutees apparaicirct avec un lisereacute rouge dans la liste des campagnes

bull Veacuterifier les logs de polling via GTAnswer (ou les fichiers de logs de polling dans le sous-reacutepertoire Polling de lrsquoinstance sur le serveur)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

70

bull Veacuterifier que le questionnaire nrsquoest pas trop volumineux Faire un test en supprimant les piegraveces jointes volumineuses que la reacuteponse soit envoyeacutee par mail ou via GTWeb (reacuteponse http)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

71

5641 Si les reacuteponses sont effectueacutees par mail (connexion de secours)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Envoyer un mail de validation avec GTAnswer (sur le poste du correspondant de maniegravere agrave srsquoassurer que GTAnswer peut dialoguer avec le serveur de messagerie

bull GTAnswer dialoguera directement avec le serveur de messagerie srsquoil est configureacute en SMTP Veacuterifier dans le cas drsquoune connexion SMTP que GTAnswer nrsquoest pas bloqueacute par un pare-feu ou un autre programme limitant les accegraves

bull GTAnswer dialoguera avec le client de messagerie installeacute sur le poste du correspondant srsquoil est configureacute en Notes (ou VIM) ou Outlook Dans certains cas de dialogue incorrect avec le client de messagerie (notamment Outlook) la reacuteinstallation du client de messagerie est neacutecessaire

bull Tester les paramegravetres de connexion au serveur de messagerie dans un client de messagerie ou mieux dans un outil externe (console etchellip preacutefeacuterentiellement non whitelisteacute par le pare-feu)

bull Si GTAnswer ne legraveve pas de message drsquoerreur mais que le mail ne parvient pas au serveur essayer drsquoenvoyer via un client messagerie un mail agrave ladresse de consolidation du serveur Si les paramegravetres de connexion drsquoAnswer sont diffeacuterents de celui du client essayer drsquoenvoyer un mail au client de messagerie en configurant un compte avec les mecircmes paramegravetres SMTP que ceux speacutecifieacutes dans Answer

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai de reacuteponse avec moins de donneacutees ou des piegraveces jointes moins volumineuses Essayer drsquoenvoyer le fichier qstx par mail agrave la messagerie pour reacutealiser un test de volumeacutetrie Le serveur de messagerie doit accepter des reacuteponses avec des piegraveces jointes drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant Si cela nrsquoest pas possible utiliser la reacuteponse http

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier qursquoun ou des mails dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo et marqueacutes en non lu (surtout pour des connexions MAPI ou Notes) ne se trouve(nt) pas dans la boicircte de mails deacutedieacutee agrave GTServer (ces mails correspondent agrave des reacuteponses GTAnswer) La boicircte de mail agrave scruter est celle de lrsquoadresse de consolidation speacutecifieacutee dans lrsquoonglet Messagerie de GTAdmin

bull Apregraves avoir arrecircteacute le service GTServer de lrsquoinstance veacuterifier en reacutepondant avec Answer sur le poste du correspondant qursquoun mail dont lrsquoobjet commence par laquo Gathering Tools Answer Environment raquo parvient bien dans la boicircte de mails deacutedieacutee agrave GTServer (ce mail correspond agrave un mail de reacuteponse GTAnswer) Si ce nrsquoest pas le cas un outil interne agrave lrsquoinfrastructure informatique de lrsquoentreprise a probablement intercepteacute ou modifieacute le mail (antivirus anti-spam etchellip)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

72

5642 Si les reacuteponses sont effectueacutees en http

Ces veacuterifications devraient eacutegalement ecirctre effectueacutees dans les autres cas de communication de GTAnswer avec le serveur Web (Synchronisation laquo Veacuterification http raquo hellip)

Veacuterification cocircteacute GTAnswer (correspondant)

bull Veacuterifier les messages drsquoerreurs exprimeacutes dans le log de GTAnswer une erreur devrait se preacutesenter dans GTAnswer lors de la transmission de la reacuteponse ou dans le log de polling de GTServer

bull Lrsquoaccegraves de GTAnswer agrave lrsquourl de GTWeb peut ecirctre bloqueacute par un pare-feu (ou un antivirus inteacutegrant un pare-feu) Veacuterifier lrsquoaccegraves agrave lrsquourl dans un navigateur sur le poste du correspondant utilisant GTAnswer la page web afficheacutee est la page contenant un logo Gathering Tools Si vous arrivez agrave une quelconque autre page lrsquourl speacutecifieacutee est incorrecte

bull De faccedilon agrave veacuterifier qursquoun pare-feu nrsquoa pas bloqueacute lrsquoaccegraves de GTAnswer agrave lrsquourl GTWeb tester lrsquourl GTWeb agrave partir du poste client dans navigateur ou mieux dans un outil console http (preacutefeacuterentiellement non whitelisteacute par un pare-feu par exemple un port de wget sous windows)

bull Veacuterifiez que lrsquourl de teacuteleacutechargement du SetupGatheringToolsexe (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe (Le setup doit ecirctre placeacute dans le reacutepertoire public du site Web)

httpsurl_base_GTWebSetupGatheringToolsexe

bull Essayer de changer lrsquoaccegraves proxy speacutecifieacute par GTAnswer (options avanceacutees de GTAnswer choisir laquo Pas de proxy raquo laquo Lire les paramegravetres proxy du systegraveme raquo ou Personnaliseacute avec serveur speacutecifique de proxy et port agrave preacuteciser) Les meacutethodes drsquoauthentification au proxy geacutereacutees par Answer sont laquo Basic raquo et laquo Digest raquo en version 2020

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

73

bull Si le questionnaire est volumineux (plus de 1 Mo) faire un essai drsquoenvoi de reacuteponse avec moins de donneacutees dans le questionnaire ou des piegraveces jointes moins volumineuses Configurer le serveur Web PHP pour accepter des documents drsquoune taille eacutequivalente agrave celle du fichier qstx contenant la reacuteponse du correspondant (cf sect 575)

Veacuterification cocircteacute GTWeb (serveur Web)

bull Veacuterifier que les tests preacutealables de fonctionnement du serveur Web heacutebergeant les scripts GTWeb sont effectueacutes avec succegraves (cf 3212)

bull Veacuterifier que lrsquourl de teacuteleacutechargement du SetupGatheringTools (ou SetupGatheringTools64exe) est opeacuterationnelle cette url se construit en prenant lrsquourl de base de GTWeb et en ajoutant SetupGatheringToolsexe ou SetupGatheringTools64exe

httpsurl_base_GTWebSetupGatheringToolsexe

Cette opeacuteration permet de tester le dialogue entre GTWeb et GTServer (en plus de lrsquoaccegraves agrave lrsquourl)

bull Veacuterifier les logs Apache ou IIS pour le site web heacutebergeant les scripts GTWeb

bull Veacuterifiez les logs PHP pour le site web heacutebergeant les scripts GTWeb

bull Si lrsquoaccegraves au serveur GTWeb est impossible via le navigateur veacuterifiez le port de votre serveur GTWeb

Pour savoir quel port TCP ou UDP est utiliseacute par une application Cliquer sur Deacutemarrer Exeacutecuter puis tapez cmd et cliquer sur OK pour ouvrir une console DOS Sous linviteacute de commande Dos taper netstat -a ceci affichera la liste complegravete des connexions actives et des ports en eacutecoute sur la machine

Veacuterification cocircteacute GTServer (serveur)

bull Veacuterifier que lrsquourl speacutecifieacutee dans GTAdmin soit correcte Pour ce faire sur le poste du serveur GTWeb cliquer sur le bouton laquo hellip raquo agrave droite de lrsquourl speacutecifieacutee dans GTAdmin le navigateur est alors lanceacute la page web afficheacute doit contenir les messages laquo ok raquo Vous pouvez aussi entrer cette url dans votre navigateur pour cette veacuterification

bull Veacuterifier les messages drsquoerreur exprimeacutes dans les logs de GTServer

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

74

565 Si vous ne pouvez acceacuteder au serveur Web ou reacutepondre au questionnaire par http ou synchroniser (via le serveur web)

Le sect 5642 contient les points pouvant ecirctre veacuterifieacutes

566 Si des reacuteponses tombent en Failed lors drsquoun polling

Veacuterifier que le compte acceacutedant agrave la base GT a les droits suffisants pour eacutecrire des donneacutees dans la base

Veacuterifier que la base GT nrsquoest pas limiteacute par des quotas ou autres

Veacuterifier les messages drsquoerreurs produits dans les logs fichiers ou journaux Windows

Relancer un polling apregraves avoir corrigeacute les eacuteventuelles erreurs

Si des reacuteponses continuent agrave rester en Failed Les fichiers correspondant (mentionneacutes dans les journaux fichier ou journaux Windows) peuvent ecirctre deacuteplaceacutes pour ecirctre transmis au support Calame (supportgathering-toolscom)

567 Si GTServer ne peut se connecter agrave la base de donneacutees GTServer ou agrave la base client

bull Tester dans GTAdmin chacune des connexions avec la base GT avec la base client et avec le serveur de messagerie (configurations de messagerie pour lrsquoenvoi et pour le pollingreacuteception) Pour effectuer ces tests GTAdmin doit ecirctre lanceacute avec le compte du service GTServer

bull Veacuterifier les droits des utilisateurs speacutecifieacutes pour chacune des connexions agrave la base GTServer ou la base client Tester ces droits en utilisant un autre client de base de donneacutees agrave partir du mecircme poste

bull Veacuterifier qursquoun pare-feu ne bloque pas lrsquoaccegraves aux serveurs de base de donneacutees

568 Si GTAnswer ne peut se connecter agrave GTServer

bull Veacuterifier qursquoagrave partir du poste client on peut ouvrir le port de lrsquoinstance sur le serveur La veacuterification des ouvertures de ports peut ecirctre reacutealiseacutee avec un outil comme Telnet (avec telnet une connexion reacuteussie avec GTServer affichera une page vierge dans la telnet un eacutechec de connexion affichera un message drsquoerreur)

Si GTAnswer geacutenegravere un timeout vous pouvez modifier les timeout de GTAnswer via le menu principal -gt Answer Preacutefeacuterences

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

75

Les modifications des paramegravetres ReadTimeOut et WriteTimeOut configureacutes dans lrsquoinstance GTServer peuvent eacutegalement ecirctre utiles si crsquoest GTServer qui geacutenegravere des timeout

Ne pas oublier dans GTAdmin drsquoenregistrer la configuration (Fichier-gtEnregistrer la configuration de lrsquoinstance) avant de lancer le service GTServer lorsque des modifications de parameacutetrage ont eacuteteacute effectueacutees

569 Si une erreur externe srsquoest produite lors de lrsquoexeacutecution drsquoune action (lancementinteacutegrationrestitution)

Tous les accegraves du service GTServer aux deux bases de donneacutees (base GT et base Client) sont enfermeacutes dans des transactions qui ne sont laquo committeacutees raquo que lorsque toutes les opeacuterations se sont deacuterouleacutees correctement

Si une erreur quelconque se produit lors de lrsquoaccegraves aux donneacutees GTServer demande un rollback au serveur de base de donneacutees

Si une erreur se produit avant le commit interrompant la connexion avec la base les modifications des donneacutees demandeacutees par GTServer qui sont enfermeacutees dans des transactions de base ne seront pas prises en compte

Ainsi si lrsquoexeacutecution drsquoune action drsquointeacutegration ou drsquoune action SQL est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis

Si les opeacuterations de GTServer avec la base de donneacutees sont interrompues il nrsquoen est pas de mecircme pour les opeacuterations avec le serveur de messagerie pour lequel lrsquoeacutequivalent drsquoune transaction de base de donneacutees nrsquoexiste pas

Si une action de lancement de campagne ou de restitution est interrompue alors que les mails sont partiellement ou totalement envoyeacutes ces envois ne pourront ecirctre annuleacutes

Ainsi si lrsquoexeacutecution drsquoune action de lancement de campagne ou de restitution est interrompue par une erreur externe il suffit de la relancer une fois que les services (GTServer reacuteseau base de donneacutees messagerie hellip) sont reacutetablis Certains correspondants pourront recevoir une deuxiegraveme version des questionnaires Le gestionnaire pourra interdire les reacuteponses agrave la premiegravere version des questionnaires dans la gestion des reacuteponses et questionnaires envoyeacutes de la campagne

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

76

57 Ameacutelioration du fonctionnement

571 Arrecirct et redeacutemarrage du service GTServer

Il est conseilleacute de redeacutemarrer reacuteguliegraverement les services GTServer de chaque instance (un redeacutemarrage une fois par mois est souhaitable)

Le redeacutemarrage drsquoun service GTServer devrait ecirctre effectueacute agrave un moment de moindre sollicitation (la nuit ou le week-end)

Le service devrait ecirctre configureacute pour ecirctre lanceacute au deacutemarrage de la machine

572 Purge des historiques de la base du serveur

Les diffeacuterents historiques du serveur doivent ecirctre purgeacutes reacuteguliegraverement

bull Historique des exeacutecutions (Menu principal historique des actions dans GTAnswer)

bull Historique du polling (Menu principal historique du polling dans GTAnswer)

bull Historique des connexions (via la boicircte de dialogue de gestion des utilisateurs bouton dans la barre drsquooutils supeacuterieure de GTAnswer)

Dans GTAdmin une option (dans lrsquoonglet Messagerie de la configuration de lrsquoinstance) permet de configurer le nombre de jours de logs de polling agrave conserver

573 Suppression des anciennes campagnes

Les campagnes tregraves anciennes devraient ecirctre termineacutees et supprimeacutees (en accord avec les responsablesgestionnaires de ces campagnes)

574 Nettoyage de la boicircte mail du compte GTServer

Si les reacuteponses se font par mail la connexion de GTServer agrave la boicircte mail (qui lui est deacutedieacutee) peut ecirctre ralentie si de nombreux messages non pertinents pour GTServer sont preacutesents dans cette boicircte

Les mails de reacuteponse de GTAnswer agrave GTServer sont identifieacutes par un sujet contenant laquo Gathering Tools Answer Environment raquo

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

77

Tous les autres messages ne sont pas pertinents pour le fonctionnement de GTServer et devraient ecirctre supprimeacutes de la boicircte mail de GTServer Ils peuvent ecirctre transfeacutereacutes au preacutealable agrave une autre boicircte mail afin que les personnes concerneacutees par le projet puissent deacutecider du sort de ces messages

575 Configurer le moteur PHP de GTWeb pour accepter des fichiers volumineux

Le moteur PHP peut ecirctre configureacute pour accepter des fichiers de reacuteponse plus volumineux que la taille par deacutefaut

Ce parameacutetrage est effectueacute dans le fichier phpini

Lrsquoentreacutee suivante du fichier phpini devrait ecirctre ajusteacutee agrave la taille maximale des fichiers qstx

post_max_size = 8M

upload_max_filesize = 2M

Lrsquoentreacutee suivante du fichier phpini peut eacutegalement ecirctre ajusteacutee

max_execution_time = 30

576 Configuration de la machine heacutebergeant GTServer

Seacuteparer le serveur sur lequel est exeacutecuteacute GTServer du serveur des bases de donneacutees peut ecirctre avantageux en termes de performances

Lrsquoaugmentation de la capaciteacute de la machine GTServer (RAM processeur etc) peut ecirctre une piste

Lrsquoidentification du goulet drsquoeacutetranglement (GTServer base de donneacutees ou dans un faible nombre de cas messagerie) est une eacutetape indispensable agrave un diagnostic des performances Activer tous les niveaux de logs dans GTAdmin pour obtenir plus drsquoinformations dans les journaux fichiers et permettre un diagnostic plus preacutecis Des articles sur la performance heacutebergeacutes sur le Wiki peuvent aider le concepteur de questionnaires et de base de donneacutees

Lrsquoaccegraves aux diffeacuterentes sources (bases de donneacutees et messagerie) en dehors de GTServer mais en restant dans le mecircme cadre de fonctionnement que le service GTServer est une piste drsquoexploration

Le passage agrave un client POP ou IMAP plutocirct que Exchange ou Notes est toujours preacutefeacuterable

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

78

Si GTServer fonctionne sur une machine virtuelle srsquoassurer que les processeurs de la machine hocircte ne sont pas reacutepartis sur un trop grand nombre de machines virtuelles Le fait drsquoarrecircter les autres machines virtuelles de la machine hocircte de deacuteplacer la machine virtuelle sur une machine hocircte qui lui est deacutedieacute ou de faire fonctionner GTServer sur une machine physique et non une machine virtuelle devrait permettre drsquoameacuteliorer les performances et drsquoidentifier les goulets drsquoeacutetranglements potentiellement lieacutes agrave la virtualisation

577 Mise agrave jour de la suite Gathering Tools

Des ameacuteliorations et des corrections sont apporteacutees reacuteguliegraverement agrave la suite Gathering Tools

La mise agrave jour de la suite tout en restant dans la branche mineure devrait ecirctre effectueacutee reacuteguliegraverement pour profiter de ces corrections et ameacuteliorations

Pour teacuteleacutecharger les derniegraveres versions de la suite vous pouvez

bull contacter le support (supportgathering-toolscom)

bull aller sur le site de teacuteleacutechargement de GT

httpsgathering-toolscomtickets

6 Virtualisation

Le fonctionnement de la suite dans son ensemble est indeacutependant du fait que la machine soit virtuelle ou non du moment que la machine a accegraves agrave un disque dur un peacuteripheacuterique de pointage un peacuteripheacuterique drsquoentreacutee clavier un peacuteripheacuterique de sortie un accegraves reacuteseau etchellip de maniegravere similaire agrave une machine physique et si les preacuterequis techniques de lrsquoinstallation sont respecteacutes

Neacuteanmoins les performances du fonctionnement pourront ecirctre deacutegradeacutees si les machines hocirctes heacutebergeant les machines virtuelles ne sont pas suffisamment performances (ou heacutebergent trop de machines virtuelles ou des machines virtuelles requeacuterant trop de puissance de calcul drsquoaccegraves disques reacuteseaux etc) De maniegravere geacuteneacuterale pour assurer le minimum de performances les ressources recommandeacutees pour un serveur physique devraient ecirctre garanties en tout temps (et mecircme ecirctre supeacuterieures) pour la machine virtuelle La virtualisation eacutetant une laquo couche suppleacutementaire raquo les performances ne peuvent qursquoecirctre deacutegradeacutees mecircme faiblement par rapport agrave une machine physique de caracteacuteristiques eacutequivalentes

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

79

Enfin la virtualisation de SGBD pour des bases de donneacutees devant assurer des performances eacuteleveacutees (accegraves nombreux etou volumeacutetries importantes hellip) nrsquoest geacuteneacuteralement pas preacuteconiseacutee par les eacutediteurs mecircmes de ces diffeacuterents SGBD

Pour quelques modules clients comme GTAnswer lrsquointerface graphique est tregraves leacutegegraverement la virtualisation opeacutereacutee sur certaines machines ne gegravere pas correctement les couches 3D utiliseacutees

Le support logiciel fourni dans le cadre du contrat de maintenance est assureacute que la machine soit virtuelle ou non

Cependant srsquoil srsquoavegravere que la cause drsquoun eacuteventuel problegraveme qui nous est reporteacute puisse ecirctre issue de la virtualisation Calame Software sera ameneacute agrave demander de reproduire le problegraveme dans une machine physique

Calame Software est partenaire certifieacute Microsoft Dans le cadre de cette certification le produit a lui-mecircme eacuteteacute certifieacute quant agrave son fonctionnement sous la plateforme de virtualisation de Microsoft (Hyper-V)

De plus des plateformes internes de tests et de formation de la suite Gathering Tools sont virtualiseacutees sous Hyper-V ou VMWare Lrsquoaccegraves agrave ces machines en interne est geacuteneacuteralement effectueacute dans le cadre de sessions de bureau agrave distance (TSE)

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

80

7 Reacutesumeacute des preacuterequis techniques

Le tableau ci-dessous fournit agrave titre indicatif la liste des preacuterequis techniques pour lrsquoinstallation de Gathering Tools

OslashSupporteacute Aucun droit requis

Design GTAnswer GT Admin

Windows Server 2016

Windows 10

Windows Server 2012 et 2012 R2

Windows 8 et 81

Windows Server 2008 et 2008 R2

Windows 7

Design GTAnswer GT AdminFichiers

Base de registresEcrire dans HK_Local_Machine Ecrire dans HKLM

sinon HKCU

Services

Envoi Recept

POP () Sans objet Sans objet

SMTP () Sans objet

IMAP () Sans objet Sans objet

MAPI

Auto-detecteacute Protocole(s)

Widows Live Mail Oui SMTP

Windows Mail Oui SMTP

Microsoft Outlook (32 bits et 64 bits) Oui Outlook SMTP

Thunderbird (2 mini) Oui SMTP

GT Server

Droits neacutecessaires agrave linstallation

GT ServerEcrire dans le reacutepertoire dinstallation

LeacutegendeNon supporteacute

OS supporteacutes

Ecrire dans HK_Local_Machine

Oslash OslashInstaller Deacutemarrer

Arrecircter les services

Installer Deacutemarrer Arrecircter

les services

Protocoles de messagerie supporteacutes

Design GTAnswerGT Server

GT Admin

Sans objet Sans objet

() avec Support SSL

Clients de messagerie supporteacutes (Autodeacutetection par module GTAnswer)

Note Les protocoles de messagerie entrant

(POP IMAP) ne sont utiliseacutes par GTAnswer que

dans le cadre dune connexion de secours

pour des utilisateurs ne pouvant se connecter au

serveur web Par deacutefaut GTAnswer eacutechange

avec le serveur via http

Gathering Tools est une marque commerciale de Calame Software Pour ce manuel et toute la documentation affeacuterente copy 2003 ndash 2020 Calame Software SAS

81

Role Modules Espace min

GT Server

GT Admin

Design

GTAnswer

Gestionnaire Valideur Reacutepondant GTAnswer 40 Mo

Design +

GTAnswer1024

4096

Base Versions

SqlServer 2008 2012 20142016

Oracle Client ODAC 11G requis 10G 11G

PostGreSQL 8 et +

DB2 (UDB) 9

Module Fonctionnaliteacute Version mini

Design Import Excel 2007

Restitutions Excel 2000

Toutes 472

56

75

24

1 Go

100 Mo

GT Server +

GTAdmin4096

1 compte de messagerie accessible via SMTP pour lenvoi des mails

1 compte de messagerie accessible via POPIMAP (de preacutefeacuterence le mecircme compte que celui pour lenvoi via SMTP)

OU 1 compte de messagerie Exchange avec un client Outlook 32 bits ou 64 bits installeacute sur le serveur (de preacutefeacuterence le mecircme compte que celui

pour lenvoi via SMTP)

OU 1 accegraves au serveur GTWeb (si les reacuteponses Answer sont envoyeacutees par http)

1 scheacutema de base de donneacutees pour la base client (base ouverte) ce scheacutema doit ecirctre diffeacuterent de celui de la base GT

RAM Recommandeacutee (Mo)

RAM Minimum (Mo)

8192

Deacuteveloppeur 1 Go

Espace disque requis

Serveur 10 Go

Espace recommandeacute

20 Go

Ram (Mo)

1 scheacutema de base de donneacutees pour la base GT (base proprieacutetaire) ce scheacutema doit ecirctre diffeacuterent de celui de la base client

Microsoft Excel installeacute sur le serveur si des restitutions doivent ecirctre geacuteneacutereacutees par la suite GT

Besoins geacuteneacuteraux GTServer

Solution distribueacutee

Bases de donneacutees supporteacutees Bande passante recommandeacutee

Solution centraliseacutee

Module compleacutementaire

Microsoft Excel

GT Server

Microsoft Excel

Modules compleacutementaires requis

Microsoft NET Framework

Serveur Web

PHP

ouIIS

Apache

Page 15: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 16: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 17: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 18: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 19: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 20: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 21: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 22: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 23: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 24: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 25: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 26: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 27: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 28: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 29: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 30: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 31: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 32: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 33: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 34: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 35: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 36: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 37: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 38: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 39: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 40: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 41: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 42: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 43: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 44: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 45: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 46: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 47: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 48: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 49: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 50: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 51: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 52: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 53: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 54: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 55: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 56: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 57: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 58: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 59: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 60: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 61: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 62: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 63: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 64: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 65: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 66: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 67: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 68: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 69: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 70: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 71: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 72: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 73: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 74: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 75: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 76: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 77: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 78: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 79: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 80: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation
Page 81: Gathering Tools...droits d’utilisateur avec pouvoir. Ce compte est utilisé pour lancer le service du serveur de GTServer. Ce compte peut être le même que le compte de l’installation