Siebel Server Sync Guide > Configuring Siebel Server Sync >

Configuring Exchange Connector Parameters


The Siebel Exchange Connector contains various parameters that you can adjust to optimize performance. The following procedure describes how to tune Exchange Connector parameters.

This task is a step in Process of Configuring SSSE.

Exchange Connectors can run on any machine that is equipped with the sspicnea.exe executable file and certain SSSE DLLs. Exchange Connector, PIMSI Engine, and PIMSI Dispatcher can all be located on different machines.

If an SSSE deployment contains any Exchange Connector applications that reside on machines that do not contain PIMSI Engines, those Exchange connector applications are known as remote Exchange connector applications. For information about installing Exchange Connectors, see Installing Siebel Exchange Connector.

Use the following procedure to configure Exchange Connector parameters on any machine where Exchange Connector software is installed.

To configure Siebel Exchange Connector parameters

  1. From the Siebel application menu, choose Navigate > Site Map > Administration - PIM Server Integration > Configuration > PIM Server Integration Configuration.
  2. In the PIM Server Integration Configuration list, select the record in which the value of Profile Name is Exchange 2000 Connector.

    NOTE:  This is the correct record to select for either 2000 or 2003 Exchange environments.

  3. In the Configuration Parameters list, create or modify and save records as needed, using the information in Table 21.

    You may be able to use default values for most of the parameters listed. However, you must create records for the Engine Shares section.

Table 21. Exchange 2000 Connector Configuration Parameters
Section
Parameter
Default
Comments

Calendar

QueryExternalDomains

FALSE

When the Exchange Connector cannot locate a Calendar item attendee in the Active Directory Global Catalog, this setting determines whether or not to perform an exhaustive Active Directory search.

Connector Application Map

Name of an Engine Share (for example, Share1 or Share01)

Not applicable

(Optional) If your Exchange Servers are located in several geographical locations, you may be able to improve performance by assigning synchronization tasks for each Exchange Server to Exchange Connector applications that run nearby.

To do this, create one or more records with Section set to Connector Application Map. In the Parameter field of each record, enter the name of one of your Engine Shares (the shared directories where Exchange Connector applications are run). In the Value field, enter the name of the Exchange Server that you want that Exchange Connector to serve.

You can create as many Connector Application Map records as you have Engine Shares. For more information about this setting, see About Mapping Exchange Connectors to Exchange Servers.

NOTE:  If you have sync-enabled users on more Exchange Servers than you have Engine shares, make sure there is an Engine Share on the PIMSI Engine machine that is not associated with any particular Exchange Server. This share must serve users on any Exchange Server that is not explicitly specified in a Connector Application Map record.

Engine Shares

Sharen

Not Applicable

The n in the parameter name should be a unique number. Specify the value of each share as a UNC path to a remote or local file system directory that has been shared, using the format \\machine_name\share_name. Connector applications are run on the machine indicated in the share. For more information about configuring shares, see Setting Up the Connector Share Directory.

PreferredGCServers

GCServern (replace n with 1, 2, and so on)

Not applicable (Enter the name of a Global Catalog server)

(Optional) Indicates one or more preferred Active Directory Global Catalog servers for the Exchange Connector to contact when identifying SSSE user mailboxes.

SyncOptions

PreserveAttachments

TRUE

Indicates whether or not the Connector should preserve PIM attachments for noncalendar domains. If this parameter is set to FALSE, attachments are removed when the Connector updates the record in Exchange. This setting does not affect Siebel attachments.

SyncOptions

PreserveUnmappedFields

TRUE

Indicates whether or not the Connector should preserve the data for fields which are not mapped for synchronization for noncalendar domains. If this parameter is set to FALSE, any data in an unmapped field is removed from the record in Exchange.

Timeouts

Connect

180 seconds

When an Exchange Connector application first runs, it waits the configured number of seconds for a PIMSI Engine instance to establish a connection with it. If no connection is established, the Exchange Connector application shuts down to conserve resources. You may want to increase the value of this setting if your users run SSSE over a slow network.

NOTE:  The application is automatically restarted if the PIMSI Dispatcher requests synchronization for more users than currently running Exchange Connector instances can handle.

Timeouts

Reconnect

30 seconds

When a running Exchange Connector application detects that no PIMSI Engine instance is exchanging data with it, the application waits the configured number of seconds for a PIMSI Engine instance to reestablish a connection. If no connection is established, the Exchange Connector application shuts down to conserve resources. You may want to increase the value of this setting if your users run SSSE over a slow network.

UsersPerApplication

MaxUsers

10

Maximum number of users each instance of a Connector application can simultaneously synchronize. Maximum value is 200.

You may find that performance improves if you use a low value for this setting during initial extract operations.

For more information about this setting, see About Tuning SSSE for Optimal Performance.

 

Siebel Server Sync Guide Copyright © 2007, Oracle. All rights reserved.