This documentation supports the 19.02 version of Remedy Deployment.

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

Extending delta data migration to include customizations

You can add custom forms to the Delta Data Migration package and migrate the data in these custom forms. You can migrate the data manually or with the Customer Form Instruction Generation tool.

You can also update a field mapping file to correct customer-defined fields in the BMC Remedy reserved range.

In this topic

Manually adding custom forms to package

  1. Open the Custom_Form_Instructions.xml instruction file in the <MigratorInstallDirectory>\DeltaDataMigration\Packages\Custom directory.
    The file contains information that is similar to the instructions XML example.
  2. Provide your custom form name and the unique field IDs (unique index field IDs) in their respective tags.
    Follow the same process for all of the forms that you want to add.
  3. Open the Custom_Form_Package.xml package file in the <MigratorInstallDirectory>\DeltaDataMigration\Packages\Custom folder.
  4. Provide the instruction XML file names in the package XML file:

    <instructions file="Custom_Form_Instructions.xml type="all" command="migrate" enabled="true">
    <instruction name="Custom_Form_Instructions"> </instructions>
  5. Save the instruction and package XML files.
    You are now ready to run the migrate and compare scripts for the custom package. The new package will run in parallel in a separate command window in the same way as the Delta Data Migration out-of-the-box package files.

Adding custom forms to package by using the Customer Form Instruction Generation tool

If you do not have the list of your custom (non-BMC) regular forms, run the following batch files as outlined in the procedure for adding custom forms to a package by using the Custom Form Instruction Generation tool.

  • The migratorFindCustomForms.bat utility — Finds all of your custom forms on the AR System server that are not recognized as BMC Software forms. The utility generates a CSV file that includes a list of all custom form names with their unique indexes.
  • The migratorCSV2Instructions.bat utility — Uses the generated CSV file as the input, and creates a Custom_Form_Instructions.xml file for the custom forms in the CSV file.

To add custom forms to the package by using a Customer Form Instruction Generation tool

  1. Navigate to <MigratorInstallDirectory>\Migrator\migrator\DeltaDataMigration\Utilities\migratorUtilities folder.
  2. Run the migratorFindCustomForms utility by using the following syntax:

    migratorFindCustomForms.bat -s <sourceARServerName> -u <adminUserID> -p <adminPassword> -P <ARServerPort>

    For example:

    migratorFindCustomForms.bat -s -u Demo -p "" -P 2020
  3. Open the Customforms.csv output file in a text editor or spreadsheet application.
  4. If a form is included in the list but should not be migrated, remove the entire line.
    Do not include forms that are used for testing or to keep temporary data. If you are not sure, it is better to include the form in the migration. Migrating a form multiple times is permitted.


    You can save the names of forms to be excluded in a separate file, and then use that file the next time you run migratorFindCustomForms.

  5. Save the changes you made to the Customforms.csv file.
  6. Run the migratorCSV2Instructions utility by using the following syntax:

    migratorCSV2Instructions.bat -i Customforms.csv

    For example:

    migratorCSV2Instructions.bat -i Customforms.csv

    This utility generates an instruction file that BMC Remedy Migrator reads and uses for the migration.

  7. Verify that the output file is Custom_Form_Instructions.xml.
  8. Open the Custom_Form_Instructions.xml file, and ensure that the name inside of the xml file has the same name "Custom_Form_Instructions."
  9. Copy the Custom_Form_Instructions.xml files to the Packages\Custom directory. (You can overwrite the same file in the directory.)
    The custom package is now ready to be used. On the Delta Data Migration Tool user interface, when you select Custom, this custom package is selected, and the migration for the custom forms is executed.

Where to go from here

Next task

During the delta period, if you changed the login ID, support group association, permissions groups, or the functional role for your users on the current production server, go to Deleting orphan records after delta data migration.

Otherwise, for the next step in the process return to Migrating delta data.

Was this page helpful? Yes No Submitting... Thank you