The first step of the migration process is to import the NSX-V with vRealize Automation configuration.


  • Generate a deployment configuration file in a .json format from the vRealize Automation environment. The configuration file must be valid and conform to a predefined JSON schema.


  1. From a browser, log in to NSX Manager as admin.
  2. Navigate to System > Migrate.
  3. In the vRealize Automation pane, click Get Started and select Fixed Topology.
  4. In the Upload Deployment Configuration File section, click Select File. Select the .json configuration file that was generated from the vRealize Automation environment, and click Upload.
    After uploading a file, if necessary, you can click Select File again and upload a different file. The previous file is overwritten. You cannot remove the .json file after it is uploaded. The configuration file is removed only if you take any of the following actions:
    • Roll back the migration on the Import Configuration page or the Migrate Configuration page.
    • Finish the migration on the Migrate Hosts page.
  5. Click Start to import the configuration.
  6. When the import has finished, click Continue to proceed to the Resolve Configuration page.
    • If the import fails due to incorrect edge node configuration translation, click the Failed flag to view information about the number and size of the required NSX Edge resources. After you deploy the correct number and size of edge nodes, click Rollback to roll back this migration attempt and restart the configuration import.
    • If syntax errors are found in the deployment configuration file, import fails during the translate configuration step. Roll back the migration, resolve the syntax errors in the .json file, and import the configuration again.
    • If import configuration fails due to schema mismatch errors, review the error messages, roll back the imported configuration, and upload a valid configuration file to start a new migration. The error message in the migration coordinator UI might not display all the possible reasons for the schema mismatch errors. For a complete information about the schema mismatch errors, see the migration log (cm.log file) on the NSX Manager appliance where the migration coordinator service is running.

      You can find this log file at /var/log/migration-coordinator/v2t, and use it for further troubleshooting purposes.


When the NSX-V with vRealize Automation topology is imported successfully, the View Imported Topology link is enabled. Click this link to view a graph of the imported topology. However, the topology viewer does not work for a scaled NSX-V environment.