Fine-Tuning the Exchange Callback Service
The Callback Service Url source parameter indicates the location of the Exchange Callback Service (see Configuring and Indexing a Microsoft Exchange Source).
Important: Ensure to open the port 8181 in the firewall. The Exchange Server has to connect to the Exchange Callback Service to send notifications.
The Exchange Callback Service requires that a user identity is defined on the source to work (see Configuring a Microsoft Exchange User Identity).
When an Exchange WebServices source starts, a message appears in the CES log to specify whether the Exchange Callback Service is used or not, either because it is not configured correctly or cannot be started.
|Callback service state||Message in CES log when an Exchange (WebServices) source starts|
|Used||[SourceName] – Using Push Notifications.|
|Not used||An error message followed by:
[SourceName] – Using Standard Mode.
The Exchange Callback Service is configured to run correctly in most cases using default parameter values. You can however manually configure advanced parameters in the Exchange Callback Service configuration file to fine-tune out-of-the-box behaviors.
To fine-tune the Exchange Callback Service configuration file
Consult the following list of available configuration file parameters to see if you need to change the default value of one or more of them.
- Duration before a log file is automatically deleted by the service. Default is 30 days.
- Maximum size before splitting a log file. Default is 10 MB (10 485 760 bytes).
- Maximum number of concurrent connections that the service can create when calling the Exchange WebServices. Default is 4 connections.
- Displays the usage statistics about the service in the CES console and logs before each live indexing run. Default is false.
- Location of the data files used by the service. By default, data files are located in the [Index_Path]\Index\Crawlers\EchangeCallbackService folder.
- Location of the log files created by the service. By default, log files are saved in the same folder as the other CES log files ([Index_Path]\Log).
- Duration before an Exchange subscription is considered invalid. This value should not be changed unless there are issues using the default value. Default is 30 minutes. Maximum allowed is 1440 minutes.
- Host name used internally to build the web service URL. Changing this value affects directly the Callback Service Url parameter that is set on an Exchange source. Default is the computer name.
- Port number used internally to build the web service URL. Changing this value affects directly the Callback Service Url parameter that is set on an Exchange source. Default is 8181.
Using an administrative account, connect to the Coveo Master server.
- Browse to the CES bin folder ([CES_Installation_Path]\Bin).
Using a text editor:
Open the CESExchangeCallbackService.exe.config file.
Under <configuration> in the content of the file, locate the <appSettings> section.
Add one custom parameter per line under <appSettings> using the following format:
<add key=”parameter_name” value=”value”>
Save the file.Example: To specify a maximum number of connections equal to 6, add line 4 as shown in the following file excerpt.
<?xml version="1.0" encoding="utf-8"?> <configuration> <appSettings> <add key=”MaxConnections” value=”6”> </appSettings> ... </configuration>