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.
The term ‘user‘ is used in a gender-neutral sense throughout the document.
Before installing the Microsoft Exchange Connector ensure that the Mindbreeze Server is already installed and this connector is also included in the Mindbreeze license.
The Microsoft Exchange Connector is available as a ZIP file. This file must be registered with the Fabasoft Mindbreeze Enterprise Server via mesextension.exe as follows:
mesextension --interface=plugin --type=archive --file=MicrosoftExchangeConnector<version>.zip install
PLEASE NOTE: The Connector can be updated by calling the same mesextention. Fabasoft Mindbreeze Enterprise will automatically carry out the required update.
Execute the following power shell commands on the Microsoft Exchange server:
Get-Mailbox | Add-MailboxPermission -user <domain>\<user>
Or per mailbox database:
Get-MailboxDatabase -identity “Mailbox 1” |Add-ADPermission -user <domain>\<user> –accessrights GenericALL
The crawling user can read the mailbox of other users but he cannot send emails on behalf of these users. The crawling user should have read permission on user objects in AD in order to read the msexchmailboxsecuritydescriptor attribute containing mailbox permissions during crawling ACLs.
For better crawling performance its recommended to overwrite the default Throttling Policies (EWSFindCountLimit = 1000 , EWSMaxConcurrency =10) according to current infrastructure. Therefor a new Throttling Policy should be defined for service user.
New-ThrottlingPolicy -Name serviceUserPolicy -EWSFindCountLimit 1000
Set-Mailbox <domain>\<serviceuser> -ThrottlingPolicy serviceUserPolicy
Select the “Advanced” installation method:
Click on the “Indices” tab and then on the “Add new index” symbol to create a new index.
Enter the index path, e.g. “/data/indices/exchange/2”. Change the Display Name of the Index Service and the related Filter Service if necessary.
Add a new data source with the symbol “Add new custom source” at the bottom right.
This information is important for the configuration of the connection with the Microsoft Exchange Server:
Hits of emails, attachments and calendars can be downloaded via the context menu.
To open a hit through Outlook Web Access, the “Outlook Web Access URL” must be configured and the option “Use Outlook Web Access” must be checked.
If the “Use Outlook Web Access Open as Default Action” option is selected, this action will be performed as a standard context action for every search result, i.e. the link of the hit opens Outlook Web Access.
“All Folders Items”: All folders items are compared for changes with their corresponding item in index.
“Changed Folders Items”: All items of only that folders which have at least one modified item are compared with their corresponding item in index.
“All Folders Items On Startup Only”: “All Folders Items” method for the first crawling run and “Changed Folders Items” for the subsequent runs.
In order to index items within specific time scope, the “Past Time Unit” and the “Number of Past Time Units” options must be defined. The time interval changes relative to last delta run so that old items are removed from index and new items are indexed.
To restrict all users’ searches to their primary-mailbox and public folders the “Restrict to Primary Mailbox and Public Folder” setting must be selected. If this feature is enabled users get no results from shared mailboxes or shared folders from other users’ mailboxes.
For Microsoft Exchange 2003 and 2007 it is necessary to fully re-crawl the Microsoft Exchange Server to use this option (if existing indices have been created with versions prior to 2016 Spring Release). A delta-crawling run is not sufficient.
In this area, you can define settings influencing the resource utilization on the Microsoft Exchange 2010 Server and the Mindbreeze Enterprise Search Server. These parameters can be set:
The “Dump Requests/Responses” enables enhanced troubleshooting by logging requests and responses to the configured directory “Dump Directory”. Using the “On Error” option, a request or response dump will be saved only if an error occurs in the process. Using the “Always” option all requests and responses will be dumped and by using the “Never” option no Requests/Responses will be dumped.
Note: Please do not activate this option in production use.
If the installation is made on a Microsoft Windows Server, the Kerberos authentication of the current Mindbreeze Service user can also be used for the Microsoft Exchange Crawler. In this case the Service user must be authorized to access the Microsoft Exchange Web Services.
For installations under Linux, you can use the managementcenter to generate the keytab.
IMPORTANT: The keytab must contain the key of the abovementioned user. The keytab for the Client Service cannot be used here.
To uninstall the Microsoft Exchange Connector, first delete all Microsoft Exchange Crawlers and then carry out the following command:
mesextension --interface=plugin --type=archive --file=MicrosoftExchangeConnector<version>.zip uninstall