Export (0) Print
Expand All

Rule Engine Configuration and Tuning Parameters

The following table contains a list of registry keys that may be useful for configuration validation and troubleshooting. These registry keys are stored under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BusinessRules\3.0.

With the exception of the first three keys listed, these keys are intended to allow products—and not users—to customize the rule engine. All of them are created upon installation; however, no interface is provided to set any of these values.

The definitions for the table columns are as follows:

  • Name. Name of the registry key.

  • Description. A brief description about the location or use of the key.

  • Config default. Value returned if the key does not exist.

  • Install default. Value set by BizTalk Server when installing the rule engine.

 

Name Description Config default Install default

InstallPath

Location of BRE files that is used at the configuration time.

(null)

C:\Program Files\Common Files\Microsoft BizTalk (or C:\Program Files (x86)\Common Files\Microsoft BizTalk on a 64-bit operating system)

DatabaseServer

Database server used.

(empty string)

Name of the database server specified during configuration of BRE.

DatabaseName

Name of database to be used.

(empty string)

Name of the database specified during configuration of BRE. Typically, it is BizTalkRuleEngineDb

PubSubAdapterAssembly

Assembly name of pub/sub adapter.

Microsoft.RuleEngine

Microsoft.RuleEngine

PubSubAdapterClass

Class name of pub/sub adapter.

Microsoft.RuleEngine.PubSubAdapter

Microsoft.RuleEngine.PubSubAdapter

DeploymentDriverAssembly

Assembly name of deployment driver.

Microsoft.RuleEngine

Microsoft.BizTalk.RuleEngineExtensions

DeploymentDriverClass

Class name of deployment driver.

Microsoft.RuleEngine.RuleSetDeploymentDriver

Microsoft.BizTalk.RuleEngineExtensions.RuleSetDeploymentDriver

TrackingInterceptorAssembly

Assembly name of tracking interceptor.

(empty string)

Microsoft.BizTalk.RuleEngineExtensions

TrackingInterceptorClass

Class name of tracking interceptor.

(empty string)

Microsoft.BizTalk.RuleEngineExtensions.RuleSetTrackingInterceptor

TranslationTimeout

Maximum time in milliseconds that can be used to translate a ruleset.

noteNote
This can be overridden on a per-ruleset basis by using the RuleSetConfiguration).

60000 (1 minute)

60000

UpdateServiceName

Name of the Update service, used by .NET remoting to locate the service.

RemoteUpdateService

RemoteUpdateService

UpdateServiceHost

Computer hosting the Update service, used by .NET remoting to locate the service.

noteNote
The service currently restricts incoming messages to same machine only.

localhost

localhost

UpdateServicePort

TCP port number used by the Update service, used by .NET remoting to locate the service.

3132

3132

CacheEntries

Maximum number of rulesets cached by the Update service.

32

32

CacheTimeout

Time in seconds for entries to age out of the Update service cache.

3600 (1 hour)

3600

PollingInterval

Time in seconds for the Update service to check SqlRuleStore for updates.

60 (1 minute)

60

SqlTimeout

Timeout value for SQL commands that access the SQL rule store. The value for this key is interpreted as follows:

< 0 - Uses the .NET default value (30 seconds)

= 0 - Unlimited timeout

> 0 - Maximum time for a query before it times out

-1

-1

You can also add a registry key named StaticSupport as mentioned in Invoking Static Members of a Class.

The registry settings are global for all applications that host a rule engine instance. You can override these registry settings at an application level by using the application configuration file. For BizTalk Server applications, the host application is the BTSNTSvc.exe and the configuration file is the BTSNTSvc.exe.config, which you can find in the BizTalk Server installation directory. You need to specify the values for the configuration parameters that you want to override in the application configuration file as show below:

<configuration>
    <configSections>
        <section name="Microsoft.RuleEngine" type="System.Configuration.SingleTagSectionHandler" />
    </configSections>
    <Microsoft.RuleEngine
        UpdateServiceHost="localhost"
        UpdateServicePort="3132"
        UpdateServiceName="RemoteUpdateService"
        CacheEntries="32"
        CacheTimeout="3600"
        PollingInterval="60"
        TranslationTimeout="3600"
        CachePruneInterval="60"
        DatabaseServer="(localhost)"
        DatabaseName="BizTalkRuleEngineDb"
        SqlTimeout="-1"
        StaticSupport="1"
    />
</configuration>
  © 2009 Microsoft Corporation. All rights reserved.
Show:
© 2014 Microsoft