IBM Lotus Connector
Installation und Konfiguration

Infrastrukturelle Vorbereitungen

Auf dem IBM Domino Server muss ein Service laufen, das die DIIOP-Datei für externe Anwendungen zur Verfügung stellt.

IBM-Doku: https://www-10.lotus.com/ldd/dominowiki.nsf/dx/DIIOP_Usage_and_Troubleshooting_Guide

Installation

Vor der Installation des IBM Lotus Connector Plugins muss sichergestellt werden, dass der Mindbreeze Server bereits installiert ist und dieser Connector auch in der Mindbreeze Lizenz inkludiert ist.

Konfiguration von Mindbreeze

Konfiguration der IBM Lotus Datenquelle

Um sich mit dem Lotus Domino Server zu verbinden und die Datenquelle zu crawlen, müssen die folgenden Informationen angegeben werden:

Nach der Konfiguration des Lotus Domino Server Connectors muss die zu indizierende Datenquelle spezifiziert werden. Das kann wie folgt durchgeführt werden:

1. Durchsuchen der Datenquelle mittels Adressbücher, oder
2. Direkt über die Namen der Datenquellen

Sowohl Datenquellen als auch Adressbücher können zum Auffinden der Datenquellen konfiguriert werden.

Zur Konfiguration von Datenquellen und Adressbüchern muss die Einstellung „Advanced Settings“ oben rechts im „Indices“ Tab angehakt werden.

Konfiguration von Adressbüchern

Um ein neues Adressbuch hinzuzufügen klicken Sie auf Add Property unten rechts.

Um ein Adressbuch zu konfigurieren, müssen die folgenden Informationen angegeben werden:

Konfiguration von Datenquellen

Um eine neue Datenquelle hinzuzufügen, klicken Sie auf Add Property unten rechts und konfigurieren Sie diese wie folgt:

Mit dem Klick auf den Save-Button oben rechts werden die Einstellungen gespeichert.

Datenbanken und Metadaten

Standardmäßig werden nur wenige Metadaten aus den userspezifischen Datenbanken übernommen. Um alle gewünschten Metadaten zu übernehmen, muss eine Mapping-Datei angelegt werden.

Mit der Option „Custom Form Configuration File Path“ können Sie einen File Pfad konfigurieren, in dem sich eine Form Konfigurationsdatei befindet.

Um die forms.xml Datei zu bearbeiten gibt es 2 Möglichkeiten:

• Automatisches Generieren der Mapping-Datei
• Manuelles Anlegen der Mapping-Datei

Automatisches Generieren der Mapping-Datei

Verwenden Sie dazu das Tool (forms_tool.zip) aus dem Verzeichnis:  IBM Lotus wie folgt:

java -jar ibm-domino-dbinfo.jar <servername[:port]> <username> <password> <database.nsf> [form regex] [field regex]

• Wenn Regex leer ist, werden alle Forms und deren Metadaten genommen. Ansonsten nur jene Forms, die das Forms Regex matchen und jene Felder/Metadaten davon, die das Feld Regex matchen
• Der Alias kann im IBM Domino/Lotus, wie im nachstehenden Screenshot veranschaulicht, eingesehen werden.

Kopieren Sie den Output anschließend in die forms.xml-Datei.

Manuelles Anlegen der Mapping-Datei

Öffnen Sie dazu die forms.xml-Datei und fügen Sie ihr eigenes Mapping hinzu.

Beispiel:

  <Form lotusName="content" categoryclass="blog">

                  <Title>$TITLE</Title>

                  <Metadatum lotusName="technorati" name="breadcrumbs"/>

                  <Metadatum lotusName="$UpdatedBy" name="updatedby">

                                               <PostProcessing type="CNExtract" />

   <!--CNExtract ==> Es werden CN-Properties entfernt, sodass zB Username überbleibt</!--CNExtract>-->

                               </Metadatum>

                <Metadatum lotusName="OriginalModTime" name="mes:date">

                               <PostProcessing type="ParseDateTime" format="dd.MM.yyyy HH:mm:ss z" locale="en"/>

   <!--Damit Mindbreeze das Datum interpretierten kann-->

                </Metadatum>

                <Metadatum lotusName="safesubject" name="content" fulltext="true" />

                </Form>

...

Diese Konfiguration bedeutet, dass alle Objekte gecrawled werden, die den Namen content haben, in der Datenbank blog liegen und die Metadaten davon wie im Beispiel gemapped werden.

Beispiel:

<Metadatum lotusName="technorati" name="breadcrumbs"/>

Das lotus-Metadatum technorati wird auf das Metadatum breadcrumbs in Mindbreeze gemapped.

Um den lotusName der Form herauszufinden, können Sie den IBM Domino Administrator verwenden:

Mit Default Einstellungen werden von Lotus Dokumenten nur die Attachments indiziert, die in Rich Text Felder eingebettet sind.

Wenn die Option „Index Not Embedded Attachments“ aktiv ist, werden alle Attachments extrahiert und indiziert.

Document Selection Patterns

Es ist möglich zu crawlende Datenquellen einzuschränken. Im folgenden Beispiel werden nur die Mailboxen von Benutzern, deren Name mit „john“ beginnt, gecrawlt.

Konfiguration User Mapping

Wird Map Users via Address Book ausgewählt, werden die ShortName Eigenschaften des speziellen Adressbuchs “names.nsf” zur Zuordnung der Identität (ShortName) des Benutzers eines IBM Lotus Accounts (FullName) benutzt.

Andernfalls muss ein Dateipfad für ein File, das ein Mapping für Benutzernamen enthält, angegeben werden. Dieses File wird dazu benutzt die Benutzeraccount-Namen mit den Lotus Domino Account Namen zu mappen.

Das File ist wie ein Java-Properties File aufgebaut:

<sso username (SAML, Kerberos, ...)> = <Lotus username/FullName aus names.nsf>

Beispiel:

Lotus username==Im names.nsf im Feld/Spalte “FullName“

Konfiguration IBM Lotus Principal Resolution Cache

Wählen Sie im neuen oder bestehenden Service in der Einstellung „Service“ die Option CachingIBMLotusNotesPrincipalResolutionService aus. Für mehr Informationen über das Erstellen und das grundlegende Konfigurieren eines Cache für einen Principal Resolution Service, siehe Installation & Konfiguration - Caching Principal Resolution Service.

Der IBM Lotus Principal Resolution Cache hat folgende spezifische Einstellungen:

Die restlichen Parameter müssen in den meisten Fällen nicht verändert werden.

Fehlererkennung und –behebung

Wenn keine Daten gefunden werden, kann das mehrere Ursachen haben:

• Der Crawler kann sich nicht zum Lotus Domino Server verbinden oder die Authentifikation schlägt fehl.
  • Das Log-File log-ibmlotuscrawler_*.txt gibt Aufschluss über mögliche Probleme. Standardmäßig ist es unter folgendem Pfad zu finden:
    • C:\Windows\TEMP\ log-ibmlotuscrawler_*.txt.
    • Unter Linux wird folgender Pfad benutzt /var/opt/mindbreeze/log/log-ibmlotuscrawler_*.txt.
  • Der Log Level kann in der Fabasoft Mindbreeze Enterprise Konfiguration konfiguriert werden. Weitere Details finden Sie im Whitepaper für Fabasoft Mindbreeze Enterprise.

• Probleme bei der Filterung/Indizierung von Daten.
  • Im Windows Event-Log (eventvwr.exe) unter Applications nach aufgezeichneten Events suchen, die ein Problem anzeigen könnten. Auf Linux Systemen werden Warnungen und Fehler ins Syslog geschrieben.