Import / Export

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.

Exportation et importation de la configuration 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.

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

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.

Fichier .mapping

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 :

1. Exportez la configuration JMap Server.

2. Exportez la configuration des données utilisateur.

Sur le nouveau server JMap Server :

1. Importez la configuration JMap Server.

2. Prenez note de l'ID de chaque projet sur l'ancien serveur.

3. Prenez note de l'ID de chaque projet sur le nouveau serveur.

4. Créez un (1) fichier .mapping avec la correspondance pour chaque projet entre l'ancien et le nouveau ID.

   
5. Importez la configuration des données utilisateur en spécifiant le fichier .mapping créé à l'étape antérieure.

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.

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.