Manage retirement definitions for CMDB Data Manager

  • Release version: Xanadu
  • Updated August 1, 2024
  • 3 minutes to read

    • Use CMDB Workspace to create, delete, edit, or activate retirement definitions in your organization, for a class. Tables that are targeted in CMDB Data Manager life-cycle policies, must be associated with an active retirement definition. Target CIs in Retire policies, are set to match their associated class retirement definitions.

    Before you begin

    Role required: sn_cmdb_admin

    For information about retirement definitions used in CMDB Data Manager (Core UI), see Retirement definitions.

    About this task

    Some retirement definitions in the base system are inactive and you must activate any retirement definition that you want to use with a CMDB Data Manager life-cycle policy by setting its Active attribute to true. Retirement definitions are stored in the CMDB Retirement Custom Definitions [cmdb_retirement_custom_definitions] table.

    When a CMDB Data manager retires a CI, ensure that any of its dependent CIs are also retired and don't remain as orphan CIs, by enabling management of dependent CIs. Orphan CIs can impact the consistency, accuracy, and integrity of the CMDB.
    Note:
    • Always be aware of the automatic derivation of retirement definitions throughout the class hierarchy. For example, an active retirement definition for the Configuration Item [cmdb_ci] class can potentially be in effect throughout the entire CMDB hierarchy (aside from classes with their own retirement definition).
    • You can't deactivate (or delete) the retirement definition of the Configuration Item [cmdb_ci] class.
    • Each CMDB class can be associated with only a single retirement definition.
    • Regardless of where you manage retirement definitions, the definitions are used in both the Data Manager (Core UI) and Data Manager in CMDB Workspace.

    Procedure

    1. Navigate to Workspaces > CMDB Workspace and then select Management in the CMDB Workspace menu bar.
    2. Select the Data Manager link in Management tools, in the Manage section.
    3. In the Get started area on the Data Manager overview page, select Manage retirement definitions.
    4. On the Data Manager settings page, review the Retirement definitions list view.
      1. Optional: Drill down to a definition and then, on the Retirement definition form, toggle the Active switch to activate or deactivate a definition.
      2. Optional: Edit the conditions on the definition.
      3. Select Save definition.
    5. On the Data Manager settings page, select Add definition.
    6. Fill out the Retirement definition form and then select Save definition.
      Field Description
      Active Toggles the retirement definition between active and inactive.
      Table Table that the retirement definition applies to. The retirement definition will be derived by all child classes of the specified parent class.
      Condition builder Condition that reflects on what retirement means in the organization.

      Target CIs in Retire policies that belong to the specified table are set as specified in the retirement definition. You can, therefore, only use AND clauses in the definition. OR clauses aren't applicable.

    Delete a CMDB Data Manager retirement definition

    Delete a retirement definition that is no longer needed, in CMDB Workspace.

    Before you begin

    The following restrictions are in effect:
    • The retirement definition that you want to delete must be in an inactive mode (Active = false).
    • The retirement definition for the Configuration Item [cmdb_ci] class can't be deleted.

    Role required: sn_cmdb_admin, data_manager_admin

    About this task

    Procedure

    1. Navigate to Workspaces > CMDB Workspace and then select the Data Manager quick link on the Home view.
    2. In the Get started area on the Data Manager overview page, select Manage retirement definitions.
    3. On the Data Manager settings page, in the Retirement definitions tile select the retirement definition that you want to delete.
    4. On the Retirement definition page, select Delete definition.
    5. In the Delete retirement definition dialog box, select Delete.

    Result

    After the deletion, a retirement definition for the class is derived from a parent class.