This documentation applies to the 8.1 version of BMC Atrium Core, which is in "End of Version Support." You will not be able to leave comments.

To view the latest version, select the version from the Product version menu.

Migrating reconciliation jobs and dataset settings

You can export reconciliation definitions from one server and import them on another server.

Exporting reconciliation definitions

You can export reconciliation definitions from one server and import them on another server. The settings are saved in an .arx structure to the clipboard, which you must save to a text file. You can export two types of information:

  • Reconciliation job definitions — You must save each job to a separate file. This data includes all the settings for the jobs, activities, and qualifications.
  • Dataset — For each dataset, you can export the accessibility, account ID, security settings, dataset type, creation and modification data, normalization status, identification status, reconciliation ID, and other information.

To import the settings and jobs to a Reconciliation Engine on another server, you must use the dataimport.bat command. For more information, see Importing reconciliation definitions.

Note

Do not save the file using Microsoft Notepad because it does not save the carriage returns and line feeds (CR+LF) correctly. Use a plain text editor that retains CR+LF. Otherwise, importing the definitions fails.

To export reconciliation jobs

  1. From the Reconciliation console, click Export.
  2. In the Export Jobs tab, select a job.
  3. Click Save to Clipboard.
  4. In a text editor, paste the copied job settings.
  5. Save the file with an .arx extension.

To export reconciliation datasets

  1. From the Reconciliation console, click Export.
  2. Click the Export Datasets tab.
  3. From the list of datasets, select one.
  4. Click Save to Clipboard.
  5. In a text editor, paste the copied job settings.
  6. Save the file with an .arx extension.

Importing reconciliation definitions

You import reconciliation definitions by using the BMC Remedy Data Import CLI.

Note

Before using the CLI on UNIX for the first time, you must add an entry to your library path. The CLI also has several other options not described in the following procedure, some of which might be necessary depending on your AR System server environment. For more information about these topics, see Migrating using command-line interface.

To import reconciliation definitions

  1. Open a command prompt.
  2. For Microsoft Windows, change to the directory where BMC Data Import tools are installed.
    The default directory is:
    <bmcInstall>\AR System\dataimporttool
  3. Enter the command:
    dataimport.bat -x <serverName> -u <userName> -p <password> -a <portNumber> -o <importFile> -l <logFile> -e 179 -D 4

For <importFile>, specify the full path to the file containing the exported definitions from the procedure Exporting reconciliation definitions. Specifying a log file is optional, but recommended in case there are any errors with the import. If you are not using portmapper, you can specify the port for the server with the optional -a parameter.

The -e 179 option enables you to verify whether a definition you are importing already exists. This check is performed based on the globally unique identifier (GUID) values. Specifying the -D4 option updates an entry if a match is found. If no match is found, a new entry is created. For more information about the various options for the dataimport.bat utility, see Enabling the Data Import utility.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments

  1. Lukasz Pilch

    Hello Gary Beason,

     

    Two things:

    1. What is procedure for migrating dataset settings? I can see only export part.
    2. Looks like export part for dataset settings contains errors:
      1. "5. In a text editor, paste the copied job settings."
      2. "6. Save the file with an .arx extension." - dataset setting are generated in the form of xml.

     

    Best regards,

    Lukasz

     

    Jun 03, 2016 09:47