×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')

 

This documentation supports the 18.05 version of BMC Atrium Core.

To view the latest version, select the version from the Product version menu.
BMC CMDB 18.05 ... Using Transferring data from external datastores to BMC CMDB Migrating existing data exchanges to Atrium Integrator

Migrating BMC Atrium Integration Engine data exchanges to Atrium Integrator

Perform the following steps to migrate your existing BMC Atrium Integration Engine (AIE) data exchanges to Atrium Integrator. 
If something goes wrong while migrating the data exchanges, you must delete the newly created jobs and connectors, make necessary changes and migrate again.

Before you edit a data exchange, please make sure that the AIE to AI Migration tool is closed.

Related topics

Migrating existing data exchanges to Atrium Integrator


Migration of data exchange parameters to Atrium Integrator

The following table describes the BMC Atrium Integration Engine data exchange parameters that are migrated to Atrium Integrator by the AIE to AI Migration Tool.

BMC Atrium Integration Engine data exchange parameters

BMC Atrium Integration Engine data exchange parameter

In Atrium Integrator

Exchange Name

Exchange is migrated as is.

Instance Name

Instance names are not migrated to Atrium Integrator. All migrated data exchanges run under a single carte server.

Data Exchange Type

The AIE to AI Migration Tool supports all the data exchange types:

  • AR
  • CI Class
  • Relationship Class
    The AIE to AI Migration Tool migrates only those Relationship Class data exchanges that are triggered by other CI Class data exchanges.

External Data Store

The AIE to AI Migration Tool supports the following external data stores:

  • Comma separated value (CSV) flat file
  • Oracle Server
  • SQL Server
  • XML
  • DB2

Direction

The AIE to AI Migration Tool supports the following external data stores:

  • External data into Remedy AR System
  • External data into CMDB

Execute Exchange As

The AIE to AI Migration Tool supports the following methods of execution:

  • Schedule Only
  • Event Driven Only

Concurrent Session Limit

Not applicable

Data in Target (Insert/Update/Delete)

The AIE to AI Migration Tool migrates all the settings for this parameter. However, each setting does not correspond to a specific setting in Atrium Integrator. If a record deleted from source option is set to Delete according to data mapping, that setting is migrated as a delete transformation within the corresponding Atrium Integrator job.
Note: If the following Data in Target options are configured for a data exchange, that data exchange is migrated as a delete job in Atrium Integrator.

To migrate BMC Atrium Integration Engine data exchanges to Atrium Integrator

  1. On the computer on which the Atrium Integrator server is installed, click Start > Programs > BMC Software > Atrium Integrator > AIE to AI Migration Tool to open the AIE to AI Migration Tool.
    AIE to AI Migration Tool
  2.  In the AIE Server Details area, specify the details about the server on which BMC Atrium Integration Engine is installed:
    1. In the Server Name field, enter the host name of the Remedy Action Request System server on which you have installed BMC Atrium Integration Engine.
    2. In the TCP Port field, enter the port that you have configured for the Remedy Action Request System server.
    3. In the Log on Name field, enter the user name for the Remedy Action Request System server.
    4. In the Password field, enter the credentials for the Remedy Action Request System server.

  3. Click Get Exchanges to retrieve the data exchanges from the BMC Atrium Integration Engine instance that you specified in step 2.

    Note

    The data exchanges that are triggered by another data exchange are automatically migrated to the Atrium Integrator server when you migrate the data exchange that triggers the data exchanges.

  4.  In the Target Server Details area, specify the details about the Atrium Integrator server to which you want to migrate the data exchanges:
    1. In the Server Name field, enter the host name of the Remedy AR System server on which you have installed the Atrium Integrator server.
    2. In the TCP Port field, enter the port that you have configured for the Remedy AR System server.
    3. In the Password field, enter the password of Remedy Application Service user.
  5. Click Test Connection to confirm that you can successfully connect to the Atrium Integrator server that you have specified in step 4.
  6. Select the data exchanges that you want to migrate to the Atrium Integrator server.

    • You can edit the path of .csv and .xml file for the flat file or XML type of data exchanges. Double-click the file name displayed in the File Name/Table Name column and make the changes. Do not add extensions for file names.

    • The Migrated column in the AIE to AI Migration Tool displays the migration status of the data exchanges.

  7. Click Migrate to migrate the selected data exchanges to the Atrium Integrator server.
    You can view messages related to the status of the migration process in the AIE to AI Migration Tool window.

    Note

    On the target server in any directory of the repository, if a transformation has a name similar to an existing date exchange (created through Atrium Integrator or migrated from AIE to AI Migration Tool) then the migration status of the transformation is displayed as Yes in the AIE to AI Migration Tool.

  8. (optional) To clear the status messages that are displayed in the AIE to AI Migration Tool, click Clear Messages.
    After the migration process is complete, open the corresponding jobs in BMC Atrium Integrator Spoon and verify that the job definition and settings have been successfully migrated. 
    You can identify the migrated jobs as: 
    <Source AR system server><Parent job name><datasetID>

Note

  • If there are Delete only data exchanges in a migrated job then the job is created as a separate job. Also, To Be Triggered mode is not set for Delete transformations even if the corresponding data exchange was set to To Be Triggered mode in BMC Atrium Integrator Engine. You must rearrange the Delete transformation at sub job level according to the corresponding data exchange in BMC Atrium Integrator Engine.
  • After the migration is complete, ensure that Atrium Integrator Pentaho repository is created with the correct server name.
  • For instances of flat file migration, check the arcarte.log to ensure that Atrium Integrator Carte Server has successfully migrated all the flat file entries under NGIE:FileMetaData.

The Status messages area in the AIE to AI Migration Tool window displays messages related to the status of the migration process. If there are errors in the migration process, you can view the following files for detailed information:

  • MigrationInfo.txt
  • Migrationdbg.log

The log files are located in the following directory:

<ARInstallationDirectory>\diserver\data-integration\ngie\ngie\log

You can also click the View Log button on the AIE to AI Migration Tool window to view logging details.

For more troubleshooting information about data exchange migration, see Atrium Integrator data exchange migration issues.

Was this page helpful? Yes No Submitting... Thank you
Last modified by Maithili Deshpande on Apr 29, 2021
task

Comments

Log in or register to comment.

Migrating advanced settings to Atrium Integrator
Migrating connection settings to Atrium Integrator
© Copyright 2005-2007, 2009-2021 BMC Software, Inc. © Copyright 2011-2021 BladeLogic, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.