Installation Guide for JMap 6.5

 

Related product

JMap

Versions

6.5

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, Web and Mobile applications, JMap Admin, etc.).

After the installation, you must install the latest JMap patch. The patches are incremental, so you don't need to install the older versions of the patches. For example, if you installed JMap 6.5, you must also install patch JMap 6.5 c (or more recent).

Requirements

Operating System and Environment

Operating System and Environment

Windows 32 bits/64 bits

7, 8, Server 2003*, Server 2008, Server 2012

(Requires the installation of .Net)

Linux 32 bits/64 bits

GLIBC 2.12 +

GCC 4.4 +

Mac OS X

V10+

Solaris (Intel)

9, 10

Java

See Compatibility of JMap with Java.

Hardware (minimum recommended)

Hardware (minimum recommended)

Architecture

32/64 bits

CPU

Dual-Core @ 2 GHz

RAM

4 Gb

(including 1 Gb dedicated for JMap Server)

Storage

1 Gb

(The required storage space increases with the volume of the data published by JMap.)

Installation Program

Chose the installation program corresponding to the target platform. There are 5 installation programs.

Installation program

Target platform

Installation program

Target platform

Target platformjmap_windows-x64_6_5.exe

Windows 64 bits

jmap_windows_6_5.exe

Windows 32 bits

jmap_unix64_6_5.sh

Linux and Unix 64 bits

jmap_unix_6_5.sh

Linux and Unix 32 bits

jmap_macos_6_5.dmg

Mac OS X

The installation programs can be downloaded from this web site https://k2geospatial.info/support/.

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

This section describes the process of installing a new setup of JMap 6.5.

Launch the installation program for your target platform. The steps are the following.

No

Step

Description

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

Enter the network parameters that JMap Server will use. Avoid conflicts with other services running on the same system.

JMap Server bind address: IP address used by JMap Server to receive requests from JMap Pro applications and for communication between different instances of JMap Server. If your server has more than one address, you can enter the one that will be used. If you enter value 0.0.0.0, JMap Server will use all available IP addresses.

JMap Server port: TCP/IP port that JMap Server uses for the specified IP address.





Enter the parameters used by JMap Server for sending emails (optional).

Host: IP address of a SMTP server that will be responsible for routing the emails sent by JMap Server.

Port: TCP/IP port used by the SMPT server.

Encryption: If applicable, select the encryption method used by the SMTP server.

Username: If the SMTP server requires an authentication, enter the username to use to connect to the SMTP server.

Password: If the SMTP server requires an authentication, enter the password to use to connect to the SMTP server.





Enter the parameters of the web server (Tomcat) embedded in JMap Server. This web server will be used to execute JMap Admin and other web pages related to JMap.

Tomcat bind address: IP address used by Tomcat to receive HTTP requests. If your server has more than one address, you can enter the one that will be used. If you enter value 0.0.0.0, Tomcat will use all available IP addresses.

Tomcat HTTP port: TCP/IP used by Tomcat for the specified IP address.





7

Enter the size of the main memory (in Mb) allocated for the execution of JMap Server. The memory needs of JMap Server vary generally between 768 Mb and 8 Gb, depending on the number of users and the volume of the data. You can leave the default values and adjust it at a later time, according to your needs.

Press Next.





Select this option to automatically create a security certificate. This security certificate will be used by JMap Server to allow secured connections (HTTPS) to JMap Server. This will allow for the execution of JMap Admin and all JMap applications in a secured mode.

This is a temporary certificate and should be replaced by a certificate created for your organization by a trusted authority.

Create temporary security certificate: Select this option to create a temporary security certificate.

Name (CN): The address of the web site of the organization (e.g. www.abcinc.com).

Organisation Unit (OU): The name or division of the organization (e.g. IT Department).

Organisation (O): The name of the organization (e.g. ABN inc.)

Country (C): The 2 letter country code of the organization (e.g. CA).

Store password: Password that will be used to protect the certificate file.

Key password: Password that will be used to protect the entry for the certificate in the file.

Press Next.

9

Select this option to install JMap Server as a service. A service will start automatically when the computer is started. It is recommended to select this option.

You can specify a different name for the service. If you install JMap Server as a service, you can also specify the user account that will be used to start the service. This can impact the system ressources that JMap Server can access.

Press Next.

10

Select the options for the creation of shortcuts to start JMap Server.

Press Next.

11

File copying can take a few minutes.







When installing on Windows, in certain cases, this window is displayed. If it is the case during your installation, select the Repair option.

Press Next.

13

Press Finish.

14

The installation of JMap 6.5 is completed.

Press Finish.

Installation of a patch

Patches for JMap contain bug fixes to address problems detected when using the product. They are named using consecutive letters after the version name (e.g. 6.5a, 6.5b). Patches are alway cumulative, which means that a patch contains all the changes of previous patches for the same version (6.5c contains all bug fixes included in 6.5a and 6.5c).

A patch must be installed in a folder containing an existing setup of JMap that is compatible with it. The JMap Server service will be interrupted during the installation of a patch.

During the installation, you will be prompted for the installation folder of the existing JMap setup to be updated.

Upgrading an existing setup of JMap

JMap 6.5 can be installed over an existing setup of JMap 6.0. All existing configurations will be preserved. The steps are the same as for a new installation.

The process to upgrade from older versions is more complex.

Please see Migration Guide to JMap 6.5 for more information.