Migration Tool Command-Line Syntax

Command Syntax

  • For 32-bit:
    MigrateIHA.exe "<IHA file name with full path>" "<IHC filename with full path>"
  • For 64-bit:
    MigrateIHA_x64.exe "<IHA file name with full path>" "<IHC filename with full path>"

Command-line Options

OptionDescription
/NOTHROTTLEThis does not throttle any part of the migration process, but may impact resources on the server. Optionally, you can remove this switch as required. By default, throttling is rated at 5000 events per second.
/NOMESSAGESThis does not migrate messages into the newly created archive. Using this switch may or may not reduce the size of your archives, depending on the number of messages stored in the archive. By default, messages are migrated if this switch is not used.
/EXISTINGTAGSThis will migrate data for only those tags that exist in the destination archiver.
/bThis option of the start.exe file allows the IHA Migration tool to start without opening a new window for each instance.

If you are migrating a pre 4.5 IHA file you will need to have the IHC file for that IHA and specify the IHC file in the Options window or on the command line. Otherwise, you will get a warning message.

/waitThis option of the start.exe file allows each instance of the IHA Migration tool to complete the migration before starting the next migration in the sequence.
/NOIHC

This option skips verifying for IHC file and proceed with the migration. IHC file is not required, if batch command have /NOIHC option.

Notes

  • If you are migrating from a command line, provide IHC file, else, use /NOIHC option to omit the IHC file.

  • If you do not have the IHC or you are not sure you have the correct IHC then you should use the pre-4.5 version of MigrateIHA to migrate the IHA. Otherwise, the data will not migrate correctly.

  • You should keep a copy of the original IHA file.
  • The IHC must contain all the tags that are in the IHA file, so use the most current IHC you have.
  • You must use double quotes when you enter the IHA and IHC file even if you do not have spaces in your file path or file name.
  • Migrating an IHA will upgrade it to 4.5 format.
  • If you are migrating a 4.5 IHA you should provide the IHC file in the Options window but if you do not have the IHC you can safely continue past the warning message.