IBM Lotus Connector Installation und Konfiguration Version 2016 Fall Release Status: 04. Mai 2016
Copyright Mindbreeze GmbH, A-4020 Linz, 2017. Alle Rechte vorbehalten. Alle verwendeten Hard- und Softwarenamen sind Handelsnamen und/oder Marken der jeweiligen Hersteller. Diese Unterlagen sind streng vertraulich. Durch die Übermittlung und Präsentation dieser Unterlagen alleine werden keine Rechte an unserer Software, an unseren Dienstleistungen und Dienstleistungsresultaten oder sonstigen geschützten Rechten begründet. Die Weitergabe, Veröffentlichung oder Vervielfältigung ist nicht gestattet. Aus Gründen der einfacheren Lesbarkeit wird auf die geschlechtsspezifische Differenzierung, z.b. Benutzer/- innen, verzichtet. Entsprechende Begriffe gelten im Sinne der Gleichbehandlung grundsätzlich für beide Geschlechter. IBM Lotus Connector 2
Inhalt 1 Installation 4 2 Konfiguration von Mindbreeze 4 2.1 Konfiguration des Index 5 2.2 Konfiguration der IBM Lotus Datenquelle 6 2.2.1 Konfiguration von Adressbüchern 7 2.2.2 Konfiguration von Datenquellen 8 2.2.3 Document Selection Patterns 9 2.3 Konfiguration User Mapping 10 3 Fehlererkennung und behebung 10 IBM Lotus Connector 3
1 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. Wenn die Lizenz die Verwendung des IBM Lotus Crawler nicht erlaubt, wird folgende Warnung im Microsoft Application Event Log angezeigt: Erweiterung von Mindbreeze zum Gebrauch des IBM Lotus-Connectors: Der Mindbreeze IBM Lotus Connector ist als ZIP File verfügbar. Dieses File muss am Enterprise Search Server über das mesextension.exe Tool wie folgt registriert werden: mesextension --interface=plugin --type=archive -- file=ibmlotusconnector<version>.zip install Hinweis: Ein Update des Connectors kann über den gleichen mesextension Aufruf durchgeführt werden, Mindbreeze führt automatisch die benötigten Update Tasks aus. Um den IBM Lotus-Connector zu deinstallieren, müssen alle Lotus Notes Crawler entfernt warden und der folgende Aufruf ausgeführt werden: mesextension --interface=plugin --type=archive -- file=ibmlotusconnector<version>.zip uninstall 2 Konfiguration von Mindbreeze Bei der Installation die Advanced Option auswählen. IBM Lotus Connector 4
Im Indices-Tab das Symbol Add new index auswählen um einen neuen Index zu erstellen. 2.1 Konfiguration des Index Fügen sie einen Indexpfad, e.g. C:\Index hinzu. Wenn nötig muss der Display Name des Fabasoft Mindbreeze Enterprise Index Services und des dazugehörigen Fabasoft Mindbreeze Enterprise Filter Service angepasst werden. IBM Lotus Connector 5
2.2 Konfiguration der IBM Lotus Datenquelle Das Hinzufügen einer neuen Drittanbieterdatenquelle erfolgt über einen Klick auf das Add new custom source -Symbol rechts unten. Um sich mit dem Lotus Domino Server zu verbinden und die Datenquelle zu crawlen muss die folgende Information angegeben werden: Lotus Domino Server: DNS oder IP Adresse. Lotus Domino Port: TCP Port. Privileged Logon Account: Benutzeraccount mit entsprechenden Rechten zum Crawlen. IBM Lotus Connector 6
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üchern, oder 2. Direkt über die Namen der Datenquellen Sowohl Datenquellen als auch Adressbücher könne zum Auffinden der Datenquellen konfiguriert werden. Zur Konfiguration von Datenquellen und Adressbüchern muss das Feld Advanced Setting oben rechts im Indices Tab angehakt werden. 2.2.1 Konfiguration von Adressbüchern Um ein neues Adressbuch hinzuzufügen klicken sie auf Add Composite Property unten rechts. IBM Lotus Connector 7
Um ein Adressbuch zu konfigurieren, muss die folgende Information angegeben werden: File: Ein gültiges.nsf file (z.b. names.nsf). Server Key: Mailserver item key (z.b. MailServer). Server Item: Mailfile item key (z.b. MailFile). Crawl Mailbox of Users: Wenn Mailboxen bestimmter Benutzer in das Adressbuch aufgenommen werden sollen. 2.2.2 Konfiguration von Datenquellen Um eine neue Datenquelle hinzuzufügen, klicken Sie auf Add Composite Property unten rechts und konfigurieren Sie diese wie folgt: File: Datenquellen File Name (z.b. mail/johndoe.nsf). IBM Lotus Connector 8
Server: DNS oder IP Adresse des Lotus Domino Servers Mit dem Klick auf den Save-Button oben rechts werden die Einstellungen gespeichert. 2.2.3 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. IBM Lotus Connector 9
2.3 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 Benutzer Account Namen mit den Lotus Domino Account Namen zu mappen. 3 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. o 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. o 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. o 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. IBM Lotus Connector 10