Restoring a backup results in restoring the state of the network at the time of the backup. In addition, the configurations maintained by the NSX Manager are also restored and any changes, such as adding or deleting nodes, that were made to the fabric since the backup was taken are reconciled.

You must restore a backup on a new installation of NSX Manager, as described in the first step below.

Prerequisites

  • Verify that you have the login credential for the backup file server.
  • Verify that you have the SSH fingerprint of the backup file server. Only an SHA256 hashed ECDSA (256 bit) key is accepted as a fingerprint. See Find the SSH Fingerprint of a Remote Server.
  • Verify that you have the passphrase of the backup file.

Procedure

  1. Install a new NSX Manager node on which to restore the backup.
    If the original NSX Manager was configured with the default setting of not publishing its FQDN, that is "publish_fqdns": false, then the new installation of NSX Manager must be installed with the same IP address that was used by the original NSX Manager. If the original NSX Manager was set up to publish its FQDN, that is "publish_fqdns": true, the new NSX Manager can be installed with a different IP address. However, the new NSX Manager must also be configured to publish its FQDN. If you had an NSX Manager cluster when the backup was taken, you must also restore to an NSX Manager cluster. The restore process restores one NSX Manager node first and then prompts you to add the other NSX Manager nodes.
    1. Power down all NSX Manager nodes.
    2. Deploy a new NSX Manager node with the same name and IP address of the original NSX Manager node.
      To identify the original NSX Manager node, open the NSX Manager dashboard and navigate to System > Appliances to view the Management Cluster. This displays the NSX Manager nodes. The original node is the one whose Deployment Type shows as Manual.
    After the new NSX Manager node is running and online, you can proceed with the rest of the procedure.
  2. From your browser, log in with admin privileges to a new NSX Manager.
    The IP address or FQDN of this NSX Manager node must be the same as the IP address or FQDN of the NSX Manager where the backup was taken.
  3. Select System > Backup & Restore.
  4. Click the Restore tab.
  5. To configure the backup file server, click Edit.
  6. Enter the IP address or host name.
  7. Change the port number, if necessary.
    The default is 22.
  8. To log in to the server, enter the user name and password.
  9. In the Destination Directory text box, enter the absolute directory path where the backups are stored.
  10. Enter the passphrase that was used to encrypt the backup data.
  11. Enter the SSH fingerprint of the server that stores the backups.
  12. Click Save.
  13. Select a backup.
  14. Click Restore.
    The status of the restore operation is displayed. If you have deleted or added fabric nodes or transport nodes since the backup, you are prompted to take certain actions, for example, log in to a node and run a script.

    If the backup has information about an NSX Manager cluster, you are prompted to add NSX Manager nodes. If you decide not to add NSX Manager nodes, you can still proceed with the restore.

    After the restore operation is completed, the Restore Complete screen is displayed, showing the result of the restore, the timestamp of the backup file, and the start and end time of the restore operation. If the restore failed, the screen displays the step where the failure occurred, for example, Current Step: Restoring Cluster (DB) or Current Step: Restoring Node. If either cluster restore or node restore failed, the error might be transient. In that case, there is no need to click Retry. You can restart or reboot the manager and the restore continues. You can also determine that there was a cluster restore or node restore failure by running the following CLI command to view the system log file and searching for the strings Cluster restore failed and Node restore failed.
        get log-file syslog
    To restart the manager, run the following CLI command:
        restart service manager
    To reboot the manager, run the following CLI command:
        reboot
  15. After the first NSX Manager node is up and functional, deploy two additional nodes to complete the NSX Manager cluster.
    See DeployNSX Manager Nodes to Form a Cluster from UI in the NSX-T Data Center Installation Guide.
  16. After the new NSX Manager cluster is deployed, delete the original NSX Manager cluster VMs that you powered down in Step 1a. of this procedure.

Results

Note: If you added a compute manager after the backup, after the restore, if you try to add the compute manager again, you will get an error message indicating that registration failed. You can click the Resolve button to resolve the error and successfully add the compute manager. For more information, see Add a Compute Manager, step 4. If you want to remove the information about NSX-T Data Center that is stored in a vCenter Server, follow the steps in Remove NSX-T Data Center Extension from vCenter Server.