SphinxOnline Manuel d'utilisation Module " SphinxConnect " Le Sphinx Developpement - Parc Altais - 74650 CHAVANOD France - Tel : +33 (0)4 50 69 82 98 Fax : +33 (0)4 50 69 82 78 - www.lesphinx-developpement.fr - contact@lesphinx-developpement.fr 1 / 20
SphinxConnect est la solution Sphinx pour les enquêtes en ligne. Ce document décrit la configuration nécessaire, les différentes spécifications et la procédure d'installation. Dernière mise à jour : 21/05/2013 Configuration et spécifications Configuration nécessaire Voici la liste des éléments à rassembler avant de procéder à l installation : - processeur DualCore (recommandé) - 2Go de mémoire vive (recommandé) - 40 Go de disque dur (recommandé) - Windows 2008 Server (32 ou 64 bits) - IIS 7/7.5 (procédure d'installation en annexe) - Frameworks ASP.NET 3.5.1 ET.NET 4.0 installés sur la machine (procédures d'installation en annexe) - Deux adresses IP fixes et les noms DNS associés. - L'adresse du serveur SMTP que l'on utilisera pour l'envoi des messages. Ainsi qu'un login et un mot de passe si le serveur SMTP requiert une authentification - une bande passante de 2Mb/s (recommandé) - L adresse email de la personne qui sera super-administrateur (ou un alias) - Pour les emailings, une boite POP3 (dédiée à l application) qui permettra de récupérer les mails d erreurs (facultatif) - Le port 25 vers le serveur SMTP et le port 80 doivent être ouverts - Aucun moteur de base de données n'est nécessaire sur le serveur. Pour des configurations particulières, merci de contacter notre service technique. Les programmes La solution se compose de trois éléments : - Le Sphinx Plus² pour la création des enquêtes et les analyses statistiques - Le Serveur d'enquêtes pour le pilotage de la saisie et l'analyse statistique en ligne - La Plateforme ASP pour la gestion, la diffusion et le partage des enquêtes. Sphinx Plus² est un logiciel pour Windows qui s'installe sur le poste du chargé d'études et qui permet notamment : - de rédiger les questionnaires, de préparer les formulaires papier ou écran - de publier des enquêtes sur le serveur d'enquêtes - de gérer (consulter/modifier, importer, exporter, calculer, qualifier, consolider) les données - de dépouiller les études (analyses statistiques, états, graphiques,...) - de créer des rapports automatiques aux formats Office, HTML, PDF. Le Serveur d'enquêtes est une application autonome qui s'installe comme un service Windows sur l'ordinateur relié à l'internet/intranet et qui permet notamment : - de piloter la saisie interactive des réponses par des internautes depuis un navigateur Internet, soit dans des formulaires HTML, soit dans une applet Java. Tous les navigateurs Internet sont compatibles (Internet Explorer 6 et +, Mozilla Firefox 1.0 et supérieur, Pocket Explorer pour Windows Mobile, Opera, Safari,...) - de consulter à tout moment tout ou partie de la table des réponses - de consulter à tout moment les résultats (tableaux et graphiques) dans un format qui aura été préparé par l'auteur de l'enquête - de contrôler l'accès aux formulaires et aux résultats par un système de mots de passe - de télécharger sur le poste du chargé d'études l'ensemble des résultats pour des analyses complémentaires. La Plateforme de gestion (ASP), est un ensemble d applications ".NET" s'exécutant dans l'environnement de Microsoft IIS et qui permet notamment : - La gestion (consulter, fermer, archiver, recopier, réinitialiser, télécharger) des enquêtes publiées - L envoi de mails personnalisés (option Emailing) - La création d'enquêtes simples directement en ligne (sans aucun logiciel client installé) 2 / 20
- Des outils interactifs d'analyse statistique en ligne - Créer, gérer des évaluations multiples (option Eval Net) - Créer, gérer des panels de répondants (option Web Panel). - Editer des rapports en ligne (option Webreporting). La description des fonctionnalités est donnée dans les guides d'utilisation correspondants. Pour plus d informations n hésitez pas à consulter notre site web : http://www.lesphinx-developpement.fr Spécifications Le serveur d'enquêtes (serveur HTTP autonome) et la Plateforme ASP (applications IIS) cohabitent sur la même machine, mais sur des ports ou des adresses IP différents. Serveur d'enquêtes Le Serveur d'enquêtes est un serveur web (http ou https) complètement autonome (indépendant de IIS, Apache,...). Le logiciel s'installe comme un service et en a donc toutes les fonctionnalités : reprise après panne, démarrage automatique,... La communication du client avec le serveur d'enquêtes se fait par des requêtes. Le langage de requête est décrit en détail dans le manuel relatif aux enquêtes en ligne. Le protocole est http ou https selon la licence acquise. Pour https, il est nécessaire d avoir un certificat SSL pour le nom de domaine. Le serveur s installe par défaut sur le port 80 (http) ou 443 (https) mais le port peut être changé si nécessaire. Les données sont stockées sur le serveur dans des bases de données Sphinx et des fichiers xml. Plateforme ASP La Plateforme ASP est un ensemble d'applications fonctionnant dans l'environnement du serveur web de Microsoft (IIS) avec Microsoft Framework.NET 3.5.1 et 4.0. Cohabitation Il est recommandé de configurer IIS pour que celui-ci se limite à écouter le port 80 sur une seule adresse IP. Cette opération est mal documentée par Microsoft et nous suggérons de la faire avec le technicien de Sphinx développement qui procédera à l'installation ou de vous référer à l annexe correspondante. Il est également possible de mettre le serveur d enquêtes sur le port 80 et IIS sur le port 8080 afin de simplifier les URL d accès aux enquêtes. La plateforme ASP n est en effet utilisée que par le groupe restreint des chargés d études alors que le serveur d enquêtes est utilisé par l ensemble des répondants. Performances L'efficacité du système est fonction de la qualité de la ligne Internet et de la rapidité du processeur. Le serveur d'enquêtes est le plus sollicité, puisqu'à chaque page d'un questionnaire, l'internaute renvoie des informations au serveur d'enquêtes qui construit en conséquence la page suivante. Le nombre de connexions simultanées à une enquête n'est pas limité et plusieurs centaines de personnes peuvent répondre simultanément à un questionnaire. Les requêtes sont traitées par ordre d'arrivée dans la file d'attente. La génération d'une page de formulaire prend en général quelques centièmes de secondes. Dix personnes peuvent donc cliquer dans la même seconde sur le bouton Enregistrer ou Page suivante sans ressentir de ralentissement. Attention toutefois à ce que les chargés d'étude ne surchargent pas les formulaires avec des images trop volumineuses et / ou des calculs automatiques trop longs ou trop nombreux. Installation Installeur Avant de lancer l installeur, vous devez impérativement vous demander où vous souhaitez placer les fichiers du serveur d enquêtes (données des enquêtes, exécutables ) et les fichiers de la plateforme de gestion (applications ASP, configuration, données emailing). Par défaut, les répertoires sont C:\Eureka_s et C:\inetpub\wwwroot. Même si un CD-ROM vous a été envoyé, il est préférable de télécharger la version la plus récente sur notre site, à l'url : 3 / 20
http://telechargement.sphinxonline.com/solmanager316/cleeursrv.exe. Exécuter CleEurSrv.exe pour lancer le programme d installation. Indiquer le nom d'utilisateur et la clef d'installation. Les fichiers relatifs au serveur d'enquêtes sont copiés dans un premier répertoire (par défaut C:\Eureka_s) que vous pouvez éventuellement modifier. Le programme d installation propose ensuite d'installer la plateforme de gestion dans un second répertoire (par défault C:\inetpub\wwwroot) que vous pouvez également modifier. Un raccourci (Sphinx - Serveur) vers le programme de paramétrage est créé sur le bureau. La base de registre est modifiée. L'assistant de configuration est alors lancé automatiquement (si ce n'est pas le cas, celui-ci sera lancé lorsque vous exécuterez le raccourcis Sphinx - Serveur). Assistant de configuration Important : Cette partie de l'installation est la plus importante, certains éléments de la solution seront configurés de manière définitive (les noms de domaine par exemple). Vous devez être certain que les paramètres que vous allez entrer seront ceux qui devront être utilisés une fois le serveur en production. L'utilitaire de configuration va créer et configurer tous les services nécessaires au bon fonctionnement du serveur d'enquête et effectuer toute la configuration de la plateforme de gestion (création des applications IIS, mise à jour des droits NTFS,...). Voici son interface : Celle-ci est divisée en différentes sections : - Nom de la plateforme : ce champ (prérempli à "SphinxServer") accueille le nom que vous souhaitez donner à la plateforme SphinxConnect, il sera utilisé pour créer les services windows et le site web dans IIS. Ce nom vous permettant de reconnaitre les éléments appartenant à la solution. - Serveur d'enquêtes : dans cette section vous renseignez le nom de domaine, l'adresse IP et le port que devra utiliser le serveur d'enquête. - Service d'emailing : ici, renseignez l'adresse et le port du serveur SMTP à utiliser pour l'envoi des mails. Si ce dernier requiert une authentification, il vous faut renseigner le nom d'utilisateur et le mot de passe que devra utiliser SphinxConnect pour réaliser ses envois. - Plateforme de gestion (IIS) : indiquez dans cette section les informations relatives à la plateforme de gestion à savoir le mode, le nom de domaine, le chemin d'accès au répertoire wwwroot (prérempli avec ce que vous avez sélectionné dans l'installeur), l'adresse IP et le port à utiliser. A noter : Le serveur d'enquêtes et la plateforme de gestion ne peuvent pas fonctionner sur la même adresse IP et le même port. Si vous n'avez pas de noms de domaine associé aux adresses IP du serveur d'enquêtes ou de la plateforme de gestion, utilisez le nom réseau (ou éventuellement l'adresse IP) de votre serveur. Si vous configurez la plateforme de gestion en mode HTTPS, le site web créé dans IIS sera configuré en HTTP, ce sera à vous d'aller supprimer la liaison HTTP et de créer la liaison HTTPS avec votre certificat SSL. Une fois que vous avez renseigner tous les champs nécessaires, cliquez sur le bouton "Installer". Une boite de dialogue vous informe que l'installation est terminée. Puis Sphinx Serveur est lancé automatiquement. Pour terminer l'installation, cliquez sur le bouton "Utilisateurs..." et connectez-vous en tant qu'administrateur (login/mot de passe par défaut: admin/admin). 4 / 20
Configuration manuelle Cette section n'est à utiliser qu'en cas de défaillance de l'assistant de configuration ou pour des utilisateurs avancés. Serveur d'enquêtes Le programme de configuration du serveur d enquêtes se lance dès la fin de l'installation. On pourra le relancer (c: \eureka_s\server.exe ou via le raccourci sur le bureau Sphinx - Serveur) Le haut du dialogue, reproduit ci-dessous, permet de renseigner les paramètres de fonctionnement. Cette tâche requiert des compétences d'informaticien et devra être faite exclusivement par l'administrateur du système. Installation du service Avant l'installation du service, les éléments suivants doivent être renseignés : - Le nom du serveur et son Adresse IP fixe : Le Nom du serveur est le nom de domaine associé à l Adresse IP fixe de l ordinateur. On peut se contenter de donner temporairement l adresse IP fixe comme nom du serveur. Sauf si vos enquêtes sont tournées uniquement vers votre réseau interne, attention de ne pas indiquer le nom réseau de la machine ou son adresse IP sur le réseau interne. - Le Port : Le Port par défaut est 80 (443 pour une licence de serveur HTTPS). Il est possible d indiquer ici un autre port. Attention, si une autre application (IIS, Apache ou autre) utilise le même port sur la même adresse IP, le démarrage du serveur sera impossible. - Le Protocole : Le Protocole est soit HTTP soit HTTPS selon la licence d'utilisation. Le protocole HTTPS est sécurisé et il est nécessaire pour l utiliser d'avoir, pour un nom de domaine, un certificat d'authenticité délivré par les organismes accrédités. Si le protocole est HTTPS, le bouton... montre un dialogue dans lequel on désigne le certificat SSL (propre au nom de domaine) et son mot de passe. Cliquez sur Installer le service. Configurer le gestionnaire de comptes Cliquez sur le bouton Configurer L'URL de la plateforme ASP est indiquée en absolu, par exemple http://plateforme.mondomaine.com, tel que l on y accède depuis l Internet (ou l Intranet). Si il s agit d une installation sur la même IP mais deux ports différents : le port de IIS doit être indiqué, sinon c est l url de la plateforme de gestion. L'adresse email Webmaster permet de désigner un responsable du système d'information dont l'adresse apparaitra sur les pages de contact. Configurer le serveur SMTP Dans le dialogue montré par le bouton Configurer, le groupe de contrôles Serveur SMTP affiche les éléments (hôte, port, utilisateur, Mot de passe) de configuration d'un serveur de messagerie. 5 / 20
Ce serveur de messagerie est utilisé dans deux circonstances : - Le chargé d'études peut configurer son enquête pour qu'un mail soit automatiquement envoyé lorsqu'un questionnaire est enregistré - La Plateforme ASP permet de diffuser l'url de l'enquête en effectuant des emailings automatisés. Mise en route Une fois toutes les configurations terminées, utilisez le bouton Démarrer pour lancer le service. Si un message d erreur apparait vous informant de l impossibilité du démarrage, c est probablement qu IIS écoute déjà sur l adesse IP et le Port du serveur d enquêtes. Réessayez après avoir arrêter IIS ou basculer IIS sur un autre port. Cliquez sur le bouton Tester pour vérifier le fonctionnement du serveur sur une enquête de test intégrée. Pour tester le fonctionnement depuis une autre machine, démarrer le navigateur Internet et taper l'url http:// enquetes.mondomaine.com. Vous devez voir apparaître un message du serveur répondant qu'une url complète doit lui être envoyée. Ces URL construites sur le modèle http://enquetes.mondomaine.com/moncompte/monenquete/questionnaire.htm seront créées lors de la création d'une enquête. Configuration IIS Site Web Si vous avez choisi d installer la plateforme dans un répertoire différent que celui par défaut. Vous allez devoir modifier le chemin d accès du site web par défaut (propriétés / Répertoire de base / Chemin d accès local) ou créer un nouveau site web via l assistant d IIS (Cliquez droit sur site web / nouveau /site web). Services de rôle La première chose à vérifier dans le gestionnaire de serveur est la liste des services de rôle installés pour IIS. Les services de rôle ASP.NET et ASP au minimum doivent être installés. 6 / 20
Propriétés du site web Dansle menu Document par défaut du site web dans IIS, veillez à ce que les pages Default.aspx et index.aspx soit configurées comme ci-dessous. 7 / 20
Service d emailing Installer le service d emailing (exécuter install.bat du répertoire wwwroot\config\sphmailserv\installutil). Répertoires virtuels Copier le répertoire aspnet_client pour le mettre directement à la racine d IIS (C:\inetpub\wwwroot\). Depuis l outil de gestion d IIS, créer les répertoires virtuels correspondant au sous-répertoire d'installation et aux sousrépertoires des applications comptes, declic, droits, evalnet, evalnet3, report, SphinxWS et webstat (voir image ciaprès). Pour cela, il faut cliquer droit sur le répertoire, puis cliquer sur le bouton Convertir en application. Configuration complémentaire d IIS (optionnel) - Pour l'application Comptes, dans le menu Documents, la page index.aspx doit être en première position dans la liste des pages par défaut. - Renommez le fichier default1.asp présent dans le répertoire du site web en default.asp. Configuration du pool d'application Le pool d'application utilisé par les applications ASP.NET doit être correctement configuré. Dans les paramètres de base du pool d'application, sélectionner le Mode pipeline géré Classique. Dans les paramètres avançés, modifier l'identité du pool en utilisant le groupe NetworkService. Si Windows Server 2008 est en version 64bits, Mettre True à l'option Activer les applications 32 bits. 8 / 20
Droits NTFS sur les fichiers La plateforme de gestion comprend un certain nombre de fonctionnalité qui ont besoin de lire, modifier ou écrire des fichiers dans les différents dossiers d installation de la solution. La liste suivante décrit les droits à attribuer aux fichiers pour une installation par défaut sur disque C:\. Si vous n avez pas procédé à l installation par défaut il faudra adapter ces chemins à votre configuration. Sous Windows server 2008, le groupe d utilisateur à choisir est IIS_IUSRS. Fichiers de la plateforme de gestion C:\Inetpub\wwwroot (propager aux sous-dossiers) Groupe d'utilisateurs IIS_IUSRS = Lecture et exécution, Affichage du contenu du dossier, Lecture C:\Inetpub\wwwroot\config\ (propager aux sous-dossiers) C:\Inetpub\wwwroot\evalsdata C:\Inetpub\wwwroot\uploads Groupe d'utilisateurs IIS_IUSRS = Modification, [ ], Ecriture Fichiers du serveur d enquêtes C:\Eureka_s (propager aux sous-dossiers) Groupe d'utilisateur IIS_IUSRS = Lecture et exécution, Affichage du contenu du dossier, Lecture C:\Eureka_s\Etudes (propager aux sous-dossiers) C:\Eureka_s\Pages C:\Eureka_s\Sauvegarde Groupe d'utilisateurs IIS_IUSRS = Modification, [ ], Ecriture Configuration d'une tâche planifiée - Dans Outils d'administration > Planificateur de tâches, cliquer sur Créer une tâche de base... Le programme à planifier est disponible dans le dossier «DOSSIER_INSTALL_IIS\config\Report\planifiedTasks» et s appelle «PlanifiedTasks.exe» - Sélectionner «Exécuter cette tâche : Tous les jours» - L heure de début doit être fixe, c'est-àdire 12:00 par exemple. Après validation, éditer les propriétés de la tâche planifiée en se basant sur la copie d'écran cidessous : 9 / 20
- Pour finir, éditer le fichier «...\config\report\planifiedtasks\configuration.xml» et remplacer <config> <xmlpath>c: \Inetpub\wwwroot\config\Report\planified.xml</xmlPath> </config> par <config> <xmlpath>dossier_install_iis \config\planified.xml</xmlpath> </config> Super-Administrateur L'accès à la plateforme ASP en tant qu'administrateur se fait à partir du bouton Utilisateurs du panneau de commande du serveur d enquêtes ou bien directement depuis le navigateur Internet à l'url : http://plateforme.mondomaine.com/ comptes/admin où http://plateforme.mondomaine.com est l'url de base d IIS. Le nom et le mot de passe indiqué dans le dialogue de configuration sont ceux du super-administrateur (admin / admin par défaut). 10 / 20
Créer des comptes utilisateurs Le menu Gestion > Créer un compte montre une page dans laquelle on indique obligatoirement un nom de compte, un mot de passe et un mail (ces deux dernières informations pourront être changées ultérieurement par l'utilisateur). Configuration Le menu Gestion > Configuration du système permet d'éditer dans un ficher XML le nom de la plateforme, le logo associé, l adresse email du super-administrateur, les paramètres du serveur smtp ainsi que les chaines de caractères de la page d'accueil. Le menu Gestion > Configuration de l emailing permet d'éditer dans un ficher XML les paramètres de la boite pop3 utilisé pour lire les mails de retour. Le menu Gestion > Gestion des administrateurs permet au super-administrateur de créer des accès administrateurs qui pourront à leur tour créer des comptes utilisateurs. Mais si le super-administrateur voit tous les comptes de la plateforme, chaque administrateur ne voit que les comptes qu'il a lui même créé. Le menu Gestion > Versions donne un aperçu des versions des différents éléments de la solution. Le menu Outils > Télécharger sauvegardes, logs, conf... permet de récupérer les données des comptes supprimés et de créer une archive des fichiers de configuration. En cas de problème, vous pourrez ainsi facilement communiquer la configuration de votre système à un technicien de Sphinx Développement. Utilisation du système Publication depuis Sphinx Plus² Lors de la publication, les fichiers de l'enquête sont copiés sur le serveur. Le protocole est le protocole http ou https selon la licence. Le proxy devra être configuré en conséquence. 11 / 20
Un paramétrage sera nécessaire lors de la publication de la première enquête. Les éléments renseignés seront conservés ensuite. On indique le Nom du serveur ainsi que le Port auquel il est rattaché. On indiquera aussi le nom et le mot de passe de l'utilisateur. Gestion du compte par le chargé d études L'accès à la plateforme ASP en tant que chargé d'études se fait à partir du navigateur Internet à l'url : http:// plateforme.mondomaine.com/comptes. Tester l'installation Pour tester les principales fonctionnalités de la solution... Créez un compte - Accédez à la plateforme en tant que super-administrateur : http://plateforme.mondomaine.com/comptes/admin - Indiquez le nom et mot de passe (admin/admin si vous n'avez pas changé les valeurs par défaut) - Cliquez sur Créez un compte et renseignez les champs obligatoires (indiquez votre propre adresse mail, pour la suite des tests). Créez et gérez une enquête - Accédez à la plateforme en tant qu utilisateur : http://plateforme.mondomaine.com/comptes en indiquant les infos du compte créé - Cliquez sur Nouvelle enquête, choisissez un Modèle 12 / 20
- Donnez un nom à votre enquête et cliquez sur OK - Cliquez sur Liste des enquêtes (menu de gauche), l'enquête doit apparaître dans la liste - Cliquez sur l enquête que vous venez de créé, puis accédez à l onglet Réponses. La partie centrale de la page doit afficher l en-tête d un tableau. Créez un emailing - Cliquez sur Emailing (menu de gauche), puis sur le bouton Valider l adresse email en milieu de page - Accédez à votre messagerie et cliquez sur le lien de validation contenu dans l email - De retour à l emailing, sélectionnez l option Emailing associé à l enquête puis sélectionnez l enquête précédemment créée et faites Suivant - Cliquez sur le lien Message puis sur le lien Destinataires puis sur Ajouter des destinataires - A la ligne, après votre adresse mail, rajoutez une ou plusieurs adresses que vous pouvez consulter - Cliquez sur OK, puis sur Envoie/Relance - Sélectionnez les options Sélection automatique et Effectuer l envoi dès que possible - Cochez la case J'ai pris connaissance et cliquez sur Envoyez puis OK - Vérifiez dans votre logiciel de messagerie que vous avez bien reçu l email et cliquez sur le lien pour répondre - Cliquez à nouveau sur Emailing et vérifiez que les statuts des destinataires ont été modifiés en conséquence. Publier une enquête depuis le logiciel client Pour cette opération, vous pouvez obtenir la version de démonstration du logiciel sur notre site web : http://www.lesphinx-developpement.fr/ Veuillez consulter le document d'aide pour la publication disponible ici : http://asp.ergole.fr/config/help/fr/publication/ Maintenance Sauvegardes Pour palier à une déficience matérielle ou logicielle, vous trouverez ci-dessous la liste des répertoires et des fichiers à sauvegarder régulièrement : Fichiers de données (enquêtes, réponses,.) : - C:\Eureka_s\Etudes\ - C:\Eureka_s\Pages\ - C:\Eureka_s\Sauvegarde\ - C:\inetpub\wwwroot\Uploads\ - C:\inetpub\wwwroot\evalsdata\ (si vous avez l option Eval Net) Fichiers de configuration : - C:\Eureka_s\Eureka.ini - C:\inetpub\wwwroot\config\ Si vous n êtes pas limité par le poids des archives, nous vous conseillons de sauvegarder l intégralité des répertoires C: \inetpub\wwwroot\ et C:\Eureka_s. Renouvellement de licence A la suite d une commande de comptes et/ou d options supplémentaires ou d un prolongement de licence dans le temps, une nouvelle clé vous sera envoyée par notre service commercial. Pour l activer voici la démarche à suivre : - Exécutez Sphinx - Serveur (icône du bureau), cliquez sur le bouton Arrêter - Ouvrez le fichier licence.exe se trouvant dans le répertoire Eureka_s\licence\ - Choisissez Réinstaller, cliquez sur Continuer - Sélectionnez Vous avez une clef d installation, cliquez sur Continuer - Rentrez les informations que l on vous a communiquées. (Nom d utilisateur et Clef d installation) 13 / 20
- Cliquez sur Continuer, puis sur Terminer - Dans Sphinx - Serveur (icône du bureau), Cliquez sur le bouton Démarrer. Mises à jour Vous pouvez déterminer la version actuelle de votre serveur en vous connectant en tant qu'utilisateur : le numéro de version apparait à gauche, en-dessous du lien pour se déconnecter : La dernière version de SphinxConnect disponible est la 3.1.6 si vous disposez d'une version antérieure nous vous invitons à vous rapprocher de notre service technique (update@ergole.fr) pour obtenir la procédure de mise à jour adaptée à votre cas. Changement de nom de domaine Voici la liste des manipulations à suivre pour changer le nom de domaine utilisé par le serveur d enquête : 1. Réalisez une sauvegarde complète du système. 2. Renseignez le nom de domaine adéquat dans le serveur d enquêtes : - Exécutez Sphinx - Serveur (icône du bureau), Cliquez sur le bouton Arrêter puis Désinstaller le service - Dans le champ Nom du serveur : renseignez le nom de domaine voulu - Cliquez sur le bouton Installer le service puis Configurer - Dans le champ URL de la plateforme ASP, renseignez l adresse http:// de la plateforme - Cliquez successivement sur les boutons : OK et Démarrer. 3. Deuxièmement, renseignez le nom du serveur d enquêtes dans la configuration de la plateforme de gestion : - Via l accès administrateur de la plateforme cliquez sur le lien configuration puis configuration du système - Entre les balises <eureka> et </eureka>, inscrivez le nom de domaine du serveur d enquêtes et cliquez sur Ok. 4. Enfin, remplacez les occurrences de l ancien nom de domaine dans les fichiers : Pour cela, vous allez avoir besoin d un outil permettant de faire du rechercher/remplacer dans des fichiers (type search and replace) et lui faire changer toutes les occurrences de l ancien nom de domaine par le nouveau. Changement du mot de passe super-administrateur - Se connecter à la plateforme ASP en tant qu'administrateur - Cliquez sur Configuration > Changement mot de passe administrateur 14 / 20
- Vous pouvez alors changer le mot de passe du super-administrateur - Enregistrez les changements en cliquant sur le boutons Modifier Suivi de l'utilisation Toutes les requêtes adressées au serveur sont enregistrées dans des fichiers du répertoire Logs. Chaque requête est décrite par un code de retour, la date précise, l'ip de l'appelant, l'url, la requête complète, la taille en octets des éléments produits, le délai d'exécution. Pour la signification des différentes requêtes, on se reportera au manuel relatif aux enquêtes Internet. Il y a un fichier de log par jour. Des contrôles permettent de changer de jour et de voir les résultats sous forme graphique. Le bouton Activité permet de voir un résumé de l'activité du serveur, jour par jour, enquête par enquête, heure par heure,... On pourra notamment comparer le nombre d'accès au questionnaire (requête input) et le nombre d'observations effectivement enregistrées (requête save). 15 / 20
Annexes Autres documentations Vous pouvez retrouver le mode d'emploi de la solution à l'adresse suivante : http://asp.ergole.fr/config/help/fr.html. Installation IIS 7/7.5 Voici la procédure à suivre pour l installation d IIS. Dans le menu Gérer votre serveur, cliquez sur Ajouter des rôles. Après l analyse de votre système, sélectionnez Serveur Web (IIS) et cliquez sur Suivant. Suivez ensuite les instructions de l assistant. Installation Framework.NET v3.5.1 Le framework s'installe en ajoutant la fonctionnalité directement depuis le gestionnaire de serveur. 16 / 20
Installation Framework.NET v4.0 Le package d'installation du framework.net 4.0 est disponible en téléchargement sur le site de microsoft à l'adresse suivante : http://www.microsoft.com/fr-fr/download/details.aspx?id=17718. Empêcher IIS d écouter sur toutes les adresses IP Par défaut, sur un serveur qui possède plusieurs adresses IP, IIS les écoutes toutes. Cela s avère être un problème lorsque l on veut configurer des IP différentes pour le serveur d enquête et la plateforme de gestion. Dans IIS 7/7.5 sur un serveur tournant sous Windows server 2008, il faut inscrire les IP écoutées par IIS dans une liste. Ouvrir un panneau de commande et exécuter : - netsh http add iplisten ipaddress=x.x.x.x : ajoute la première adresse IP à la liste d'écoute - netsh http add iplisten ipaddress=b.b.b.b : Ajoute la seconde adresse IP à la liste d écoute - netsh http delete iplisten ipaddress=x.x.x.x : supprime l adresse x.x.x.x à la liste d écoute d IIS - netsh http show iplisten : Vérifie qu il ne reste que l adresse b.b.b.b qui va être utilisé par IIS dans la liste d écoute Récapitulatif des commandes : Faire cohabiter plusieurs solutions sur la même machine Pour pouvoir lancer plusieurs services de type serveur d enquêtes sur la même machine, il faut pouvoir leur attribuer des noms différents. Pour cela il faut rajouter l attribut ServiceName dans le fichier Eureka.ini situé dans le répertoire Eureka_s par défaut. ServiceName=Bis Ce qui donnera le nom de service suivant : Sphinx Serveur d enquêtes Bis80 Pour pouvoir lancer plusieurs services de type service d'emailing sur la même machine, il faut pouvoir leur attribuer des noms différents. Pour cela il faut rajouter l attribut /name=servicename dans le fichier install.bat situé dans le répertoire wwwroot/config/sphmailserv/installutil. InstallUtil.exe /name=servicename /i..\sphmailserv.exe 17 / 20
Dans le conf.xml, il faut rajouter la balise suivante: <mailingservice>servicename</mailingservice> Migrer une solution d'un serveur à un autre Pré-requis Windows server 2008 Installer Framework.NET v3.5.1 et v4.0 (redémarrage nécessaire) Faire une sauvegarde des répertoires Eureka_s et wwwroot. Désinstallation de l'ancienne solution Désinstaller le service de mailing : exécuter le fichier de commande uninstall.bat qui se situe dans le répertoire wwwroot \config\sphmailserv\installutil. Arrêter le serveur d enquête : lancer «Sphinx Serveur» (raccourci sur le bureau), cliquer sur le bouton «Arrêter» puis sur le bouton «Désinstaller le service». Supprimer la plateforme de gestion : ouvrir la console de gestion d IIS, dans la partie Site Web, supprimer celui qui correspond à Sphinx. Idem dans la partie Pools d applications. Enfin, supprimer les répertoires Eureka_s et wwwroot (après les avoir sauvegardés) ainsi que les raccourcis du bureau. Migration de la plateforme Copier les répertoires Eureka_s et wwwroot sur le nouveau serveur (si possible dans la même arborescence que sur l'ancien, sinon une manipulation de remplacement sera nécessaire par la suite). Exécutez le programme Eureka_s\licence\licence.exe, cliquez sur "(Ré)installer" puis sur "Continuer" (deux fois), entrez vos informations de licence et cliquez sur "Continuer", puis sur "Terminer". Dans le cas où les répertoires Eureka_s et wwwroot ne sont pas installés dans la même arborescence que l'ancien serveur, veuillez suivre la procédure suivante : Effectuez un rechercher/remplacer des anciennes occurrences du chemin C:\eureka_s (remplacez "C:\" par l'ancien chemin de votre serveur d'enquête) vers le nouveau chemin. Faites de même pour les occurences du chemin C:\inetpub\wwwroot (remplacez "C:\inetpub" par l'ancien chemin de votre plateforme de gestion). Ces remplacements doivent s effectuer sur les fichiers présents dans les répertoires wwwroot et le nouveau répertoire Eureka_s. Si vous n avez pas d outils pour faire cela, vous pouvez en télécharger un à cette adresse : http://www.divlocsoft.com/ index.htm Créez un raccourci vers Eureka_s\server.exe sur le bureau, lancez-le puis reprenez la documentation d'installation au chapitre " Serveur d'enquête ". Problèmes fréquemment rencontrés Pour palier aux problèmes les plus souvent rencontrés lors de l installation de SphinxConnect, voici une liste de solutions éventuelles. Serveur d enquête Service Serveur d enquête PBM : Le démarrage du service est impossible Cause possible : Une autre application écoute la même IP et le même port que le serveur Le socket (couple IP:Port) est déjà probablement utilisé sur le serveur, veillez à ce qu aucune autre application web (IIS, Apache ) n écoute la même adresse IP et le même port. Pour vous assurer que le problème vient bien de là, essayer de démarrer le serveur d enquête sur un autre port (82 ou 90 par exemple). Vous pouvez également lancer la commande netstat -an (ou netstat -anvb) pour voir si le port est en écoute. 18 / 20
PBM : La page de Test ne s affiche pas Cause possible : Le nom du serveur est incorrect Vérifiez que le nom du serveur est bien celui défini pour l adresse IP du serveur. Essayez en remplaçant le champ "Nom du serveur" par son adresse IP. Publication PBM : Impossible de publier mon enquête depuis le logiciel Cause possible : Les droits sur les fichiers de données ne sont pas valides Vérifiez que les droits sur les répertoire et sous-répertoires Eureka_s, en annexe ici. Pour vérifier les droits tentez d accéder à l url suivante : http://url-plateforme:8080?account=nom-compte&pwd=mdp-compte pour une plateforme sur le port 8080, le compte nom-compte avec le mot de passe mdp-compte. Cette page doit afficher le message "OK". Cause possible : L URL de la plateforme n est pas bien renseignée Arrêtez le serveur d enquêtes, cliquez sur le bouton "Configurer". Vérifiez que le champ url de la plateforme est bien renseigné (Par exemple http://url-plateforme:8080 pour une plateforme sur le port 8080) Cause possible : Votre proxy n'autorise pas les requêtes PUT Rapprochez vous de votre service informatique pour configurer le proxy. Plateforme de Gestion Gestionnaire de compte PBM : La page d accueil du gestionnaire de compte ne s affiche pas Cause possible : L application compte n est pas correctement configuré dans IIS Vérifiez que l application compte ainsi que les autres applications (déclic, moduleop, droits, ) soient bien créés, détails ici. Cause possible : Les pages ASP et/ou ASP.Net ne sont pas autorisé par IIS Dans IIS/extensions de service web, les extensions "Activer server pages" et "ASP.NET v2.0.xxxx" doivent être autorisées, détails ici. Cause possible : La version d ASP.NET utilisée par l application n est pas bonne Dans les propriétés de l application compte, onglet ASP.NET, la version ASP.NET sélectionnée doit être la 2.0.xxxx, détails ici. PBM : Impossible de se loguer au gestionnaire de compte Cause possible : Les droits sur les fichiers de données ne sont pas valides ou compte inexistant Vérifiez les droits sur les répertoires de la plateforme de gestion (détails ici) et que le compte existe bien. Administration PBM : Impossible de se loguer à l interface d administration des comptes Cause possible : Le nom de domaine est mal défini dans IIS Vérifiez que le nom de domaine est bien défini dans IIS. Valeur du "host header value" ou "nom d en-tête" qui se configure via les propriétés du site web, onglet Site Web, bouton "Avancé", sélection de l adresse IP, bouton "Edit". Cause possible : Les droits sur les fichiers de données ne sont pas valides Vérifiez les droits sur les répertoires de la plateforme de gestion, détails ici. PBM : La création d un compte, l enregistrement de la configuration échouent Cause possible : Les droits sur les fichiers de données ne sont pas valides Vérifiez les droits sur les répertoires de la plateforme de gestion, en annexe ici. PBM : La suppression d un compte est impossible Cause possible : Les droits sur les fichiers de données ne sont pas valides Vérifiez les droits sur les répertoires, détails ici, spécialement le fichier wwwroot/config/comptes.mdb et le répertoire Eureka_s/sauvegardes. 19 / 20
Déclic PBM : Erreur à la création/suppression d une enquête Cause possible : Les droits sur les fichiers de données ne sont pas valides Vérifiez que les droits sur les répertoire et sous-répertoires Eureka_s, détails ici. Emailing PBM : La validation de mail sur la page emailing renvoie à la page d accueil Cause possible : La création du socket vers le serveur mail est impossible Vérifiez que l adresse du serveur smtp est correcte Vérifiez que la machine puisse accéder au port 25 (smtp par défaut) du serveur mail (pare-feu, antivirus, ) PBM : Le mail de validation n arrive pas à destination Cause possible : L adresse du webmaster de la plateforme n a pas été changée Les serveurs smtp n acceptent généralement pas les envois d email à partir d adresse extérieur à leur domaine. Pour configurer cette adresse dans la plateforme, connectez-vous en administrateur, cliquez sur le lien configuration, puis sur configuration du système. Remplacer la valeur de la balise <account webmaster="webmaster@lesphinxdeveloppement.fr"> par <account webmaster="votre-adresse-m@il.fr"> Réponses / Analyse PBM : Les onglets Analyse et Réponses affiche une page d erreur Cause possible : Le serveur d enquête n est pas démarré Exécutez le raccourci "Sphinx Serveur" sur le bureau puis en cliquez sur le bouton "Démarrer". Cause possible : L adresse du serveur d enquête est mal renseignée Pour configurer le nom du serveur d enquêtes dans la plateforme, connectez-vous en administrateur, cliquez sur le lien configuration, puis sur configuration du système. Entre les balises "Eureka", renseignez l url du serveur d enquêtes. Exemple : <Eureka>http://www.sphinxonline.net</Eureka> Cause possible : L application compte n est pas correctement configuré dans IIS Vérifiez que l application moduleop soit bien créée dans le site web, détails ici. 20 / 20