Upload
others
View
0
Download
0
Embed Size (px)
Citation preview
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
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
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
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
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
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
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
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
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
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
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
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
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
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