Enabling CSDM life-cycle sync between asset and CI to support product instance
-
- UpdatedJan 30, 2025
- 8 minutes to read
- Yokohama
- Common Service Data Model
You can align life-cycle values for each product instance on the asset, CI, and IBI tables. A one-time process moves legacy status values for asset and CI across the platform to standard CSDM life-cycle value pairs (life cycle stage and life cycle stage status). Business rules then run regularly to ensure identical IBI, asset, and CI life-cycle data for each product instance.
- Detailed instructions for running the align-and-sync process appears in Activate align and sync for CSDM life-cycle values.
- A detailed reference to all sync options appears in How life-cycle values for Asset, CI, and IBI are synced.
Why enable CSDM life-cycle sync between CI and asset entities
When the one-time data sync operation finishes, CSDM life-cycle values for each product instance as represented in the asset and CI tables will be identical. Business rules then sync life-cycle value pairs among the asset, CI, and IBI tables. The business rules then run on regular schedules to ensure that life-cycle values for the asset, CI, and IBI tables remain aligned.
See How life-cycle values for Asset, CI, and IBI are synced.
The following products, for example, benefit from the standardized values:
- To handle alerts appropriately, the Event Management and Operational Intelligence features need to know whether a CI is in the maintenance life cycle stage status.
- To report cost data effectively, the Cloud Cost Management feature needs to know the CSDM life-cycle values of a CI.
- To generate consistent tasks and workflows, the Audit Management and Compliance features need to use standard CSDM life-cycle values.
How the mapping between legacy status values and CSDM CSDM life-cycle values is specified
A life-cycle value pair is the combination life cycle stage and life cycle stage status values for a CI, asset, or IBI over the life cycle of a product instance. The base system includes the life-cycle mapping [life_cycle_mapping] table that holds mapping rules. The default rules specify how to align common legacy status values to a CSDM life-cycle value pair. You can update and add rules as needed. (The table is described more fully in Life cycle mapping table.)
Alignment/sync process
To start the align and sync process, you select Enable life cycle sync on the Life cycle mapping table list page. That action sets the
csdm.lifecycle.sync.between.ci.and.asset.activated system property to true
and starts the following activities:
Phase 1: Run the discrepancy check and correct all mappings
- The system runs the discrepancy check
-
The discrepancy check script checks all mapping rules:
- Verify CSDM life-cycle mapping rules for asset tables.
- Verify CSDM life-cycle mapping rules for CMDB CI tables.
- Verify legacy asset-to-CI mapping rules that appear in the alm_hardware_state_mapping and alm_asset_ci_state_mapping tables.Note: For each CI that is not associated with an asset (non-asset CI), use CSDM mapping tables to derive the life-cycle value pair for the CI from the legacy status.
The script generates a discrepancy report. The report displays the list of missing or inactive mappings that you need to repair before you can perform bulk alignment of life-cycle values.- Legacy status values that aren't yet mapped to life-cycle value pairs.
- Legacy status values that aren't included in a mapping rule or that are included in an inactive rule.
- Custom legacy status values. For each custom value, the system adds a record to the life_cycle_mapping table. Those mapping records, however, are inactive because some required field values are not yet set. You will edit and activate those records so all custom legacy status values will be aligned.
- After the one-time alignment, legacy status values between CI and asset will be auto-synced. The report therefore identifies hardware statuses or install statuses that are not present or that are included in an inactive mapping rule between asset and CI.
- Manual process: If there are mapping errors, add or update mappings
- Add missing mapping rules and ensure that current rules are correct and active. The buttons open mapping tables where you can update mapping rules. Instructions for updating individual rules appear in Map legacy status values to CSDM life-cycle values.
- Run the discrepancy check again
- Run the discrepancy check and fix errors until all errors are fixed.
Phase 2: Automated bulk alignment: Align all legacy CMDB CI and asset data to CSDM life-cycle value pairs
When all mapping errors are fixed, a scheduled job in the batch process performs one-time-only bulk alignment to life cycle stage and life cycle stage status life-cycle value pairs.
- Step 1: For all assets that do not have life-cycle value pairs, generate the values
-
Use the CSDM life-cycle mapping rules for asset tables to derive the life-cycle value pairs from the legacy status values.
- Step 2: One-time sync: For each CI whose CSDM life-cycle values do not match the asset values, update the CI with the asset values
-
This one-time sync will not be repeated because in one of the following phases, bi-directional sync is implemented between CI life-cycle value pairs and asset life-cycle value pairs.
- Step 3: One-time sync: If a CI is not associated with an asset, use CSDM mapping tables to derive the CI's life-cycle values from the legacy status.
- This one-time sync will not be repeated because bi-directional sync continues between CI legacy values and asset legacy values. Future CI values will derive from the new bi-directional sync between asset and CI life-cycle value pairs.
Phase 3: Automated update to sync operations
- New: Activate sync of life-cycle data between asset and CMDB CI
- CSDM life-cycle value pairs are bi-directionally synced between asset and CI.
- New: Deactivate Bi-directional sync between CMDB CI legacy values and CSDM life-cycle values
-
As a result, changes to CI legacy values will not update CSDM life-cycle value pairs (the values will diverge over time). Instead, CSDM life-cycle value pairs are updated by the bi-directionally sync with asset life-cycle value pairs. A report on the CSDM dashboard lists CIs whose life-cycle values diverge from legacy values.
- No change: Sync between asset legacy values and CI legacy values
- The existing bi-directional sync between asset legacy values and CI legacy values continues.
- (No change if sync is currently active): Activate sync between asset legacy and asset life-cycle values.
- Bi-directional sync between asset legacy values and life-cycle value pairs continues.
Phase 4: Ongoing automated sync operations
Immediately after sync operations are completed, business rules run to align life-cycle value pairs in the asset, CI, and IBI tables for each product instance. Business rules then run on a regular schedule to incorporate changes to legacy status values as updates to life-cycle value pairs and to maintain alignment among Asset, CI, and IBI.
Activate life-cycle alignment and sync
Instructions Activate align and sync for CSDM life-cycle values
Map legacy status values to CSDM life-cycle values
Use the Life Cycle Mapping module to specify how existing legacy status values should be converted to CSDM life-cycle value pairs (life cycle stage and life cycle stage status). You map both asset and CI legacy status values to life-cycle value pairs.
Before you begin
Role required: itil_admin or asset_admin
About this task
Because the base system includes a large number of default mappings, you might not have to create many custom mappings. To view the list of default mappings, navigate to .
In the following example, your existing data uses a status attribute named Install Status for hardware CIs. You configure the Life cycle mapping form to map the existing Pending Install value of the Install Status attribute to the Deploy/Test life-cycle value pair in the CMDB.
Procedure
Activate align and sync for CSDM life-cycle values
Activate life-cycle sync to migrate your legacy asset and CI status settings to the CSDM standard life-cycle value pairs. After the one-time migration process, business rules maintain sync among IBI, asset, and CI life-cycle values.
Before you begin
- Adjust and add any mappings as needed for your environment.
- Review mappings for any custom status values. Those mappings are incomplete and you must provide the desired standard life cycle control to map to.
- Ensure that all mappings are configured with a life cycle control.
- Ensure that all mappings are activated.
- All mapping records are set to active and are configured with a life cycle control
- All mapping records for custom legacy values are fully configured.
Role required: itil_admin or asset_admin
Procedure
Result
One-time sync is done. All cmdb_ci and asset records should have life cycle stage and life cycle stage status values, either coming directly from what the asset had (if you have an asset/CI combo), or from the life cycle mapping table directly for non-asset CIs.
Business rules now perform ongoing alignment of life-cycle data as described in Enabling CSDM life-cycle sync between asset and CI to support product instance.
What to do next
- Activate the CSDM Activation (com.snc.cmdb.csdm.activation) plugin.
- Use the CMDB Data Manager to centrally govern the life cycle of CIs in bulk and in a standard and consistent way.
On this page
- Why enable CSDM life-cycle sync between CI and asset entities
- How the mapping between legacy status values and CSDM CSDM life-cycle values is specified
- Alignment/sync process
- Phase 1: Run the discrepancy check and correct all mappings
- Phase 2: Automated bulk alignment: Align all legacy CMDB CI and asset data to CSDM life-cycle value pairs
- Phase 3: Automated update to sync operations
- Phase 4: Ongoing automated sync operations
- Activate life-cycle alignment and sync
- Map legacy status values to CSDM life-cycle values
- Activate align and sync for CSDM life-cycle values