Migrator syntax example 1

Here, the current directory of the Niagara console window has been changed to the backups folder of the AX-3.8 installation home, such that the prompt is C:\niagara\niagara-3.8.111\backups>

A command is entered specifying only the source, and not target (recommended for station migration).

C:\niagara\niagara-3.8.111\backups>n4mig -t:1 backup_J300E_W_150210_1715.dist

The migration tool processes the J300E_W backup .dist file in the current directory, as JACE station, and the target output goes under the stations folder of your current Workbench User Home. The standard log file (migration report) is also created in the root of the stations folder.

So here, migration produces these items:

  • C:\Users\userName\Niagara4.x\<brand>\stations\J300E_W (complete station folder)
  • C:\Users\userName\Niagara4.x\<brand>\stations\J300E_W_miglog_150212_0846.txt (log file or “migration report)

The name of the migrated station (folder), in this case “J300E_W”, is determined by the station name inside the station backup .dist file, and is not affected by the name of the .dist file. Therefore, you could rename the source file frombackup_J300E_W_150210_1715.dist to, say, J3Wbu.dist before running the migration tool, and run the command (again, specifying only the source):

C:\niagara\niagara-3.8.111\backups>n4mig -t:1 J3Wbu.dist

You would have essentially the same results, with these items:

  • C:\Users\userName\Niagara4.x\<brand>\stations\J300E_W (complete station folder)
  • C:\Users\userName\Niagara4.x\<brand>\stations\J3Wbu_miglog_150212_0847.txt (log file or “migration report)

This may be useful to reduce the amount of typing in the console when migrating stations to N4.