Before you can export data to BMC Atrium CMDB, using the CMDB Sync page or the full export, you must satisfy the following pre-requisites:

1. Extend the CMDB - In order to tightly integrate the two models it is necessary to store a BMC Atrium Discovery specific identifier on the corresponding BMC Classes in the CMDB. This attribute is not currently present in the default Atrium CDM, so it must be extended.
2. Create the BMC.ADDM dataset - It is required that the BMC.ADDM dataset is manually created in the CMDB before a synchronization is attempted.
3. Create the Job to merge the BMC.ADDM dataset with BMC.ASSET - Once the BMC.ADDM dataset has been created the job to reconcile it with the BMC.ASSET dataset needs to be created.

An additional step is required if your Atrium CMDB instance is earlier than: 7.5 patch 004 7.6 patch 001 See Modify the Atrium Core Reconciliation Rules for more details

Once you have performed these steps you can start exporting BMC Atrium Discovery data to BMC Atrium CMDB using the following methods:

• CMDB Synchronization
• the BMC Atrium adapter

Applying the ADDM Integration Extension

BMC Atrium CMDB ADDM Integration extension is supplied as a zipped archive of XML files called extension-423-ADDMIntegration.zip. You can obtain this from the CMDB Sync page.

The ADDM Integration extension adds an attribute to the BMC Atrium CMDB which is used to hold metadata on BMC Atrium Discovery nodes to enable the integration to link nodes in each system representing the same configuration item. The XML extension files should be extracted from the ZIP archive and saved to your local file system.

To Apply the Integration Extension

The extension is applied using the BMC Atrium Extension Loader. The Extension Loader is part of the BMC Atrium Configuration Management Database Maintenance Tool, which is installed with BMC Atrium Configuration Management Database.

Due to a defect in CMDB, you must run the BMC Atrium Configuration Management Database Maintenance Tool as the same NT user that installed the CMDB - otherwise, you will get a critical failure related to authentication and the rik.exe executable not being found.

1. Depending on your environment, perform the following steps to access the Extension Loader:
   • On Windows
     • Atrium CMDB 7.5
       • From <BMC_install_directory>\BMC Software\AtriumCore\<server>\atriumcore, double-click AtriumCoreMaintenanceTool.cmd.
     • Atrium CMDB 7.6
       • From <BMC_install_directory>\BMC Software\AtriumCore\atriumcore, double-click AtriumCoreMaintenanceTool.cmd.
   • On UNIX
     • Navigate to your installation directory and run ./AtriumCoreMaintenanceTool.sh.
2. Click the Configuration tab.
3. From the Configuration tab, select the Run Extensions.
4. Click Browse to locate and select the extension data file ExtensionLoader.xml which you extracted from the extension-423-ADDMIntegration.zip file.
5. Click Next.
6. Provide the following BMC Remedy AR System information, and click Next.
   • User Name—Specify an Administrator user name.
   • Password—Type the password for the Administrator user name.
   • Port Number—If you specified a port number when installing the AR System server, type that number in this field. If the server uses a portmapper to automatically select a port to use, leave this field to the default "0".
   • AR Server Host Name—Type the AR System server on which you want to install the extensions.
7. Click Run.
   An installation summary indicates if the generation succeeded or failed, including a brief reason for the failure, such as "The structure of the XML is not proper. Please ensure tags are closed properly."
8. For a failure, click View Log to find details.
   1. In the atriumcore_configuration_log.txt window, you can sort by Severity.
   2. Look for SEVERE messages highlighted in red.
   3. Select a message to display the details at the bottom of the window.
9. To return to the initial generation view, click Done.

See the BMC Atrium CMDB Administrator's Guide for more information on Atrium CMDB extensions.

Additional Information If you are having difficulty applying the extension you might like to try the resolution covered in this thread on the BMC Communities site.

Creating the BMC.ADDM dataset

Creating a BMC.ADDM dataset provides a dataset into which BMC Atrium Discovery is exported before being taken into the BMC Atrium CMDB.

To Create the BMC.ADDM dataset

You create the extension using the BMC Atrium CMDB Reconciliation console.

1. You can create a dataset from one of two places in the console. Either:
   • 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, click "Create Dataset" option.
2. Complete the following fields:
   

   Field	Description
   Name	The name for the dataset. This must be BMC.ADDM.
   ID	the system identifier for the dataset. Note that this is the value that you provide to the Atrium adapter configuration in the Dataset field. See Configuring an Atrium Adapter
   Accessibility	Set to "Writable".
   DatasetType	Set to "Regular".

3. Click Save.

See the BMC Atrium CMDB Normalization and Reconciliation Guide for more information.

Creating the Identification, Merge and Purge Job

ADDM exports its data to a staging dataset in the Atrium CMDB. The content of this dataset then needs to be reconciled into the BMC.ASSET dataset. To achieve this a new Job needs to be added via the Atrium CMDB Reconciliation Console.

To add the Identification, Merge and Purge Job

1. From the Mid Tier, Open Atrium Core Console -> Applications -> Reconciliation Application.
2. Select the "Create Standard Identification and Merge Job" Icon
3. Give the Job a meaningful name; for example "BMC ADDM - Identification, Merge and Purge"
4. Set the Source Dataset to be "BMC.ADDM"
5. Once the Job is Created, Select "BMC ADDM - Identification, Merge and Purge" job, Click on "Edit Job" icon, from the opened 'Job Editor' window, in the 'Activities' pane, select 'New' tab.
6. In the 'New Activity' pane, select Type as 'Purge', Sequence as '700' and provide 'Name' as BMC ADDM - Identification, Merge and Purge. In the Datasets option below, select Datasets as BMC.ADDM.
7. Click on 'Done'.
8. Click 'Save' in the 'Job Editor'.

Modifying the Reconciliation Rules

Atrium CMDB version 7.5 patch 004 and version 7.6 patch 001 contain changes to the standard reconciliation rules that are required for succesful reconciliation of the BMC.ADDM dataset with the BMC.ASSET dataset.

If you are using an earlier version of the Atrium CMDB then the standard reconciliation rules need to be modified before running the first reconciliation from BMC.ADDM to BMC.ASSET.

These are described in the table below:

How to Modify the Reconciliation Rules – BMC Atrium CMDB version 7.5 and 7.6

1. From the Mid Tier, Open Atrium Core Console -> Applications -> Reconciliation Application, click Standard Rules Editor.
2. Select Attribute 'Application Type' for BMC_Application class. Drill down Attribute 'Application Type' and change it to 'Name'.
3. Similarly, Select Attribute 'Connectivity Type' for BMC_ConnectivitySegment class. Drill down Attribute 'Connectivity Type'and change it to 'Name'.
4. Select Attribute 'SoftwareServerType' for BMC_SoftwareServer class. Drill down Attribute 'SoftwareServerType'and change it to 'Name'.
5. Click Save.

Modifying reconciliation rules is fully described in the BMC Atrium CMDB Normalization and Reconciliation Guide.