Running the migration tool

At the PC, open a standalone Niagara Console window using the shortcut from the Windows Start menu.

NOTE: Do not use the Workbench embedded Console because it cannot accept keyboard inputs, and thus it hangs on input selections.

If you have a number of station backups in a single folder to migrate, it may be simplest to change the console window’s current directory to that location. For example, your console prompt may be similar to: C:\niagara\niagara-3.8.111\backups>

The above would apply if you have both NiagaraAX-3.8 and Niagara 4 installed on your PC. Alternatively, enter the full path to source station backup .dist files in the commands.
Enter the migration tool command (n4mig) using syntax that specifies the source backup file, at a minimum. By default (if left unspecified), the migration output targets the stations folder of your Workbench User Home. Generally, this is the recommended method: specify source file only.

If you changed the console’s current directory to the location of station backups your command could be:

n4mig -t:2 backup_Supvsr_141117_1707.dist

(to migrate a backup .dist with that default file name, for a station named “Supvsr”).

CAUTION: Do not attempt a station migration using the Workbench embedded Console. This console cannot accept keyboard inputs, and thus will hang waiting for your input selection. The only workaround at that point is to restart Workbench.

While the migration tool runs, operation activity is reflected in the console window. When finished, the ending lines in the console window state where the target output results and log file can be found.

For reference details on the n4mig command, see Migration tool command usage. For general information, see About the migration tool.

Running the migration tool

Related Links