Properties for Identification and Reconciliation

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 9 minutes to read

    • Use the Identification and Reconciliation properties to configure the identification and reconciliation engine (IRE).

    These properties are available for Identification and Reconciliation. To view and edit these properties, the admin role is required.
    Note:
    To open the System Properties [sys_properties] table, enter sys_properties.list in the navigation filter.
    Table 1. Properties for Identification and Reconciliation
    Property Description

    Enforce the requirement that required attributes cannot be null during identification and reconciliation.

    glide.required.attribute.enabled
    • Type: true | false
    • Default value: true
    • Location: Configuration > CMDB Properties > Identification/Reconciliation Properties

    Allow class upgrade during IRE identification and reconciliation.

    glide.class.upgrade.enabled

    When false, IRE rejects a payload (or a payload item in Enhanced IRE) with the respective reclassification update, and creates a reclassification task.

    Allow class downgrades during IRE identification and reconciliation.

    glide.class.downgrade.enabled

    When false, IRE rejects a payload (or a payload item in Enhanced IRE) with the respective reclassification update, and creates a reclassification task.

    Allow class switching during IRE identification and reconciliation.

    glide.class.switch.enabled

    When false, IRE rejects a payload (or a payload item in Enhanced IRE) with the respective reclassification update, and creates a reclassification task.

    glide.identification_engine.update_without_upgrade_enabled

    Enable IRE to process CI updates with upgrade reclassification updates. This property takes precedence over the glide.class.upgrade.enabled property.

    Depending on the property setting, IRE processes or skips the upgrade update:
    • true: IRE processes the CI updates but doesn't process the CI upgrade reclassification update.
    • false: IRE processes the CI updates including the CI upgrade reclassification update.

    glide.identification_engine.update_without_downgrade_enabled

    Enable IRE to process CI updates with downgrade reclassification updates. This property takes precedence over the glide.class.downgrade.enabled property.

    Depending on the property setting, IRE processes or skips the downgrade update:
    • true: IRE processes the CI updates, but doesn't process the CI downgrade reclassification update.
    • false: IRE processes the CI updates including the CI downgrade reclassification update.

    glide.identification_engine.update_without_switch_enabled

    Enable IRE to process CI updates with switch reclassification updates. This property takes precedence over the glide.class.switch.enabled property.

    Depending on the property setting, IRE processes or skips the switch update:
    • true: IRE processes the CI updates, but doesn't process the CI switch reclassification update.
    • false: IRE processes the CI updates including the CI switch reclassification update.

    glide.identification_engine.reclassification_restriction_rules_enabled

    Globally enable or disable the application of active reclassification restriction rules.

    Allow the update of an empty field by a lower priority data source.

    glide.reconciliation.override.null
    • Type: true | false
    • Default value: true
    • Location: Configuration > CMDB Properties > Identification/Reconciliation Properties

    Controls how identification processes a small set of duplicate CIs.

    glide.identification_engine.skip_duplicates
    • Type: true | false
    • Default value: true
    • Other values:
      true

      If the number of duplicate CIs is less than the threshold specified by glide.identification_engine.skip_duplicates.threshold, then the oldest of the duplicate CIs is picked as a match and gets updated. That oldest CI is also designated as the main CI for that set of duplicate CIs.

      For the rest of the duplicate CIs, the duplicate_of field is set as a reference to the main CI.

      false
      Matching a CI fails, and an error is logged.
    • Location: Configuration > CMDB Properties > Identification/Reconciliation Properties

    Maximum number of CIs that can be in a set of duplicate CIs to allow identification to process the duplicate CIs according to the setting of glide.identification_engine.skip_duplicates.

    glide.identification_engine.skip_duplicates.threshold

    If the number of duplicate CIs exceeds the threshold, then identification processes the duplicate CIs as if glide.identification_engine.skip_duplicates is set to false.

    • Type: integer
    • Default value: 5
    • Location: Configuration > CMDB Properties > Identification/Reconciliation Properties

    Maximum number of log runs that can be displayed when navigating to Configuration > Identification Logs.

    glide.identification_logs.max_run_ids
    • Type: integer
    • Default value: 1000
    • Location: Configuration > CMDB Properties > Identification/Reconciliation Properties

    glide.cache.size.service_cache

    		 Maximum cache size (in MB) that is used by the identification engine for inbound and outbound relations. When the limit is reached, the least recently used cached data is discarded, releasing space for new data.
    Note:
    You cannot disable the service cache.
    glide.identification_engine.granular_insert_locking Determines whether to use multiple granular insert locks or single global insert lock.

    Set to false if there are performance issues associated with the usage of multiple granular insert locks.
    glide.identification_engine.batch_update_last_discovered Controls batch update of last_discovered field in CIs that are being processed by the identification engine.

    Set to false if there are business rules that apply to the last_discovered field, and you want to trigger these rules when calling an Identification and Reconciliation API.
    glide.identification_engine.related_items_local_cache_count

    For optimization, a custom number of locally cached query result entries of related/lookup items.

    Note:
    If there is a memory issue due to optimization related to using local cache, set the glide.identification_engine.related_items_local_cache_count and the glide.identification_engine.dependent_items_local_cache_count properties to 0.
    glide.identification_engine.dependent_items_local_cache_count

    For optimization, a custom number of locally cached query result entries of dependent CIs.

    Note:
    If there is a memory issue due to optimization related to using local cache, set the glide.identification_engine.related_items_local_cache_count and the glide.identification_engine.dependent_items_local_cache_count properties to 0.
    glide.identification_engine.independent_items_local_cache_count

    For optimization, a custom number of locally cached query result entries of independent CIs.

    Setting the value to 0 avoids using local cache for independent CIs which might affect performance.
    glide.cmdb.logger.source.identification_engine

    Enable and configure what type of details the system logs when using IRE outside the scope of identification simulation. For example, when using an API, ECC queue or scheduled jobs.

    Note:
    Depending on the setting, the system can generate large amounts of data that might affect overall system performance. Set the value with caution, and limit the level of details and use time to the minimum necessary for testing or debugging.

    For more troubleshooting information, see the How to capture IRE [identification and reconciliation engine] debug logs [KB0750382] knowledge base article.
    glide.identification_engine.partial_payload_items_max_size

    Maximum number of items allowed when creating a partial payload. When that limit is reached, the partial payload is split.

    For example, when IRE creates a partial payload, items and associated relations and references, are all merged in one partial payload. This merge could result in a large partial payload.

    Adjusting this property can help with performance issues related to IRE processing of partial items.
    glide.identification_engine.partial_items_process_limit

    Maximum number of partial items to be fetched in a single IRE call. After reaching this limit, IRE fetches only partial items corresponding to complete items in the input payload.

    Adjusting the value can help with performance issues related to IRE processing of partial items.
    glide.identification_engine.partial_items_process_absolute_limit

    Absolute limit of the number of partial items for IRE to fetch, after which, IRE stops fetching partial payloads from the CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] table. Adjusting the value can help with performance issues related to IRE processing of partial items.
    glide.identification_engine.skip_updating_source_last_discovered_if_older
    Determines how IRE updates the last_discovered and the discovery_source attributes in the CMDB.
    • true: If last_discovered is provided in the payload and it is older than the last_discovered of the CI in the CMDB, IRE does not use the payload values to update the last_discovered and the discovery_source attributes in the CMDB.
    • false: Even if the last_discovered provided in the payload is older than the last_discovered of the CI in the CMDB, IRE uses the payload values to update the last_discovered and the discovery_source attributes in the CMDB.
    Note:
    Only the attributes mentioned above are affected by this property in an update operation.
    glide.identification_engine.ire_message_listener_skip_updating_source_last_discovered_to_now

    If Robust Transform Engine (RTE) does not pass the ire.skip_updating_last_scan_to_now custom property on the Robust Import Set Transformer form, IRE uses the value of this property for the skip_updating_source_last_discovered_to_now IRE option.
    glide.identification_engine.skip_updating_last_scan_if_older
    Determines how IRE uses the source_recency_timestamp value in a payload to determine whether to update the last_scan attribute in the Source [sys_object_source] table.
    • true: If source_recency_timestamp is provided in the payload and it is older than the last_scan of the CI in the CMDB, IRE does not update the last_scan attribute in the Source [sys_object_source] table.
    • false: Even if the source_recency_timestamp provided in the payload is older than the last_scan of the CI in the CMDB, IRE uses the payload value to update the last_scan attribute in the Source [sys_object_source] table.

    You can check the input payload for a CI and the last_scan attribute value in the Source [sys_object_source] table to learn if IRE will update that last_scan value or not.

    Note:
    Only the attributes mentioned above are affected by this property in an update operation.
    glide.identification_engine.ire_message_listener_skip_updating_last_scan_to_now

    If RTE does not pass the ire.skip_updating_last_scan_to_now custom property on the Robust Import Set Transformer form, IRE uses the value of this property for the ire.skip_updating_last_scan_to_now IRE option.
    glide.identification_engine.platform_domain_separation_enabled
    Toggles domain separation support mode during IRE processing.
    • false: IRE processes run only within the current domain. Basically disabling parent domains access to child domains during IRE processing.
    • true: IRE domain separation follows the platform domain separation behavior. Basically, enabling parent domains to look access into all its child domains during IRE processing.
    glide.identification_engine.enable_identifier_optional_condition
    Enables advanced options for regular identifier entries in identification rules. Those advanced options let you add conditions to narrow the set of records that will be searched for a matching CI.
    Note:

    This property affects only regular identifier entries (it doesn't affect lookup or hybrid identifier entries).

    In the base system, identifier entries of various classes are pre-configured with advanced options conditions. All these pre-configured conditions in regular identifier entries will automatically apply when you set this property to true.

    To prevent unexpected behavior, review those predefined conditions in regular identifier entries before setting this property to true. In the Filter box in the primary navigation, enter cmdb_identifier_entry.list. Then, in the Identifier Entry list view, review the 'Optional condition' column.
    glide.identification_engine.enable_reconciliation_filter_before_update

    Determines whether filter conditions of a reconciliation rule are applied before a value change during payload processing, or after.