Cisco DNA Upgrading
Upgrading Packages Individually
If you chose to install packages individually, you must install the packages in the following order depending on if you use Automation or Assurance.
Before you begin
The preferred method of upgrading DNA Center is explained in Upgrading to Cisco DNA Center, Release 1.1.8. However, you can also install packages individually after you have installed the system updates.
Be sure you have the username and password for at least one cisco.com user account. You might be prompted, once, for the credentials during package installation. This can be any valid cisco.com user account.
Procedure
| Step 1 | Install the system update as explained in Step 1 to Step 7 in Upgrading to Cisco DNA Center, Release 1.1.8. |
| Step 2 | From the DNA Center home page, choose > System Settings > App Management > Packages & Updates. |
| Step 3 | Install the packages one at a time, depending on if you use Automation or Assurance in one of the following two tables.Note Packages that have available updates appear automatically. If a package does not appear in the Available Version column, skip it and install the next package in the following sequence.Table 2. System Upgrade Installation Order for AutomationInstallation OrderPackage Name in GUI1Package Name in CLI21NCP – Basencp-system2NCP – Servicesautomation-core3Network Controller Platformnetwork-visibility4Automation – Image Managementimage-management5Command Runnercommand-runner6Automation – Device Onboardingdevice-onboarding7Assurance – Path Tracepath-trace8Automation – Basebase-provision-core9Automation – SD Accesssd-access10Automation – Sensorsensor-automation11Automation – Application Policyapplication-policy1 GUI name refers to the package name as shown in Settings > System Settings > App Management.2 CLI name refers to the package name as shown in maglev package status output. |
| Step 4 | If you use Assurance only, from the DNA Center home page, click the gear icon () and choose System Settings > App Management > System Updates, and then upgrade System.Note Download and install System from the System Updates page only. Even if System appears on the Packages & Updates page, do not download or install it from that page. Use the System Updates page only. |
| Step 5 | From the DNA Center home page, click the gear icon () and choose System Settings > App Management > Packages & Updates, and install the packages one at a time in the order shown in the following table.Table 3. System Upgrade Installation Order for Assurance OnlyInstallation OrderPackage1Network Data Platform – Core (ndp-platform)2Network Data Platform – Base Analytics (ndp-base-analytics)3Network Data Platform – Manager (ndp-ui)4Assurance – Base (assurance)5Assurance – Sensor (sensor-assurance)For the IP-based access control feature, you must install the following packages in the order specified:Network Control PlatformAutomation – BaseIf you previously installed SD Access, at a minimum, you must upgrade the following packages in the order specified:Network Controller PlatformAutomation – BaseAutomation – SD Access |
Recovering From Premature Package Downloads
Successful migration to this release requires that you install all system updates before downloading or installing application package updates. Due to dependencies among the updates, failure to observe this rule can make it impossible to install both system updates and package updates. Problem indicators include messages that a system update has failed and package update downloads that never exit the “Downloading” state.
As an admin user with Maglev SSH access privileges, complete the following steps to recover and install the system update.
Procedure
| Step 1 | Using an SSH client, log in to the DNA Center appliance using the IP address of the out-of-band management network adapter, on port 2222. Use the maglev login command and log in with an admin username and password (which is the same login used for the admin user on the DNA Center UI). |
| Step 2 | At the command line, delete all prematurely downloaded package updates by entering the following command:$ for pkg in $(maglev package status -o json | jq -r '.[] | select(.available!="-") | [ .name,.available | tostring ] | join (":")'); do maglev catalog package delete $pkg 2>/dev/null; done |
| Step 3 | Trigger the downloaded system update from the DNA Center UI. |
| Step 4 | After the system update installs successfully, download and install package updates. |
