Properties related to remediation of duplicate CIs

  • Release version: Xanadu
  • Updated August 1, 2024
  • 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 and control how duplicate Configuration Items (CIs) are remediated using the Duplicate CI Remediator or the De-duplication dashboard in CMDB Workspace. Proper configuration helps optimize performance, control scope, and enable safe testing of remediation processes.

    Show full answer Show less

    Key Properties and Their Practical Use

    • glide.duplicateciremediator.max.fieldlength: Sets the maximum attribute length (default 4000 characters) for attributes considered in remediation actions. Attributes exceeding this length are excluded to improve performance. Data exceeding this length is truncated. Adjust this with caution as it impacts de-duplication task performance.
    • glide.duplicateciremediator.relateditemsblacklist: Defines a comma-separated list of related tables and reference columns excluded from merging during remediation. This prevents unintended merges of related records that could affect data integrity.
    • glide.duplicateciremediator.max.cis: Sets a threshold (default 1000, max 5000) for the maximum number of duplicate CIs supported in reconciliation. Exceeding this limit restricts remediation support to maintain system performance.
    • glide.duplicateciremediator.dryrun: When set to true, allows testing remediation workflows without updating records, producing work notes that describe intended changes. Default is false, where updates are applied during remediation.
    • glide.duplicateciremediator.enablerestrictedmode: Enables restricted mode remediation, limiting the use of related items during de-duplication. This mode allows blocked remediations to proceed using a restricted workflow, improving control in complex scenarios.

    Practical Benefits

    • Helps administrators balance thoroughness and performance by controlling attribute size and merge scope.
    • Protects data integrity by excluding sensitive or critical related records from merges.
    • Supports testing remediation changes safely before actual updates, reducing risk.
    • Provides options to handle large volumes of duplicates without overwhelming system resources.
    • Offers a restricted mode for flexible remediation in complex or sensitive environments.

    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.