Home
Home
German Version
Support
Impressum
22.1 Release ►

    Main Navigation

    • Preparation
      • Connectors
      • Initial Startup for G7 appliances
      • Setup InSpire G7 primary and Standby Appliances
    • Datasources
      • Configuration - Atlassian Confluence Connector
      • Configuration - Best Bets Connector
      • Configuration - COYO Connector
      • Configuration - Data Integration Connector
      • Configuration - Documentum Connector
      • Configuration - Dropbox Connector
      • Configuration - Egnyte Connector
      • Configuration - GitHub Connector
      • Configuration - Google Drive Connector
      • Configuration - GSA Adapter Service
      • Configuration - HL7 Connector
      • Configuration - IBM Connections Connector
      • Configuration - IBM Lotus Connector
      • Configuration - Jira Connector
      • Configuration - JiveSoftware Jive Connector
      • Configuration - JVM Launcher Service
      • Configuration - LDAP Connector
      • Configuration - Microsoft Azure Principal Resolution Service
      • Configuration - Microsoft Dynamics CRM Connector
      • Configuration - Microsoft Exchange Connector
      • Configuration - Microsoft File Connector (Legacy)
      • Configuration - Microsoft File Connector
      • Configuration - Microsoft Graph Connector
      • Configuration - Microsoft Project Connector
      • Configuration - Microsoft SharePoint Connector
      • Configuration - Microsoft Stream Connector
      • Configuration - Microsoft Teams Connector
      • Configuration - Salesforce Connector
      • Configuration - SAP KMC Connector
      • Configuration - SemanticWeb Connector
      • Configuration - ServiceNow Connector
      • Configuration - SharePoint Online Connector
      • Configuration - Sitecore Connector
      • Configuration - Web Connector
      • Configuration - Yammer Connector
      • Data Integration Guide with SQL Database by Example
      • Indexing user-specific properties (Documentum)
      • Installation & Configuration - Atlassian Confluence Sitemap Generator Add-On
      • Installation & Configuration - Caching Principal Resolution Service
      • Installation & Configuration - Jive Sitemap Generator
      • Installation & Configuration - Mindbreeze InSpire Insight Apps in Microsoft SharePoint On-Prem
      • Mindbreeze InSpire Insight Apps in Microsoft SharePoint Online
      • Mindbreeze Web Parts for Microsoft SharePoint
      • User Defined Properties (SharePoint 2013 Connector)
      • Whitepaper - Mindbreeze InSpire Insight Apps in Salesforce
    • Configuration
      • CAS_Authentication
      • Cognito JWT Authentication
      • Configuration - Alternative Search Suggestions and Automatic Search Expansion
      • Configuration - Back-End Credentials
      • Configuration - Chinese Tokenization Plugin (Jieba)
      • Configuration - CJK Tokenizer Plugin
      • Configuration - Collected Results
      • Configuration - CSV Metadata Mapping Item Transformation Service
      • Configuration - Entity Recognition
      • Configuration - Exporting Results
      • Configuration - Filter Plugins
      • Configuration - GSA Late Binding Authentication
      • Configuration - Identity Conversion Service - Replacement Conversion
      • Configuration - Index-Servlets
      • Configuration - Item Property Generator
      • Configuration - Japanese Language Tokenizer
      • Configuration - Kerberos Authentication
      • Configuration - Management Center Menu
      • Configuration - Metadata Enrichment
      • Configuration - Metadata Reference Builder Plugin
      • Configuration - Mindbreeze Proxy Environment (Remote Connector)
      • Configuration - Notifications
      • Configuration - Personalized Relevance
      • Configuration - Plugin Installation
      • Configuration - Principal Validation Plugin
      • Configuration - Profile
      • Configuration - QueryExpr Label Transformer Service
      • Configuration - Reporting Query Logs
      • Configuration - Reporting Query Performance Tests
      • Configuration - Request Header Session Authentication
      • Configuration - Shared Configuration (Windows)
      • Configuration - Vocabularies for Synonyms and Suggest
      • Configuration of Thumbnail Images
      • Cookie-Authentication
      • Documentation - Mindbreeze InSpire
      • I18n Item Transformation
      • Installation & Configuration - Outlook Add-In
      • Installation - GSA Base Configuration Package
      • Language detection - LanguageDetector Plugin
      • Mindbreeze Personalization
      • Mindbreeze Property Expression Language
      • Mindbreeze Query Expression Transformation
      • Non-Inverted Metadata Item Transformer
      • SAML-based Authentication
      • Trusted Peer Authentication for Mindbreeze InSpire
      • Using the InSpire Snapshot for Development in a CI_CD Scenario
      • Whitepaper - SSO with Microsoft AAD or AD FS
      • Whitepaper - Text Classification Insight Services
    • Operations
      • app.telemetry Statistics Regarding Search Queries
      • Configuration - app.telemetry dashboards for usage analysis
      • Configuration Usage Analysis
      • Deletion of Hard Disks
      • Handbook - Backup & Restore
      • Handbook - Command Line Tools
      • Handbook - Distributed Operation (G7)
      • Handbook - Filemanager
      • Handbook - Indexing and Search Logs
      • Handbook - Updates and Downgrades
      • Index Operating Concepts
      • Inspire Diagnostics and Resource Monitoring
      • InSpire Support Documentation
      • Mindbreeze InSpire SFX Update
      • Provision of app.telemetry Information on G7 Appliances via SNMPv3
      • Restoring to As-Delivered Condition
    • User Manual
      • Cheat Sheet
      • iOS App
      • Keyboard Operation
    • SDK
      • api.v2.alertstrigger Interface Description
      • api.v2.export Interface Description
      • api.v2.personalization Interface Description
      • api.v2.search Interface Description
      • api.v2.suggest Interface Description
      • api.v3.admin.SnapshotService Interface Description
      • Debugging (Eclipse)
      • Developing an API V2 search request response transformer
      • Developing Item Transformation and Post Filter Plugins with the Mindbreeze SDK
      • Development of Insight Apps
      • Embedding the Insight App Designer
      • Java API Interface Description
    • Release Notes
      • Release Notes 20.1 Release - Mindbreeze InSpire
      • Release Notes 20.2 Release - Mindbreeze InSpire
      • Release Notes 20.3 Release - Mindbreeze InSpire
      • Release Notes 20.4 Release - Mindbreeze InSpire
      • Release Notes 20.5 Release - Mindbreeze InSpire
      • Release Notes 21.1 Release - Mindbreeze InSpire
      • Release Notes 21.2 Release - Mindbreeze InSpire
      • Release Notes 21.3 Release - Mindbreeze InSpire
      • Release Notes 22.1 Release - Mindbreeze InSpire
    • Security
      • Known Vulnerablities
    • Product Information
      • Product Information - Mindbreeze InSpire - Standby
      • Product Information - Mindbreeze InSpire
    Home

    Path

    Sure, you can handle it. But should you?
    Let our experts manage the tech maintenance while you focus on your business.
    See Consulting Packages

    IBM Lotus Connector

    Installation and Configuration

    Copyright ©

    Mindbreeze GmbH, A-4020 Linz, 2022.

    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.

    Infrastructure preparationsPermanent link for this heading

    The IBM Domino server must run a service that provides the DIIOP file for external applications.

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

    InstallationPermanent link for this heading

    Before installing the IBM Lotus Connector ensure that the Mindbreeze Server is already installed and this connector is also included in the Mindbreeze license.

    Configuration of MindbreezePermanent link for this heading

    Configuration of IBM Lotus Data SourcePermanent link for this heading

    To connect to the Lotus Domino server and crawl the data source, the following information must be provided:

    • Lotus Domino Server: DNS or IP address.
    • Lotus Domino Port: TCP Port. (Port where you can reach the DIIOP file (e.g.: http://YOURSERVER/diiop_ior.txt))
    • Privileged Logon Account: User account with appropriate rights to crawl.

    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.

    Configuration of Address BooksPermanent link for this heading

    Click on Add Property on the bottom right to add a new address book.

    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
    • Example: jane.doe@testlab.com 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

    Configuration of DatabasesPermanent link for this heading

    Click on Add Property on the bottom right to add a new database and configure it as follows.

    • File: Database file name (e.g. mail/johndoe.nsf).
    • Server: DNS or IP address of Lotus Domino Server

    By clicking the Save-button on the top right the settings will be persisted.

    Databases and MetadataPermanent link for this heading

    By default, only a small amount of metadata is taken from the user-specific databases. A mapping file must be created in order to transfer all required metadata.

    With the option "Custom Form Configuration File Path" you can configure a file path that contains a form configuration file.

    There are two ways to edit the forms.xml file:

    Automatically Generating the Mapping FilePermanent link for this heading

    Use the tool (forms_tool.zip) 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 field regex are taken.
  • The alias can be viewed in IBM Domino/Lotus as shown in the screenshot below.

    Then copy the output into the forms.xml file.

    Manually Creating the Mapping FilePermanent link for this heading

    Open the forms.xml file and add your own mapping.

    Example:

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

                      <Title>$TITLE</Title>

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

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

                                                   <PostProcessing type="CNExtract" />

       <!--CNExtract ==> CN properties are removed, so that e.g. username remains</!--CNExtract>-->

                                   </Metadatum>

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

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

       <!--So that Mindbreeze can interpret the date-->

                    </Metadatum>

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

                    </Form>

    ...

    This configuration means that all objects with the name content are crawled, stored in the database blog and their metadata is mapped as in the example.

    Example:

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

    The lotus metadatum technorati is mapped to the metadata breadcrumbs in Mindbreeze.

    To find out the lotusName of the form, you can use the IBM Domino Administrator:

    With default settings, Lotus documents index only those attachments embedded in rich text fields.

    If the "Index Not Embedded Attachments" option is enabled, all attachments are extracted and indexed.

    Document Selection PatternsPermanent link for this heading

    It is possible to narrow sources to be crawled. In the following example, only mailboxes of users whose names begin with john are crawled.

    Configuring User MappingPermanent link for this heading

    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>

    Example:

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

    Configuration IBM Lotus Principal Resolution CachePermanent link for this heading

    The IBM Lotus Principal Resolution Cache has the following specific settings:

    • „IBM Lotus Domino Server Host“: IBM Lotus Domino FQDN of IP address
    • „IBM Lotus Domino Server Port“: TCP Port with which one you can reach the DIIOP-file
    • „IBM Lotus Domino Login Credential“: username/password credential with read access to the configurated domain catalog and directory databases.
    • „Directory Database“: The Directory Database (typically names.nsf where users and groups are saved)
    • „Domain Catalog Database“: The IBM Lotus Domain Catalog Datenbase (Default: catalog.nsf)
      Includes the database, ACLs and roles for all available databases in the domain.
    • „Database For Role Resolving“: A list of databases its locally defined roles are taken into account.
    • „Additional User ID Properties“: A list of Documents Properties which should be used as User ID. For example, MailAddress or employeeNumber

    The other parameters usually do not need to be changed. A more detailed description can be found here: Installation & Configuration - Caching Principal Resolution Service

    Um den Caching Principal Resolution Service zu testen, können Sie die Principal Resolution Service REST API verwenden.

    Troubleshooting and RecoveryPermanent link for this heading

    If no data can be found, there are different possible reasons:

    • The crawler cannot connect to the Lotus Domino Server or the authentication collapses.
      • 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.
      • 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.
      • Warnings and errors can be found in the Applications event log (eventvwr.exe) on Windows systems or in the syslog on Linux systems.

  • Download PDF

    • Configuration - IBM Lotus Connector

    Content

    • Infrastructure preparations
    • Installation
    • Configuration of Mindbreeze
    • Configuration IBM Lotus Principal Resolution Cache
    • Troubleshooting and Recovery

    Download PDF

    • Configuration - IBM Lotus Connector