Installation

This page describes how to install the map.apps Smart Search Extension. If you want to update an existing installation, proceed with Update an existing installation.

Installing the smart.finder server component

To use the map.apps Smart Search Extension, the smart.finder search component must be installed. The WAR file of the smart.finder search component is located at [RELEASE-ORDNER]/smartfinder-search.war.

To install the smart.finder server, proceed as follows:

  1. Optionally, you can first customise the name of the WAR files. The name is used in the URL through which the application is called.

  2. Make sure that the Tomcat service is started.

  3. Then copy the WAR file into the folder %TOMCAT%\webapps. The file will now be unpacked automatically.
    Alternatively, you can use the Tomcat Manager to install the WAR file. Once the Tomcat service is started, you can usually reach the Tomcat Manager at http://<yourserver>:8080/manager/html.

The web application is now available at the following URL: https://<yourserver>/smartfinder-search

Installing the bundles

  1. Log in to the map.apps manager as administrator.

  2. Open the tab Bundles.

  3. Click on the + button above the list of installed bundles.

  4. Upload the file [RELEASE-ORDNER]\ct-smartsearch-js-2.5.1.jar. This contains all bundles for the extension.

Once the upload is complete, the Smart Search Bundles will be displayed in the list of installed bundles.

Installing the Job Manager

To use the Job Manager within map.apps Manager, proceed as follows.

  1. Open the map.apps configuration file application.properties.
    This is usually located in the folder [USER_HOME]/.mapapps.

  2. Find the entry manager.config.viewbundles.

    The property controls which management bundles are loaded in the map.apps manager.

    If the property already exists, add the sf_jobadmin value at the end. Otherwise, create the property with the default map.apps values and sf_jobadmin.

    Example for manager.config.viewbundles
    manager.config.viewbundles=appmanagement,reportmanagement,bundlemanagement,mapapps-github-manager,bundleupdatechecker,sf_jobadmin

Afterwards, the new tab Indexing jobs appears in the map.apps manager.

Minimum configuration

After the bundles have been installed, map.apps must know the URL of the server application for search queries. To do this, add the following entry to the application.properties file of map.apps:

finder.service.url=https://<yourserver>/smartfinder-search

Adjust the domain and the name in the URL to your environment. If the smart.finder server is installed in the same Apache Tomcat instance as map.apps, a relative specification is sufficient:

finder.service.url=/smartfinder-search
If the smart.finder server component is accessible under a different domain than map.apps, make sure that the map.apps proxy servlet is enabled to access the smart.finder server.