Reconciliation Engine configuration settings
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 |
|---|---|---|---|
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 |
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 |
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 AR System server 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 BMC Helix CMDB and not ports that the AR System 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 |
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 and Merge service
The RE ID service is enabled by default. The following configurations are available if the ID, Merge or Misc service is enabled in the com.bmc.arsys.other component type. For more information about enabling or disabling these services, see Improving reconciliation job performance.
To modify the ID service settings
- Go to Applications > AR System Administration > AR System Administration Console > System > General > Centralized Configuration.
- From the Component Type list, select com.bmc.cmdb.recon.idservice > * .
To modify the Merge service settings
- Go to Applications > AR System Administration > AR System Administration Console > System > General > Centralized Configuration.
- From the Component Type list, select com.bmc.cmdb.recon.mergeservice > *
Parameter or Setting Name | Description | Default value |
|---|---|---|
| Api-Timeout-Long (RE Merge service only) | Indicates the API time out (in seconds) for long API/CMDB API calls. | 3600 |
| Api-Timeout-Normal (RE Merge service only) | Indicates the API time out (in seconds) for normal API/CMDB API calls. | 1800 |
AR-Private-RPC-Socket (RE ID service only) | 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 (Default) 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. | 0 |
| Batch-Processing-Chunk-Size (RE Merge service only) | Indicates the chunk size that in which the worker threads should process the CIs for merging activity. | 125 |
Identify-Source-Duplicates (RE ID service only) | 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 False: Identify-Source-Duplicates: F To disable this feature, set the value to True from the Centralized Configuration console in Mid Tier with the following setting: Identify-Source-Duplicates: T | F |
Log-Level | Logs the severity or type of information the system captures when the RE ID Service runs. The following log levels are available:
| 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 |
Polling-Interval | Defines the polling interval in seconds. | 30 |
| RE-RPC-Socket (RE Merge service only) | Uses a private queue dedicated only to RE Merge Service. Set the following values: Minimum threads - 24 (Default) 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. | 0 |