This documentation supports the 18.08 version of BMC Atrium Core.

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

Reconciliation best practices

For reconciliation to be effective you must be aware of the following best practices. You must follow some of these guidelines to prepare your data, and follow other guidelines throughout the process.

Import data sets

Make sure that each data provider has its own import data set.

CI attributes

Verify that the CI (configuration item) attributes used in the identification rules of identify activity have unique values and are populated consistently. 

If you use a standard job with the standard identification rules, you can verify the classes and identifying attributes on the Standards tab in Configurations > Manage Reconciliation Rules > Identification Rules


The Name attribute is used to identify instances of most classes, but for some classes the identification rules include other attributes. The standard rules identify instances of BMC_DiskDrive are based on Name and SerialNumber.


Do not populate the TokenID attribute unless you know the formulae that BMC discovery products use to populate it. The Token ID is reserved for use by some BMC discovery applications and is one of the primary attributes for identifying a computer system.

The identify activity and reconciliation IDs

To set up a reconciliation job, you must configure identification activities that match instances across datasets. The Identify activity reviews all incoming data, determines similar CIs across more than one data set, and marks where these data set instances seem to be the same CI. 

The reconciliation engine marks CI and relationship instances with reconciliation IDs that are unique to individual CIs within a data set. 

This initial marking step is critical to enable the compare and merge activities without causing conflicts from overlapping data that could potentially corrupt your CMDB with unreliable CI data.


Do not change the value of the ReconciliationIdentity attribute for unidentified and identified CIs or relationships.

Changing the value of the ReconciliationIdentity attribute for unidentified and identified CIs or relationships to some other character causes inconsistent results. The reconciliation engine looks for a value of 0 for unidentified CIs in the ReconciliationIdentity attribute.

The reconciliation ID is stored in the ReconciliationIdentity attribute of the BMC_BaseElement and BMC_BaseRelationship classes. 

In the CMDB dashboard user experience, you can use the following setting to modify the reconciliation ID at Jobs > Manage Reconciliation > Create Job >  Add Activity > Identify.


If this option is enabled, the reconciliation engine searches for CIs in the production data set that have a reconciliation ID of 0 and sets the ID to a non-zero value that is unique across all data sets.

Reconciliation in a server group

In response to server status changes, the reconciliation engine automatically executes reconciliation jobs on a primary or secondary server in a server group. A server group is two or more servers that share the same database and provide failover operations.

The AR System server notifies the reconciliation engine for a status change. If the primary server status changes to suspended, the reconciliation engine stops reconciliation jobs on the primary server and resumes them on another server from the point where it stopped on the primary server. If the primary server status changes to running, reconciliation jobs on secondary servers are paused and resumed on the primary server.

The reconciliation engine assigns the SGPaused status when a job is paused while the job switches from one server to another in the server group. For example, when a job is running on one server (server 2) and a higher ranking server (server 1) comes up, the reconciliation engine pauses the job on server 2 and updates the job run status to SGPaused.


  • To exclude a server that has no rank assigned or a user facing server from running reconciliation jobs, comment out the reconciliation engine entry (arrecond.exe) in the armonitor.cfg file.
  • To exclude a ranked server from running reconciliation jobs, remove rank of the server and comment out the reconciliation engine entry (arrecond.exe) in the armonitor.cfg file.

The AR System server transfers control from one server to another depending on the Rank value specified in the AR System group operation ranking form. The reconciliation engine requires three iterations of 60 seconds each (180 seconds total) to transfer a job from one server to another so that the first server properly pauses the running jobs and the second server resumes the jobs. This process avoids running the same job on both servers simultaneously.

For more information about AR System and server groups, see the BMC Remedy AR System Documentation .

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