Migrating each station

The migrator is a command line utility. Using the backup .dist file, it creates the Niagara 4 Supervisor and subordinate station folders. Then, using Workbench, you open a platform connection to each new platform and install each new station using the Station Copier.

Prerequisites: Niagara 4 is installed on your PC. You know the name of the .dist file and where it is located. Zip files must be “unzipped” to expose the “*.dist” file for the migrator to process.

Open a standalone Console window using the shortcut from the Windows Start menu.

NOTE: Do not use the Workbench embedded Console. It cannot accept the required keyboard inputs during the migration process.
Change directories to the location of the backup .dist file.

NOTE: If you change directories to the location of the backup .dist file you do not need to specify the path to this file.
Enter: n4mig distributionfilename.dist, where distributionfilename.dist is the name of the backup .dist file you created.

If the current directory does not contain the .dist file, include the correct file path in the command line to precede the .dist file name. For example: c:\path\distributionfilename.dist.
When the process pauses, respond to the prompts in the console window, as follows:
1. Please select a migration template:1: Controller Migration Template or 2: Supervisor Migration Template
2. Enter the passphrase used to protect Niagara 4 BOG files.
  If you know the passphrase of the system that you are targeting with the migrated station(s), enter it here. If you do not know or have access to the system passphrase, create one now and remember it. You will have to enter it when you copy the migrated station to the Niagara 4 host system. For more details about passphrase refer to the Niagara Platform Guide topics: ”System Passphrase” and “System passphrase usage in backups and station copies”.
While the migration utility runs, it displays the log in the console window. The final message displays the source, target, and Migration Report locations for reference, as shown below:
```
Completed Migration
        Source: backup_EntSec24Supervisor_190411_1415.dist
        Target: C:\Users\User123\Niagara4.8\brand\stations\EntSec24Supervisor
        Migration Report: C:\Users\User123\Niagara4.8\brand\stations\
        backup_EntSec24Supervisor_190411_1415.dist_miglog_190411_1423.html
```
Make a note of these locations.

Migrating each station

Related Links