Installation

Diese Seite beschreibt die Neuinstallation der map.apps Smart Search Extension. Wenn Sie eine bestehende Installation aktualisieren möchten, fahren Sie mit Update einer bestehenden Installation fort.

Installation der smart.finder Server Komponente

Für die Benutzung der map.apps Smart Search Extension ist die Installation der smart.finder search Komponente notwendig. Die WAR-Datei der smart.finder search Komponente befindet sich unter [RELEASE-ORDNER]/smartfinder-search.war.

Um den smart.finder Server zu installieren gehen Sie wie folgt vor:

  1. Optional können Sie zunächst den Namen der WAR-Dateien anpassen. Der Name wird in der URL verwendet, über die die Anwendung aufgerufen wird.

  2. Stellen Sie sicher, dass der Tomcat-Dienst gestartet ist.

  3. Kopieren Sie anschließend die WAR-Datei in den Ordner %TOMCAT%\webapps. Die Datei wird nun automatisch entpackt.
    Alternativ können Sie den Tomcat Manager benutzen, um die WAR-Datei zu installieren. Wenn der Tomcat-Dienst gestartet ist, erreichen Sie den Tomcat Manager üblicherweise unter http://<yourserver>:8080/manager/html.

Die Webanwendung ist jetzt unter folgender URL verfügbar: https://<yourserver>/smartfinder-search

Installation der Bundles

  1. Melden Sie sich als Administrator im map.apps Manager an.

  2. Öffnen Sie den Reiter Bundles.

  3. Klicken Sie auf die +-Schaltfläche oberhalb der Liste der installierten Bundles.

  4. Laden Sie die Datei [RELEASE-ORDNER]\ct-smartsearch-js-2.5.1.jar hoch. Diese enthält alle Bundles für die Extension.

Sobald das Hochladen beendet ist, werden die Smart Search Bundles in der Liste der installierten Bundles angezeigt.

Installation des Job-Manager

Um den Job-Manager innerhalb des map.apps Manager nutzen zu können, gehen Sie folgendermaßen vor:

  1. Öffnen Sie die map.apps Konfigurationsdatei application.properties.
    Diese liegt üblicherweise im Ordner [USER_HOME]/.mapapps

  2. Suchen Sie den Eintrag manager.config.viewbundles.

    Die Property steuert, welche Management-Bundles im map.apps Manager geladen werden.

    Falls die Property bereits existiert, ergänzen Sie am Ende den Wert sf_jobadmin. Andernfalls erstellen Sie die Property mit den Standardwerten von map.apps und dem Wert sf_jobadmin.

    Beispiel für manager.config.viewbundles
    manager.config.viewbundles=appmanagement,reportmanagement,bundlemanagement,mapapps-github-manager,bundleupdatechecker,sf_jobadmin

Anschließend erscheint im map.apps Manager der neue Reiter Indexierungs-Jobs.

Minimalkonfiguration

Nachdem die Bundles installiert wurden, muss map.apps die URL der Server-Anwendung für Suchanfragen kennen. Füge Sie dazu in der Datei application.properties von map.apps den folgenden Eintrag hinzu:

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

Passen Sie dabei die Domäne und den Namen in der URL an ihre Umgebung an. Wenn der smart.finder Server in derselben Apache Tomcat-Instanz installiert ist wie map.apps, genügt eine relative Angabe:

finder.service.url=/smartfinder-search
Falls die smart.finder Server-Komponente unter einer anderen Domäne erreichbar ist als map.apps, stellen Sie sicher, dass das map.apps Proxy-Servlet für den Zugriff auf den smart.finder Server freigeschaltet ist.