This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

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. For BMC Atrium Core version 9.1 and later, the feature is disabled by default and the value is set to 0 minutes.

If you realize that an RE job is idle for more than 12 hours, BMC recommends 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 detailed information on the fail safe feature see, Monitoring reconciliation jobs using the fail-safe mechanism.

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

Comments

  1. Worawut Ekarat

    Just to be clear, changing parameters here doesn't require AR System restart, correct? Thanks.

    Jun 07, 2016 11:07
    1. Amol Redij

      Hi Worawut,

      Thank you for your comment.

      You are right, you do not need to restart the AR System server. I have confirmed this with the concerned SME.

      Regards,

      Amol

      Jun 08, 2016 01:45
  2. Lj Longwing

    This is in regards to

    RE-Job-Idle-Time

    on page

    https://docs.bmc.com/docs/display/public/ac9000/Configuring+Reconciliation+Engine+system+parameters (version 9.0 of this doc) it states "For Service Pack 1 and later, the feature is disabled by default and the value is set to 0 minutes."

    I see the SAME comment in the above 9.1 documents.  Is this SP1 for 9.0 or SP1 for 9.1

    further, the above section states both of these things

    default idle time is 60

    and

    disabled by default

    A setting cannot have two different defaults, so it needs to be one or the other, but not both...so, at a minimum the 'for service pack' section needs to be clarified properly....but the section needs to be updated to properly represent the default value.

    Apr 12, 2017 12:53
  3. Marcel Martins

    Hello,

    When I try to save thoses configurations the pop-up closes but nothing happened, then when I open it again all configurations are in blanked. Is there any issue about it?

    May 23, 2018 02:38
    1. Kanchana Iyer

      Hi Marcel, Thanks for your question. I will check with the SME and update you shortly.

      Regards, Kanchana

      Jun 07, 2018 05:05
    1. Kanchana Iyer

      Hello Marcel,

      To get this issue resolved, I suggest you to please log in a ticket with BMC Support .

      Hope this helps.


      Thanks and regards,

      Kanchana

      Jun 28, 2018 12:15