Installation Guide for JMap Server (JMap 7)
Related product | JMap | Versions | 7 |
|---|
The installation of JMap is typically done on a server that will be accessed by all users. During the installation, all components are installed (JMap Server, JMap Pro applications, JMap Admin, etc.). Make sure to maintain an up to date setup by installing the most recent patches. It is recommended to do a backup of the system before proceeding with the installation.
Before proceeding with the installation, verify the requirements in the JMap Server Technical Specifications article of the version of JMap you are going to install.
Installation Program
Chose the installation program corresponding to the target platform. The names vary to indicate the version of JMap Server: Amsterdam, Bogotá, Cairo, Dakar, etc.
Full installation program | Target platform |
|---|---|
jmap_7_version_build_windows-x64.exe | Windows 64 bits |
jmap_7_version_build_windows.exe | Windows 32 bits |
jmap_7_version_build_unix64.sh | Linux and Unix 16.04 64 bits |
jmap_7_version_build_unix.sh | Linux and Unix 16.04 32 bits |
jmap_7_version_build_macos.dmg | macOS |
The installation programs can be downloaded from the K2 Support Portal https://odoo.k2geospatial.com/web/login. You must create a user account in order to access the downloads section.
To execute an installation program, you must have system administration privileges. On Windows, it is necessary to run the installation program as an administrator (right-click on the program -> Run as Administrator).
Please refer to the section that corresponds to your situation:
New Installation on Windows, macOS or Linux platform (with graphical interface)
This section describes the process of installing a new setup of JMap Server on a Windows, macOS or Linux platform with graphical interface.
Launch the installation program for your target platform. The steps are the following :
No | Step | Description |
|---|---|---|
1 |  | Press Next. |
2 |  | Accept the license terms. Press Next. |
3 |  | Select the JMap installation folder. The folder will be automatically created if it does not exist. If the folder already contains a setup of JMap, the installation program will perform an update of the existing system, if applicable. See section Updating an existing setup for more details. Press Next. |
4 |  | File copying can take a few minutes. |
5 |  | The installation of JMap Server is completed. Press Finish. |
New installation on Linux platform without graphical interface
To install JMap Server on a Ubuntu 16.04 platform, follow the steps:
Installing libwebp5
1. Install libwebp5 as follows:
sudo apt update
sudo apt install libwebp5Creating and configuring Linux users
1. Create a "jmap" user:
sudo useradd jmap
sudo usermod -d /opt/jmap jmap Creating and configuring directories
1. Create a directory for temporary data:
cd /opt
sudo mkdir jmap_temp
sudo chown jmap:k2geo /opt/jmap_temp -R
sudo chmod 775 /opt/jmap_temp -R2. Install JMap:
cd /opt
sudo mkdir jmapInstalling JMap Server
1. Copy the installer into /opt/jmap_temp.
2. Modify the installer permissions:
cd /opt/jmap_temp
sudo chmod +x [filename].sh3. Run the installer as "root":
cd /opt/jmap_temp
sudo ./[filename].shIMPORTANT: Install JMap Server on the /opt/jmap directory.
4. Change the owner of the installation folders:
sudo chown jmap:jmap /opt/jmap -R
sudo chown jmap:jmap /opt/i4j_jres -RInstalling updates of JMap Server
1. Copy the installer into /opt/jmap_temp.
2. Modify the installer permissions:
cd /opt/jmap_temp
sudo chmod +x [filename].sh3. Stop the JMap service.
sudo service jmapserverservice stop4. Make a backup copy of JMap Server:
sudo cp -R /opt/jmap /opt/jmap_temp
sudo mv /opt/jmap_temp/jmap /opt/jmap_temp/jmap_[date]
5. Run the installer as "root" because the installation have to modify the service:
cd /opt/jmap_temp
sudo ./[filename].sh6. Change the owner of the installation folders:
sudo chown jmap:jmap /opt/jmap -R
sudo chown jmap:jmap /opt/i4j_jres -R7. Start JMap Server:
sudo service jmapserverservice startControlling JMap service
1. To stop the service:
sudo service jmapserverservice stopIMPORTANT: If the service does not start, you have to make a "stop" JMap Server.
2. To restart the service:
sudo service jmapserverservice restart3. To start the service :
sudo service jmapserverservice start4. To kill the JMap process:
ps -ef | grep jmap
sudo kill -9 [nombre du processus]Editing a file as a "jmap" user
sudo su - jmap -c "nano -w /[absolute_path_to_file]"Update an existing installation
JMap Server can be installed over an existing installation of JMap 6.5 or JMap Server. Existing configurations will be retained.
JMap Server Kathmandu can only be installed over an existing installation of JMap Server Jakarta Fix 5, Fix 6 or Fix 7.
This article details the procedure for migrating an existing installation to JMap Server (JMap 7): Migration Guide to JMap Server (JMap 7).
Note: If you want to use JMap on port 80 or 443 you will have to install JMap on port 8080, install Nginx on port 80 or 443 and configure redirection (reverse proxy) to JMap Server.