Guide d`installation d`Opti-Time

Guide d’installation d’Opti-Time
1
Guide d’installation d’Opti-Time
Introduction ..................................................................................................................................... 3
Informations sur le document ................................................................................................... 3
Architecture de l’application ...................................................................................................... 3
Pré-requis ....................................................................................................................................... 5
Eléments matériels et numéro de série ..................................................................................... 5
Installation du serveur web (Apache) ........................................................................................ 5
Installation du serveur web (Microsoft IIS) ................................................................................. 6
Installation de l’environnement Java ....................................................................................... 22
Paramétrage spécifique pour les configurations MSSQL .......................................................... 22
Installation d’Opti-Time ................................................................................................................... 27
Installation de l’application Opti-Time ...................................................................................... 27
Installation des données géographiques .................................................................................. 34
Le configurateur Opti-Time ..................................................................................................... 34
Configuration manuelle d’Apache (versions 8.3 et antérieures) ................................................. 35
Création de la base de données (MSSQL) .............................................................................. 36
Création de la base de données (MySQL) .............................................................................. 36
Paramétrage manuel de la connexion à la base de données .................................................... 37
Tests de la configuration ................................................................................................................ 38
Démarrage des services ........................................................................................................ 38
Test de connexion ................................................................................................................. 38
Test du service GCIS ............................................................................................................ 38
Test du module cartographique, HTC ..................................................................................... 40
Test du module de géocodage, UGC ...................................................................................... 41
Test du module de calcul d’itinéraire, Smartrouting .................................................................. 43
Désinstallation ............................................................................................................................... 45
2
Introduction
Introduction
Informations sur le document
Objectif
Cette documentation décrit la procédure d’installation d’Opti-Time.
Version
Les informations figurant dans le présent document décrivent les fonctions et modes d’utilisation d'OptiTime au 1er Février 2017.
Elles sont sujettes à révision sans préavis.
Le logiciel décrit dans ce document est diffusé dans le cadre d’un contrat de droit d’utilisation et ne peut
être utilisé, copié ou cédé qu’en conformité avec les stipulations de ce contrat.
Toute copie de l’application Opti-Time sur disque ou autre support à des fins autres que l’usage du
programme par l’acheteur pour ses besoins propres est interdite.
Informations légales
Opti-Time est une marque déposée de GEOCONCEPT SAS.
Geoconcept est une marque déposée de GEOCONCEPT SAS.
Geoconcept Internet Serveur est une marque déposée de GEOCONCEPT SAS.
Universal Geocoder est une maque déposée de GEOCONCEPT SAS.
Dispatcher est une maque déposée de GEOCONCEPT SAS.
Les captures d'écran peuvent varier en fonction des droits attribués et des options retenues.
Architecture de l’application
L’installation va déployer l’ensemble des composants ci-dessous :
3
Guide d’installation d’Opti-Time
Schéma d’architecture d’Opti-Time
4
Pré-requis
Pré-requis
Il est recommandé que l’installation soit réalisée par un administrateur réseau, un administrateur de base
de données ou de serveur d’application.
Avant l’installation de GCIS, il convient d’installer les éléments suivants :
• Apache HTTP Server ou Microsoft Internet Information Services (IIS).
Depuis la version 8.3.6, l’installation d’Opti-Time installe automatiquement le serveur Apache.
• Java Runtime Environment
• une base de données, les moteurs supportés par défaut étant : Oracle, Microsoft SQL Server, MySQL,
PostgreSQL
Eléments matériels et numéro de série
Cette partie décrit le matériel indispensable pour réaliser l’installation avec les supports fournis :
Matériel requis
• l’installateur Opti-Time ;
• le pack GEOCONCEPT.
La configuration requise est détaillée dans les Notes de versions / Lisez-Moi d’Opti-Time.
Numéro de série requis
Un numéro de série vous sera demandé au cours de l’installation d’Opti-Time. Elle servira à récupérer les
caractéristiques de votre licence Opti-Time et à activer le produit en fin d’installation.
Installation du serveur web (Apache)
Les versions d’Apache compatibles sont indiquées dans les Notes de versions / Lisez-Moi
d’Opti-Time.
Depuis la version 8.3.6, l’installateur d’Opti-Time installe automatiquement le serveur Apache.
Par défaut, Apache Web Server s’installe dans le dossier C:\Program Files (x86)\Apache Software
Foundation\Apache2.2 (= APACHE_PATH dans ce document).
S’il est nécessaire de modifier le port Apache Web Server, éditer le fichier APACHE_PATH/conf/httpd.conf
et modifier le port sur les lignes :
5
Guide d’installation d’Opti-Time
Listen « n° de port »
ServerName « mon-server.com »:« n° de port »
Installation du serveur web (Microsoft IIS)
Voici la procédure d’installation de Microsoft IIS 7 pour Windows Server 2008.
• Lancer le Panneau de configuration de Windows puis lancer Programmes et fonctionnalités :
Panneau de configuration de Windows Server 2008
Fenêtre Programmes et fonctionnalités
• Dans la liste des Tâches visible à gauche du panneau, lancer la tâche Activer ou désactiver des
fonctionnalités Windows et cliquer dans la partie gauche sur Rôles. Dans la partie droite, cliquer sur le
raccourci Ajouter des rôles.
6
Installation du serveur web (Microsoft IIS)
Le Gestionnaire de serveur, les rôles et le raccourci Ajouter des rôles
• Un assistant d’ajout de rôles se lance. Cliquer sur Suivant .
7
Guide d’installation d’Opti-Time
La page d’accueil de l’ajout de rôles
• La liste des rôles à installer sur le serveur s’affiche alors dans la partie droite. Cocher le rôle Serveur
Web (IIS).
8
Installation du serveur web (Microsoft IIS)
La liste des rôles
• Une fenêtre peut alors indiquer que d’autres fonctionnalités sont requises pour effectuer l’installation du
serveur web IIS. Cliquer sur le bouton Ajouter les fonctionnalités requises .
Ajout de fonctionnalités requises
• L’assistant permet alors de passer à l’étape suivante.
9
Guide d’installation d’Opti-Time
L’assistant d’installation de IIS
• Une fenêtre d’introduction au serveur web IIS s’affiche alors.
10
Installation du serveur web (Microsoft IIS)
Introduction au serveur web IIS
• Dans l’étape suivante, il est nécessaire de préciser la liste des services de rôle à installer pour le
serveur web IIS :
• Dans la rubrique Développement d’applications, sélectionner :
• CGI,
• Extensions ISAPI,
• Filtres ISAPI,
11
Guide d’installation d’Opti-Time
Les services de développement d’applications
• Dans la rubrique Sécurité, sélectionner :
• Authentification de base,
• Authentification Windows,
12
Installation du serveur web (Microsoft IIS)
Les services de Sécurité
Les autres services pré-sélectionnés doivent rester cochés.
• Ensuite, une étape de confirmation résume la liste des services de rôles et fonctionnalités à installer.
13
Guide d’installation d’Opti-Time
Confirmation (1/2)
14
Installation du serveur web (Microsoft IIS)
Confirmation (2/2)
• Le bouton Installer permet alors de lancer l’installation du serveur Web IIS.
15
Guide d’installation d’Opti-Time
Installation de IIS
• Une fois l’installation effectuée, l’assistant affiche un rapport du résultat de cette procédure.
16
Installation du serveur web (Microsoft IIS)
Résultats de l’installation (1/2)
17
Guide d’installation d’Opti-Time
Résultats de l’installation (2/2)
• Le bouton Fermer permet alors de terminer l’assistant d’ajout de rôles de Windows. Le Gestionnaire
de serveur affiche alors, dans la liste des rôles, le serveur web IIS installé et l’ensemble des services
de rôles associés.
18
Installation du serveur web (Microsoft IIS)
Les rôles dans le gestionnaire de serveur
• La sélection du serveur web IIS dans l’arborescence des rôles (à gauche de la fenêtre), affiche un
résumé sur le rôle.
19
Guide d’installation d’Opti-Time
Le serveur web IIS dans les rôles (1/2)
20
Installation du serveur web (Microsoft IIS)
Le serveur web IIS dans les rôles (2/2)
Une fois le serveur web IIS installé, il se peut qu’à l’issue de l’installation, le répertoire \Inetpub\Scripts ne
soit pas créé par défaut.
Il convient alors de créer ce répertoire manuellement avant d’effectuer l’installation de GCIS.
Pour ce faire, dans le répertoire racine de IIS (nommé Inetpub), créer un nouveau dossier nommé
Scripts.
21
Guide d’installation d’Opti-Time
Création du dossier à la racine du répertoire Inetpub
Dans ce répertoire Scripts, des extensions du serveur web (CGI et ISAPI) seront installées pour GCIS.
Installation de l’environnement Java
Les versions de java compatibles sont indiquées dans les Notes de versions / Lisez-Moi d’OptiTime.
Télécharger la version de Java souhaitée sur le site d’Oracle [http://www.oracle.com/technetwork/java/
javase/downloads/index.html] puis installer la.
Par défaut, Java est installé dans C:\Program Files\Java\jdk[X] .
Une machine 64-bits permettra un fonctionnement plus performant.
Il est conseillé d’installer la version jdk de Java.
Paramétrage spécifique pour les configurations MSSQL
Avant d’utiliser Opti-Time sur MSSQL, il est nécessaire de vérifier la configuration du service MSSQL.
22
Paramétrage spécifique pour les configurations MSSQL
Il faut impérativement avoir un mode de connexion mixte "authentification Windows" et "authentification
SQL Server" pour utiliser Opti-Time avec SQL Server. Vérifier que le mode d’authentification mixte est
activé :
• Lancer SQL Server Management Studio (SSMS) et se connecter à localhost\SQLEXPRESS
• Clic-droit sur la connexion dans l’Explorateur d’objets > Propriétés
• Dans l’onglet Sécurité, vérifier que le mode d’authentification mixte est activé :
Onglet d’authentification mixte
Activer la fonction TCP/IP et forcer le port 1433
Ouvrir le Gestionnaire de configuration SQL Server.
La fonction TCP/IP doit être active :
23
Guide d’installation d’Opti-Time
Fonction TCP/IP
Dans l’onglet "Adresses IP", renseigner 1433 dans toutes les adresses IP de la fenêtre (IP1 à n, y
compris IPAII) :
24
Paramétrage spécifique pour les configurations MSSQL
Adresse IP
Redémarrer le service SQL Server :
25
Guide d’installation d’Opti-Time
Service SQL Server
26
Installation d’Opti-Time
Installation d’Opti-Time
Depuis la version 8.3.6 d’Opti-Time, l’installation se fait en une seule étape durant laquelle sont installés :
• Geoconcept (le moteur cartographique) ;
• Geoconcept Internet Server, ou GCIS (le serveur web cartographique) ;
• Geoconcept Universal Geocoder, ou UGC (le serveur de géocodage) ;
• Geoconcept SmartRouting (le serveur de calcul d’itinéraires) ;
• selon la version, Geoconcept Dispatcher (le serveur d’optimisation de tournées) ;
• le serveur web Apache HTTP Server ;
• le serveur d’applications Apache Tomcat ;
• le client web cartographique HTC (client Ajax) ;
• ainsi que les paramètres liés au serveur web.
Avant de procéder à l’installation d’Opti-Time, il est nécessaire de lire les Notes de versions /
Lisez-Moi d’Opti-Time, et d’installer si nécessaire les pré-requis.
Installation de l’application Opti-Time
Assistant d’installation
Lancer l’installateur Master_OptiTime en double-cliquant sur le fichier setup.exe situé dans le dossier
fourni.
Ensuite suivre les instructions (voir captures écran ci-dessous) :
Saisir la langue du logiciel Geoconcept et cliquer sur Suivant Si vous avez déjà installé une version antérieure d’Opti-Time, un avertissement vous invite à
confirmer votre souhait de mise à jour
27
Guide d’installation d’Opti-Time
Cliquer sur Suivant Une version 1.8 de Java doit être installée sur le serveur, sinon vous obtenez un message
d’erreur.
28
Installation de l’application Opti-Time
Accepter la licence d’utilisation et cliquer sur Suivant Confirmez votre choix
Saisir la clé d’installation fournie et cliquer sur Suivant 29
Guide d’installation d’Opti-Time
Vérifier le dossier d’installation et cliquer sur Suivant Vous pouvez choisir d’installer Opti-Time sur une autre partition.
Choisissez le type d’installation et cliquer sur Suivant En type d’installation Personnalisée, vous pourrez alors choisir les composants à installer :
30
Installation de l’application Opti-Time
Installation personnalisée
Si vous souhaitez utiliser un serveur http autre que le serveur Apache installé lors de l’installation,
décocher Apache 2.2 dans le dossier Outils.
Si vous souhaitez utiliser un serveur d’application autre que le serveur Tomcat installé lors de
l’installation, décocher Apache Tomcat dans le dossier Outils.
Puis, cliquer sur Suivant .
Vérifier les dossiers d’installation du cache et l’espace
de travail d’Opti-Time (work) et cliquer sur Suivant 31
Guide d’installation d’Opti-Time
Les informations sur l’installation s’affichent alors. Cliquer sur Suivant Il est conseillé de conserver les informations sur l’installation dans un fichier texte.
L’installation se poursuit
32
Installation de l’application Opti-Time
Si le pare-feu Windows bloque l’installation d’un composant, cliquer sur Autoriser l’accès Activation de la licence Opti-Time
En fin d’installation, l’activation automatique d’Opti-Time s’effectue et télécharge la clé d’activation
associée au numéro de série dans le fichier : L’activation automatique (dite silencieuse) d’Opti-Time se
lance en fin d’installation de la solution.
Un accès Internet est requis pour permettre l’activation automatique d’Opti-Time.
Les informations de licence (numéro de série, clé d’activation) sont alors recopiées dans le fichier
gclicense.xml créé dans le dossier :
Opti-Time_PATH\license (par défaut, C:\Program Files (x86)\GEOCONCEPT\Opti-Time\license). En cas
d'échec de l’activation automatique de la solution (par exemple en l’absence d’accès Internet), l’assistant
d’activation se lance et permet d’effectuer une activation manuelle d’Opti-Time.
33
Guide d’installation d’Opti-Time
L’assistant d’installation se termine et propose de poursuivre avec la configuration d’Opti-Time
Fin d’installation
En fin d’installation du produit, la dernière page indique les étapes suivantes à suivre.
Cocher la case pour poursuivre avec la configuration d’Opti-Time.
Cliquer sur Terminer à la fin du processus d’installation. Cette installation est terminée.
Installation des données géographiques
L’installation des données géographiques peut se faire à l’aide de l’assistant d’installation dédié, ou
manuellement en recopiant les donnnées sur le serveur.
Installation via l’assistant
L’assistant d’installation des données livré avec la solution propose d’effectuer la décompression et la
copie des fichiers dans le dossier :
Opti-Time_PATH\data\maps (par défaut, C:\Program Files (x86)\GEOCONCEPT\Opti-Time\data\maps)
Installation manuelle
Télécharger et décompresser l’archive contenant le pack GEOCONCEPT fourni dans le dossier :
Opti-Time_PATH\data\maps (par défaut, C:\Program Files (x86)\GEOCONCEPT\Opti-Time\data\maps).
Le configurateur Opti-Time
Le configurateur permet de paramétrer automatiquement les serveurs web et les serveurs d’application
ainsi que les composants d’Opti-Time installés précédemment.
Dans le menu « Démarrer », lancer le programme Configurateur Opti-Time situé dans le dossier
d’installation de GEOCONCEPT.
34
Configuration manuelle d’Apache (versions 8.3 et antérieures)
Vérifier que les champs de saisie contiennent les bons chemins (corriger si nécessaire) :
• Dossier d’installation d’Opti-Time : dossier dans lequel est installé l’espace de travail d’Opti-Time
ex : C:\Program Files (x86)\GEOCONCEPT\Opti-Time
• Adresse IP ou nom logique de votre serveur : nom ou ip du serveur
• Adresse IP ou nom logique du répartiteur de serveurs : nom ou ip du serveur
• Port Apache ou IIS
Port Apache : Par défaut : 80 (Tomcat est installé sur le port 8080)
Une fois la configuration terminée, cliquer sur Configurer Fermer le configurateur une fois la configuration terminée.
Configuration manuelle d’Apache (versions 8.3 et antérieures)
Ce chapitre concerne uniquement les versions d’Opti-Time antérieures à la version 8.3
Au préalable, il est nécessaire d’arrêter les services suivants, et dans cet ordre :
Apache 2.2, Apache Tomcat, Geoconcept Service
En profiter pour paramétrer ces services en « démarrage automatique » selon.
Éditer le fichier httpd.conf
Dé-commenter les lignes suivantes (faire une recherche sur « mod_proxy » et « mod_rewrite ») :
35
Guide d’installation d’Opti-Time
LoadModule proxy_module modules/mod_proxy.so)
LoadModule proxy_http_module modules/mod_proxy_http.so)
LoadModule rewrite_module modules/mod_rewrite.so)
Dupliquer la ligne ScriptAlias
par : ScriptAlias /scripts/
/cgi-bin/ "APACHE_PATH/cgi-bin/"
et remplacer : ScriptAlias
/cgi-bin/
Atteindre la fin du fichier et y ajouter les lignes suivantes :
Exemple avec les valeurs APACHE_PORT=80 et TOMCAT_PORT=8080 : à remplacer par les ports ad
hoc.
# Virtual Hosts:
NameVirtualHost *:80
# otgs
<VirtualHost *:80>
ServerName le_nom_du_serveur
ProxyPreserveHost On
RewriteCond %{REQUEST_URI} ^/$
RewriteRule ^/(.*) ajp://localhost:8080/otgs [P]
Proxypass /otgs http://localhost:8080/otgs
Proxypassreverse /otgs http://localhost:8080/otgs
Proxypass /otgsCharter http://localhost:8080/otgsCharter
Proxypassreverse /otgsCharter http://localhost:8080/otgsCharter
Proxypass /otgsDoc http://localhost:8080/otgsDoc
Proxypassreverse /otgsDoc http://localhost:8080/otgsDoc
Proxypass /htc http://localhost:8080/htc
Proxypassreverse /htc http://localhost:8080/htc
RedirectMatch permanent ^/$ /otgs
</VirtualHost>
Création de la base de données (MSSQL)
Avant d’effectuer l’installation des données, il est nécessaire de vérifier la configuration de MSSQL.
Cette étape vise à créer l’utilisateur, le schéma et tous les objets Opti-Time dans la base de données
SQL Server.
• Lancer SQL Server Management Studio (SSMS) et se connecter à localhost\SQLEXPRESS
• Créer une base de données (Clic droit sur Bases de données ▸ Nouvelle base de données… et
appelez-la)
• Exécuter les scripts inclus dans le dossier Opti-Time_PATH\database\scripts\mssql\initial-current
Opti-Time est prêt à être utilisé.
Création de la base de données (MySQL)
Cette étape vise à créer l’utilisateur, le schéma et tous les objets Opti-Time dans la base MySQL.
• Lancer le programme MySQL Workbench.
• Se connecter au serveur MySQL.
36
Paramétrage manuel de la connexion à la base de données
• Créer un schéma « Opti-Time ».
• Exécuter les scripts contenus dans le dossier Opti-Time_PATH\database\scripts\mysql\initial-current
• Quitter MySQL Workbench.
Veillez à décocher le mode « Safe Updates » (dans le menu Edition > Préférences, onglet SQL
Queries de My SQL Workbench)
Paramétrage manuel de la connexion à la base de données
Les paramètres de connexion à la base de données se trouvent dans le fichier hibernate.properties
situé dans le dossier Opti-Time_PATH\config\param.
En dessous de « Specific Configuration », copier-coller les lignes de votre base de données.
Décommenter-les et modifier les informations nécessaires sur les lignes :
• hibernate.connection.url
• hibernate.connection.username
• hibernate.connection.password
Redémarrez alors le service Tomcat.
37
Guide d’installation d’Opti-Time
Tests de la configuration
Démarrage des services
Si vous n’aviez pas déjà coché la case Démarrer les services Opti-Time au niveau du configurateur OptiTime, démarrez maintenant les services dans l’ordre suivant :
1. Opti-Time Map,
2. Opti-Time PostgreSQL,
3. Opti-Time Tomcat,
4. Opti-Time Apache Http.
Test de connexion
Aller sur la page web http://localhost/otgs/ et se connecter en admin/admin :
On arrive alors sur la page suivante :
Connexion
Test du service GCIS
Taper l’adresse suivante : http://localhost:(Port_Apache_ou_IIS)/gcis
On arrive alors sur la page suivante :
38
Test du service GCIS
Service GCIS
Cliquer sur le lien « Page d’administration de GCIS ».
Sur la page suivante, cliquer sur Connect .
Le voyant doit passer en vert et les informations de GCIS doivent s’afficher dans le cadre inférieur :
39
Guide d’installation d’Opti-Time
Administration GCIS
GCIS fonctionne correctement.
Test du module cartographique, HTC
Taper l’adresse suivante : http://localhost:(Port_Tomcat)/htc/
Cliquer sur les différents boutons afin de constater que le service répond bien.
Le dernier bouton CreateMap permet de tester l’affichage de la carte :
40
Test du module de géocodage, UGC
Test d’affichage
HTC fonctionne correctement.
Test du module de géocodage, UGC
Taper l’adresse suivante : http://localhost:(Port_Tomcat)/ugc-admin/
41
Guide d’installation d’Opti-Time
Accueil UGC Server
Se rendre d’abord sur la page du lien DataSources Configuration , copier le nom du fichier de
géocodage sans l’extension « ugc » (exemple : navteq_maps_for_geoconcept_france_Q412_v1).
Configuration des Datasources
Ensuite aller sur la page du lien Test datasource (single address) . Ce lien permet de tester le
géocodage d’une adresse.
Coller le nom du fichier dans le champ « datasource », et cliquer sur le bouton Search . UGC doit
donner une proposition :
42
Test du module de calcul d’itinéraire, Smartrouting
Géocodage
Test du module de calcul d’itinéraire, Smartrouting
Taper l’adresse suivante : http://localhost:(Port_Tomcat)/smartrouting-admin/
Accueil Smartrouting Server
Cliquer sur Test calculate route : single .
43
Guide d’installation d’Opti-Time
Noter le nom de la carte présente sur le serveur (dossier OT_PATH\data\maps) dans le champ
« datasource ».
Cliquer sur calculate route 44
Désinstallation
Désinstallation
La désinstallation d’Opti-Time s’effectue en suivant ces étapes :
1. Arrêter les services d’Opti-Time
2. Lancer le Panneau de configuration de Windows puis lancer Programmes et fonctionnalités.
Sélectionner Opti-Time et clic-droit désinstaller. Ne pas demander la suppression complète du dossier.
45
46