How to Work with Reconciliation Analyzer

  • KM03788055
  • 01-Mar-2021
  • 01-Mar-2021

Summary

This document shows How to Work with Reconciliation Analyzer on Universal CMDB 2020.11

Question

Note

  • Minimum permissions required for users who want to access Reconciliation Analyzer:

    • System Administrator Privileges role or higher
    • Discovery and Integrations Admin role or higher
  • The amount of memory (RAM) necessary for Reconciliation Analyzer to work properly is as follows:

    • Minimum: 16 GB
    • Recommended: 24 GB

Answer

Reconciliation is the process of identifying and matching entities from different data repositories (for example, UCMDB Universal Discovery, ticketing, or BSM). This process is designed to avoid duplicate CIs in UCMDB. For detailed information about the reconciliation process, see Reconciliation.

The Reconciliation Analyzer helps you understand how the reconciliation process works. By using this option, you can find what happened with a CI that may have merged with another CI. You can view the following information:

  • All the changes made to the searched CI (create, update, or remove CI)
  • The reasons why the CI was changed. This includes a list of identification candidates, and the reasons for matching the searched CI with them

The changes are listed in chronological order, grouped by reconciliation Operations. The most recent operation is displayed on top of the page. You can view the following information for each reconciliation operation:

  • The type of operation performed: created, modified, or removed
  • The date and time when the operation was performed
  • A list of changed attributes. For each changed attribute you can view the attribute name, the previous value of the CI attribute (before the change), and its new value.

Note
Reconciliation Analyzer displays only the changes that are performed after the Reconciliation option is enabled. For detailed information about how to enable the Reconciliation option, see Enable the Reconciliation option.

If some reconciliation operations are performed and the CI is not changed, then those operations will not be displayed the Reconciliation Analyzer module.

Enable the Reconciliation option

The Reconciliation option is hidden by default. To enable or to disable the Reconciliation option, follow these steps:

From JMX Console:

  1. On UCMDB server, go to JMX Console > UCMDB:service=Settings Services > setGlobalSettingValue.

  2. In the name field, enter cmdb.recon.analyzer.enabled.
  3. In the value field, enter:

    • true: if you want to enable the Reconciliation option
    • false: if you want to disable the Reconciliation option

  4. Click Invoke.
  5. Restart the UCMDB server.

From UCMDB UI:

  1. On UCMDB UI, go to Administration > Infrastructure Settings Manager.
  2. Locate the Reconciliation Analyzer setting.
  3. Set the value to True to enable Reconciliation Analyzer, False to disable Reconciliation Analyzer.
  4. Save the change.
  5. Restart the UCMDB server.

View the list of operations that were applied to a CI

To view the list of operations that were applied to a CI, follow these steps:

  1. In the Top Search Bar, select Reconciliation from the drop-down list of available options.

  2. Type a text string in the search field, and then select the desired CI from the suggestions list.

    Note

    • The search can be performed only by Name or UCMDB ID.
    • The suggestions list is limited to 10 items.

The Reconciliation Analyzer module opens, and all the changes made to the CI are displayed.

Display more information about a reconciliation operation

To view more information about a certain operation that was done for a CI, follow these steps:

  1. In the Top Search Bar, select Reconciliation from the drop-down list of available options.

  2. Type a text string in the search field, and then select the desired CI from the suggestions list.

  3. Click the desired operation to display more information about it. The following details are displayed:

    • Changer. The source of the incoming data
    • Operation ID.The operation ID. This can be used further to investigate the logs for more details.
    • Customer ID. The customer ID
    • Details. Allows you to view the list of identification candidates, and the reasons for matching the searched CI with them

View the list of identification candidates, and the reasons for matching the searched CI with them

To view the list of identification candidates, and the reasons for matching the searched CI with them, follow these steps:

  1. In the Top Search Bar, select Reconciliation from the drop-down list of available options.

  2. Type a text string in the search field, and then select the desired CI from the suggestions list.

  3. Click the desired operation, and then click the Details button.
  4. Click a CI in the Identification candidates column. More details about the CI are displayed, and in the Match reason column you can view why the CIs were matched.

Tip
To go back to the list of operation, use the web browser's back button.

Remove old data of CIs from SOLR

Once you have enabled Reconciliation Analyzer, the scheduled job Clear Recon Analyzer index runs every 15 days by default to remove the old data of CIs from Solr. To reschedule the job, you can go to UCMDB UI > Administration > Scheduler, locate the job and reschedule it.

You can also configure how many days the documents from the Reconciliation Analyzer are kept. To do so, do either of the following:

From UCMDB UI:

  1. Go to Administration > Infrastructure Settings Manager.
  2. Locate the Remove old documents from Reconciliation Analyzer setting.
  3. In the Value field, type the desired days.
  4. Save the change.

    The change takes effect immediately.

From JMX Console:

  1. On UCMDB server, go to JMX Console > UCMDB:service=Settings Services > setGlobalSettingValue.

  2. In the name field, enter cmdb.recon.analyzer.keep.index.days.
  3. In the value field, enter the desired days. (Default: 15)

  4. Click Invoke