Properties related to remediation of duplicate CIs

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Properties related to remediation of duplicate CIs

    These properties allow ServiceNow administrators to configure how duplicate Configuration Items (CIs) are remediated when using the Duplicate CI Remediator or the De-duplication dashboard in CMDB Workspace. Proper configuration of these properties helps manage duplicate CI remediation tasks effectively, impacting performance, data handling, and remediation behavior.

    Show full answer Show less

    Key Properties and Their Practical Use

    • Maximum Field Length (glide.duplicateciremediator.max.fieldlength): Controls which CI attributes appear in remediation wizards based on their data length. Attributes exceeding this length (default 4000 characters) are excluded to optimize performance. Truncation occurs if data size surpasses this limit.
    • Related Items Blacklist (glide.duplicateciremediator.relateditemsblacklist): Specifies tables and reference columns excluded from merging during remediation. This prevents undesired updates to related records, maintaining data integrity.
    • Maximum Number of Duplicate CIs (glide.duplicateciremediator.max.cis): Sets a threshold for the number of duplicate CIs supported in reconciliation tasks (default 1000). Exceeding this limits reconciliation capabilities to maintain system performance. The maximum allowable setting is capped at 5000.
    • Dry Run Mode (glide.duplicateciremediator.dryrun): Enables testing of remediation without applying actual changes. When true, remediation tasks generate work notes describing intended changes, allowing safe validation before executing updates.
    • Restricted Mode (glide.duplicateciremediator.enablerestrictedmode): Activates a remediation mode that limits the use of related items, enabling blocked remediations to proceed safely. This is useful in scenarios where related item constraints interfere with remediation processes.

    Why This Matters

    Configuring these properties correctly helps ServiceNow customers optimize the performance and reliability of duplicate CI remediation processes. It provides control over data handling, system load, and remediation safety, ensuring that CMDB data remains accurate and consistent.

    What to Expect

    • Improved control over which CI attributes are considered during remediation, enhancing task efficiency.
    • Protection against unintended merges of related records through blacklist configuration.
    • Clear limits on task size to prevent performance degradation during large-scale duplicate remediation.
    • Ability to safely validate remediation actions through dry run mode before committing changes.
    • Option to enable restricted mode for remediations that would otherwise be blocked, increasing flexibility.

    Administrators can manage these properties under Configuration > CMDB Properties > Duplicate CI Remediator Properties, requiring admin role access.

    Use de-duplication properties to configure how remediation of duplicate CIs works when using the Duplicate CI Remediator or the De-duplication dashboard in CMDB Workspace.

    To view and edit these properties, the admin role is required.

    Although the properties below reference the Duplicate CI Remediator, these properties have an equivalent effect in duplicate CI remediation in CMDB Workspace.

    Property Description

    Attributes in which max_length exceeds this property value (4000 by default) are excluded from the Select Main CI, Merge Attribute Values, and Determine Duplicate CI Actions tabs in the Duplicate CI Remediator wizard.

    glide.duplicate_ci_remediator.max.field_length

    		 If the max_length for an attribute is equal to the property value, and the size of the data exceeds the property value, then the data is truncated to the property value and the attribute appears in attribute lists.
    • Type: integer
    • Default value: 4000
    • Location: Configuration > CMDB Properties > Duplicate CI Remediator Properties
    Note:
    This property impacts the performance of de-duplication tasks, therefore be cautious about setting this value.

    Comma separated list of related tables in the format '<table>.<reference column>', that are excluded from merging during duplicate CI remediation.

    glide.duplicate_ci_remediator.related_items_blacklist
    • Type: string
    • Default value: cert_task.cmdb_ci,cert_audit_result.configuration_item,discovery_log.cmdb_ci,alm_hardware.ci,alm_asset.ci,fm_expense_line.ci
    • Location: Configuration > CMDB Properties > Duplicate CI Remediator Properties

    Threshold for the number of duplicate CIs, which if exceeded, support for reconciliation in the Duplicate CI Remediator is limited (1,000 by default).

    glide.duplicate_ci_remediator.max.cis
    • Type: integer
    • Default value: 1000
    • Location: Configuration > CMDB Properties > Duplicate CI Remediator Properties
    • Learn more: See 'Large number of duplicate CIs' in Remediate a de-duplication task (legacy).
    This threshold never exceeds 5,000, even if you set the property to a value greater than 5,000.

    Determines whether the Duplicate CI Remediator actually remediates CI duplication by updating records in the CMDB, or not.

    glide.duplicate_ci_remediator.dry_run

    When set to false (default value), updates specified in the wizard are actually performed.

    You can set this property to true and then test run through the Duplicate CI Remediator without any records actually being updated. In this case, the work notes for the task describe the changes that will happen in an actual remediation.

    • Type: true | false
    • Default value: false
    • Location: Configuration > CMDB Properties > Duplicate CI Remediator Properties
    glide.duplicate_ci_remediator.enable_restricted_mode

    Enables restricted mode remediation in the Duplicate CI Remediator. This option restricts the use of related items in de-duplication remediation and allows a blocked remediation to proceed using the Use the Duplicate CI Remediator (Restricted Mode) option. For more information, see Using restricted mode within the Duplicate CI Remediator [KB1542272].

    Set to true to enable restricted mode remediation.