This documentation supports the 21.05 (12.2) version of BMC Discovery.

To view an earlier version of the product, select the version from the Product version menu.

Preparing BMC Helix CMDB for synchronization

At the time of its release, integration of the current version of BMC Discovery was supported with the following versions of BMC Helix CMDB:

  • 21.02
  • 20.08
  • 20.02
  • 19.02, 19.08
  • 18.05, 18.08
  • 9.1.04 (Limited support)


For more information, see Product compatibility.

The BMC Discovery integration with ServiceNow CMDB is supported for all supported releases of ServiceNow CMDB.

Support for cloud discovery

A new class, BMC_CloudInstance is added in BMC Core 9.1.03: Service Pack 3 to support cloud discovery. To synchronize cloud nodes to the CMDB, you must have this service pack installed. Service Pack 3 also provides a REST API which you can use as an alternative access mechanism to use to connect to the CMDB.


Do not change the CMDB synchronization configuration at the same time as changing the cluster configuration.

  • Changing the CMDB sync configuration means, adding connections, removing connections, and starting or stopping a resync. 
  • Changing the cluster configuration means adding members, removing members, moving the coordinator, or changing fault tolerance.


Before you begin

Before you can synchronize data to a supported BMC Discovery version, you must complete the following required tasks in the given order:


BMC Discovery versions earlier than 7.6.04 are no longer supported and are not recommended for use. Synchronizing data to these earlier versions required you to complete some additional tasks. For more information, see the BMC Discovery 8.3 documentation.

  1. Create the BMC.ADDM dataset: The BMC.ADDM dataset must be manually created in the CMDB before a synchronization is attempted.
  2. Create the Job to merge the BMC.ADDM dataset with BMC.ASSET: After the BMC.ADDM dataset has been created, you must then create the job to reconcile it with the BMC.ASSET dataset.
  3. Check the BMC.ADDM dataset configuration: When using ITSM 7.0 with a backwards compatibility patch, you also need to ensure that the BMC.ADDM dataset is trusted.

After completing the preceding tasks, you can start synchronizing BMC Discovery data to BMC Helix CMDB.

Performance considerations

To obtain the maximum synchronization performance when using CMDB synchronization with BMC Discovery, you should consider tuning the database which BMC Discovery (or BMC Remedy AR System) is using. For more information, see the performance tuning documentation corresponding to your product version. The following information should be of particular interest:

  • Performance tuning and benchmarks Open link .
  • Tuning the AR System database server Open link .

To create the BMC.ADDM dataset

Creating a BMC.ADDM dataset provides a dataset into which BMC Discovery is exported before being taken into the BMC Helix CMDB. You create the dataset by using the BMC Helix CMDB Reconciliation console. It is recommended that you create the BMC.ADDM dataset on the primary AR System server.


The dataset you create is intended to receive data from only one BMC Discovery appliance. If your deployment architecture requires that several scanners or consolidators synchronize to the same CMDB, then you must create a separate dataset for each. For example, BMC.ADDM1, BMC.ADDM2, and associated reconciliation jobs.

Once created, do not make changes to any CMDB synchronization dataset.

You can create a dataset from one of two places in the console.

  1. From the Identify activity, click Add Dataset Identification Group Association,
    and then click Create Dataset.

  2. From the Mid Tier, open the Core Console > Applications > Reconciliation console, and then click Create Dataset.
    Complete the following fields:




    The name for the dataset. Usually set to BMC.ADDM.


    The system identifier for the dataset. This must match the ID used in the configuration in BMC Discovery. The default is BMC.ADDM.


    Set to Writable.


    Set to Regular.

  3. Click Save.

To create the Identification, Merge and Purge Job

BMC Discovery exports its data to a staging dataset in BMC Helix CMDB. The content of this dataset should then be reconciled into the BMC.ASSET dataset. To accomplish this, a new Job must be added in the BMC Helix CMDB Reconciliation Console. It is recommended that you create the Identification, Merge and Purge Job on the primary AR System server.

  1. From the Mid Tier, open BMC Helix CMDB Core Console > Applications > Reconciliation application.
  2. Select the Create Standard Identification and Merge Job icon.
  3. Give the job a meaningful name (for example, BMC ADDM - Identification, Merge and Purge).
  4. Set the Source Dataset to BMC.ADDM.
  5. After the job is Created, select BMC ADDM - Identification, Merge and Purge Job.
  6. Click the Edit Job icon.
  7. From the Job Editor window, in the Activities pane, select the New tab.
  8. In the New Activity pane, select Type as PurgeSequence as 700 and Name as BMC ADDM - Purge.
  9. In the Datasets option, select Datasets as BMC.ADDM.
  10. Click Done.
  11. Click Save in the Job Editor.


The recommended practice is to create a precedence group that specifies a precedence for the BMC.ADDM dataset. The value depends on your relative preference for data populated by BMC Discovery and other data providers to the CMDB. For more information about how precedence groups are configured, see the documentation on defining a precedence association set corresponding to your product version.

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