Migrate from NDB to ND

Migrate from NDB to ND

If you are currently using Nexus Dashboard Data Broker (NDB) release 3.10.3, 3.10.4, or 3.10.5.x, you can migrate to Nexus Dashboard (ND) 4.3. Supported deployment types vary by release. For more information, see Table 1.

Table 1. Supported migration paths from NDB 3.10.x to ND 4.x

NDB release

Deployment type

Supported target ND releases

3.10.3

Embedded

4.3

3.10.4

Centralized,Embedded

4.3

3.10.5

Centralized

4.3

Note

Beginning with ND 4.3, the migration tool supports migrating multiple embedded NDB 3.10.3 and 3.10.4 deployments to a single ND 4.3 cluster.

If your NDB release or deployment type is not listed in Table 1, migrate in two steps:

  1. Upgrade NDB to a release listed in Table 1. You can upgrade from NDB 3.8.x, 3.9.x, 3.10.1, 3.10.2, and 3.10.3.

  2. Migrate to Nexus Dashboard 4.3.

Example: To migrate from NDB 3.8.1 to ND 4.3, first upgrade to NDB 3.10.4 or 3.10.5.x, and then migrate to ND 4.3.

For more information about upgrading NDB, see the Cisco Nexus Data Broker Deployment Guide for your release.

Use this procedure to migrate your NDB centralized or embedded deployment to ND 4.3.

Before you begin

  1. Log in to the NDB GUI, and download the configuration file using the standard procedure.

    On the NDB GUI, navigate to Administration > Backup Restore > Actions. You can back up the configuration to your local machine or to a server.

  2. Convert the NDB configuration file (which you have downloaded using step 1) to an ND-compatible file using the backup_converter.sh file located on Github.

  3. (optional) Create an encryption key using ./backup_converter.sh -f {zip_file} -v {ND_version} -k {password}. See Run the Script step (Github). This encryption key cannot be changed later. Ensure to save the encryption key as you will need to enter the same key while restoring the backup.

  4. Follow the steps detailed in the steps_to_generate_ND_format_backup.txt file (available on Github). The file includes a detailed procedure for converting the NDB configuration file to an ND-compatible file. The ND compatible file is named as cisco-nddb-backup.tar.gz.

Procedure

Step 1

Log in to the ND GUI.

Step 2

Navigate to Admin > Backup and Restore.

Step 3

On the Backup and Restore screen, click the Restore button.

Step 4

On the Restore screen, enter:

  1. Source: the location of the backup file.

  2. Backup file: the converted ND compatible file.

  3. Encryption key: enter the custom encryption key which you had earlier created. If you have not set an encryption key, the default value, cisco123, is assigned.

  4. Click Validate and upload. The Filename field is automatically populated with the ND compatible file (cisco-nddb-backup.tar.gz).

  5. Click Next after the validation is complete.

    The progress of the validation is indicated by the green bar, wait till 100% is displayed.

Step 5

(on the next page of the Restore screen) Check the Do not restore persistent IP configs from this backup check box to override the persistent IP configuration.

Ensure to check the check box, else the restore process will fail.

Step 6

Click Restore.

Step 7

Click Restore (again) on the Begin Restore confirmation screen.

After the confirmation, the migration process is initiated. You can monitor the progress; the various stages are indicated by the progress bar.

Step 8

Click Close.

What to do next

After the migration process, perform these steps:

  1. On the ND GUI, navigate to Manage > Fabrics.

  2. Select the required NDB fabric (NDB_default or if you have created a slice, the slice name is the fabric name).

  3. Click Actions (on the top right) > Recalculate and deploy.

    This updates the configuration on the NDB devices.

  4. Check the device mode (Manage > Inventory). The mode is now displayed as Normal (during the migration process, the device mode is indicated as Migration).