Installation of Save State Service

The Save State Service is required to save app states persistently to a database.

  1. Install Save State Service: Copy the file savestate.war from the map.apps SDI ZIP archive to the webapps folder in your Apache Tomcat server.

    If Tomcat is not already running, start it now. It will then automatically unpack the WAR file to a new folder webapps/savestate. This might take a few seconds.
    Alternatively, you can use the Tomcat Manager application running at http://localhost:8080/manager/html to deploy the WAR file.

  2. Configure map.apps: Open the map.apps application.properties file. The location of this file is defined by the property data.directory.location in the map.apps WEB-INF/classes/custom-application.properties file.

    1. Set URL to Save State Service: Add a new property savestate.service.url to the application.properties file.

      Its value is the full URL to the Save State Service followed by /resources/appstates.

      savestate.service.url=http://<yourserver>:<port>/savestate/resources/appstates
    2. Add bundle for map.apps Manager: Append the entry sdi_appstate-manager-integration to the property manager.config.viewbundles:

      manager.config.viewbundles=appmanagement,reportmanagement,bundlemanagement,mapapps-github-manager,bundleupdatechecker,sdi_appstate-manager-integration
  3. Restart Tomcat and reload map.apps Manager in your browser.

  4. Log in to map.apps Manager as an admin user to check the installation. There should be a new tool titled App States (Line 4) in the main toolbar.

    app state