Installation of the web application

This page describes how to set up a new installation of map.apps. If you want to update an existing installation, read Update of an existing installation instead.

To install the map.apps client, the following steps have to be performed:

  • Optionally, you can first change the name of the WAR file from the map.apps-4.9.2 directory (for example mapapps.war). The name is used in the URL to launch the application (for example https://<yourserver>/mapapps).

  • Make sure that the Tomcat service is started.

  • Then copy the WAR file to the %TOMCAT%\webapps folder. The file is extracted automatically.

  • Alternatively you can use the Tomcat Manager to install the WAR file. If the Tomcat service is started, you can usually reach the Tomcat Manager at http://<yourserver>:8080/manager/html.

When installing map.apps on Linux systems, you have to change the following parameter in the configuration:

data.directory.location=$\{user.home\}/.mapapps to for example data.directory.location=/tmp/.mapapps

The application is now available under this URL: https://<yourserver>/mapapps. If you load the web context after deployment, you see an empty app overview, as shown in the following screenshot:

empty app overview

To learn how to create your first app, read the section Getting started.