Default language.

Important This documentation space contains information about the SaaS version of BMC Helix Discovery. If you are using the on-premises version of BMC Helix Discovery, see BMC Helix Discovery 25.2 (On-Premises).

Managing a CMDB sync connection

You can perform additional configuration and management tasks on individual CMDB sync connections. You can accomplish these from the Manage CMDB Connection page.

Related topics

Best-practices-for-avoiding-CMDB-sync-performance-issues

Configuring-CMDB-Sync-blackout-windows

Filtering-nodes-and-CI-types-for-CMDB-Sync

Resynchronizing-a-CMDB-connection

To overview individual CMDB sync connections

  1. Log in to BMC Helix Discovery.
  2. From the main menu, click the Administration admin_icon.png icon.
    The Administration page displays.
  3. From the Model section, click CMDB Sync. 
  4. Click the name of a CMDB sync connection.

The following image shows details of an individual CMDB sync connection:

Manage a CMDB connection.png


The Manage CMDB Connection page is displayed showing the status tab. The other tabs are introduced below:

Tab

Description

Details

Provides an editable form where you can edit the details used when the connection was created. For information on the details you can edit, see setting up the CMDB synchronization connection.

Filtering

Provides a two stage filter which enables you to first filter the root nodes, using the BMC Helix Discovery model, to sync to the CMDB and then perform a second filter on the CIs in the generated model. This page has two sub pages accessed using the following buttons:

  • BMC Helix Discovery – Enables you to select the BMC Helix Discovery root device nodes used to create the model to synchronize to the CMDB. All device nodes are synchronized unless a filter is applied. You can create a filter for each root node kind, which may be:
    • All
    • None
    • Matching a condition created using a three column selector
  • CMDB – All device nodes matching the BMC Helix Discovery filter are synchronized to the CMDB. The CMDB filter enables you to add a second level of filtering on the data once it has been transformed into the Common Data Model. You can create a filter on each CI type, which may be:
    • All
    • None
    • Matching a condition created using a three column selector

You can check which root nodes will be allowed through the filter specified on the BMC Helix Discovery filter page, by following the link at the bottom of that page labelled "Click here to see the current candidate set". After selecting node(s) from the list that appears, and clicking the CMDB Sync Preview button above the list, a Software Context view of CIs corresponding to those nodes can be displayed, together with highlighting of any CIs filtered by the settings on the CMDB filter page. The highlighting distinguishes explicitly filtered CIs from those that are implicitly filtered (only connected to the model by explicitly filtered nodes).

Blackout Windows

CMDB synchronization can occur at any time by default. To prevent CMDB access for a connection during sensitive times, you can configure blackout windows. During a blackout window, all processing of the CMDB synchronization queue for that connection is paused. New nodes can still be scheduled for synchronization, by continuous or manual synchronization, but no processing occurs until the blackout window ends.

For more information on blackout windows, see Configuring-CMDB-Sync-blackout-windows.

Resync

Occasionally, the model stored in the CMDB dataset becomes out of step with the shadow copy for a CMDB connection and require resynchronization. For example, if CMDB tools have been used to modify the dataset. In this case, when updates are written to non-existent nodes, instance errors are raised. When BMC Helix Discovery registers these instance errors, a resynchronization is recommended. In other cases, such as after upgrading from version 10.1, or the creation of a new CMDB sync connection, a resynchronization is mandatory, and CMDB sync is disabled until the resynchronization is complete.

For more information on resyncing a connection, see Resynchronizing-a-CMDB-connection.

Status

Shows a detailed status of the CMDB sync connection.

  • Server
    • CMDB Version
    • AR Server Version
    • Connection Test Response Time
  • Export Queue
    • Devices in Queue
    • Currently Processing Devices
    • Queue Status
  • CMDB Synchronization
    • Device Nodes Inserted
    • Device Nodes Updated
    • Device Nodes Deleted
    • Total Errors
    • Most Recent Synchronized Devices
    • Most Recent Error Messages
    • Reports
      • Devices that Failed Last CMDB Sync
      • Devices that Succeeded Last CMDB Sync
      • CIs awaiting incremental resync—a link to this report is only displayed when an incremental resync has been run. 

To manage individual CMDB sync connections

From the Actions list, select an actions on the connection:

  • Delete Sync
  • Enable or Disable Continuous Sync
  • Pause or Resume Sync
  • Disable or Enable Sync
  • Reset Counters — Resets the count of devices inserted, updated, or deleted and errors reported for that synchronization target. The counts are displayed on the Status tab.

The following image shows actions for a CMDB sync connection:

Actions.png

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*