Reconciliation Engine configuration settings


The parameters in the Reconciliation section allow you to configure reconciliation settings in a server group environment.

CMDB core configurations - Reconciliation

If you are in a server group environment, make sure the reconciliation engine pod is selected from the Select Server list.

The required server name is automatically displayed if you have a stand-alone environment.

Parameter

Description

Default Value

Setting in the AR Configuration file 
(ar.cfg or ar.conf)

Definition Check Interval

Defines an expiration period for the Reconciliation Engine's cache of job definitions.

Example: If you change job, activity, precedence, or merge definitions, and then run a job, you might not see the results after the cache expires. Setting an expiration for the cached definitions helps to improve performance and reduce log size.

300

RE-Defn-Check-Interval

Polling Interval

Defines the polling interval in seconds. The Reconciliation Engine "sleeps" until the next job is scheduled to run or for this interval, or whichever occurs first. The Polling interval is used only when the dispatcher does not send a signal to the Reconciliation Engine.

18000

RE-Polling-Interval

RPC Socket

Specify the ports for the reconciliation engine.

The  RPC socket that the Reconciliation Engine uses for processing. You can specify only 390698 or 390699, which are the ports reserved for the Reconciliation Engine. You should use only those ports reserved for  and not ports that the  can use. 

If you use a port other than the reserved ports, the Reconciliation Engine displays a warning that the port in invalid. This can be used to specify a maximum number of threads.

390698

RE-RPC-Socket

Execution Interval for Continuous Job

Set the execution interval for continuous reconciliation job.

The execution interval of a continuous job. If you set this value to less than 120 seconds (2 minutes), then the Reconciliation Engine converts that value to 120 seconds (2 minutes).

1800

(30 minutes)

RE-Cont-Job-Interval

Job Idle Time

Set the duration for which the job remains idle.

Important: By default, the feature is disabled by setting the value to 0 minutes.

If you realize that a reconciliation job is idle for more than 12 hours, we recommend you to increase the value in the Job Idle Time field to 500 minutes. This ensures that after 500 minutes, the fail-safe mechanism detects the unresponsive job, starts a new job instance, and deletes the earlier job instance that was stuck.

For more information on the fail safe feature see, Monitoring-a-reconciliation-job.

0

RE-Job-Idle-Time

View Other Datasets for Parallel Continuous Jobs

Select this option if you have configured jobs that are running in parallel. When this option is selected, the jobs run the identify activity on the source and target datasets that are configured for the jobs and on all the other datasets. This ensures that the same Reconciliation ID is assigned to identical CIs in all the datasets and the data integrity is maintained.

False

RE-Parallel-Job-Run

You can also configure the server settings and threads for the Reconciliation Engine, in addition to setting the core configuration parameters for reconciliation. 

For setting up Reconciliation Engine logging, see Contents-of-the-logs


 

CMDB Centralized Configurations - ID Service

The RE ID service is enabled by default. The following configurations are available if the RE ID Service is enabled in the com.bmc.arsys.other component type:

To disable RE ID Service, in the Centralized configurations, change the Setting value of the parameter RE-Enable-IDService to F. For more information, see Reconciling-a-large-number-of-CIs

Parameter or Setting Name

Description

Default value

Polling-Interval

Defines the polling interval in seconds.

30

AR-Private-RPC-Socket

Uses a private queue dedicated only to RE ID Service.

Before using the private queue for the RE ID Service, define the private queue as described in Setting ports and RPC numbers

Set the following values:

Minimum threads - 24

Maximum threads - Set Fast threads to 3 times the number of CPU cores, and set List threads to 5 times the number of CPU cores.
You can adjust the values later if needed.

0

Log-Level

Logs the severity or type of information the system captures when the RE ID Service runs. The following log levels are available:

  • ERROR: Logs the events in which the application continues to run with some errors.
  • WARN: Logs the events that are potentially harmful situations.
  • INFO: Logs results of events and calls that highlight the progress of the application at a basic level.
  • DEBUG: Logs the useful events and calls to debug an application. This level includes input and output values.

WARN

Max-Log-File-Size

Indicates the maximum size (in megabytes) for the log file.

128MB

Max-Log-History

Indicates the maximum number of backup log files to be allowed when the log file reaches the Max-Log-File-Size value and a new log file is created. 

10

Identify-Source-Duplicates

The identification activity in a reconciliation job looks for duplicate CIs in the source dataset and filters them out before processing the CIs in the target dataset. This action reduces the number of identification errors and makes the reconciliation process more efficient.

By default, this parameter is enabled and the following setting is set to True:

Identify-Source-Duplicates: T

To disable this feature, set the value to False from the Centralized Configuration console in

Some content is unavailable due to permissions.

with the following setting:

Identify-Source-Duplicates: F

T


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*