Classical applications

Deploying a JMap application consists of preparing the application and putting it online so it can be accessed by users. You must select the desired options (application type, activated extensions, access controls, etc.) to customize the application according to your needs. To allow a user to open a deployed JMap application, simply give the user the application URL.

Deployed JMap applications are placed online in the web server integrated to JMap Server. They can also be copied manually to other web servers.

The deployment section displays a list of applications that have already been deployed.

Creating a new deployment

To create a new application deployment, click on the Create button in the Deployed applications section. Some parameters will be common to all types of applications. The following tables describe these parameters.

Template

Application type

There are four types of JMap applications. Each type of application has different features that are adapted to different needs. Custom application templates can also be added; these can be variants of the types offered by default. JMap Pro applications: This type of JMap application offers advanced functionality. It requires more IT resources, and a Java Runtime Environment (JRE) must be installed (Java is no longer required if you use the new deployment mode with an installation program). JMap Web applications: This type of JMap application is lighter and you can run it from a web browser or a mobile web browser. It doesn’t offer as many advanced features as JMap Pro applications. WFS Service: This type of application is a vector data web service destined to provide data to third-party applications through the Web Feature Service standard protocol. WMS Service: This type of application is a web service for the production of map images. It is destined to provide maps to third-party applications using the Web Mapping Service standard protocol.

Identification
Name	Enter a name for the new deployed application. Names must be unique. The name can contain spaces and any other characters.
Type	Select the deployment type, either local or external. Local: The application service will be deployed directly in JMap Server. External: Select this option for applications that must be deployed on a web server that is external to JMap Server. The application service will not be deployed in JMap Server. Instead, a .war file will be created. This file must be copied onto the external web server. A Download button in the deployment section allows you to download the .war file.
Protocol	The protocol to be used for communication between the JMap application and JMap Server. Select https for secure communication. If the HTTPS protocol is not configured in JMap Server, this option is not available. For more information on using the HTTPS protocol, refer to the Using HTTPS with JMap section.
Application host	The host name or IP address that will be included in the URL of the deployed application. If your server has several IP addresses, specify the one that must be used. If you have selected the External deployment type, make sure you enter the name or address of the external web server where the application will be deployed.
Application port	The TCP/IP port used in the URL of the deployed application.
Relative path	The path used in the URL of the deployed application, taken from the name given to the application.

The following steps depend on the type of application you selected. Refer to the following sections: JMap Pro Applications, JMap Web Applications and WFS and WMS Services.

Managing Deployed Applications

Once you have deployed applications, you can perform certain management tasks on them from the Deployed Applications interface of the Deployed section.

Editing an existing application

Editing an existing application allows you to go through all configuration sections again and change any options as needed. Double-click on the application’s name and select Edit.

Clone an existing application

Select an application to duplicate it.

Updating applications

Updating a deployed application means deploying it again, overwriting the existing version. This is equivalent to editing an existing application and keeping all the same options. Updating applications is useful when you install a new version of JMap to make sure your deployed application uses all the latest library versions. You do not need to update deployed applications when the data or the project changes.

Loading and unloading applications

If you want to temporarily make a deployed application unavailable, you simply need to unload it by selecting it in the list and pressing Unload. When an application is unloaded, users can no longer start it using its URL. If you want to make it available again, simply press Load to reload it.

Downloading applications

If an application’s type is External, you can download that application’s .war file in order to deploy it on another web server. Select the application and click on Download.

For more information on external applications, see this section.

Deleting applications

Deleting an existing deployed application deletes all files related to this application. There is no way to undelete an application (you need to redeploy it). Note that when deleting an application, none of your data or configurations (projects, layers, data sources, databases, etc.) are deleted nor affected in any way.

Other fonctions

Click on this button to access the following functions:

Permissions

If you select a deployment, you can access the Permissions section of the application.

Download REST services

The service.war file containing the JMap REST services is downloaded to your computer for deployment on another server.

Download report services

The report.war file containing the report service is downloaded to your computer for deployment on another server.

Download securityRealm services

The securityRealm.war file is downloaded to your computer. This file is used in single sign-on (SSO) by authentication servers (OIDC, SAML2) to communicate with JMap.