Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

CI relationships in the CMDB

The CMDB, in contrast to a static asset list, helps you track not only the configuration items (CIs) within your system, but also the relationships between those items.

A relationship in the CMDB consists of two CIs and a relationship type:

  • Parent CI
  • Child CI
  • Type of the relationship that links both CIs

For example, in the [Server1] [Managed by] [Server2] relationship:

  • Server1 is the child CI
  • Server2 is the parent CI
  • [Managed by] is the relationship type

For example, a web application might read data from an instance of Oracle, which in turn might depend on a piece of underlying hardware. Most CIs in a CMDB have multiple relationships to other CIs, users, and groups.

The relationships between CIs can be automatically discovered. If you use Discovery, many relationships can be automatically loaded into the system through the discovery process. If you import your data from another system, you get some form of relationships.

You can add to automatically discovered relationships, create relationships, or edit relationships for a CI by launching the CI relationship editor from the CI form. As an alternative to the CI relationship editor, Unified Map in the CMDB Workspace store app provides the latest functionality for editing CI relationships. For more information, see Edit relationships in Unified Map.

Dependent and non-dependent relationships

Dependent relationships, such as tomcat RunsOn Hardware, are used by the Identification and Reconciliation Engine (IRE) to identify dependent CIs. The IRE avoids duplicate entries of CIs into your Configuration Management Database (CMDB) by leveraging these relationships to determine if a recently discovered CI is already in the CMDB.

For non-dependent relationships, the CMDB tracks the discovery source and the last scanned time in the Relationship Sources [sys_rel_source] table. Non-dependent relationships aren't used for CI identification, and can be deleted when no longer needed.

To avoid burdening your IRE with excessive load, by default, the Relationship Sources [sys_rel_source] table doesn't auto-populate. If you want to track full information on non-dependent relationships, you can change the default using the glide.identification_engine.populate_sys_rel_source property.

Dependent relationships are used for CI identification, so they shouldn't be directly deleted as they aren't tracked.

Information in the Relationship Sources [sys_rel_source] table can be used to decide if it’s safe to delete a potentially non-dependent relationship. For example, a discovery source, which is attempting to delete a non-dependent relationship can confirm that:

  • There are no other data sources for that relationship.
  • The relationship wasn't updated for some specified length of time and therefore is no longer needed.

When a non-dependent relationship is deleted from the CI Relationship [cmdb_rel_ci] table, all cascading corresponding records in the Relationship Sources [sys_rel_source] table are deleted.

Key relationships

The following table contains descriptions for some key CMDB relationships.

ParentChildDescription
Applicative Flow ToApplicative Flow From

Connections between endpoint CIs.

Note: For internal use only (service model).

Connects toConnected byNetwork Connections between elements that are talking to each other. Examples: Workstation to switch, switch to switch, kubernetes workload to service.
ContainsContained byTypically a containment relationship \(CI to contained CI\). The child CI typically has a single parent CI with this relationship type. Examples: Tomcat to Tomcat WAR, VMware Datacenter contains Network.
Defines resources forGets resources fromParent CI defines/gets resources from a child CI. Example: VMware - Resource pool gets resources from ESX Server.
Depends onUsed byParent CI depends on child CI. Meaning that problem/change in the child CI may impact the parent CI.
Hosted onHostsHosting relationship between an element and its host. Examples: Cloud resource to logical data center, k8s workload to k8s cluster.
Implement End Point ToImplement End Point From

Endpoint to CI that exposes this endpoint.

Note: For internal use only (service model).

ManagesManaged byTypically used where one CI manages one or more other CIs. Example: vCenter manages vCenter Datacenter.
MembersMember ofTypically used with clusters where a cluster node is a member of a cluster. Example: ESXi Server is a member of vCenter Cluster.
OwnsOwned byUsually a containment relationship \(CI to owned CI\). The child CI typically has a single parent with this relationship type.
Runs onRunsTypically between a CI that represents a software application, to the hosting hardware/VM. Example: Tomcat 'Runs on' Linux server.
Use End Point ToUse End Point From

From the CI to an outgoing endpoint.

Note: For internal use only (service model).

  • Suggested class relationships
    The system keeps a table (Suggested Relationship [cmdb_rel_type_suggest]) of relationship types that are appropriate for a CI type, based on its class. You can manage suggested relationships by navigating to Configuration > Suggested Relationships, or in the CI Class Manager.
  • Add a suggested relationship
    Add a suggested relationship for a class. The list of suggested relationships for a class is available when you create a new relationship for a CI of that class.
  • Relationship governance rules
    Relationship governance rules is a set of relationship rules used to ensure consistency and validity in modeling relationships between configuration items (CIs) in the CMDB. Use relationship governance rules to prevent the selection of relationship types or directions that are not allowed between specific CI types.
  • CI relations formatter
    The default CI form includes a CI relations formatter from which you can examine a CI and its relationships in various views. From the CI relations formatter, you can also launch the CI relationship editor for the CI.
  • CI relationship editor
    Use the relationship editor to view, create, modify, or delete CI relationships. Open the relationship editor from the CI Relations formatter.
  • Relation qualifier
    A relation qualifier, which is a CI of the Qualifier [cmdb_ci_qualifier] type, stores important information about the CI relationships.
  • CI relationship security
    When applying security to CI relationships, it is important to apply the access controls both to the CI Relationship (cmdb_rel_ci) table and to create an operation editCIRelations to the * table as well.
  • Create a CI relation rollup
    A CI relation rollup allows you to sum, count, max, min, or mean a relationship type. You can create CI relation rollups.

Parent Topic:Configuration Management Database (CMDB)

Related topics

Create a CI relation rollup