Retirement definitions

  • Release version: Australia
  • Updated March 12, 2026
  • 3 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 Retirement Definitions

    Retirement definitions establish protocols for managing the life cycle of Configuration Items (CIs) within the CMDB. These definitions are crucial for transitioning CIs through various life cycle stages in accordance with CMDB Data Manager policies, particularly for retiring, archiving, or deleting CIs based on their class attributes.

    Show full answer Show less

    Key Features

    • Each targeted class must have an active retirement definition for implementing Retire, Archive, or Delete policies.
    • Retirement definitions help identify CIs ready for archiving or deletion by verifying their retired status.
    • Definitions are derived through the CMDB hierarchy, allowing child classes to inherit retirement definitions from parent classes unless explicitly defined at the child level.
    • Predefined retirement definitions are available for key classes, such as Hardware and Application, and can be customized to meet organizational needs.

    Key Outcomes

    By utilizing retirement definitions, ServiceNow customers can efficiently manage the status of CIs throughout their life cycle. This results in enhanced compliance with organizational policies, streamlined processes for retiring, archiving, and deleting CIs, and improved clarity in CI management. Customers can activate or customize retirement definitions to suit their operational practices, ensuring each class of CIs is correctly managed according to its specific needs.

    Specify a retirement definition for a class, to reflect protocols in your organization applicable to the class and to its child classes. These definitions support the transition of CIs through life cycle stages as implemented by CMDB Data Manager life-cycle policies. A class can have a retirement definition by derivation, or by a retirement definition specified for that class.

    CMDB Data Manager requirement and usage

    An active retirement definition is required for each targeted class in a Retire, Archive, or Delete CMDB Data Manager policy. A retirement definition is used to flag a CI as retired according to the CI’s class retirement definition in effect. When retiring a CI, the CI's attributes are set according to the retirement definition for the CI's class. A subsequent operation such as delete or archive, that needs to be applied to retired CIs, first checks if a CI is in a retired state by verifying that it satisfies the retirement definition for its class.

    Retirement definitions are used in life-cycle policies as follows:
    • Setting target CIs in Retire policies, according to their associated class retirement definitions.
    • Filtering out target CIs In Retire policies, that are determined to already be in a retired state according to their associated retirement definitions. Those CIs aren’t targeted even if they meet the policy filter.
    • Identifying CIs as being ready to be processed by an Archive or Delete policies. Archive and Delete policies can only process CIs that are in a retired state that matches their associated class retirement definition. Therefore, target CIs in Archive and Delete policies, are checked against their associated class retirement definition to verify that they are in a retired state before they can be archived or deleted.

    Derivation across the CMDB hierarchy

    Retirement definitions are derived throughout the CMDB hierarchy in the same way that rules, such as identification rules, are derived. Child classes extended from a parent class with a retirement definition, derive that definition unless there’s a retirement definition defined at the child class level.

    When retirement definitions for classes exist in different levels in the class hierarchy, then the retirement definition that applies is the one that is most specific for a class. For example, if there are retirement definitions for both, the Computer and the Configuration Item class, then the Computer class definition also applies to its descendant classes. All other classes that aren't descendants of the Computer class, use the Configuration Item retirement definition.

    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).

    Predefined retirement definitions

    The base system includes predefined retirement definitions for key classes such as Hardware [cmdb_ci_hardware] and Application [cmdb_ci_appl], and are stored in the CMDB Retirement Custom Definitions [cmdb_retirement_custom_definitions] table. For example, the predefined retirement definition for the Service [cmdb_ci_service] class specifies that for a retired CI, the value of the attributes [operational status], [Phase], and [Status] is Retired.

    Retirement definition for the Configuration item [cmdb_ci] class behaves in the following important ways:
    • It is active by default and you can't deactivate it.
    • You can't delete it.
    • By default, it is in effect throughout the entire CMDB hierarchy due to derivation.

    The rest of the predefined retirement definitions are inactive by default, and you must activate a retirement definition that corresponds to a targeted class in a Retire, Archive, or Delete CMDB Data Manager policy.

    You can use the default retirement definitions, or customize a definition to reflect practices in your organization. You can also add a custom retirement definition for a class. However, each CMDB class can be associated with only a single retirement definition.

    To manage or delete a retirement definition, see Manage retirement definitions.