Guide d’installation de Geoconcept Sales & Marketing Portal GEOCONCEPT SA Copyright © 2015 Geoconcept This manual is Geoconcept property 1 Guide d’installation de Geoconcept Sales & Marketing Portal... 1. Introduction ................................................................................................................................. 3 1.1. Architecture ...................................................................................................................... 3 1.2. Pré-requis d’installation pour l’application web .................................................................... 4 2. Installation de Geoconcept Sales & Marketing Portal ..................................................................... 7 2.1. Etapes de l’installateur ...................................................................................................... 7 2.2. Activation de la licence .................................................................................................... 23 2.3. Fin de l’installation .......................................................................................................... 30 Version : 2.0 Date : 12/02/15 2 Introduction 1. Introduction Ce guide recense les différentes étapes d’installation nécessaires à la mise en oeuvre de la solution Geoconcept Sales & Marketing Portal. Il comporte uniquement les informations concernant l’installation elle-même. Les informations concernant l’utilisation de la solution sont détaillées dans le Guide de référence. 1.1. Architecture Geoconcept Sales & Marketing Portal est une solution web basée sur les composants de Geoconcept Web. De ce fait son installation inclut l’ensemble des composants communs aux différentes solutions basées sur Geoconcept Web ainsi que les éléments spécifiques à Geoconcept Sales & Marketing Portal. Les composants de Geoconcept Web sont au nombre de trois et permettent d’intégrer des éléments cartographiques, de géocodage et de calcul d’itinéraires dans des applications web: • Geoconcept Web Map (anciennement nommé GCIS) est le composant cartographique. Ce composant utilise une carte Geoconcept, document au format .gcm/.gcr ; • Universal GeoCoder est le composant de géocodage. Ce composant utilise une table de référence, document au format .ugc, accompagné d’une grammaire au format .xml ; • SmartRouting est le composant de calcul d’itinéraires. Ce composant utilise un graphe, document au format .siti Une présentation plus détaillée de chacun de ces composants est disponible dans le Guide de référence Geoconcept Web. Figure 1. Architecture de Geoconcept Sales & Marketing Portal Voici l’ensemble des composants nécessaires au fonctionnement de la solution Geoconcept Sales & Marketing Portal : 3 Guide d’installation de Geoconcept Sales & Marketing Portal... Pour le déploiement de l’application web: • une machine virtuelle Java ; • un serveur web ; • un serveur d’applications ; • l’application web Geoconcept Sales & Marketing Portal. Pour le traitement des requêtes cartographiques, de géocodage et de calcul d’itinéraires: • Geoconcept Web Map ; • Universal GeoCoder ; • SmartRouting Server. Pour stocker les paramètres de l’application ainsi que les données métier: • une base de données. 1.2. Pré-requis d’installation pour l’application web A l’exception de la machine virtuelle Java l’ensemble des éléments pré-mentionnés peuvent être installés via l’installateur de Geoconcept Sales & Marketing Portal. Avertissement Dans tous les cas il est nécessaire d’avoir préalablement installé sur la machine hôte une machine virtuelle Java. Il existe deux méthodes pour l’installation de la solution : • Une installation Automatique pour installer l’intégralité des composants proposés, y compris la base de données (PostgreSQL). Cette méthode est recommandée car elle gère l’ensemble des paramétrages nécessaires et à son issue la solution est utilisable immédiatement ; • Une installation Personnalisée si une partie des composants sont déjà pré-installés, notamment le serveur web, le serveur d’applications ou le serveur de base de données. Elle s’adresse à des utilisateurs avancés souhaitant personnaliser l’installation. Dans le cas d’une installation personnalisée il peut être nécessaire, à l’issue de l’installation, de réaliser un certain nombre de configurations, selon les choix réalisés : • La configuration du serveur web ; • La configuration de Tomcat ; • Le configuration de la base de données. Pour plus de détails sur ces configurations, consulter le chapitre Installation manuelle du Guide de référence Geoconcept Web. 4 Pré-requis d’installation pour l’application web 1.2.1. Machine Virtuelle Java Geoconcept Sales & Marketing Portal nécessite une JVM version 1.6 ou 1.7. Pour télécharger une JVM, rendez vous sur le site de java : http://www.java.com/fr/ Lancer l’exécutable téléchargé et laissez-vous guidez par l’installateur. Le répertoire d’installation de la JVM n’est pas important. En revanche, il est important de choisir entre une installation 32 bits ou 64 bits. En effet, l’installation du serveur d’application Apache Tomcat s’appuie sur cette version de Java. L’installation de Tomcat sera 32 bits si la version de Java est 32 bits. Elle sera 64 bits si la version de Java est 64 bits. Avertissement Nous recommandons fortement d’installer une version 64 bits pour bénéfier de performances optimales. Pour valider l’installation, lancer via la commande Exécuter de Windows (Menu démarrer / exécuter …) le logiciel cmd. Puis lancez la commande « java –version ». Si l’installation a été correctement effectuée, la commande doit renvoyer la version de la JVM installée ainsi que la liste des options de celle-ci. Exemple de réponse à la commande « java -version ». java version "1.6.0_10" Java(TM) SE Runtime Environment (build 1.6.0_10-b33) Java HotSpot(TM) Client VM (build 11.0-b15, mixed mode, sharing) 1.2.2. Base de données Geoconcept Sales & Marketing Portal nécessite une base de données pour stocker l’ensemble des informations nécessaires au bon fonctionnement de l’application ainsi que l’ensemble des données métier analysées au travers de l’outil. Geoconcept Sales & Marketing Portal est compatible avec de nombreux systèmes de gestion de bases de données. Cependant, tous n’offrent pas les mêmes performances, notamment à cause des volumes de données. L’installeur de Geoconcept Sales & Marketing Portal propose d’installer uniquement une base de données PostgreSQL. Si vous souhaitez utiliser un autre serveur de base de données, vous devez l’installer au préalable. Création d’un user de la base de données Il est nécessaire de créer un user spécifique qui sera utilisé par l’application Geoconcept Sales & Marketing Portal avec les droits nécessaires. Voici un script d’exemple pour la création d’un user web pour une base Oracle: Créer un user 5 Guide d’installation de Geoconcept Sales & Marketing Portal... define username = web define userpwd = web drop user &username cascade; create user &username identified by &userpwd default tablespace users; alter user &username quota unlimited on users; grant create session to &username; grant create table to &username; grant create view to &username; grant create sequence to &username; La schéma de la base de données sera initialisé par l’application à l’issue de l’installation de Geoconcept Sales & Marketing Portal. Ensuite l’ensemble des données métier pourront y être intégrées. Pilote de la base de données Pour que l’application web puisse se connecter à la base de données et déployer le schéma propre à l’application, il est nécessaire de copier dans le répertoire lib de Tomcat le pilote à utiliser. Pour le cas d’une base de données Oracle 11g, le pilote jdbc ojdbc6.jar est disponible dans le répertoire d’installation du serveur de base de données. Par exemple : c:\app\oracle\product\11.2.0\dbhome_1\jdbc\lib\ Avertissement Selon la base de données installée le pilote portera un nom différent, mais il est indispensable de copier dans le répertoire lib de Tomcat le pilote à utiliser pour la base de données à utiliser. 6 Installation de Geoconcept Sales & Marketing Portal 2. Installation de Geoconcept Sales & Marketing Portal Le fichier téléchargé est une archive auto-extractible (fichier .exe) de l’installateur complet. Important : si Internet Explorer est utilisé pour exécuter ce lien, le fichier portera le suffixe [1] au lieu de l’extension .exe. Une fois le fichier téléchargé, il convient de le renommer en remplaçant [1] par l’extension .exe Il est recommandé de conserver le contenu de l’archive téléchargée. 2.1. Etapes de l’installateur Pour lancer l’installation, double-cliquer sur le fichier setup.exe puis suivre les étapes de l’assistant. Lancement de l’installation La première étape de l’assistant permet de choisir la langue utilisée pour l’installation et par conséquent la langue dans laquelle sera installé Geoconcept Sales & Marketing Portal. Cliquer sur Suivant. Figure 2. Choix de la langue Un message de bienvenue s’affiche alors. Si entre-temps une étape proposant plusieurs actions possibles s’affiche, vous devez choisir Installer une nouvelle copie de ce produit. Cliquer sur Suivant pour passer à l'étape suivante. 7 Guide d’installation de Geoconcept Sales & Marketing Portal... Figure 3. Message de bienvenue La lecture et l’acceptation du contrat de licence sont nécessaires à la poursuite de l’installation de Geoconcept Sales & Marketing Portal. Choisir J’accepte les termes du contrat de licence pour poursuivre l’installation. 8 Etapes de l’installateur Figure 4. Acceptation des termes du contrat de licence Une confirmation de cette acceptation est demandée. Cliquer sur Oui pour poursuivre l’installation. Figure 5. Confirmation d’acceptation des termes du contrat de licence Identification et saisie du numéro de série L'étape suivante propose de saisir : • Le Nom d’utilisateur ; 9 Guide d’installation de Geoconcept Sales & Marketing Portal... • Le Nom de société ; • Le Numéro de série. Le numéro de série de Geoconcept Sales & Marketing Portal est fourni soit sur la page de téléchargement http://mygeoconcept.com, soit dans un mail envoyé avec le lien de téléchargement. Avertissement La saisie d’un numéro de série valide est un pré-requis pour pouvoir poursuivre l’installation de Geoconcept Sales & Marketing Portal. Le bouton Suivant ne s’active qu’après saisie d’un numéro de série valide. Figure 6. Identification de l’utilisateur Choix de l’emplacement de destination L'étape suivante permet de définir l’emplacement de destination de l’ensemble des composants de la solution à installer. L’installateur propose un dossier de destination par défaut qui est modifiable en cliquant sur Parcourir. 10 Etapes de l’installateur Figure 7. Choix de l’emplacement de destination Choix du mode d’installation L'étape suivante permet de choisir le type d’installation. 11 Guide d’installation de Geoconcept Sales & Marketing Portal... Figure 8. Choix du type d’installation Deux choix sont possibles : Installation Automatique ou Installation Personnalisée. Installation Automatique : L’ensemble des composants du programme seront installés avec les paramètres par défaut. Cliquer sur Suivant. Dans l'étape suivante, un résumé des composants qui vont être installés est affiché avec leur emplacement de destination. Les composants qui seront installés sont les suivants : • Geoconcept : il s’agit du noyau de Geoconcept ; • SmartLabel for Geoconcept : permet de lire les couches SmartLabel paramétrées dans la carte ; • Geoconcept Universal GeoCoder : permet de géocoder des adresses ; • Geoconcept Internet Server : permet le tuilage des couches à afficher dans l’application ainsi que l’affichage des analyses thématiques ; • SmartRouting Server : permet de réaliser tous les calculs basés sur un graphe routier ; • Geoconcept Sales & Marketing Portal : il s’agit de l’application web ; • Outils : 12 Etapes de l’installateur • Microsoft .NET Framework 4.0 ; • Adobe Reader 10.0 ; • Microsoft Visual C++ Redistributable Package ; • Apache Tomcat 6 ; • Apache 2.2 ; • PostgreSQL 9.3 ; • 7zip ; • baretail ; • notepad++ . Astuce Si Apache, Tomcat et/ou PostgreSQL sont déjà présents sur la machine d’installation, il convient de choisir une installation de type personnalisée pour éviter une tentative de mise à jour des composants déjà installés ou une nouvelle installation de ces composants. Avertissement Dans le cas où un serveur IIS serait déjà présent sur le serveur d’installation, un message vous demande une confirmation afin de continuer. Figure 9. Message de détéction d’un serveur IIS 13 Guide d’installation de Geoconcept Sales & Marketing Portal... Figure 10. Récapitulatif des composants installés lors d’une installation automatique Cliquer sur Suivant pour lancer l’installation. Installation personnalisée : Ce mode d’installation permet de modifier le choix des composants à installer ou les chemins par défaut des répertoires de cache et de travail. 14 Etapes de l’installateur Figure 11. Choix du type d’installation Cliquer sur Suivant. L'étape suivante liste l’ensemble des composants proposés par défaut à l’installation. Il convient alors de décocher ceux qui ne doivent pas être installés, notamment si le serveur Web, le serveur Tomcat ou le serveur de base de données ont été préalablement installés. Les composants listés sont les suivants : • Geoconcept : il s’agit du noyau de Geoconcept, à laisser obligatoirement ; • SmartLabel for Geoconcept : permet de lire les couches SmartLabel paramétrées dans la carte, à laisser obligatoirement ; • Geoconcept Universal GeoCoder : permet de géocoder des adresses, à laisser obligatoirement ; • Geoconcept Internet Server : permet le tuilage des couches à afficher dans l’application ainsi que l’affichage des analyses thématiques, à laisser obligatoirement ; • SmartRouting Server : permet de réaliser tous les calculs basés sur un graphe routier, à laisser obligatoirement ; • Geoconcept Sales & Marketing Portal : il s’agit de l’application web, à laisser obligatoirement ; • Outils : 15 Guide d’installation de Geoconcept Sales & Marketing Portal... • Microsoft .NET Framework 4.0 ; • Adobe Reader 10.0 ; • Microsoft Visual C++ Redistributable Package ; • Apache Tomcat 6 ; • Apache 2.2 ; • PostgreSQL 9.3 ; • 7zip ; • baretail ; • notepad++ . Une fois le choix réalisé, cliquer sur Suivant. Figure 12. Choix des composants à installer Avertissement Dans le cas où un serveur IIS serait déjà présent sur le serveur d’installation et que vous avez laissé Apache 2.2 coché durant l’installation, un message vous demande une confirmation afin de continuer. 16 Etapes de l’installateur Figure 13. Message de détéction d’un serveur IIS Répertoires d’installation des dossiers de cache et de travail Même si aucune modification dans le choix des composants n’est réalisée, le choix d’une installation personnalisée permet de redéfinir les chemins pour les répertoires de cache et de travail. Figure 14. Choix de l’emplacement des dossiers de cache et de travail Répertoires du serveur web Si vous avez décoché Apache 2.2 dans le choix des composants à installer, une étape supplémentaire vous demandera d’indiquer deux chemins: 17 Guide d’installation de Geoconcept Sales & Marketing Portal... • Le dossier racine des documents (htdocs) : ce chemin correspond au répertoire de publication du serveur web ; • Le dossier de scripts (cgi-bin) : ce chemin correspond au répertoire des scripts du serveur web. Il convient de choisir ces répertoires dans le dossier racine d’installation du serveur Apache ou IIS déjà existant. L’installateur proposera des chemins par défaut adaptés, selon qu’il ait détécté la présence d’un serveur ou pas. Par exemple, pour un serveur Apache, les chemins peuvent être du type C:\Program Files (x86)\Apache Group\Apache[version]\htdocs\ et C:\Program Files (x86)\Apache Group \Apache[version]\cgi-bin\. Par exemple, pour un serveur ISS, les chemins peuvent être du type C:\inetpub\wwwroot\ et C: \inetpub\scripts\. Dans le cas d’un serveur ISS, la création préalable du répertoire "scripts" dans le dossier racine d’installation du serveur est nécessaire. Si aucun serveur n’est détécté l’installateur proposera des chemins par défaut dans le dossier d’installation de Geoconcept Sales & Marketing Portal. Par exemple : c:\Program Files (x86)\GeoConcept SA\SMP\httpserver\htdocs et c:\Program Files (x86)\GeoConcept SA\SMP\httpserver\cgi-bin Avertissement Dans ce dernier cas il sera nécessaire, à l’issue de l’installation, de récupérer les fichiers copiés dans ces répertoires et de les déplacer dans les répertoires correspondants du serveur web déjà installé. De même, des éléments de configuration supplémentaires devront être réalisés, notamment la modification du fichier httpd.conf du serveur Apache. Il sera nécessaire de déclarer un ScriptAlias qui sera utilisé par le serveur cartographique en ajoutant une ligne dans le fichier de configuration. Ajout de la ligne ScriptAlias ScriptAlias /scripts/ "C:/Program Files (x86)/Apache Group/Apache[version]/cgi-bin/" 18 Etapes de l’installateur Figure 15. Choix de l’emplacement des dossiers des documents et des scripts Tomcat Si vous avez décoché Tomcat dans le choix des composants à installer, un répertoire Tomcat sera tout de même créé dans le répertoire d’installation de la solution, par défaut C:\Program Files (x86)\GeoConcept SA\SMP\tomcat, avec les fichiers de configuration nécessaires au bon fonctionnement de l’application. Avertissement Il sera nécessaire de copier l’ensemble des fichiers déployés dans ces différents sousrépertoires vers les répertoires correspondants de votre serveur Tomcat. Base de données Si vous avez décoché PostgreSQL 9.3 dans le choix des composants à installer, une étape supplémentaire vous demande la configuration de la base de données. 19 Guide d’installation de Geoconcept Sales & Marketing Portal... Avertissement Au préalable il est obligatoire d’avoir créé un schéma (ou User pour Oracle) pour déployer le schéma propre à l’application. Il est nécessaire d’indiquer les informations de connexion qui seront utilisées par l’application web pour accéder à la base de données, afin de paramétrer correctement le fichier de contexte de l’application. Le bouton Test de connexion permet de vérifier si la configuration est correcte. Figure 16. Configuration d’une base de données PostgreSQL 20 Etapes de l’installateur Figure 17. Configuration d’une base de données Oracle Si les informations sont inexactes ou que le serveur indiqué n’est pas accessible, un message alerte l’utilisateur. Il est tout de même possible de poursuivre l’installation. Figure 18. Message d’erreur de connexion Avertissement Dans le cas d’une base de données préalablement installée, il sera nécessaire de copier le pilote jdbc compatible avec votre base de données dans le répertoire lib de Tomcat avant le déploiement de l’application. 21 Guide d’installation de Geoconcept Sales & Marketing Portal... Si vous avez poursuivi l’installation alors que les informations de connexion à la base de données étaient incorrectes, il est possible que vous ayez à éditer le fichier de contexte de l’application smp.xml pour renseigner les bonnes informations. Après avoir paramétré l’ensemble des éléments nécessaires, cliquer sur Suivant. L'étape suivante affiche un résumé des composants qui vont être installés et leur emplacement de destination. Figure 19. Récapitulatif des composants installés lors d’une installation personnalisée Cliquer sur Suivant pour lancer l’installation. Lorsque l'écran de fin d’installation s’affiche, cela indique que l’installation ainsi que l’activation de la solution a pu être correctement réalisée. 22 Activation de la licence Figure 20. Installation terminée 2.2. Activation de la licence Activation de Geoconcept Sales & Marketing Portal Lors de l’installation, l’installateur tente d’activer automatiquement la solution. Pour cela une connexion Internet est nécessaire. Si à l’issue de l’installation l’activation de la solution n’a pas pu être réalisée, notamment parce que la machine n’est pas connectée à Internet, l’activation devra alors être faite manuellement. Un assistant apparaît alors avec deux options: • Je souhaite activer Geoconcept Sales & Marketing Portal sur cet ordinateur ; • J’ai déjà reçu une clé d’activation pour cet ordinateur. 23 Guide d’installation de Geoconcept Sales & Marketing Portal... Figure 21. Assistant d’activation Je souhaite activer Geoconcept Sales & Marketing Portal sur cet ordinateur Cette option est à choisir lorsque vous ne connaissez pas votre clé d’activation. Vous pouvez choisir cette option dans le cas d’une première activation du produit, ou ultérieurement lorsqu’une mise à jour de la clé d’activation sera nécessaire (lors d’un changement de machine, pour une extension de la date de validité et/ou pour une extension fonctionnelle). 24 Activation de la licence Figure 22. Je souhaite activer Geoconcept Sales & Marketing Portal sur cet ordinateur Les écrans suivants vont dépendre de la disponibilité d’une connexion Internet. Vous ne disposez pas d’une connexion Internet Vous devez choisir dans quel cas vous êtes : • J’active pour la première fois la licence sur cette machine ; • Je veux mettre à jour une licence, avec 2 options : • Mise à jour ; • Activation d’urgence (valable 5 jours). Dans les deux cas, l'écran suivant vous informera d’une erreur de connexion. Cliquer sur Suivant. 25 Guide d’installation de Geoconcept Sales & Marketing Portal... Figure 23. Erreur de connexion Un écran vous donne alors les informations nécessaires pour récupérer votre clé d’activation : • Le numéro de série ; • La clé machine. Vous devez copier ces informations et, à partir d’un ordinateur ayant une connexion Internet, aller sur le site web indiqué dans l’assistant afin de saisir ces informations et récupérer votre clé d’activation. Vous devez ensuite saisir la clé d’activation ainsi récupérée dans la zone dédiée dans cet écran. Vous pouvez également envoyer un mail au support technique à l’adresse indiquée dans l’assistant afin de récupérer votre clé d’activation pour ensuite la saisir dans la zone dédiée dans cet écran. 26 Activation de la licence Figure 24. Informations pour activation Vous disposez d’une connexion Internet Deux options sont alors proposées: • J’active pour la première fois la licence sur cette machine ; Astuce Ce choix est utile si vous avez entre-temps rétablit une connexion Internet sur la machine sur laquelle l’installation a été réalisée. • Je veux mettre à jour une licence, avec 2 options : • Mise à jour ; • Activation d’urgence (valable 5 jours). Dans le cas d’une mise à jour de la licence, la clé d’activation actuelle et la clé machine doivent être connues (pré-remplies dans l’assistant). L’activation d’urgence permet de continuer à utiliser l’application temporairement si l’extension de la licence n’a pas encore été autorisée. J’ai déjà reçu une clé d’activation pour cet ordinateur Vous pouvez choisir cette option si vous avez déjà reçu une clé d’activation. Dans ce cas vous pouvez saisir la clé dans la zone de saisie. Une connexion Internet n’est pas nécessaire pour réaliser cette activation. 27 Guide d’installation de Geoconcept Sales & Marketing Portal... Figure 25. J’ai déjà reçu une clé d’activation pour cet ordinateur Quel que soit le mode choisi, lorsque l’activation du logiciel est réussie un écran confirme la bonne activation de la solution. Vous pouvez imprimer les informations d’activation si vous le souhaitez. Figure 26. Confirmation d’activation de la solution Si vous avez rencontré un problème lors de l’activation, des écrans vous informent sur la nature du problème. Veuillez suivre les instructions de l’assistant. 28 Activation de la licence Figure 27. Erreur lors d’une saisie de clé d’activation invalide Figure 28. Erreur lors d’une extension de licence non autorisée Astuce Si vous ne réussissez pas à activer la solution ou que vous ne disposez pas des informations nécessaires à l’activation, vous pouvez à tout instant quitter l’assistant 29 Guide d’installation de Geoconcept Sales & Marketing Portal... d’activation. Cela n’annulera pas votre installation et la fenêtre de fin d’installation apparaîtra. Pour relancer ultérieurement l’assistant d’activation, il sera nécessaire d’aller dans le répertoire d’installation de l’application, sous-répertoire \tools\ulm. Par défaut le chemin est C:\Program Files (x86)\GEOCONCEPT SA\SMP\tools\ulm. Double-cliquer sur le fichier activate.cmd. L’assistant se lancera à nouveau. 2.3. Fin de l’installation Fin de l’installation Une fois l’installation de Geoconcept Sales & Marketing Portal effectuée, l’installateur propose de Démarrer les services maintenant afin de pouvoir directement exécuter Geoconcept Sales & Marketing Portal après l’installation. Les services démarrés sont les suivants : • Geoconcept Sales & Marketing Portal Map ; • Geoconcept Sales & Marketing Portal Tomcat ; • Geoconcept Sales & Marketing Portal PostgreSQL ; • Geoconcept Sales & Marketing Portal Apache Http. 30 Fin de l’installation Figure 29. Installation terminée Astuce Si Apache, Tomcat et/ou la base de données étaient déjà présents sur la machine d’installation, seuls les services nouvellement installés seront activés. Si vous avez installé Tomcat via l’installateur, mais que vous avez des modifications à apporter dans la configuration du serveur web et/ou de la base de données, il convient de ne pas démarrer les services Geoconcept Sales & Marketing Portal Tomcat et Geoconcept Sales & Marketing Portal Map avant d’avoir réalisé ces modifications. Démarrez ensuite manuellement les services via le gestionnaire de services de Windows. Vérification Pour vérifier le bon fonctionnement de la solution, ouvrir la page d’accueil dans votre navigateur adresse_IP_du_serveur/smp (ou depuis le serveur http://localhost/smp) et connectez vous avec l’identifiant admin et le mot de passe geoconcept. 31 Guide d’installation de Geoconcept Sales & Marketing Portal... Avertissement Pour sécuriser votre portail, il est fortement recommandé de modifier l’identifiant et le mot de passe de l’utilisateur User depuis le menu Administration / Utilisateurs. 32