Configuring and Indexing a Microsoft Exchange Source for an On-Premises Deployment
Note: For an Exchange 2013 hybrid deployment, you must create separate Exchange sources for the local and remote archives parts (see Configuring and Indexing Microsoft Exchange Sources for a Hybrid Deployment).
Important:
-
With Exchange Server 2013, to prevent having to build the source more than once, before building the source, configure the Exchange2013ViewModelValue hidden parameter to ensure that the OWA clickable URIs will be valid in search results (see Modifying Hidden Microsoft Exchange Source Parameters).
-
In the out-of-the-box search interfaces preferences, end-users can clear the Open emails with Microsoft Outlook option to open email messages in Outlook Web App (OWA) rather than in Outlook when clicking an email search result (see Modifying .NET Search Interface Preferences).
To configure and index a Microsoft Exchange source
-
On the Coveo server, access the Administration Tool (see Opening the Administration Tool).
-
Select Index > Sources and Collections.
-
In the Collections section:
-
Select an existing collection in which you want to add the new source.
OR
-
Click Add to create a new collection (see Adding a Collection).
-
-
In the Sources section, click Add.
The Add Source page that appears is organized in three sections.
-
In the General Settings section of the Add Source page:
-
Enter the appropriate value for the following required parameters:
-
Name
-
Enter a source name of your choice that represents the scope of the source.
Examples: Microsoft Exchange Server
-
Source Type
-
The connector used by this source. In this case, select Exchange (WebServices).
Select Exchange (WebDAV) only for Exchange 2003 or Exchange 2007 with Exchange 2003 compatibility mode (see Choosing to Connect to Microsoft Exchange Using Web Services or WebDAV).
Note: If you do not see Exchange (WebServices) or Exchange (WebDAV) in the Source Type list, your environment does not meet the requirements (see Microsoft Exchange Connector Requirements).
-
List of starting points for the connector. The connector supports both secured https and unsecured http servers.
Enter one address per line in one of the following forms:
-
https://servername/exchange
-
https://servername/exchange/mailboxname
-
https://servername/public
Examples:
-
To index all Microsoft Exchange mailboxes, enter a single URL that stops at the mailboxes root:
https://owa.companyname.com/exchange -
To index all public folders, enter a URL that stops at the public folders root:
https://owa.companyname.com/public
Note: Entering a specific server name will not restrict the crawled mailboxes to those located on that server (see What Are LDAP Searches?).
Tip: You can create a source that only indexes Microsoft Exchange 2010 mailbox archives, pointing the connector directly to mailbox archives and skipping normal mailboxes using the http://server/exchange/onlinearchivename address pattern, where you replace onlinearchivename by the value found in the Active Directory field msExchArchiveName. You also need to ensure that the IndexArchives hidden parameter is set to true for this source and to false for the other Exchange source (see IndexArchive (Boolean)).
-
-
Refresh Schedule
-
Time interval at which the index is automatically refreshed to keep the index content up-to-date. By default, the Every day option instructs CES to refresh the source everyday at 12 AM.
Note: You can create new or modify existing source refresh schedules (see Creating or Modifying a Source Schedule).
-
-
Review the value for the following parameters that often do not need to be modified:
-
Rating
-
Change this value only when you want to globally change the rating associated with all items in this source relative to the rating to other sources (see Understanding Search Results Ranking).
Example: If this source was for Exchange archives only, you may want to set this parameter to Low, so that in the search interface, results from this source appear lower in the search results compared to those from other sources.
-
Document Types
-
If you defined custom document type sets, ensure to select the most appropriate for this source (see What Are Document Type Sets?).
-
Active Languages
-
If you defined custom active language sets, ensure to select the most appropriate for this source.
-
Fields
-
If you defined custom field sets, ensure to select the most appropriate for this source (see What Are Field Sets?).
-
-
-
In the Specific Connector Parameters & Options section of the Add Source page, review if you need to change the parameter default values:
-
Max Number of Retries
-
Number of reconnection attempts performed when the Exchange server fails to reply to a request.
-
Retry Delay
-
Delay between reconnection attempts in seconds.
-
Exchange Folder
-
Name of the folder hosting all the mailboxes. The default value is exchange. It corresponds to the segment of the URI that is after the server name and points to the mailboxes https://servername/exchange/.
-
Use Form Authentication
-
Whether to use forms-based authentication or not. The check box is cleared by default.
Select the check box when forms-based authentication is enabled on the Microsoft Exchange server. The connector supports two forms-based authentication types:
-
Standard Microsoft Exchange forms-based authentication.
-
ISA server forms-based authentication. When an ISA filter is put in front of the Microsoft Exchange OWA server.
-
-
Index Exchange Security
-
Whether to index the permissions specified in Microsoft Outlook or not. The check box is selected by default.
Clear this check box when you want to prevent the Coveo connector from indexing user defined permissions, in which case, only Active Directory permissions are used.
-
Callback Service Url
-
Optional parameter indicating the location of the Exchange Callback Service that enhances the incremental refresh performance on Microsoft Exchange 2007, 2010, and 2013 (On-Premises and hybrid) (see Fine-Tuning the Exchange Callback Service).
The default value (http://localhost:8181/) is appropriate when the Exchange Callback Service runs on the same machine as CES. When the service runs on another computer, replace localhost by the Exchange server machine name. Change the port when the service does not use the default port (8181). Leave the parameter empty to disable the service.
-
Public Folder
-
Name of the public folder. The default value is public. It corresponds to the segment of the URI that is after the server name and that points to the public folders https://servername/public/.
-
Index Junk E-mails
-
Whether to index junk emails or not. Junk emails are indexed by default.
-
Skip 3rd Party Archived Items
-
Whether to skip indexing of items archived by an external archiving system, such as Symantec Enterprise Vault. This parameter is useful to make the Microsoft Exchange connector ignore email stubs left behind by an external archiving system. The check box is selected by default.
Notes:
-
Do not confuse the Skip 3rd Party Archived Items with the IndexArchive hidden parameter, which controls whether Exchange archive mailboxes should be indexed (see Modifying Hidden Microsoft Exchange Source Parameters).
-
CES 7.0.6767– (June 2014) The parameter is named Skip Archived Items.
-
-
Parameters
-
Click Add Parameter when you want to show and configure advanced hidden source parameters (see Modifying Hidden Microsoft Exchange Source Parameters).
In the Option section:
-
Index Subfolders
-
Check to index all subfolders below the specified starting addresses. Selected by default.
-
Index the document's metadata
-
When selected, CES indexes all the document metadata, even metadata that are not associated with a field. The orphan metadata are added to the body of the document so that they can be searched using free text queries.
When cleared (default), only the values of system and custom fields that have the Free Text Queries attribute selected will be searchable without using a field query (see Adding a Field to Search On and What Are Field Queries and Free Text Queries?).
Example: A document has two metadata:
-
LastEditedBy containing the value Hector Smith
-
Department containing the value RH
In CES, the custom field CorpDepartment is bound to the metadata Department and its Free Text Queries attribute is selected.
When the Index the document's metadata option is cleared, searching for RH returns the document because a field is indexing this value. Searching for hector does not return the document because no field is indexing this value.
When the Index the document's metadata option is selected, searching for hector also returns the document because CES indexed orphan metadata.
-
-
Generate a cached HTML version of indexed documents
-
When you select this check box (recommended), at indexing time, CES creates HTML versions of indexed documents. In the search interfaces, users can then more rapidly review the content by clicking the Quick View link rather than opening the original document with the original application. Consider clearing this check box only if you do not want to use Quick View links or to save resources when building the source.
-
Open results with cached version
-
Leave this check box cleared (recommended) so that in the search interfaces, the main search result link opens the original document with the original application. Consider selecting this check box only when you do not want users to be able to open the original document but only see the HTML version of the document as a Quick View. In this case, you must also select Generate a cached HTML version of indexed documents.
-
-
In the Security section of the Add Source page:
-
In the Active Directory Security Provider drop-down list, select Active Directory or a custom Active Directory security provider that you created for a specific domain (see Configuring an Active Directory Security Provider).
-
In the Exchange Security Provider drop-down list, select the security provider that you created for this source (see Configuring a Microsoft Exchange Security Provider).
-
In the Authentication drop-down list, select the user identity that you created for the Microsoft Exchange system.
-
Click Save and Start to save the source configuration and start indexing this source.
-
-
Validate that the source building process is executed without errors:
-
In the navigation panel on the left, click Status, and then validate that the indexing proceeds without errors.
OR
-
Open the CES Console to monitor the source building activities (see Using the CES Console).
-
Note: If you get a PowerShellException like the following, on the Coveo Master server, set Windows PowerShell execution policy to the RemoteSigned restriction to allow the connector script to run (see the Microsoft TechNet document: Using the Set-ExecutionPolicy Cmdlet).
Exchange (WebServices) Error: Error while listing mailboxes.
... Coveo.Connectors.Exchange.Connection.ExchangeConnectionException: Error while listing mailboxes. ---> Coveo.Connectors.Utilities.PowerShell.PowerShellException: Error while evaluating PowerShell script. ---> System.Management.Automation.CmdletInvocationException: There were errors in loading the format data file:
... Microsoft.PowerShell, , C:\Temp\....ps1xml : File skipped because of the following validation exception: File C:\Temp\....ps1xml cannot be loaded because the execution of scripts is disabled on this system. Please see "get-help about_signing" for more details.
What's Next?
Set an incremental refresh schedule for your source (see Scheduling a Source Incremental Refresh).
Consider modifying advanced source parameters (see Modifying Hidden Microsoft Exchange Source Parameters).