Cette section contient des outils qui vous permettent d'importer et exporter la configuration de JMap Server, les données des utilisateurs ainsi que d'effectuer des copies de sécurité de JMap Server.
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. Lima).
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 Outils.
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.
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.
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. La section Données des utilisateurs offre des détails sur ce sujet.
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.
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.).
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.
Lors des exportations et importations des configurations JMap les ID des projets changent et cela a un impact considérable sur les données utilisateur telles que les contextes qui sont associés à un projet en particulier. Pour pouvoir résoudre le problème vous pouvez créer un fichier .mapping qui établit la correspondance entre les ID ancien et nouveau de chaque projet. Le texte suivant détaille la procédure à suivre.
À partir de l'ancien JMap Server :
Exportez la configuration JMap Server.
Exportez la configuration des données utilisateur.
Sur le nouveau server JMap Server :
Importez la configuration JMap Server.
Prenez note de l'ID de chaque projet sur l'ancien serveur.
Prenez note de l'ID de chaque projet sur le nouveau serveur.
Créez un (1) fichier .mapping avec la correspondance pour chaque projet entre l'ancien et le nouveau ID.
Importez la configuration des données utilisateur en spécifiant le fichier .mapping créé à l'étape antérieure.
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.
conf
Contient tous les fichiers de paramètres, tels que jmaperver.properties, usermanager.properties, etc.
db
Contient les fichiers de configuration (projets, couches, etc.) ainsi que la base de données System de JMap Server, à moins qu’elle n’ait été déplacée vers un autre SGBD.
backups
Répertoire par défaut pour stocker les fichiers d’exportation.
workspaces
Les espaces de travail des utilisateurs contiennent les contextes et paramètres personnels 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.
Les outils d’exportation et d’importation des configurations de JMap prennent aussi en charge les données des utilisateurs.
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.
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.
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.
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.
