Manuel de référence de Geoconcept Web  -  Installation

Nous préconisons d’utiliser le serveur d’application Apache Tomcat en version 8. Vous pouvez trouver cette version en téléchargement à l’adresse suivante : http://tomcat.apache.org/ .

Lancer ensuite l’installateur et suivre les différentes étapes. Le répertoire d’installation n’est pas important ; toutefois, il est nécessaire de garder en mémoire pour la suite de l’installation de l’application. Il sera noté <TOMCAT_HOME> dans la suite de ce document.

L’installateur demande un mot de passe d’administration (facultatif). Si vous le souhaitez, mettez celui de votre choix et n’oubliez pas de le conserver. Associez la valeur 80 pour le port utilisé par le service Apache Tomcat (si ce port est déjà utilisé, en choisir un autre).

Ensuite, il demande si vous souhaitez installer le logiciel en tant que service. Répondez positivement à cette question.

A la fin de l’installation, le service Tomcat a été installé.

Si Tomcat est pré-installé, il est nécessaire de modifier le fichier server.xml.

Dans <GlobalNamingResources> ajouter :

        <!--GC-->
        <Resource
        name="geoconcept/gc/default"
        type="com.geoconcept.gc.provider.Provider"
        scope="Shareable"
        description="GC connection factory -local dll"
        auth="Container"
        RootDirectory="C:\Program Files\GEOCONCEPT\Geoconcept Web\gc\jee\gc"
        factory="com.geoconcept.gc.connect.tomcat.ConnectionFactory"
        ConnectionMode="LocalDll"
        />

        <!--UGC-->
        <Resource
                name="geoconcept/ugc/default"
                type="com.geoconcept.ugc.service.CodingProvider"
                scope="Shareable"
                description="UGC connection factory -local dll"
                auth="Container"
                RootDirectory="C:\Program Files\GEOCONCEPT\Geoconcept Web\ugc\jee\ugc"
                RefTablesDirectory="C:\Geoconcept Web\data\maps"
                factory="com.geoconcept.ugc.connect.tomcat.ConnectionFactory"
                ConnectionMode="LocalDll"
        />

        <!--SmartRouting-->
        <Resource
                name="geoconcept/smartrouting/default"
                type="com.geoconcept.smartrouting.Provider"
                scope="Shareable"
                description="Smartrouting connection factory -local dll"
                auth="Container"
                RootDirectory="C:\Program Files\GEOCONCEPT\Geoconcept Web\smartrouting\jee\smartrouting"
                GraphsDirectory="C:\Geoconcept Web\data\maps"
                factory="com.geoconcept.smartrouting.connect.tomcat.ConnectionFactory"
                ConnectionMode="LocalDll"
        />

Allez avec l’explorateur de fichier Windows dans le répertoire <TOMCAT_HOME>/bin et lancer l’exécutable « Tomcat8w.exe » (dans le cas d’une version 8 de Apache Tomcat). Cet exécutable est la console du serveur d’application Apache Tomcat.

Le bouton Start est grisé lorsque le serveur est en cours d’exécution. Dans ce cas, cliquez sur le bouton Stop pour l’arrêter.

Positionnez l’option Startup type en Automatic et cliquez sur le bouton Appliquer. Ensuite, allez sur l’onglet Java, dans la case pour les « Java Options », rajouter les lignes :

-Xmx1024m
-Xms256m

Et cliquez sur le bouton Appliquer.

Retournez sur l’onglet General et cliquez sur le bouton Start pour démarrer le serveur Tomcat.

Afin de vérifier si l’installation a été faite correctement, ouvrez un navigateur web et inscrivez l’url suivante : http://localhost:numero_port_utilise (par exemple : http://localhost:80 ou http://localhost).

Vous devez obtenir la page d’accueil de Tomcat équivalente.

Installation de la base de données

La version 8.0 est la version actuelle de MYSQL. Elle est téléchargeable à cette adresse : https://dev.mysql.com/downloads/mysql/ .

Parmi la liste des produits téléchargeables, télécharger le fichier Windows MSI Installer en fonction de la version de votre ordinateur (32 ou 64 bits) : ce fichier est de la forme mysql-n°de-version-win32.msi. Une fois téléchargé, double-cliquer sur le fichier téléchargé pour lancer l’installation puis suivre les différentes étapes de l’installation.

A la fin de cet assistant, cochez la case Launch the MySQL Instance Configuration Wizard puis renseigner les différentes étapes avec les options suivantes :

default-character-set=utf8
character-set-server=utf8

A la fin de l’installation, il est également appréciable d’installer les outils complémentaires afin de pouvoir manipuler facilement la base de données : le Workbench de Mysql est adapté. Il est téléchargeable à cette adresse : https://dev.mysql.com/downloads/workbench/ .

Après avoir téléchargé le fichier Windows MSI Installer, double-cliquer sur le fichier pour lancer l’installation.

Création du schéma et de l’utilisateur

Une fois ces opérations faites, ouvrir le MySQL Workbench. Via le menu SQL Development, une connexion à la base de données doit être spécifiée de cette façon : vous pouvez utiliser le bouton Test Connection pour vérifier vos paramètres :

En double-cliquant sur cette connexion, vous ouvrez une fenêtre SQL Editor. Dans la colonne de gauche appelée Object Browser, il est nécessaire de créer un nouveau schéma (clic-droit dans la fenêtre) appelé dans ce document geoweb.

Ouvrez également une connexion Admin via la menu Server Administration (à droite du workbench). Dans l’onglet Accounts puis Server Access Management, créer un nouvel utilisateur avec un mot de passe grâce au bouton Add account (dans ce document, nous prendrons l’exemple d’un utilisateur web avec pour mot de passe web). Utiliser le sigle « % » dans la zone de texte « Limit Connectivity to Hosts Matching ».

Via le menu Schema Privileges, assignez tous les droits à cet utilisateur web sur le schéma geoweb en utilisant la fonctionnalité Add Entry… puis suivant le schéma ci-dessous:

Sélectionner ensuite tous les droits via le bouton Select « ALL » puis Save Changes.

Ajout du driver JDBC

Il est nécessaire de télécharger le driver JDBC à partir de https://dev.mysql.com/downloads/connector/j/ afin d’autoriser les sources de données Tomcat à accéder au serveur MySQL.

Une fois l’archive dézippée, copier-coller le driver (uniquement le fichier .jar) dans le répertoire <TOMCAT_HOME>\lib\.

L’architecture du fichier de contexte est consultable dans la rubrique Déploiement de l’application.

Installation du serveur de base de données

La base de donnée PostgreSQL est téléchargeable ici : https://www.postgresql.org/download/ . Suivre les différentes étapes d’installation proposées par l’installateur. Vous pouvez vous appuyez sur la documentation en ligne à cette adresse : https://www.postgresql.org/docs/ .

Il est recommandé d’installer la base de données PostgreSQL avec un client pgAdmin 4 (pour Windows). Exécuter pgAdmin 4, puis se connecter à la base avec les droits administrateur.

Création de la base de données

Dans ce document, nous créons un utilisateur web, avec comme mot de passe « web ». Ce mot de passe sera utilisé par la suite dans la configuration du serveur d’application.

Créer une nouvelle base de données nommé « geoweb » (clic droit sur « Databases » dans l’arborescence puis « Add a database ») en utilisant l’encodage UTF-8 et l’assigner à l’utilisateur « web » dans l’onglet Owner. Utiliser le modèle postgres si nécessaire. Assigner tous les droits à cet utilisateur sur cette base geoweb dans l’onglet Rights. Noter que le schéma nommé « public » est automatiquement créé.

Ajout du driver JDBC

Le driver JDBC peut être trouvé à l’adresse suivante : https://jdbc.postgresql.org/download.html/ .

L’architecture du fichier de contexte est consultable dans la rubrique Déploiement de l’application.

Dézipper le fichier téléchargé, puis copier-coller le driver JDBC (fichier .jar uniquement) dans le répertoire « <TOMCAT_HOME> »/lib pour autoriser les sources de données Tomcat à accéder au serveur PostgreSQL.

Authentification

Si nécessaire, modifiez le fichier de configuration pg_hba.conf qui permet d’avoir un accès distant au serveur PostgreSQL, en suivant les instructions en ligne : https://www.postgresql.org/docs/12/client-authentication.html .

Dans le cadre de l’utilisation du gestionnaire de base de données SQL Server de Microsoft, la version présentée ici est SQL Server 2019 (SQLServer Express 2019 RC et SQL Server Manager Studio Express).

La version est téléchargeable : https://www.microsoft.com/en-in/sql-server/sql-server-downloads .

De la même façon que décrit pour l’utilisation de MySQL, il est nécessaire de disposer d’un profil utilisateur (web par exemple) qui sera employé dans le cadre de l’application et doit disposer de l’ensemble des droits sur la base de données créée pour l’application web.

Installation de la base de données

Après avoir téléchargé et démarré l’installateur, deux étapes doivent être respectées durant l’installation de SQL Server 2019 :

Une fois ces éléments paramétrés et l’installation terminée, lancer SQL Server Manager Studio Express en se connectant de la façon suivante :

Indiquer le nom de serveur : nom-de-la-machine (ou adresse IP)\nom-de-l’instance. Puis, choisir SQL Server Authentication comme mode d’authentification. Enfin, indiquer l’identifiant et le mot de passe définis lors de l’installation du SGBD (Exemple : sa / manager).

Création de la base de données

Une fois connecté, l'étape suivante porte sur la création d’une base de données qui sera associée à l’application, lui permettant ainsi son déploiement et son bon fonctionnement. Dans cet exemple, la base de données sera nommée "geoweb".

Faire un clic droit sur le répertoire database, puis New database.

Puis, dans Security, créer une Connection en donnant un nom d’accès / d’utilisateur, par exemple web et un mot de passe web. Veiller à bien indiquer que c’est une SQL Server Authentification. Préciser également que la base de données par défaut est "geoweb", la base précédemment créée.

Ensuite, créer le mappage entre l’utilisateur et la base de données. Cliquer sur Security puis Connection et clic droit sur le nom de l’utilisateur créé. Cliquer enfin sur Properties.

Dans les propriétés de connexion / utilisateur, cliquer sur User mapping et cocher les options suivantes :

Configuration de SQL Server

Une fois la base de données, l’utilisateur et le mappage configurés, il est nécessaire d’ouvrir le SQL Server Configuration Manager (configuration tool) afin de paramétrer les connexions réseau de SQL Server 2019.

Lorsque l’outil de paramétrage est lancé, cliquer sur Configuring the SQL Server network, choisir Protocols for SQLEXPRESS puis double-cliquer sur TCP/IP.

Dans le menu TCP/IP, dans l’onglet protocol, basculer le paramètre Activated sur Yes. Puis dans l’onglet Adresses IP, dans le groupe IPAll en bas de la fenêtre, saisir la valeur 1433 pour Port TCP et ne pas renseigner le paramètre Dynamic TCP Ports.

Lorsque ces paramètres sont validés, revenir sur le menu de gauche et cliquer sur Services SQL Server ; une liste de serveur SQL est proposée sur le volet droit du menu. Clic droit sur SQL Server (SQLEXPRESS) et enfin cliquer sur Restart.

Ajout du connecteur JDBC et du fichier XML de configuration

Après le paramétrage de SQL Server 2008, il est nécessaire de placer le driver JDBC, dans le répertoire « <TOMCAT_HOME> »/lib du serveur d’application Tomcat.

Le connecteur est accessible à l’adresse suivante : https://docs.microsoft.com/en-us/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server?view=sql-server-ver15 .

Afin que tout soit fonctionnel, coupler le déploiement du nouveau .war avec un nouveau fichier xml spécifique à l’utilisation conjointe du Designer et SQL Server (à placer dans le répertoire « <TOMCAT_HOME> »/conf/Catalina/localhost du serveur d’application Apache Tomcat).

L’architecture de ce fichier de contexte est consultable dans la rubrique Déploiement de l’application.

Il est nécessaire de créer un user spécifique qui sera utilisé par l’application Geoconcept Web 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 

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 Web.

Choisir le driver JDBC correspondant à votre version d’Oracle. Il peut être trouvée à l’adresse suivante :  : https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html . Le driver est de la forme ojdbcXX.jar (où le XX correspond au numéro de version du driver ojdbc).

L’architecture du fichier de contexte est consultable dans la rubrique Déploiement de l’application.

L’installateur de Geoconcept Web installe les librairies d’Universal Geocoder dans « <GEOCONCEPT_WEB_HOME> »/tomcat/lib, avec « <GEOCONCEPT_WEB_HOME> » le chemin d’installation de Geoconcept Web. Ces fichiers .jar sont les suivants :

En cas d’installation manuelle, il est nécessaire d’indiquer au serveur d’application où se trouve l’application UGC JEE. Grâce à un éditeur de texte, éditer le fichier server.xml présent dans un répertoire semblable à : « <TOMCAT_HOME> »\conf\,

Au sein du tag GlobalNamingResources, ajouter les lignes suivantes :

        <!--UGC-->
        <Resource
                name="geoconcept/ugc/default"
                type="com.geoconcept.ugc.service.CodingProvider"
                scope="Shareable"
                description="UGC connection factory -local dll"
                auth="Container"
                RootDirectory="``<UGC_HOME>''"
                RefTablesDirectory="``<DATA_HOME>''\data\maps"
                factory="com.geoconcept.ugc.connect.tomcat.ConnectionFactory"
                ConnectionMode="LocalDll"
     />

Les chaînes de caractères UGC_HOME et DATA_HOME doivent être remplacées par les chemins adéquats.

En option, il est également possible de rajouter le chemin vers un répertoire qui stocke les tables de référence :

RefTablesDirectory="D:\Data\TableRef"

Cette application permet de tester le bon fonctionnement de UGC JEE. Pour la déployer il est nécessaire :

Ouvrir un navigateur Internet et taper l’adresse suivante : http://nom_du_serveur:numéro_du_port/ugc-admin

Dans l’outil d’administration, cliquer sur « Load datasource » et saisir le nom de la table de référence : Loire (table d’exemple située dans le répertoire « <DATA_HOME> »\data\maps)

Cliquer ensuite sur « Active datasources » puis sur « test ». L’adresse par défaut est située dans le 13ème arrondissement de Paris. Cliquer sur ‘`Search’' : un résultat doit apparaître dans la fenêtre située en-dessous du formulaire de recherche.

En utilisant la webapp ugc-admin, vous pouvez spécifier la configuration de votre table de référence. Cette option est intéressante lorsque votre table de référence n’est pas dans le même système de coordonnées que la carte Geoconcept, par exemple.

Cette nouvelle configuration peut se faire en cliquant sur Datasource configuration, puis en cliquant sur Create. Il est ensuite nécessaire de spécifier le code EPSG dans le champ Coordinate system, afin que le géocodeur retourne les résultats dans le-dit système de coordonnées.

L’installateur de Geoconcept Web installe les librairies de SmartRouting Server JEE dans « <GEOCONCEPT_WEB_HOME> »/tomcat/lib, avec « <GEOCONCEPT_WEB_HOME> » le chemin d’installation de Geoconcept Web. Ces fichiers .jar sont les suivants :

En cas d’installation manuelle, il est nécessaire d’indiquer au serveur d’application où se trouve l’application SmartRouting JEE. Grâce à un éditeur de texte, éditer le fichier server.xml présent dans un répertoire semblable à : « <TOMCAT_HOME> »\conf\,

Au sein du tag GlobalNamingResources, ajouter les lignes suivantes :

        <!--SmartRouting-->
        <Resource
                name="geoconcept/smartrouting/default"
                type="com.geoconcept.smartrouting.Provider"
                scope="Shareable"
                description="Smartrouting connection factory -local dll"
                auth="Container"
                RootDirectory="``<SMARTROUTING_HOME>''\smartrouting\jee\smartrouting"
                GraphsDirectory="``<DATA_HOME>''\data\maps"
                factory="com.geoconcept.smartrouting.connect.tomcat.ConnectionFactory"
                ConnectionMode="LocalDll"
    />

Les chaînes de caractères SMARTROUTING_HOME et DATA_HOME doivent être remplacées par les chemins adéquats.

En option, il est également possible de rajouter le chemin vers un répertoire qui stocke les tables de référence :

GraphsDirectory="D:\Data\graphs"

Cette application permet de tester le bon fonctionnement de SmartRouting JEE. Pour la déployer il est nécessaire :

Ouvrir un navigateur Internet et taper l’adresse suivante : http://nom_du_serveur:numéro_du_port/smartrouting-admin

Le bouton Check provider access permet de vérifier la bonne installation. Le message All tests succeded doit s’afficher.

Dans l’outil d’administration, cliquer sur « Datasource configuration ». Les graphes définis dans le répertoire par défaut (ou le répertoire défini par le tag GraphsDirectory dans le fichier server.xml) s’affichent alors.

En cliquant sur test, vous pouvez tester le calcul d’un itinéraire : un résultat doit apparaître dans la fenêtre située en-dessous du formulaire de recherche.

Le fichier .war est le dossier compressé contenant l’application web. Il est nécessaire de le déployer dans le serveur d’application Apache Tomcat.

Vous trouverez ce fichier war dans le dossier « <GEOCONCEPT_WEB_HOME> »/tomcat/webapps, avec « <GEOCONCEPT_WEB_HOME> » le chemin d’installation de Geoconcept Web.

Arrêter les service Apache Tomcat,.

Placer le fichier geoconcept-web.war dans le répertoire « <TOMCAT_HOME> »/webapps.

Le fichier de contexte est indispensable, nommé geoconcept-web.xml il doit être positionné dans le répertoire « <TOMCAT_HOME> »\conf\Catalina\localhost. Ce fichier permet de spécifier différents paramètres dont le mot de passe et le nom de la base de données nécessaires au bon fonctionnement de l’application cartographique.

Ce fichier peut être créé à partir d’un document texte vide en modifiant son extension. Des exemples sont disponibles dans « <GEOCONCEPT_WEB_HOME> »\database\conf\Catalina\localhost.

Editer le fichier geoconcept-web.xml en fonction du SGBD utilisé. Copier-coller dans ce fichier les paramètres suivants en fonction de votre SGBD et modifier :

Cas de l’utilisation d’une base de données MySQL 

<Context reloadable="false">

<Resource
        name="jdbc/geoweb"
        auth="Container"
        type="javax.sql.DataSource"
        username="web"
        password="web"
        driverClassName="com.mysql.jdbc.Driver"
        url="jdbc:mysql://localhost:3306/SCHEMA_BASE?useUnicode=true&amp;characterEncoding=UTF-8"
        maxActive="8"
        maxIdle="4"
        testWhileIdle="true"
    validationQuery="SELECT 1"
    testOnBorrow="true"
        timeBetweenEvictionRunsMillis="1800000"
        minEvictableIdleTimeMillis="21600000"
/>

<!-- geocoder resource definition -->
<ResourceLink
  global="geoconcept/ugc/default"
  name="geoconcept/ugc/default"
  type="com.geoconcept.ugc.service.CodingProvider"
/>

<!-- smartrouting resource definition -->
<ResourceLink
  global="geoconcept/smartrouting/default"
  name="geoconcept/smartrouting/default"
  type="com.geoconcept.smartrouting.Provider"
/>

<!-- geoconcept web map resource definition -->
<ResourceLink
  global="geoconcept/gc/default"
  name="geoconcept/gc/default"
  type="com.geoconcept.gc.provider.Provider"
/>

<Environment name="LicenseFilePath" value="C:\Program Files\GEOCONCEPT\Geoconcept Web\license" type="java.lang.String" override="true"/>

</Context>

Cas de l’utilisation d’une base de données PostgreSQL 

<Context path="geoweb" >

<Resource
        name="jdbc/geoweb"
        type="javax.sql.DataSource"
        username="web"
        password="web"
        driverClassName="org.postgresql.Driver"
        maxWait="5000"
        url="jdbc:postgresql://localhost:5432/SCHEMA_BASE?useUnicode=true&amp;characterEncoding=UTF-8"
        maxActive="8"
        maxIdle="4"
/>

<!-- geocoder resource definition -->
<ResourceLink
  global="geoconcept/ugc/default"
  name="geoconcept/ugc/default"
  type="com.geoconcept.ugc.service.CodingProvider"
/>

<!-- smartrouting resource definition -->
<ResourceLink
  global="geoconcept/smartrouting/default"
  name="geoconcept/smartrouting/default"
  type="com.geoconcept.smartrouting.Provider"
/>

<!-- geoconcept web map resource definition -->
<ResourceLink
  global="geoconcept/gc/default"
  name="geoconcept/gc/default"
  type="com.geoconcept.gc.provider.Provider"
/>

<Environment name="LicenseFilePath" value="C:\Program Files\GEOCONCEPT\Geoconcept Web\license" type="java.lang.String" override="true"/>

</Context>

Cas de l’utilisation d’une base de données SQL Server 

<Context reloadable="false">
<Resource
        name="jdbc/geoweb"
        auth="Container"
        type="javax.sql.DataSource"
        username="web"
        password="web"
        driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
        url="jdbc:sqlserver://localhost:1433;databaseName=SCHEMA_BASE;"
        maxActive="8"
        maxIdle="4"
/>

<!-- geocoder resource definition -->
<ResourceLink
  global="geoconcept/ugc/default"
  name="geoconcept/ugc/default"
  type="com.geoconcept.ugc.service.CodingProvider"
/>

<!-- smartrouting resource definition -->
<ResourceLink
  global="geoconcept/smartrouting/default"
  name="geoconcept/smartrouting/default"
  type="com.geoconcept.smartrouting.Provider"
/>

<!-- geoconcept web map resource definition -->
<ResourceLink
  global="geoconcept/gc/default"
  name="geoconcept/gc/default"
  type="com.geoconcept.gc.provider.Provider"
/>

<Environment name="LicenseFilePath" value="C:\Program Files\GEOCONCEPT\Geoconcept Web\license" type="java.lang.String" override="true"/>

</Context>

<Context reloadable="true">

 <Resource name="jdbc/geoweb" auth="Container"
        type="javax.sql.DataSource"
        username="web"
        password="web"
        driverClassName="oracle.jdbc.OracleDriver"
        url="jdbc:oracle:thin:@localhost:1521:SCHEMA_BASE"
        maxActive="8"
        maxIdle="4"
        testWhileIdle="true"
        timeBetweenEvictionRunsMillis="1800000"
        minEvictableIdleTimeMillis="21600000"/>

<!-- geocoder resource definition -->
<ResourceLink
  global="geoconcept/ugc/default"
  name="geoconcept/ugc/default"
  type="com.geoconcept.ugc.service.CodingProvider"
/>

<!-- smartrouting resource definition -->
<ResourceLink
  global="geoconcept/smartrouting/default"
  name="geoconcept/smartrouting/default"
  type="com.geoconcept.smartrouting.Provider"
/>

<!-- geoconcept web map resource definition -->
<ResourceLink
  global="geoconcept/gc/default"
  name="geoconcept/gc/default"
  type="com.geoconcept.gc.provider.Provider"
/>

<Environment name="LicenseFilePath" value="C:\Program Files\GEOCONCEPT\Geoconcept Web\license" type="java.lang.String" override="true"/>

</Context>

Cas de l’utilisation d’une base de données HSQLDB

HSQLDB est une base de données écrite en Java. C’est une base de données embarquée : elle crée des fichiers directement sur le disque ; aucune installation préalable n’est donc nécessaire.

Dans le cadre de l’utilisation du Geoconcept Web, les paramètres peuvent être stockés à l’aide d’une solution de base de données embarquée via la technologie HSQLDB. Pour obtenir le driver JDBC, allez sur le site suivant : http://www.hsqldb.org/. Ce driver est de la forme hsqldb.jar. Il doit être placé dans le répertoire « <TOMCAT_HOME »>\lib.

Dans le cas de l’utilisation de cette base de données, il est nécessaire de créer le fichier DesignerParameters.xml dans le répertoire « <TOMCAT_HOME> »\lib et de compléter les paramètres comme ci-dessous, avec les paramètres propres à la configuration de votre serveur. Dans l’exemple ci-dessous, les fichiers BDD seront créés directement dans le répertoire C:\BDD. Ce paramètre est modifiable via la ligne url.

<Context path="/geoconcept-web" reloadable="true" >
<!-- Extra info begin -->
<Parameter name="database.connection.datasource"
value="java:comp/env/jdbc/geoweb" override="true"/>

<Resource
        name="jdbc/geoweb"
        auth="Container"
        driverClassName="org.hsqldb.jdbcDriver"
        maxActive="100"
        maxIdle="30"
        maxWait="10000"
        password="web"
        username="web"
        type="javax.sql.DataSource"
        url="jdbc:hsqldb:file:[Path\To\Database]"
/>

<!-- geocoder resource definition -->
<ResourceLink
  global="geoconcept/ugc/default"
  name="geoconcept/ugc/default"
  type="com.geoconcept.ugc.service.CodingProvider"
/>

<!-- smartrouting resource definition -->
<ResourceLink
  global="geoconcept/smartrouting/default"
  name="geoconcept/smartrouting/default"
  type="com.geoconcept.smartrouting.Provider"
/>

<!-- geoconcept web map resource definition -->
<ResourceLink
  global="geoconcept/gc/default"
  name="geoconcept/gc/default"
  type="com.geoconcept.gc.provider.Provider"
/>

<!-- Extra info end

<Logger className="org.apache.catalina.logger.SystemOutLogger" verbosity="4" timestamp="true"/>

<Environment name="LicenseFilePath" value="``<GEOCONCEPT_WEB_HOME>''\license" type="java.lang.String" override="true"/>

</Context>

Une fois le fichier .war et le fichier .xml déposés à leurs endroits respectifs (cf. paragraphes précédents), démarrer le services Apache Tomcat.

Il est ensuite nécessaire de spécifier certains paramètres afin de s’assurer du bon fonctionnement de l’application cartographique et des services associés.

Deux possibilités s’offrent à vous pour effectuer ces manipulations :

Nous retiendrons la deuxième solution. La première est réservée à des utilisateurs avertis connaissant le fonctionnement de l’application et les différents paramètres nécessaires au fonctionnement de l’application.

Modification des paramètres via la console d’administration

La console est accessible via l’URL : http://localhost/geoconcept-web à partir du serveur. Cette URL devra être adaptée à votre propre installation (localhost remplacé par le nom de votre machine, éventuellement un numéro de port, geoconcept-web remplacé par le nom éventuellement différents de votre fichier .war si vous avez modifié le nom geoconcept-web).

Par défaut, les paramètres de connexion sont les suivants : admin / geoconcept. Se connecter à l’application.

Par défaut, l’utilisateur voit s’afficher la page d’accueil.