Preparing BMC Atrium CMDB for synchronization
The following section describes steps required for BMC Atrium CMDB synchronization:
At the time of its release, integration of the current version of BMC Discovery was supported with the following versions of BMC CMDB:
- 19.02, 19.08
- 18.05, 18.08
- 9.1.03, 9.1.04
- 9.1, 9.1.02 (limited support)
- 9.0, 9.0.01 (limited support)
For more information, check the BMC Solution and Product Availability and Compatibility utility (SPAC) (support login required).
Support for cloud discovery
A new class, BMC_CloudInstance is added in BMC Core 9.1.03: Service Pack 3 to support cloud discovery. To synchronize cloud nodes to the CMDB, you must have this service pack installed. Service Pack 3 also provides a REST API which you can use as an alternative access mechanism to use to connect to the CMDB.
Significant mapping changes since previous releases
If you are upgrading from a previous release, note the following significant changes in the default data mapping:
- A separate BMC_VirtualSystemEnabler is now created for each virtual machine running on a physical computer system, where previously a single CI was created.
- Cloud data is synchronized to the BMC_CloudInstance class that was introduced in CMDB 9.1 SP3. Synchronization to earlier CMDB releases will skip the cloud data due to the absence of the class.
Do not change the CMDB synchronization configuration at the same time as changing the cluster configuration.
- Changing the CMDB sync configuration means, adding connections, removing connections, and starting or stopping a resync.
- Changing the cluster configuration means adding members, removing members, moving the coordinator, or changing fault tolerance.
Before you begin
Before you can synchronize data to a supported BMC Atrium CMDB version, you must complete the following required tasks in the given order:
Integrating with earlier versions of BMC Atrium CMDB
BMC Atrium CMDB versions earlier than 7.6.04 are no longer supported and are not recommended for use. Synchronizing data to these earlier versions required you to complete some additional tasks. For more information, see the BMC Discovery 8.3 documentation.
- Create the BMC.ADDM dataset: The BMC.ADDM dataset must be manually created in the CMDB before a synchronization is attempted.
- Create the Job to merge the BMC.ADDM dataset with BMC.ASSET: After the BMC.ADDM dataset has been created, you must then create the job to reconcile it with the BMC.ASSET dataset.
- Check the BMC.ADDM dataset configuration: When using ITSM 7.0 with a backwards compatibility patch, you also need to ensure that the BMC.ADDM dataset is trusted.
After completing the preceding tasks, you can start synchronizing BMC Discovery data to BMC Atrium CMDB.
To obtain the maximum synchronization performance when using CMDB synchronization with BMC Discovery, you should consider tuning the database which BMC Atrium CMDB (or BMC Remedy AR System) is using.
Max-Entries-Per-Query parameter on BMC Remedy AR System server
To prevent BMC Discovery generating duplicate CIs in the BMC.ADDM dataset when running a resynchronization, you must set the BMC Remedy AR System server parameter
Max-Entries-Per-Query to 5000, rather than the current default or recommended value of 2000.
For more information, see the following documentation corresponding to your product version:
- BMC Remedy ITSM Deployment 9.1 Performance tuning for Remedy
- BMC Remedy ITSM Deployment 9.0 Performance tuning for Business Service Management
- BMC Remedy AR System 8.1 Performance tuning for Business Service Management
- BMC Remedy AR System 8.0 Performance tuning for Business Service Management
BMC Remedy AR System Server 7.6 Performance Tuning for Business Service Management White Paper
The following sections in the White Paper are particularly relevant:
- Tuning an Oracle server.
- Best practices for tuning Oracle database servers.
- Tuning a SQL Server database.
- Best practices for tuning SQL Server database servers.
To create the BMC.ADDM dataset
Creating a BMC.ADDM dataset provides a dataset into which BMC Discovery is exported before being taken into the BMC Atrium CMDB. You create the dataset by using the BMC Atrium CMDB Reconciliation console. It is recommended that you create the BMC.ADDM dataset on the primary AR System server.
The dataset you are creating is intended to receive data from only one BMC Discovery appliance. If your deployment architecture requires that several scanners or consolidator synchronize to the same CMDB, then you must create a separate dataset for each. For example,
BMC.ADDM2, and associated reconciliation jobs.
Once created, do not make any changes to any CMDB synchronization dataset.
You can create a dataset from one of two places in the console.
- From the Identify activity, click Add Dataset Identification Group Association,
and then click Create Dataset.
- From the Mid Tier, Open Atrium Core Console > Applications > Reconciliation console, and then click Create Dataset .
Complete the following fields:
The name for the dataset. Usually set to
The system identifier for the dataset. This must match the ID used in the configuration within BMC Discovery. The default is
Set to "Writable".
Set to "Regular".
For more information, see:
To create the Identification, Merge and Purge Job
BMC Discovery exports its data to a staging dataset in BMC Atrium CMDB. The content of this dataset should then be reconciled into the BMC.ASSET dataset. To accomplish this, a new Job must be added in the BMC Atrium CMDB Reconciliation Console. It is recommended that you create the Identification, Merge and Purge Job on the primary AR System server.
To add the Identification, Merge and Purge Job
- From the Mid Tier, open BMC Atrium Core Console > Applications > Reconciliation Application.
- Select the Create Standard Identification and Merge Job Icon
- Give the job a meaningful name (for example, "BMC ADDM - Identification, Merge and Purge").
- Set the Source Dataset to be "BMC.ADDM".
- After the job is Created, select BMC ADDM - Identification, Merge and Purge Job.
- Click the Edit Job icon.
- From the Job Editor window, in the Activities pane, select the New tab.
- In the New Activity pane, select Type as 'Purge', Sequence as '700' and Name as BMC ADDM - Purge.
- In the Datasets option, select Datasets as BMC.ADDM.
- Click Done.
- Click Save in the Job Editor.
The recommended practice is to create a precedence group that specifies a precedence for the BMC.ADDM dataset. The value depends on your relative preference for data populated by BMC Discovery and other data providers to the CMDB. For more information about how precedence groups are configured, see the following documentation corresponding to your product version:
BMC Atrium CMDB 7.6.04 Normalization and Reconciliation Guide – section named "Defining a Precedence Association Set".
To check the BMC.ADDM dataset configuration
When using BMC Remedy ITSM 7.0 with a backward compatibility patch, you also need to ensure that the BMC.ADDM dataset is trusted. To do this:
- Access the Home page from BMC Remedy User or a browser.
- Access the Application Administration Console.
- Go to the Custom Configuration page.
- From Foundation, select Products / Operational Catalogs.
- Select Trusted Datasets for Product Catalog and click Open.
- Select the BMC.ADDM dataset for Dataset Name.
- Click Save.