Inbetriebnahme - Quickstart

Da die Inbetriebnahme eine Vielzahl von Einzelmaßnahmen umfasst, werden in diesem Abschnitt die notwendigen Schritte beschrieben.

Für dieses Quickstart-Tutorial wird eine vorhandene Installation des security.managers vorausgesetzt.
Dieser Quickstart-Tutorial erläutert die Verwendung des Standalone-Clients. Die Installation der Bundles in map.apps ist hier beschrieben: Installation in vorhandener map.apps Instanz.

Umgebung einrichten

Stellen Sie sicher, dass ihre Umgebung der entspricht, die durch das Produkt unterstützt wird:

  • JDK Version

  • Apache Tomcat Version

  • Datenbanksystem

ZIP Archiv entpacken

Das Produkt wird als ZIP Archiv ausgeliefert. Entpacken Sie dieses z.B. in ein temporäres Verzeichnis.

Ergebnis: im Wurzelverzeichnis befinden sich folgende Artefakte, die für den weiteren Installationsprozess wesentlich sind:

ct-smartfinder-sdi-client-webapp-[VERSION].war

Standalone Web Client

ct-smartfinder-sdi-extension-js-[VERSION].jar

map.apps Bundles für smart.finder SDI

ct-smartfinder-csw-[VERSION].war

CSW Proxy

ct-finder-iso-webapp-[VERSION].war

smart.finder Backend für ISO Dokumente

ct-smarteditor-webapp-[VERSION].war

Metadatenerfassungskomponente (smartEditor)

Deployment der Web-Applikation

Deployen Sie die folgenden Archive in die Apache Tomcat Instanz:

  • ct-smartfinder-sdi-client-webapp-[VERSION].war

  • ct-smartfinder-csw-webapp-[VERSION].war

  • ct-finder-iso-webapp-[VERSION].war

  • ct-smarteditor-webapp-[VERSION].war

Details zum Deployment finden Sie hier: Basiskomponenten

Ergebnis: die Web-Anwendungen sind unter folgenden URLs zugreifbar:

  • http://[HOST]:[PORT]/ct-smartfinder-sdi-client-webapp-[VERSION]

  • http://[HOST]:[PORT]/ct-smartfinder-csw-webapp-[VERSION]

  • http://[HOST]:[PORT]/ct-finder-iso-webapp-[VERSION]

  • http://[HOST]:[PORT]/ct-smarteditor-webapp-[VERSION]

Stoppen Sie den Apache Tomcat, damit die Properties für ihre Umgebung in den nächsten Schritten angepasst werden können.

Konfiguration der Web-Anwendung

Jede Web-Applikation besitzt drei Properties-Dateien, die unter /WEB-INF/classes bereitgestellt werden. Der grundsätzliche Aufbau der Properties-Dateien wird in Konfigurationsdateien erläutert.

In der Datei custom-application.properties wird das Home-Verzeichnis festgelegt: data.directory.location=$\{user.home\}/.smartfinder

Öffnen Sie dieses Verzeichnis und legen Sie hier eine Datei mit dem Namen application.properties an.
Hier werden sämtliche Properties für ihre Umgebung gespeichert und von allen Applikationen verwendet. Diese sind mindestens:

Properties Erläutert in

finder.service.url

Anpassen der URL-Konfiguration

smarteditor.context.name

URL des smartEditors

db.use
db.type
(db.jndi.name)
db.jdbc.driver
db.jdbc.url
db.jdbc.username
db.jdbc.password
db.hibernate.dialect

Datenbank-Verbindung

security.administration.url
security.sso.cookie.name
security.sso.cookie.domain
security.keystore.location
security.keystore.passwd
security.keystore.key.alias
security.keystore.key.passwd

Sicherheitsaspekte

Vorbereitung der Datenbank

Einige Datenbank-Parameter wurden im Abschnitt der Konfiguration bereits aufgelistet. Zwar wird die Datenbank über die Komponente smartEditor automatisch eingerichtet, es müssen jedoch einige Datenbank-spezifische Vorbereitungen getroffen werden. Diese sind im Detail im Kapitel Datenbank-Verbindung erläutert.

Ergebnis: Die Datenbank ist so vorbereitet, dass eine JDBC Verbindung durch die Applikationen aufgebaut werden kann. Die Datenbank-Parameter sind in der Datei data.directory.location=$\{user.home\}/.smartfinder/application.properties eingetragen.

Die benötigten JDBC-Datenbanktreiber werden nicht mit ausgeliefert. Kopieren Sie daher die zu Ihrem Datenbanksystem passenden Treiber entweder nach [TOMCAT_HOME]/lib oder [TOMCAT_HOME]/webapps/ct-smarteditor-webapp-[VERSION]/WEB-INF/lib.

Starten Sie den Apache Tomcat.

Wenn alle Web-Applikationen bereit sind, wurde auch die Datenbank unter der angegebenen Datenbankverbindung erzeugt.

Folgende Tabellen sind vorhanden:

  • Metadata

  • Locking

Einrichtung Nutzer

Öffnen Sie den security.manager und melden Sie sich als Administrator an. Legen Sie folgende Rollen an:

  • tc_Informationssuchender

  • tc_Datenpfleger

  • tc_Redakteur

  • tc_Administrator

  • maAdmin

Details finden Sie unter Rollenbasiertes Rechtekonzept.

Legen Sie einen Test-Nutzer mit dem Namen sfsdiadmin an und weisen Sie diesem die Rollen tc_Administrator und maAdmin zu.

Einrichtung Indexierung

Rufen Sie die Anwendung auf http://[HOST]:[PORT]/ct-smartfinder-sdi-client-webapp-[VERSION] und melden Sie sich mit dem gerade erzeugten Nutzer sfsdiadmin an. Öffnen Sie den Manager.

Richten Sie nur den Data Import Handler ein, um die Datenbank kontinuierlich zu indexieren. Eine detaillierte Anleitung finden Sie im Kapitel Indexierung der Datenbank.

Ein erster Test

Testen Sie die gesamte Anwendung wie folgt:

  1. Öffnen Sie http://[HOST]:[PORT]/ct-smartfinder-sdi-client-webapp-[VERSION].

  2. Wählen Sie die App full-page-sdi.

  3. Falls Sie nicht schon angemeldet sind, melden Sie sich als sfsdiadmin an.

  4. Rufen Sie im Menu "Smart Editor" auf.

  5. Erfassen Sie einen Metadatensatz und speichern Sie diesen als Öffentlich.

  6. Warten Sie solange, bis der Data Import Handler die Datenbank neu indexiert hat. Alternativ können Sie diese Indexierung auch direkt im Job-Manager anstossen.

  7. Gehen Sie zur Startseite der App full-page-sdi.

  8. Tippen Sie einen Begriff ein, den Sie im gerade erstellen Metadatensatz verwendet haben.

  9. Wählen Sie einen der Vorschläge aus.

  10. Das Dokument wird nun in der Ergebnisliste angezeigt.

  11. Klicken Sie auf den Eintrag in der Ergebnisliste, um zur Detailansicht zu gelangen.

Optionale Schritte

Migration der Altdatenbestände

Zur Übernahme von Metadatenbeständen aus smart.finder SDI 1.x können Sie das mitgelieferte Migrationstool verwenden. Dieses wird detailliert erläutert unter: Migration von smart.finder SDI 1.x zu smart.finder SDI 2.x.

Einrichtung CSW Proxy

Sie können den CSW Proxy bezüglich der Capabilities, Sprachunterstützung und SSL/TLS Verbindung konfigurieren. Dies wird hier detailliert erläutert: CSW Proxy.

Einrichtung verteilte Kataloge

Um die Broker-Funktionalität zu nutzen, können Sie weitere Katalog indexieren. Dies wird detailliert hier erläutert: Indexierungs-Jobs.