How to Work with the Population from Atrium Adapter

1. Prerequisites - File preparation

   1. • For Atrium 7.6.04 and earlier versions: Locate the files listed in the table below on the Remedy ARS and Atrium system, and copy them to:

        <DataFlowProbe_Home>\runtime\probeManager\discoveryResources\AtriumImportAdapter

        Note All the files listed in the table below are required.

      • For Atrium 8.1: Locate the files arapi81_build001.jar and cmdbapi.jar on the Remedy ARS and Atrium system and copy them to:

        <DataFlowProbe_Home>\runtime\probeManager\discoveryResources\AtriumImportAdapter

      • For Atrium 9: Locate the files arapi90_build002.jar and cmdbapi90.jar on the Remedy ARS and Atrium system and copy them to:

        <DataFlowProbe_Home>\runtime\probeManager\discoveryResources\AtriumImportAdapter

      JAR Files	DLL Files
      arapi75.jar arutil75.jar cmdbapi75.jar commons-beanutils.jar commons-codec-1.3.jar commons-collections-3.2.jar commons-configuration-1.3.jar commons-digester-1.7.jar commons-lang-2.2.jar log4j-1.2.14.jar oncrpc.jar spring.jar	arapi75.dll arencrypt75.dll arjni75.dll arrpc75.dll arutiljni75.dll arutl75.dll arxmlutil75.dll cmdbapi75.dll cmdbjni75.dll icudt32.dll icuinbmc32.dll icuucbmc32.dll Xalan-Cbmc_1_9.dll XalanMessagesbmc_1_9.DLL xerces-cbmc_2_6.dll xerces-depdombmc_2_6.dll

      Note
      

      • The AR System Java API is forward and backward compatible with other versions of the AR System, except Atrium version 7.6.0.4 where you must use the SDK of the same version. For a complete compatibility matrix, refer to the "API Compatibility" section in the BMC Remedy/Atrium Developer Reference Guide.
      • The arencrypt*.dll files are only required if encryption is enabled on the Remedy server.

   2. Edit the WrapperGateway.conf file (or WrapperManager.conf if the Probe Manager and Gateway are running in separate mode) in the following directory: <DataFlowProbe_Home>\bin.

   Add the following line after the wrapper.java.library.path.2=%content_dll% line:

   wrapper.java.library.path.3=%runtime%/probeManager
/discoveryResources/AtriumPushAdapter

   3. For Atrium 7.6.04 and earlier versions only: Add the complete path to the Atrium DLL files (for example, C:\UCMDB\DataFlowProbe\runtime\probeManager\
      discoveryResources\AtriumImportAdapter) to the Windows system path on the Data Flow Probe machine.

   4. Restart the Data Flow Probe service.

2. Prerequisites - Set up protocol credentials

   Configure a generic protocol with the ARS server's username and password.

   Note While creating the generic protocol, set the protocol description to atrium.

3. Prerequisites - Create XML mapping files

   This step involves creating XML mapping files (in the <DataFlowProbe_Home>\runtime\probeManager\discoveryResources\TQLExport\Atrium\data directory). These files map the BMC Atrium classes, attributes and relationships to their UCMDB equivalents. To create the XML mapping files for the topology requires identification of the topology to be imported from Atrium, and ensuring an equivalent topology exists in UCMDB. For more details, see Mapping Files.

4. Run the job

   In the Integration Studio, create a new integration point.

   1. Provide a name and description for the integration point.

   2. Under Integration Properties > Adapter, select the Population from Atrium adapter.

   3. Configure the following adapter properties:

      • ARS_Server

      • ARS_Port

      • BMC_NameSpace

   4. Under Adapter Properties > Data Flow Probe, select the Data Flow Probe to be used for the integration.

   5. Under Adapter Properties > Trigger CI instance select:

      1. Select Existing CI (if you have a valid, existing CI). The Select Existing CI pane appears. Select the CI, or

      2. Create New CI (if you need to create a new CI). The Topology CI Creation Wizard appears. Complete the creation of the CI using the Wizard.

         Note For details on the Topology CI Creation Wizard, see "Topology CI Creation Wizard" in the Data Flow Management section of the UCMDB Help.

   6. Save the integration point.

   7. Run the job.

      Note For details on running an integration job, see "Integration Studio" in the Data Flow Management section of the UCMDB Help.