IBM Connections Connector

Installation and Configuration

Copyright ©

Mindbreeze GmbH, A-4020 Linz, 2017.

All rights reserved. All hardware and software names are brand names and/or trademarks of their respective manufacturers.

These documents are strictly confidential. The submission and presentation of these documents does not confer any rights to our software, our services and service outcomes or other protected rights. The dissemination, publication or reproduction hereof is prohibited.

For ease of readability, gender differentiation has been waived. Corresponding terms and definitions apply within the meaning and intent of the equal treatment principle for both sexes.

InstallationPermanent link for this heading

Before you install the IBM Connections Connector plug-in, you must ensure that the Mindbreeze server is installed and this connector is also included in the Mindbreeze license. If you are installing or upgrading the connector, use the Mindbreeze Management Center.

Plugin installation via Mindbreeze Management CenterPermanent link for this heading

To install or update Mindbreeze plug-in files, open the Mindbreeze Management Center. In the "Configuration" menu item, navigate to the "Plugins" tab. Select the ZIP file in the "Plugin Management" section and upload it using the "Upload" button. This automatically installs or updates the connector. After a plug-in installation, the Mindbreeze services are restarted.

Configuring MindbreezePermanent link for this heading

Basic settingsPermanent link for this heading

Select the installation method “Advanced“.

Click on the “Indices“ tab and then on the “Add new index“ icon to create a new index.

Enter the index path, e.g. /data/indices/ibm-connections. If necessary, change the display name of the index service and the associated filter.

Add a new data source with the icon “Add new custom source” on the lower right-hand side.

If not already selected, select “IBM Connections” by the “Category” button.

Using the “Crawler Interval“ setting, configure the time interval between two indexing runs.

Set the "Persistence directory" field to a valid folder path.

Set the IBM Connections URL field to the appropriate IBM Connections host and port.

You can use two variants for the authentication to IBM Connections:

  • HTTP Basic Authentication
  • HTTP Authentication Header

However, no matter which one you use, make sure that there is a user with the “search-admin” role in IBM Connections, and that you use this user for the connector.

For the "HTTP Basic Authentication" variant, make sure to tick the box "Use Basic Authentication" in the "Connection Settings" section. Set the "User Name" and "Password" fields accordingly.

For the "HTTP Authentication Header" variant, remove the checkmark from the "Use Basic Authentication" checkbox and insert the appropriate header (with a colon) under "HTTP Authentication Header".

Include or exclude metadata from indexingPermanent link for this heading

IBM Connections has a set of metadata that you can configure in IBM Connections. In Inspire, you can configure which of these metadata should be processed in general.

For example, comments are saved as metadata in the "blog" document type. If you do not want to index these comments, you can configure the "Metadata Include/Exclude" settings in the "Metadata Settings" section.

The following screenshot shows a rule that handles all metadata for the "blog" document type except for comments.