À partir de cette version de JMap 7 Jakarta vous avez la possibilité d’installer JMap Server dans un conteneur Docker. Ceci facilite le déploiement d’instances de JMap Server dans votre environnement.

Ce guide présente les deux manières d’installer JMap 7 Jakarta :

Télécharger, installer et mettre en route JMap 7 Jakarta avec la méthode traditionnelle

Suivez les étapes suivantes pour télécharger, installer et mettre en route JMap.

1. Téléchargez JMap
   
   JMap peut être téléchargé directement du site web de K2 Geospatial : https://k2geospatial.com/fr/soutien/ . Vous devez posséder un compte autorisé à accéder aux téléchargements. Si vous n'en avez pas, vous pouvez créer un nouveau compte. Lorsque votre nouveau compte aura été validé par notre équipe, vous pourrez continuer vers les téléchargements. Contactez K2 Geospatial pour toute question.
   

2. Installez JMap
   
   Le guide d'installation de JMap 7 est disponible ici : https://k2geospatial.atlassian.net/wiki/x/GgAzIg.
   

3. Envoyez le fichier d'activation
   
   Lors de l'installation, une fichier activationkey.txt a été généré dans le dossier bin de JMap (par ex. C:\Program Files\JMap\bin). Vous devez envoyer ce fichier par courriel à license@k2geospatial.com.
   

4. Copiez le fichier de licence
   
   Après l'envoi de votre fichier d'activation, vous recevrez par courriel un fichier jmap.license. Vous devez copier ce fichier dans le dossier bin de JMap, au même endroit où se trouve le fichier d'activation.
   

5. Démarrez JMap Server
   
   Si vous avez installé JMap Server comme un service de Windows, utilisez la fenêtre des services (panneau de configuration) pour démarrer JMap Server.
   
   Si non, utilisez le raccourci du menu Démarrer, ou exécutez directement le fichier startjmapserver qui se trouve dans le répertoire bin de JMap. 

Installer JMap 7.0 Jakarta dans un conteneur Docker

Mettre en route JMap Server dans un conteneur Docker est simple et semblable à la méthode traditionnelle avec un installateur. La différence principale concerne le stockage de données lues et écrites par JMap Server. En effet, étant donné qu’il n’est pas possible écrire dans un conteneur Docker, les données doivent être stockées ailleurs dans le serveur. Il faut prévoir deux espaces de stockage dénommés volumes.

Le premier volume est utilisé pour stocker les données système écrites par JMap Server (configurations, journaux, etc.). C’est le volume de données système de JMap (System Data Volume).

Le deuxième volume est utilisé pour stocker les fichiers de données spatiales qui seront lus par JMap Server. C’est le volume de données spatiales de JMap (Spatial Data Volume).

Étapes préliminaires

Avant de commencer l’installation de JMap vous devez compléter les étapes suivantes :

1. Créer un compte dans Docker Hub (https://hub.docker.com) pour télécharger des images Docker.
   

2. Installer et mettre en route le Docker Engine dans votre serveur (https://www.docker.com).
   

3. Créer le repertoire pour le volume de données système de JMap. Par exemple :
   
   Linus : /home/jmapserver/systemconfig
   
   Windows : C:\jmapserver\systemconfig
   

4. Créer le repertoire pour le volume de données spatiales de JMap. Par exemple :
   
   Linux : /home/jmapserver/data
   
   Windows : C:\jmapserver\data

Créer et mettre en route pour la première fois le conteneur JMap Server

Dans le terminal, entrez les commandes suivants pour créer et mettre en route le conteneur :

Linux

docker run -e TZ=America/New_York -it -e LOCAL_USER_ID=`id -u $USER` -e VM_OPTIONS_XMX=4g -p 8080:8080 -p 7003:7003 -d -v /home/jmapserver/systemconfig:/opt/jmap/systemconfig -v /home/jmapserver/data:/opt/jmapdata --name jmapserver k2geospatial/jmap:7_Jakarta_latest (k2geospatial/dev:7_Jakarta-SNAPSHOT)

Windows

docker run -e TZ=America/New_York -it -e VM_OPTIONS_XMX=4g -p 8080:8080 -p 7003:7003 -d -v C:\\jmapserver\systemconfig:/opt/jmap/systemconfig -v C:\\jmapserver\data:/opt/jmapdata --name jmapserver k2geospatial/ jmap:7_Jakarta_latest (k2geospatial/dev:7_Jakarta-SNAPSHOT)

Paramètres

-e LOCAL_USER_ID = ʻid -u $ USER` indique à Docker d'écrire les données dans le compte utilisé dans la session courante.

-e VM_OPTIONS_XMX = 4g alloue 4 gigabytes à la JVM (machine virtuelle java). Si cette variable n’est pas spécifiée, la valeur allouée par défaut est 2 gigabytes.

-p 7003 and 8080 définit les ports à travers lesquels accéder à JMap Server.

-v / home / jmapserver / systemconfig: / opt / jmap / systemconfig indique que le volume de données système de JMap est dans le repertoire / home / jmapserver / systemconfig du serveur et qu’il va être monté dans / opt / jmap / systemconfig.

-v / home / jmapserver / data: / opt / jmapdata indique que le volume de données spatiales de JMap est dans le repertoire / home / jmapserver / data du serveur et qu’il va être monté dans / opt / jmapdata.

--name jmapserver détermine que le nom du nouveau conteneur sera Ce nom sera utilisé par la suite pour contrôler le conteneur.

k2geospatial / jmap: latest est le nom de l’image la plus récente du conteneur Docker de JMap. Elle va être téléchargée à partir de Docker Hub. Il est aussi possible de solliciter une version particulière en spécifiant, par exemple k2geospatial / jmap: 7_jakarta.

-d exécutera la console de JMap Server en arrière-plan. Vous n’allez pas visualiser la console roulant dans le terminal. C’est un paramètre optionnel.

-e TZ=America/New_York établi le fuseau horaire.

Place the license file

After creating and running the container, JMap Server stops automatically because it cannot find a license file. As with the traditional installation, an activationkey.txt file is generated automatically and must be sent to the K2 Geospatial team for the creation of the license file (jmap.license). The activationkey.txt file is generated at the root of the JMap system data volume.

Once you receive the jmap.licence from K2 place it at the root of the JMap system data volume (same directory as the activationkey.txt file).

You will need to restart the previous created container. 

Stop the JMap Server container

Once the container has been created and started for the first time, and once the license file is correctly placed, use this command to stop it:

docker stop jmapserver

jmapserver is the name of the container

Start the JMap Server container

Use this command to start the container:

docker start jmapserver

Consult the JMap Server console

Whether the container is started or stopped, use this command to view the JMap Server console:

docker logs jmapserver

Update JMap Server

It is easy to update a JMap Server installation in a Docker container. The procedure is to download a newer image and relaunch the container.

1-    Stop the container if it is running

docker stop jmapserver

2-    Delete the container. No data will be lost.

docker rm jmapserver

3-    Run the docker run command again, specifying the new image as a parameter.

Install an extension

Extensions can be installed in your JMap and Docker environment by following the following steps:

1-    Create a scripts directory in the systems data volume. For example:

/home/jmapserver/systemconfig/scripts (Linux) or C:\jmapserver\systemconfig\scripts (Windows)

2-    Place the extension installation in the script directory. This is the .sh file that is used to install the extension on Linux. For example:

/home/jmapserver/systemconfig/scripts/ext_tracking_7_0043_unix.sh (Linux) or C:\jmapserver\systemconfig\scripts\ ext_tracking_7_0043_unix.sh (Windows)

3-    Restart the container.

docker stop jmapserver

docker start jmapserver