Manage Applications

Application Management

Cisco DNA Center provides many of its functions as individual applications, packaged separately from the core infrastructure. This enables you to install and run the applications that you want and uninstall those you are not using, depending on your preferences.

The number and type of application packages shown in the Software Management window will vary, depending on your Cisco DNA Center version and your Cisco DNA Center licensing level. All the application packages that are available to you are shown, whether or not they are currently installed.

Some applications are so basic that they are required on nearly every Cisco DNA Center deployment. For a description of a package, click the Currently Installed Applications link and place your cursor over its name.

Each Cisco DNA Center application package consists of service bundles, metadata files, and scripts.


Important

Perform all application management procedures from the Cisco DNA Center GUI. Although you can perform many of these procedures using the CLI (after logging in to the shell), we do not recommend this. In particular, if you use the CLI to deploy or upgrade packages, you must ensure that no deploy or upgrade command is entered unless the results of the maglev package status command show all the packages as NOT_DEPLOYED, DEPLOYED, or DEPLOYMENT_ERROR. Any other state indicates that the corresponding activity is in progress, and parallel deployments or upgrades are not supported.

Download and Install Application Updates

Cisco DNA Center treats individual applications as separate from the core infrastructure. Specifically, individual packages for applications can be installed to run on Cisco DNA Center.

Packages for applications may take time to install and deploy. Therefore, install the packages during a maintenance period for your network.

Before you begin

Only a user with SUPER-ADMIN-ROLE permissions can perform this procedure. For more information, see About User Roles.

Procedure

Step 1

Click the menu icon () and choose System > Software Management.

Important

 
At this point, Cisco DNA Center performs a connectivity check. If there is a connectivity issue, the Software Management window will not display application updates that are currently available.

Step 2

If any application updates are available, they are displayed at the bottom of the window. Do one of the following:

  • To install all of the available application updates, click the Select All link.

  • To install individual application updates, check the appropriate check boxes.

Note

 

To open a slide-in pane that indicates an update's file size and provides a brief description of the corresponding application, click its More details link.

Step 3

Click Install.

Step 4

After Cisco DNA Center completes a dependency check, click Continue.

The window displays a progress bar for each application that's being updated. The Software Management window updates after all of the updates have been installed.

Step 5

Click the Currently Installed Applications link and confirm that the applications you selected have been updated.

Package Download and Upgrade Event Notifications

You can receive a notification whenever a package download or upgrade event takes place. To configure and subscribe to these notifications, complete the steps described in the Cisco DNA Center Platform User Guide's "Work with Event Notifications" topic. When completing this procedure, ensure that you select and subscribe to the SYSTEM-SOFTWARE-UPGRADE event.

A notification is generated and sent when:

  • The download of a package upgrade failed. This typically happens because your Cisco DNA Center appliance doesn't have the necessary disk space or you're attempting to download a corrupted package.

  • The installation of a package upgrade failed (possibly because the service that's associated with the package is currently down).

  • The download or installation of a package upgrade succeeded.


    Note

    A notification is sent only if the previous attempt to complete the operation failed.

Uninstall an Application

Cisco DNA Center treats individual applications as separate from the core infrastructure. Specifically, individual packages for applications can be uninstalled from Cisco DNA Center.

You can uninstall only packages for applications that are not system critical.

Before you begin

Only a user with SUPER-ADMIN-ROLE permissions can perform this procedure. For more information, see About User Roles.

Procedure

Step 1

Click the menu icon () and choose System > Software Management.

Step 2

Click the Currently Installed Applications link to view all of the applications that are installed on your Cisco DNA Center appliance.

Step 3

For the package that you want to remove, click its Uninstall link.

Note

 

You cannot uninstall multiple packages simultaneously.

Step 4

Confirm that you want to remove the application by clicking Uninstall.

Cisco DNA Center displays a message after the application has been removed.