Installation

The map.apps Smart Search Extension provides a user-friendly, fast and highly configurable search for map.apps. A unified index can manage content from different domain-specific data sources and make it available for searching in map.apps.

Data sources are ArcGIS Server Feature Services or Map Services, which are available via ArcGIS Online as well as ArcGIS Server.

The map.apps Smart Search Extension is based on the smart.finder product. smart.finder customers can use the product and extension in combination, no further installation is required.

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

The .war file of the smart-finder server is located at [RELEASE-ORDNER]\ct-finder-client-webapp-2.1.0.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>/ct-finder-server-webapp-2.1

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-extension-js-2.1.0.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.
    If it already exists, add the value sf_jobadmin at the end. If it does not already exist, add the entry with the following value:

    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, the following entry must be added to the application.properties file of map.apps:

finder.service.url=: https://<yourserver>/ct-finder-server-webapp-%VERSION%

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=/ct-finder-server-webapp-%VERSION%
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.