IBM Lotus Connector - Mindbreeze Help Center

IBM Lotus Connector
Installation and Configuration
Version 2017 Winter Release
Status: March 28, 2017
Copyright ©
Mindbreeze GmbH, A-4020 Linz, 2017.
All rights reserved. All hardware and software names used
are registered trade names and/or registered trademarks of
the respective manufacturers.
These documents are highly confidential. No rights to our
software or our professional services, or results of our
professional services, or other protected rights can be based
on the handing over and presentation of these documents.
Distribution, publication or duplication is not permitted.
IBM Lotus Connector
Table of Contents
1 Infrastructure preparations ______________________________________________________ 4
2 Installation____________________________________________________________________ 4
3 Configuration of Mindbreeze _____________________________________________________ 4
3.1 Configuration of Index ________________________________________________________ 5
3.2 Configuration of IBM Lotus Data Source __________________________________________ 5
3.2.1 Configuration of Address Books _____________________________________________ 6
3.2.2 Configuration of Databases ________________________________________________ 8 Databases and Metadata _______________________________________________ 9 Automatically Generating the Mapping File _____________________________ 10 Manually Creating the Mapping File __________________________________ 10
3.2.3 Document Selection Patterns ______________________________________________ 11
3.3 Configuring User Mapping ____________________________________________________ 12
4 Troubleshooting and Recovery _________________________________________________ 13
IBM Lotus Connector
1 Infrastructure preparations
The IBM Domino server must run a service that provides the DIIOP file for external applications.
IBM Documentation:
2 Installation
Before installing the IBM Lotus Connector ensure that the Mindbreeze Server is already installed
and this connector is also included in the Mindbreeze license.
If the license does not allow you to use the IBM Lotus Crawler, the following warning will be logged
in the Microsoft Application Event Log:
The Mindbreeze IBM Lotus Connector is available as a ZIP file. This file has to be registered with
Enterprise Search Server via the mesextension.exe tool as follows:
mesextension --interface=plugin --type=archive -file=IBMLotusConnector<version>.zip install
Note: Updating the Connector can be performed using the same mesextension call, Mindbreeze will
automatically perform the update tasks required.
In order to uninstall the IBM Lotus-Connector please remove any Lotus Notes Crawler and execute
the following command:
mesextension --interface=plugin --type=archive -file=IBMLotusConnector<version>.zip uninstall
3 Configuration of Mindbreeze
At the installation select the „Advanced“ option.
Click on the Indices-Tab and then on the „Add new index“ symbol, to create a new index.
IBM Lotus Connector
3.1 Configuration of Index
Add an adequate index path, e.g. „C:\Index“. If necessary, adjust the Display Name of the Fabasoft
Mindbreeze Enterprise – Index Service and the related Fabasoft Mindbreeze Enterprise – Filter
3.2 Configuration of IBM Lotus Data Source
Add a new custom data source with the “Add new custom source” symbol in the lower right corner.
For connecting to Lotus Domino Server and crawling the databases provide the following
 Lotus Domino Server: DNS or IP address.
 Lotus Domino Port: TCP port.
 Privileged Logon Account: User account for crawling.
IBM Lotus Connector
After configuring the Lotus Domino Server connection, the next step is to specify the databases to
be crawled. This can be done by:
1. Searching databases through address books, or
2. Providing database names directly
Both databases and address books through which databases are found can be configured.
For configuring databases and address books check Advanced Setting on top-right corner of the
Indices tab.
3.2.1 Configuration of Address Books
Click on Add Composite Property on the bottom right to add a new address book.
IBM Lotus Connector
For configuring an address book, provide the following information:
 File: A valid .nsf file (for example, names.nsf).
 Server Key: Mailserver item key (for example, MailServer).
Name of the column containing the name of the server on which the actual
database files are located (reference)
 Server Item: Mailfile item key (such as MailFile).
 Crawl Mailbox of Users (map users via address book): If certain users' mailboxes are to be
included in the address book.
If this option is active, the principals (users/groups) from the first address book are
transferred in the configuration
To do this, the column/field ShortName has to be in the address book:
The CN properties are removed from the principal so that group/user
name is left
IBM Lotus Connector
Example:  jane.doe
The principal of the address book must be the same as the user/group
currently logged on (SAML, Kerberos, etc.), in order for the ACLs to work
3.2.2 Configuration of Databases
Click on Add Composite Property on the bottom right to add a new database and configure it as
 File: Database file name (e.g. mail/johndoe.nsf).
 Server: DNS or IP address of Lotus Domino Server
IBM Lotus Connector
By clicking the Save-button on the top right the settings will be persisted. Databases and Metadata
By default, only a few metadata are taken from the user-specific databases. The mapping file, which
is part of the connector, must be modified to accept all the desired metadata:
 Download Lotus Connector from the update site (
 Unpack the file \Mindbreeze IBM Lotus\IBM Lotus Connector\Plugin and then
save the Zip folder located there locally.
 Open this folder with 7-Zip and edit the forms.xml file
There are two ways to edit the forms.xml file:
IBM Lotus Connector
9 Automatically Generating the Mapping File
Use the tool ( from the directory:
IBM Lotus as follows:
java -jar ibm-domino-dbinfo.jar <servername[:port]> <username> <password>
<database.nsf> [form regex] [field regex]
If regex is empty, all forms and their metadata are taken; otherwise, only those forms that
match the forms regex and those fields/metadata that match the regex field are taken
The alias can be seen in the IBM Domino/Lotus as illustrated in the screenshot below.
Java -jar ibm-domino-dbinfo.jar <servername [: port]> <username> <password> <database.nsf>
[formregex] [fieldregex]
Afterwards, copy the output to the forms.xml file in the connector directory Manually Creating the Mapping File
To do this, open the forms.xml file in the connector directory and add your own mapping.
<Form lotusName="content" categoryclass="blog">
<Metadatum lotusName="technorati" name="breadcrumbs"/>
<Metadatum lotusName="$UpdatedBy" name="updatedby">
type="CNExtract" />
<!-CNExtract ==> CN-Properties are removed, so that e.g. Username remains</!-CNExtract>-->
<Metadatum lotusName="OriginalModTime" name="mes:date">
<PostProcessing type="ParseDateTime"
format="dd.MM.yyyy HH:mm:ss z" locale="en"/>
<!-- For Mindbreeze to
interpret the date -->
IBM Lotus Connector
<Metadatum lotusName="safesubject" name="content"
fulltext="true" />
This configuration means that all objects that have the name content and are located in the
database blog will be crawled, and the metadata from that are mapped as in the example.
<Metadatum lotusName="technorati" name="breadcrumbs"/>
The lotus metadatum technorati is mapped to the metadatum breadcrumbs in Mindbreeze.
To find the lotusName of the form, you can use the IBM Domino Administrator:
3.2.3 Document Selection Patterns
It is possible to narrow sources to be crawled. In the following example, only mailboxes of users
whose names begin with john are crawled.
IBM Lotus Connector
3.3 Configuring User Mapping
By selecting Map Users via Address Book the ShortName property of the special address book
“names.nsf” will be used to transform the identity (the ShortName) of the user to a IBM Lotus
account (the FullName).
If you want to provide your own user account to username mapping, enter a file in the “Map Users
via File” field.
The file is constructed like a Java-Properties file.
<sso username (SAML,Kerberos,..)> = <Lotus username/FullName aus names.nsf>
Lotus username==Im names.nsf im Feld/Spalte “FullName“
IBM Lotus Connector
4 Troubleshooting and Recovery
If no data can be found, there are different possible reasons:
 The crawler cannot connect to the Lotus Domino Server or the authentication collapses.
o Log-File log-ibmlotuscrawler_*.txt gives information about possible problems. Typically the log
file resides in this directory:
C:\Windows\TEMP\ log-ibmlotuscrawler_*.txt.
On Linux you can find the filein /var/opt/mindbreeze/log/log-ibmlotuscrawler_*.txt.
o Tracing can be activated in the Fabasoft Mindbreeze Enterprise Configuration. You can find
more details regarding the configuration of the log level in the Whitepaper for Fabasoft
Mindbreeze Enterprise.
 Problems during Filtering/Indexing of data.
o Warnings and errors can be found in the Applications event log (eventvwr.exe) on Windows
systems or in the syslog on Linux systems.
IBM Lotus Connector
Download PDF