Working with CMDB utilities
As an administrator, you can use different CMDB utilities to perform specific tasks, such as detecting corrupted data in the Common Data Model (CDM), updating relationships in the CDM, and investigating data issues. The CMDB utilities are run from the command line and communicate with the AR System server by using secure RPC API connections.
In environments where enhanced security or regulatory compliance is required, CMDB utilities support encrypted communication with the AR System server, including operation in Federal Information Processing Standard (FIPS)–enabled environments. When FIPS compliance is enabled, the utilities use FIPS‑approved cryptographic algorithms to help meet enterprise security and compliance requirements.
CMDBprovides the commonly used CMDB utilities in a zip file that is available for download from the BMC Electronic Product Distribution (EPD) site (Support ID required).
To download CMDB Utilities
Log in to BMC Electronic Product Distribution.
- In the search field, enter BMC Helix ITSM.
- In the search results, select <version yy.vv> > Product > BMC Helix CMDB Utilities Version <yy.vv>
For example, 21.05 > Product > BMC Helix CMDB Utilities Version 21.05.00
After downloading the CMDB Utilities zip file, extract the files to your computer. The CMDB Utilities folder contains the following folders:
- Common
- Linux
- Windows
Depending on the Operating System that you are using, open the folder to access the utilities. The Common folder contains utilities that run on any Operating System.
If you are a BMC Helix Subscriber, connect to a BMC network to run the utilities. See, BMC Helix Client Gateway connectivity.
The following table lists the utilities and the corresponding documentation about using the utility:
Utility name | Purpose | Reference |
|---|---|---|
CDMChecker | Detects invalid customization in the Common Data Model (CDM) and CDM corruption. | |
CMDBArchive | Archives the extensions that you made to the Common Data Model. | |
CMDBDiag | Checks for invalid data in CMDB and helps correct it. | |
CMDBDriver | Helps purge orphaned CIs in bulk from CMDB. | |
DataAnalyzerTool | Performs data analysis and identifies data inconsistencies in any CMDB dataset such as the following:
| |
NE Simulator | Simulates the normalization results before running the normalization process and improves the number of CIs that are normalized and the quality of data created in the Product Catalog. | |
RE Export Job | Exports the reconciliation job definitions to an ARX file to help migrate the job definitions from one server to another. | |
CDM2HTML | Converts the Common Data Model diagram to an HTML format. | |
Test_treedump | Obtains a list of the web services that are published to the Web Services Registry. | |
atriumwsutil | Modifies, packages, and deploys the configurations in security properties for CMDB Web Services. | |
isVirtual Mapper (Not applicable for BMC Helix Subscriber) | Moves data associated with isVirtual_old attributes to isVirtual attribute. Use this utility if you have upgraded from BMC CMDB versions 19.02 and earlier to BMC CMDB version 19.08 and later. | |
| Client Encryption Deployment Utility | Configures encrypted communication between BMC Helix CMDB clients (such as Atrium Spoon) and the AR System server. Use this utility to enable and manage Standard, Performance, or Premium encryption levels, including operation in FIPS‑enabled environments. | Enabling FIPS compliant encryption |