Gestion de JMap Server

Table des matières

1. État de JMap Server
2. Exportation et importation
3. Données des utilisateurs
4. Paramètres de JMap Server
5. Statistiques d’utilisation
6. Journalisation
7. Messages
8. Base de données System de JMap Server
9. Prise de copies de sécurité

---

Les sections suivantes décrivent les tâches de gestion de JMap Server.

État de JMap Server

La section État de JMap Admin fournit de nombreuses informations utiles pour effectuer le suivi de JMap Server. De plus, cette section fournit des informations détaillées sur votre licence d’utilisation. Chaque partie est expliquée ci-dessous.

Exportation et importation

Exportation et importation de la configuration de JMap

Votre configuration de JMap Server (sources de données spatiales, bases de données, projets, couches, etc.) est stockée sur disque en format binaire. Cette configuration n’est accessible que par le biais de JMap Server et n’est compatible qu’avec votre version en cours (version principale, p. ex. 7.X). En utilisant l’outil d’exportation, une version texte de cette configuration peut être produite. Cette configuration exportée peut alors être importée de nouveau vers JMap Server, et même vers une nouvelle version, avec des paramètres identiques ou différents. Voici quelques situations où il peut être utile d’exporter et d’importer votre configuration :

• Vous avez installé une nouvelle version de JMap comportant des changements majeurs et vous désirez réutiliser votre configuration existante. Vous pouvez exporter la configuration de votre version JMap précédente et ensuite l’importer dans la nouvelle version.
• Vous gérez de nombreuses instances de JMap Server et vous devez déplacer un projet d’une instance vers l’autre. Vous pouvez effectuer une exportation partielle afin de n’exporter que le projet dont vous avez besoin, puis importer celui-ci dans l’autre instance.
• Vous devez reproduire votre environnement de développement dans l’environnement de production. Vous pouvez effectuer une exportation complète de votre serveur de développement puis l’importer vers le serveur de production.

Les outils d’exportation et d’importation sont disponibles en sélectionnant Import / Export à partir de la section JMap Server.

Exportation

Lorsque vous exportez une configuration, vous devez déterminer si vous désirez exporter la configuration entière ou certaines ressources spécifiques (exportation partielle). Si vous décidez d’exporter des ressources spécifiques, vous devez déterminer si vous désirez exporter des bases de données, des sources de données spatiales, des projets, des modèles de style ou des modèles de métadonnées. Il existe une relation de dépendance entre ces diverses ressources : les projets dépendent des sources de données spatiales et des modèles de style, tandis que les sources de données spatiales peuvent dépendre de bases de données. Par conséquent, si vous exportez un projet, les sources de données spatiales, les modèles de style et possiblement aussi les bases de données seront exportées aussi.

Si l’un des projets contient des couches référencées d’un autre projet, vous devez exporter le projet qui contient les couches originales au même temps que le projet qui contient les couches référencées.

Le processus d’exportation crée quatre fichiers : le fichier .properties est le principal fichier d’exportation et il contient l’information de configuration. Tous les fichiers sont nécessaires à l’importation. Vous pouvez déterminer le répertoire de destination et le nom du fichier.

Importation

Lorsque vous importez une configuration, vous avez le choix d’importer une configuration complète (importation complète) ou seulement une portion de celle‑ci (importation partielle). Vous ne pouvez effectuer une importation complète que si les fichiers d’exportation contiennent une exportation complète. Lorsque vous effectuez une importation complète, toute configuration existante dans JMap Server est supprimée et remplacée par la configuration importée. Lorsqu’une importation complète est terminée, vous êtes automatiquement retourné à la page de connexion de JMap Admin.

Lorsque vous effectuez une importation partielle, il peut y avoir des situations où les ressources importées existent déjà (noms identiques). Dans ces cas, vous devez indiquer à JMap Admin l’action à exécuter : remplacer la ressource existante ou en créer une nouvelle sous un nom différent. Les sources de données de type fichier que vous importez ne sont pas prêtes à utiliser et doivent d’abord être mises à jour après l’importation.

Si l’un des projets contient des couches référencées d’un autre projet, vous devez importer le projet qui contient les couches originales au même temps que le projet qui contient les couches référencées.

Exportation et importation des données utilisateur de JMap

Les données utilisateur de JMap comprennent toutes les données qui sont créées ou modifiées par les utilisateurs. Cela inclut les préférences utilisateur, les contextes, les couches personnelles, les données des couches éditables JMap, etc. Si vous changez d’instance de JMap Server et voulez conserver toutes les données utilisateur existantes, vous devez les exporter à partir de l’ancien serveur et les importer dans le nouveau serveur.

Le fichier de configuration de l’exportation et l’importation des données des utilisateurs est un fichier .properties. Pour une exportation/importation réussies, validez que ce fichier contient la ligne suivante :

project.id.ID_OF_THE_PROJECT_BEFORE_EXPORT=ID_OF_THE_PROJECT_AFTER_EXPORT_SERVER_CONFIGURATION.

Exportation

Lorsque vous exportez les données utilisateur, vous devez choisir d’exporter toutes les données ou alors seulement les couches éditables stockées dans JMap (incluant les couches personnelles) ou seulement les espaces de travail (incluant les contextes, les cartes et préférences des utilisateurs, etc.).

Importation

Lorsque vous effectuez une importation des données utilisateur, il peut y avoir des situations où les ressources importées existent déjà (noms identiques). Dans ces cas, vous devez indiquer à JMap Admin l’action à prendre : remplacer la ressource existante ou en créer une nouvelle sous un nom différent.

Données des utilisateurs

Les utilisateurs des applications JMap peuvent générer certaines données qui sont stockées dans l’environnement de JMap Server.

Ces données sont de diverses natures telles que des préférences utilisateur (choix des unités, paramètres d’impression, etc.), des contextes cartographiques (JMap Pro, JMap Web et JMap NG) et des gabarits d’impressions personnalisés.

Les données des contextes cartographiques sont stockées en format JSON dans la table JMAP_CONTEXTS de la base de données System.

Les données autres que celles des contextes sont stockées dans des dossiers distincts pour chaque utilisateur. Le dossier parent de ces dossiers utilisateur est

JMAP_HOME\workspaces<username>

Notez que ce dossier peut être localisé dans un autre endroit en spécifiant un dossier différent à la ligne server.workspaces.path du fichier jmapserver.properties et en copiant manuellement les fichiers et sous dossiers.

Dans certains cas, l’administrateur peut avoir à copier certains fichiers lors de migrations ou pour les partager avec d’autres utilisateurs. Les sections suivantes décrivent plus en détails chacun des cas.

Notez que les fonctions d’exportation et d’importation des configurations de JMap prennent aussi en charge les données des utilisateurs.

Contextes

Les contextes cartographiques sont composés de l’ensemble des paramètres permettant de recréer une carte géographique par un utilisateur des applications JMap Pro, JMap Web ou JMap NG. Ils permettent de sauvegarder des cartes et de les partager entre les utilisateurs. Les contextes existants peuvent être rappelés facilement pour recréer un environnement cartographique. Tous les paramètres des couches, les annotations, les thématiques, les sélections, etc. font partie du contexte et sont recréés à l’ouverture du contexte.

Un contexte est associé au projet dans lequel il fut créé. Il n’est pas accessible à partir des autres projets.

Couches personnelles

La section Couches personnelles donne plus d’information sur la gestion des couches personnelles et les détails sur la procédure pour les rendre publiques. Les données des couches personnelles ne sont pas stockées dans le dossier workspaces mais sont plutôt enregistrées directement dans la base de données System de JMap Server (une table par couche personnelles).

Les outils d’exportation et d’importation prennent en charge les données des couches personnelles.

Tables JMap Spatial

Tout comme les couches personnelles, les données des couches éditables des projets JMap sont stockées directement dans la base de données System de JMap Server dans des tables appelées tables JMap Spatial.

Les outils d’exportation et d’importation prennent en charge les données des tables JMap Spatial.

Gabarits d’impression

Les utilisateurs des applications JMap Pro peuvent créer leurs gabarits d’impression personnels. Les fichiers sont stockés dans le dossier

JMAP_HOME\workspaces<username>\printLayouts

Vous pouvez rendre publiques les gabarits d’impression crées par les utilisateurs. Pour ce faire vous devez copier les fichiers dans ce répertoire

JMAP_HOME\workspaces\public\printLayouts.

Les gabarits publics sont accessibles par tous les utilisateurs de JMap Pro.

Paramètres de JMap Server

Ces paramètres ont un impact sur le fonctionnement et les performances du système JMap Server. Appuyez sur Sauvegarder afin de sauvegarder toutes vos modifications. Cliquez sur afin de relire les paramètres des fichiers de configuration si ceux-ci ont changé. Les fichiers de configuration se trouvent dans JMAP_HOME/conf.

Statistiques d’utilisation

Les statistiques d’utilisation offrent à l’administrateur JMap de l’information sur l’utilisation des projets, des couches et des contextes. JMap Server enregistre certaines activités de utilisateurs et permet de générer des rapports contenant des statistiques sur l’utilisation des ressources dans les applications JMap Pro, JMap NG et JMap Web. Ces informations peuvent s’avérer utiles pour évaluer la pertinence de certains projets ou de certaines couches, peu ou pas utilisés.

Pour activer l’enregistrement des données d’utilisation vous devez cocher l’option Statistiques d’utilisation lors de la création ou de l’édition d’un projet. La section Création de projets offre des détails sur le sujet. Lors de l’exportation et importation du projet, votre choix est enregistré dans la configuration exportée.

Ainsi de manière automatique à chaque fois qu’un utilisateur ouvre un projet, qu’il voit une couche ou qu’il voit ou crée un contexte dans une application JMap Pro, JMap NG ou JMap Web, l’activité s’enregistre dans une table temporelle dans la BD System.

À chaque nuit, à une heure déterminée, les données sont agrégées dans deux tables (JMAP_STATISTICS_MONTHLY et JMAP_STATISTICS_YEARLY) et elles sont par la suite affichées dans cette section de JMap Admin.

La fréquence d’agrégation des données peut être configurée dans les paramètres de JMap. Pour ce faire vous devez modifier la variable server.statistics.config.cron dans le fichier jmapserver.properties qui se trouve dans le dossier JMAP_HOME/conf. Si le fichier jmapserver.properties ne contient pas la variable server.statistics.config.cron, la fréquence d’agrégation par défaut est chaque jour à 2 h du matin (2 am, server.statistics.config.cron=0 2 * * *). Si vous souhaitez changer la fréquence d’agrégation vous devez ajouter manuellement la variable server.statistics.config.cron dans le fichier jmapserver.properties. Cette page http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html offre des détails sur les expressions cron.

Les informations sur les activités des utilisateurs qui ont été effacés sont consignées dans les deux tables. Les détails des fonctions d’agrégation se trouvent dans l’API REST de JMap Admin.

Les informations enregistrées dans la table temporelle diffèrent légèrement entre les applications JMap Pro et JMap Web. Les données d’utilisation provenant de JMap Pro sont enregistrées lorsque l’application JMap Pro est fermée ou lorsque que le projet est fermé car l’utilisateur change de projet.

Calculer les statistiques

Appuyez sur Appliquer pour produire les statistiques par projet. Appuyez sur Réinitialiser pour effacer les statistiques.

Appuyez sur Appliquer pour produire les statistiques par couche. Appuyez sur Réinitialiser pour effacer les statistiques.

Sélectionnez le filtre et appuyez sur Appliquer pour afficher les paramètres qui permettront de définir le calcul. Une fois les paramètres complétés, appuyez à nouveau sur Appliquer pour produire les statistiques. Appuyez sur Réinitialiser pour effacer les statistiques.

Exporter les rapports

Vous pouvez exporter le rapport produit en format Excel ou PDF. Pour ce faire, une fois calculées les statistiques, appuyez sur Excel ou sur PDF pour télécharger automatiquement un fichier du format sélectionné.

Journalisation

Les journaux sont des fichiers qui contiennent des informations sur les activités effectuées dans JMap Server. La quantité d’événements inscrite dans les journaux dépend du niveau de journalisation sélectionné. Un nouveau fichier de journal est créé chaque jour par défaut, mais ce paramètre peut être modifié. Par défaut, les journaux sont placés dans le répertoire JMAP_HOME/logs. Il se peut que vous ayez besoin de vérifier périodiquement le volume des journaux et d’archiver ou de supprimer les anciens fichiers.

Visualisation des journaux

Les journaux (et journaux des erreurs) peuvent être visualisés directement dans JMap Admin. Cliquez sur le nom d’un fichier de la liste pour l’ouvrir. Le contenu du fichier est affiché. Notez que les journaux d’erreurs sont affichés en plus des journaux. Les journaux d’erreurs contiennent uniquement des messages d’erreur qui servent parfois de complément aux journaux pour aider à résoudre un problème.

La fenêtre de visualisation permet de filtrer le contenu, par type d’événement, par date, par mot clé, etc. Vous pouvez aussi télécharger le fichier en appuyant sur Télécharger.

Analyse des journaux

Les journaux peuvent être analysés afin de fournir un sommaire de l’activité de JMap Server. Par exemple, ils vous tiennent informés du nombre de sessions de chaque utilisateur, du nombre d’arrêts du serveur, des échecs d’authentification, etc. Pour analyser les journaux, sélectionnez un ou plusieurs fichiers dans la liste et appuyez sur .

Messages

En tant qu’administrateur, vous pouvez envoyer des messages aux utilisateurs de JMap à partir de JMap Admin. Les messages seront affichés dans l’interface des utilisateurs (applications JMap Pro seulement). Les utilisateurs ayant une session active verront ces messages immédiatement. Les autres utilisateurs les verront la prochaine fois qu’ils se connecteront. Les messages permettent d’informer les utilisateurs des interruptions de service, par exemple. Le message est affiché chaque fois qu’un utilisateur démarre une nouvelle session, pendant la période de validité du message.

Envoi de messages

Afin de créer un nouveau message à envoyer à tous les utilisateurs, appuyez sur Créer à partir de la section des messages.

Suppression de messages

Afin de supprimer un message avant qu’il n’expire, sélectionnez‑le dans la table et appuyez sur Supprimer.

Base de données System de JMap Server

La base de données System de JMap Server est une base de données relationnelle qui stocke des données importantes pour JMap Server. Si vous utilisez le gestionnaire des utilisateurs intégré à JMap Server, les données relatives aux comptes des utilisateurs et groupes se trouvent dans cette base de données. Ce n’est pas le cas si vous utilisez un autre gestionnaire d’utilisateurs (p. ex. LDAP/Active Directory). De plus, lorsque les sources de données spatiales lisent leurs données à partir de fichiers (SHP, MIF, DWG, etc.), la géométrie et les données descriptives lues à partir de ces fichiers sont insérées dans les tables de la base de données System. Il y a une table pour chacune de ces sources de données, de même que des tables d’index spatiaux qui accélèrent l’extraction des données. Les couches personnelles créées par les utilisateurs, ainsi que les tables JMap Spatial, sont aussi stockées dans la base de données System.

Par défaut, le système de gestion de base de données relationnelle (SGBD) utilisé pour stocker les bases de données System de JMap Server est Apache Derby. Il est intégré à JMap Server et ne nécessite aucune maintenance. Ce système convient pour la publication de petites quantités de données spatiales ou pour les environnements de test. Il est fortement recommandé d’utiliser un autre système de gestion de base de données relationnelle. La liste des systèmes compatibles est présentée dans l’article Spécifications techniques de JMap 7 Kathmandu de la Base de connaissances de JMap. Par défaut, les fichiers de base de données de Derby sont situés sous le répertoire JMAP_HOME/db/database. Vous ne devez en aucun temps supprimer ou modifier les fichiers qui se trouvent dans ce répertoire.

Déplacement de la base de données System de JMap Server vers un autre environnement

Vous pouvez facilement déplacer la base de données System de JMap Server vers un autre SGBD. Ceci est fortement recommandé pour améliorer la performance ou l’extensibilité ou encore pour avoir accès à des fonctionnalités plus avancées, telles que la création de copies de sécurité. Les SGBD qui sont officiellement pris en charge pour le stockage de la base de données System de JMap se détaillent dans l’article Spécifications techniques de JMap 7 Kathmandu de la Base de connaissances de JMap.

Notez que d’autres versions et d’autres SGBD seront probablement prises en charge également, car JMap Server utilise principalement des fonctionnalités de base de données très simples et communes.

Pour contenir la base de données System, vous devriez utiliser une base de données ou un schéma réservé exclusivement à JMap. Le compte utilisateur utilisé pour établir la connexion doit avoir les privilèges requis pour sélectionner, insérer, créer et supprimer des tables et des index.

Pour déplacer la base de données System vers un autre SGBD, vous devez modifier la base de données appelée System dans JMap Admin. Sélectionnez le pilote de base de données et les paramètres de connexion correspondant à l’environnement de la nouvelle base de données System. JMap Server va automatiquement créer les tables requises dans la nouvelle base de données.

Une fois que la base de données System aura été déplacée, toute source de données spatiale qui lit des fichiers de données vectorielles se verra attribuer l’état Non Initialisé. Ces sources de données devront être mises à jour avant de pouvoir être utilisées. Les autres types de sources de données (matricielles, Oracle Spatial, SDE, etc.) ne seront pas affectées.

De plus, si vous déplacez la base de données System, toutes les données utilisateur dans l’ancienne base de données doivent être déplacées à l’aide de l’outil d’exportation et d’importation des données. Consultez la section Exportation et importation pour plus d’information.

Prise de copies de sécurité

Il est fortement recommandé de prendre des copies de sécurité de l’environnement de JMap Server.

Si votre base de données System de JMap Server a été déplacée vers un autre SGBD, vous devriez l’inclure dans votre procédure de copie de sécurité. Cette base de données contient des informations très sensibles, dont les données des couches personnelles.

La stratégie la plus simple pour prendre une copie de sécurité de JMap Server consiste à prendre en copie le répertoire JMap en entier, incluant tous les sous répertoires.

Si vous souhaitez prendre des copies de sécurité de taille moins volumineuse, vous pouvez prendre précisément les répertoires suivants qui contiennent les informations importantes.

---