This documentation supports the 9.0 version of BMC Atrium Core.

To view the latest version, select the version from the Product version menu.

Configuring Reconciliation Engine system parameters

You can define system parameters for the Reconciliation Engine.

To modify the Reconciliation Engine system parameters

  1. From the Reconciliation console, click Edit Server Configuration.
  2. In the Server Configuration Editor, enter values for the following parameters:

Parameter

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

Description

Definition Check Interval (Seconds)

RE-Defn-Check-Interval

An expiration, in seconds, of the Reconciliation Engine's cache of job definitions. The default is 300. For 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.

Polling Interval (Seconds)

RE-Polling-Interval

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

Continuous Job Interval (Seconds)

RE-Cont-Job-Interval

The execution interval of a continuous job. The default value is 1800 seconds (30 minutes). If you set this value to less than 120 seconds (2 minutes), then the Reconciliation Engine converts that value to 120 seconds (2 minutes). For more information, see Creating a continuous reconciliation job.

RPC Socket

RE-RPC-Socket

The BMC Remedy 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. Because the Reconciliation Engine uses many API calls for BMC Atrium CMDB, you should use only those ports reserved for BMC Atrium CMDB and not ports that BMC Remedy 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. For more information, see Server settings and threads for the Reconciliation Engine.

Log File Path

RE-Log-File-Location

Location of log files. The default location is <installDir>\Logs.

Logging Level

RE-Debug-Level

Amount of information to log. The following levels are available:

Error — Error and warning messages including context such as instance, class, and dataset IDs. This level is the default. The corresponding numerical value for this logging level in ar.cfg file is 1.

Info — All information included in the Error option plus job name and start and finish times; activity name and other activity information; dataset and class being processed; class statistics; and activity statistics such as the number of records identified and merged. The corresponding numerical value for this logging level in ar.cfg file is 3.

Debug — All information included in the Info option plus trace messages. The corresponding numerical value for this logging level in ar.cfg file is 5.

Note: When the logging level is set to Error, the Reconciliation Engine creates a new 0 byte log file for each run of a reconciliation job, even when the job is successful. You can choose to configure the deletion of 0 byte log files for individual reconciliation jobs. For more information, see Configuring the deletion of Reconciliation Engine job log files.

Maximum Job Log File Size (KB)

RE-Max-Log-File-Size

This option is used to control the size of the job log files. When the log file reaches its maximum size, it is renamed using the <jobName><n> file name syntax, and log messages continue to be written to the original file, which is now empty. A value of zero indicates no maximum file size. The default is 300KB.

Look Into Other Datasets for Parallel Jobs

RE-Parallel-Job-Run

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.

Maxmium ARRecond Log File Size (KB)

RE-Arrecond-Max-Log-Size

This option is used to control the size of the arrecond process log file. When the log file reaches its maximum defined size, it is renamed to arrecond_n.log and the logging is continued in the arrecond.log. A value of zero indicates that the limit on the maximum file size is not specified. In that case, the log file takes the default value. The default size is 20480KB. You can specify a value in the range of 0 to 2097152 KB. For more information on how to use this parameter see, Restricting the Reconciliation Engine log file size.

Job Idle Time (Minutes)

RE-Job-Idle-Time

This is the time interval for which a job can remain idle. The default idle time is 60 minutes. You can specify a value in the range of 60 to 720 minutes. When the job idle time is set to 60 minutes, the fail safe mechanism in the reconciliation engine monitors all the running jobs at an interval of 60 minutes. If the fail safe feature detects a job, which is not responding not processing a CI for more than 60 minutes, the fail safe feature restarts the non-responding job. For detailed information on the fail safe feature see, Monitoring reconciliation jobs using the Fail safe feature.

For Service Pack 1 and later, the feature is disabled by default and the value is set to 0 minutes.

Was this page helpful? Yes No Submitting... Thank you

Comments