Siebel Remote and Replication Manager Administration Guide > Setting Up Mobile Web Clients > Setting Synchronization Preferences >

Synchronization Parameters in Configuration Files


The configuration parameters that Siebel Remote uses for synchronization include:

  • ClientRootDir. Name of the Siebel client installation directory. This parameter is located in the [Siebel] section of the CFG file.
  • DockConnString. Logical network address of the Siebel Server to which you want to connect for synchronization.

    NOTE:  It is recommended that every synchronization session occur within the corporate firewall. If your deployment must support synchronization through the Internet from outside the firewall, VPN is a good alternative. If there are firewalls on the route from the synchronization client to the server (or from the VPN Server to the Siebel Server machine), then the port for synchronizing with the Siebel Server must be opened on the firewall, and this must be a port other than port 80.

    When not using a VPN connection, it is also possible that your Internet Service Provider (ISP) or another host on the route could block communication on this particular port.

    This parameter is located in the [Local] section of the CFG file, and it has the following format:

    siebel server name:network protocol:sync port #: service:encryption

    where:

    • siebel server name = logical network address of the Siebel Server to which you want to connect for synchronization.
    • network protocol = the name of the networking protocol to use. TCPIP is the only valid value and is the default value if nothing is specified.
    • sync port # = the TCP/IP port number dedicated to the Synchronization Manager. The default value is 40400 if nothing is specified.

      NOTE:  You can override the default value by specifying a value for the Synchronization Manager (SynchMgr) component's Static Port Number parameter in the Administration - Server Configuration > Servers view and then restarting the Siebel Server. You can also specify this port number as a command-line option when starting the Siebel Server. If you change this value, client CFG files must be updated to match the server setting.

    • service = the TCP/IP service you are requesting. SMI is the only valid value and is the default value if nothing is specified.
    • encryption = the encryption package you are using. The encryption facility must match the type used by the server. Both MSCRYPTO and RSA are supported.

      All elements of the DockConnString value except the Siebel Server name are optional. If an item between other items is omitted, adjacent colons must be retained—as in the third example below, which omits the network protocol element. Examples of valid values for DockConnString are:

    SIEBAPP1:TCPIP:40400:SMI:RSA

    SIEBAPP1:TCPIP:9000

    SIBAPP1::9000

    SIEBAPP1

  • DockRepositoryName. Name of the Siebel repository that you are currently using. This parameter must have the same value as the Siebel Server repository. This parameter is located in the [Siebel] section of the CFG file.
  • TableOwner. Name of the database account on the local database where the Siebel schema is installed. The default is SIEBEL. This parameter is located in the [Local] section of the CFG file.
  • DockTxnsPerCommit. Number of transactions that Siebel Remote applies to the local database before performing a commit. You should set this configuration parameter to a value that satisfies the needs at your site. The default is 500. This parameter is located in the [Local] section of the CFG file.
    • If you synchronize by using the File > Synchronize Database command in a Siebel application, set DockTxnsPerCommit to a high value. Merged transactions will not lock out other users. This enhances the performance of Siebel Remote.
    • If you are using the stand-alone synchronizer, set DockTxnsPerCommit to a high value only if the program will be the only active user on the database. If the program will apply transactions while the user is accessing the database through the application, set a low value to prevent locking out other users while merging transactions.
Siebel Remote and Replication Manager Administration Guide