À 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

Run the following command at the terminal to create and launch the container:

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)

-e LOCAL_USER_ID = ʻid -u $ USER` tells Docker to write data as the account used in the current session.

-e VM_OPTIONS_XMX = 4g allocates 4 gigabytes to the JVM. The default is 2 gigabytes if this environment variable is not specified.

-p 7003 and 8080 define the ports through which JMap Server will be accessible.

-v / home / jmapserver / systemconfig: / opt / jmap / systemconfig indicates that the JMap system data volume is in the / home / jmapserver / systemconfig directory of the server and that it will be mounted in / opt / jmap / systemconfig.

-v / home / jmapserver / data: / opt / jmapdata indicates that the JMap spatial data volume is in the / home / jmapserver / data directory of the server and that it will be mounted in / opt / jmapdata.

--name jmapserver determines that the name of the new container will be jmapserver. This name will be used later to control the container.

k2geospatial / jmap: latest is the name of the most recent JMap Docker image. It will be downloaded from Docker Hub. It is also possible to request a particular version by specifying for example k2geospatial / jmap: 7_jakarta.

-d will execute the jmap server console in background. It means you will not see the console running in the terminal. This option is optional.

-e TZ=America/New_York will set time zone.

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