Produit concerné | JMap Server | Versions | 7 Jakarta |
À K2 Geospatial recommande fortement l’installation et exécution de JMap en Docker, disponible à 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 :
| Table of Contents | ||
|---|---|---|
|
Télécharger, installer et mettre en route JMap 7 Jakarta avec la méthode traditionnelle
Suivez . La procédure est détaillée ici Exécution de JMap Server en conteneur Docker .
Cependant, si vous souhaitez utiliser la méthode traditionnelle, suivez les étapes suivantes pour télécharger, installer et mettre en route JMap .7 Jakarta :
Téléchargez JMap.
JMap peut être téléchargé directement du
...
Portail de support de K2 Geospatial, de la section Ressources : https://odoo.k2geospatial.com/fr_CA/
...
...
login .
Vous devez posséder un compte
...
sur le Portail pour accéder aux téléchargements. Si vous n'en avez pas, vous pouvez créer un nouveau compte.
...
Contactez K2 Geospatial pour toute question.
Installez JMap.
Le guide d'installation de JMap 7 est disponible ici :
...
Envoyez le fichier d'activation à K2 Geospatial.
Lors de l'installation, une fichier activationkey.txt
...
est 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.
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.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.
...
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 :
...
Créer un compte dans Docker Hub (https://hub.docker.com) pour télécharger des images Docker.
...
Installer et mettre en route le Docker Engine dans votre serveur (https://www.docker.com).
...
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
...