Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Tip

Role required: cmdb_manager, cmdb_admin, admin.

A CI relationship describes a connection between two configuration items by determining the attributes of their relationship. CI Relationships are represented with single-directional and bi-directional arrows connecting CIs on the Dependency Map. To open the dependency map view, click Image Removed next to the Source CI or the Recipient CI field.

You can determine an impact direction of CI relationships when specifying the Source CI and Recipient CI. According to the established relationship, if any of the source CIs degrades or becomes unavailable, the recipient CI is affected.

Tip

Role required: cmdb_manager.

Add a new CI relationship

To establish a new CI Relationship, complete the following steps:

  1. Navigate to the CMDB → CI Relationships.
  2. Click New and fill in the form.
  3. Click Save or Save and Exit exit to apply the changes.

CI Relationship form fields

State

Field

Mandatory

Description

Source CI

YSpecify a CI from the list to make a relationship outcoming from it.

Recipient CI

YSpecify a CI from the list to specify a relationship as incoming.

Bilateral Relation

NSelect the checkbox so both source and recipient CIs have impact on each other.

Operational State Transfer Type

N

Choose one of the possible values describing the type of operational impact:

An automatically calculated decimal number,
  • Conditional – the operational state of the Recipient CI is transferred by a few source CIs with relationship weights of the same values, in total equal to 1. If the number of the CI Relationships changes, their weights change weight changes, too.
  • Unconditional degradation or unavailability of the Source CI makes the Recipient CI unavailable under any conditions, regardless of the other circumstances. In this case, the Relationship Weight is equal to 1.

Relationship Weight

N
  • equal to
or less than
  • 1
. It defines a CI Relationship impact
  • .

Weight on Change

N

An automatically calculated decimal number, equal to or less than 1. It defines the CI Relationship actual weight depending on the Operational

state change. 

If the source CI is not available, the CI Relationship carries the 0 value within the Weight on Change field. If the source CI is degraded, the relationship transfers a half weight. Thus, the weight of conditional relationship or the sum weight of unconditional relationship provides the operational state of a recipient CI with the following value:

  • 0 – makes a recipient CI unavailable.
  • 1 – maintains CI availability.
  • from 0 to 1 – makes CI degraded.

As a result, a new CI Relationship record is created.

Service Dependency Map

Configuration item dependency map

The CI dependency map is Service Dependency Map is a service model represented by a hierarchical structure of the CIs with an IT Service service at the top and their current operational states as colored marks. All CIs are arranged by hierarchical levels that . Hierarchical levels are determined by the CI Typestypes.  Creating a new CI Type results in adding the next lower level of this model.CIs are presented as model elements with color-coded frames depending on their current Operational State values.

The following table shows the accordance between colors and states:

CI Frame ColorCI Operational StateGreenAvailableYellowDegradedRedUnavailable, Maintenance

Service Dependency Map CI dependency map visualizes CI Relationships with simple-directional or bi-directional arrows depending on an impact direction and with color-coded frames denoting the CI current operational state.

There are two ways to open Service Dependency Mapthe CI dependency map:

  • Click  next to the Source CI or the Recipient CI field on the CI Relationship form to see the hierarchical place of your CI on the service dependency map.
  • Navigate to CMDB → Service Model and in the URL https://instance.example.com/visual/dependency?sys_id=XXXXXXXXXXXXXXXXX&essence=sys_cmdb_ci&script=CIsubstitute the X's with the CI ID.
Creating CI Relationship

The following table shows the accordance between color-coded frames and CI states.

CI Frame ColorCI Operational State
GreenAvailable
YellowDegraded
RedUnavailable, Maintenance

Create a CI Relationship from Dependency Map


To add a new CI Relationship from the Dependency Map view, please follow the steps below:

  1. Right-click on the desired required CI and choose the click Create Relationship option in the context menu.
  2. Select one of the possible valuesoptions:
    • Incoming - to create an incoming connection to your CI
    • Outgoing - to  to create an outgoing connection from your CI.
  3. Fill in the form of a new CI Relationship .
  4. Click Save or Save and Exitexit to apply the changes.

Changing CI Operational State

Change the CI operational state from Dependency Map


To You can change the CI Relationship State right operational state from the Dependency Map view, complete the steps below:

  1. Right-click on the desired required CI and select click Change Operational State option to in the context menu.
  2. Choose Select one of the possible CI operational state values:
    • Available - a CI with this state value is marked with the green frame on the map view
    • Degraded - marks CI with yellow frame
    • Unavailable - marks CI with red frame
    • Maintenance - also marks CI with red frame, as CI is not available while in maintenance state.

Image Removed

The following toast message will appear: The operational status of the configuration item {name} is changed.

  1. states. For more information, see Configuration Management Database.
    Image Added

CI Position


The position of a configuration item on the Dependency Map is determined by a CI Position record. A CI position is assigned to a CMDB Class Type and is applied to all configuration items that belong to that type.

Create a CI Position

To create a new CI Position, complete the following steps:

  1. Navigate to CMDB → CI Types.
  2. From the list, select the CMDB Class Type the required CI belongs to.
  3. In the Related Lists area, select the CI Positions tab.

  4. Click New and fill in the fields.

  5. Click Save or Save and exit to apply the changes.

CI Position form fields

Field

Mandatory

Description

CI TypeNSpecify the CMDB Class Type this CI position is assigned to. This field is populated automatically if you opened the form via the CMDB Class Type related list.
OrderNSet the vertical position of the CI on the Dependency Map. The higher this value, the lower the CI is displayed on the Dependency Map.
IconN

Set the icon that represents the CI on the Dependency Map.

Available options:

book
Image Added
box-open
Image Added
database
Image Added
server
Image Added
sitemap
Image Added

If the field is empty, the CI is represented on the Dependency Map by an empty frame.

All CI positions are included in the CI Position (sys_cmdb_ci_position) table. Use this table to quickly customize the arrangement of configuration items by editing values in the Order columnTo create a new CMDB structure, refer to the Create a CMDB structure article.

Table of Contents
classfixedPosition