Install the web application

This page describes how to set up a new installation of map.apps. To update an existing installation, see Update an existing installation instead.

To install the map.apps client perform the following steps :

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

  2. Make sure that the Tomcat service is started.

  3. 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.

  4. In order to use the map.apps installation as an administrator or editor, it is required to set default passwords for the admin and editor user. For details, see Integrated security mechanism.

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, see Getting started.
  • If you install map.apps on a Linux system, change the following parameter in the configuration:
    data.directory.location=$\{user.home\}/.mapapps to for example data.directory.location=/tmp/.mapapps

  • Dependencies required to run map.apps line 3 are not installed by default. To run line 3 apps, install the map.apps line 3 dependencies as described in section Install map.apps line 3 bundles.