Migration Procedure

Before you begin

  • Work with a member of the Cisco support team to download a copy of the utility, and for assistance in the migration procedure.

  • The migration process requires for the IWAN App 1.6.x setup operating on APIC-EM to be operating correctly before migration. It must not be in an error state.

    Example error states:

    • Partial collection failure

    • Unmanaged state in inventory

    • Failed sites

    • Network upgrade required

  • DNA Center does not support /31 subnet masks for IP pools. If any /31 subnet masks are defined, change them before migration.

  • Migration of multi-node clusters is not supported.

  • Devices unclaimed by PnP will not be migrated. Remove all unclaimed devices before migration. After migration, devices connect to DNA Center, after discovery by the PnP app, and can be claimed at that point.

  • For any IWAN-provisioned devices, remove any PnP profile CLI, using the IWAN App 1.6.x "custom config" feature. This feature executes CLIs on multiple devices. This step prevents any devices from connecting to the PnP service on DNA Center before the migration process.

  • All IWAN sites must have location defined. Without this, they will be listed as having an "Unknown" location. Location is mandatory in DNA Center network design.

  • Verify that appliance/UCS specifications meet the requirements of DNA Center 1.2.

  • Before proceeding with the migration, remove any site-specific IP pools if there are no sites provisioned for them. If you cannot remove them before migration, then after the migration is complete, create a site with the name indicated by the site-specific IP pool. Do this in DNA Center as follows:

    DNA Center home page > Design > Network Hierarchy > Global > Add Site

Procedure

Step 1

In the currently operating APIC-EM installation, create a new backup.

Step 2

After the backup is complete, in the Downloadable Backups area, click the Download link. Download the backup to a PC or server location.

Step 3

Shut down the APIC-EM instance if installing DNA Center on a different appliance.

Step 4

Install and provision DNA Center on its appliance.

Step 5

On the DNA Center appliance, install the IWAN App, according to instructions in the IWAN App Quick Start guide (see Related Documentation).

Use the same network settings for cluster IP as were used in APIC-EM.

Important 

Do not configure any settings on the DNA Center cluster before completing the migration. These settings will be transferred as part of the migration process below.

Step 6

Transfer the backup file created in IWAN on APIC-EM to the server on which DNA Center is installed. Note the directory in which you save the file.

Example:

/home/maglev
Step 7

With assistance from Cisco support (TAC), download the migration support package from the location provided.

Example filename: migration-support-2.1.15.60387.tar.gz

Step 8

Transfer the migration support package to the server on which DNA Center is installed. Save it in the same directory that contains the backup file (see previous step 6).

Step 9

On the DNA Center server, extract the migration support package, using the following CLI command:

tar -xvf migration-support-*.gz $(tar -tf migration-support-*.gz | grep migration-job-) -O | tar -xvzf - start_migration.sh

This command extracts the package. One of the extracted files is the migration script:

start_migration.sh
Step 10

Confirm that the backup file (see previous step 6) and the start_migration.sh script are in the same directory.
Step 11

To begin the migration process, run the start_migration.sh script in the CLI:

./start_migration.sh

Table 1. Migration Script Actions

Script Step

Description

1

Log into the maglev API, display packages installed on DNA Center.

User input: None

2

Set up maglev remote backup.

User input:

  • Cluster IP

  • Port: 2222

  • Directory containing backup file

  • Maglev credentials: Username "maglev" and the password configured during setup of DNA Center.

3

Extract and push the migration-support package.

User input: None

4

Deploy migration-support package to cluster.

User input: None

5

Find the 1.6.x backup file.

User input: Absolute path of the backup file (if the default location is not correct).

6

Migrate the IWAN configuration.

The time required depends on the size of the backup file. Typical migration time is 30 to 90 minutes, but may be longer for large IWAN configurations.

User input: None

7

Configure Kong.

User input: None

8

Restart internal "fusion" services.

User input: None

9

Complete migration, restart DNA Center services.

User input: None

Migration logs available in: /tmp/tmp.xxxxxx/migration-job_console.txt

What to do next

After the migration is complete, perform the following steps to verify operational status and begin using the IWAN App on DNA Center.

Table 2. After Migration

Step

Description

1

Verify that DNA Center services are active.

On the DNA Center server, use one of the following commands:

  • magctl service display
  • magctl appstack status

In the command output, the Available column shows a value other than 0 if the service is running.

2

Verify that all devices are in a Managed state. This indicates that DNA Center has recognized the devices and that connectivity is up. If devices are in In Progress state, wait for the devices to reach Managed state.

DNA Center home page > Provision

3

In the IWAN App, verify that the site status for each site is the same as before the migration.

4

If you plan to add greenfield devices, add an NTP server in DNA Center.

DNA Center home page > Design > Network Settings > Network > Add Servers button > NTP