Produit concerné | JMap Server | Versions | 5.0, 6.0, 6.5, 7 |
|---|
Guide étape par étape
Suivez les étapes suivantes pour télécharger, installer et mettre en route JMap.
Télécharger 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.Installer Java (pour les versions antérieures à JMap 7 Amsterdam)
Cette étape n'est plus requise pour les versions récentes de JMap.
Si Java n'est pas déjà installé, vous devez le télécharger et l'installer sur l'ordinateur qui va exécuter JMap Server. Consultez cet article pour plus d'information : https://k2geospatial.atlassian.net/wiki/x/DAAtAQ .
Les versions JMap 7 Amsterdam et plus récentes incluent leur propre machine virtuelle Java (JVM). Aucune installation de Java n'est donc nécessaire sur le serveur.Installer JMap
Le guide d'installation de JMap 7 est disponible ici : https://k2geospatial.atlassian.net/wiki/x/GgAzIg.Envoyer 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.Copier 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émarrer 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.
JMap 7.0 Jakarta docker installation
Since JMap 7.0 Jakarta, it is possible to run JMap Server in a Docker container. This allows you to easily deploy instances of JMap Server in your Docker environment with all the advantages that this entails.
Running JMap Server in Docker is easy and similar to the traditional way (with installer). The main difference concerns the storage of data read and written by JMap Server. Since it is not possible to write to a Docker container, this data must reside elsewhere on the server. There must be two storage spaces, also called volumes.
A first volume is used for storing system data written by JMap Server (configurations, logs, etc.). We call it JMap's System Data Volume.
A second volume is used to store spatial data files that will be read by JMap Server. We call it the JMap spatial data volume.
Prerequisites
Before starting, make sure you have the following prerequisites:
· Account on Docker Hub (https://hub.docker.com) for downloading Docker images.
· Docker Engine installed and running on your server (https://www.docker.com).
· A directory for the JMap system data volume. For example :
/home/jmapserver/systemconfig (Linux) or C:\jmapserver\systemconfig (Windows)
· A directory for the volume of spatial data of JMap. For example:
/home/jmapserver/data (Linux) or C:\jmapserver\data (Windows)
Create and launch the JMap Server container the first time
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