Installing Software Maintenance Update

Installing Software Maintenance Update on Cisco DCNM 11.4(1) to use Network Insights for Resources Application

After installing Cisco DCNM, you can download and install various applications from the Cisco App Center. In Cisco DCNM 11.4(1) LAN Fabric installation, to use Network Insights for Resources (NIR) Release 2.2.2 or later, install the latest software maintenance update. For a Cisco DCNM Native HA clustered deployment, apply the update on the Active and Standby nodes only. You need not update the Compute nodes.

To download, add, start, stop, and delete applications from the Cisco DCNM Web UI, choose Applications > Catalog > Browse App Center. Refer to Installing and Deploying Applications for instructions.


Note

Cisco DCNM allows you to upload the NIR 2.2.2 application without the maintenance update. However, you cannot start the application. An error appears asking you to install the maintenance update (patch) before using the NIR 2.2.2 application.


Note

Only a root user must install the maintenance update (patch) on the Cisco DCNM 11.4(1).

To apply the maintenance update to use NIR 2.2.2 application with Cisco DCNM LAN Fabric installation in Native HA mode, perform the following steps:

Before you begin

  • Ensure that both the Cisco DCNM 11.4.1(1) Active and Standby peers are up and running.

  • Check and ensure that the Active and Standby servers are operational, using the appmgr show ha-role command.

    Example:

    On the Active node:
    dcnm1# appmgr show ha-role
Native HA enabled.
Deployed role: Active
Current role: Active
    On the Standby node:
    dcnm2# appmgr show ha-role
Native HA enabled.
Deployed role: Standby
Current role: Standby

Procedure

Step 1

Download the maintenance update (patch).

  1. Go to the following site: http://software.cisco.com/download/.

    A list of the latest release software for Cisco DCNM available for download is displayed.

  2. In the Latest Releases list, choose Release 11.4(1).

  3. Locate DCNM 11.4(1) LAN Fabric maintenance update for Network Insights for Resources (NIR 2.2.2+) and click Download icon.

  4. Save the dcnm-va.11.4.1-p1.iso.zip file to your directory that is easy to find when you start to apply the maintenance update (patch).

Step 2

Unzip the dcnm-va.11.4.1-p1.iso.zip file and upload the file to the /root/ folder in both Active and Standby node of the DCNM setup.

Note 
For example, let us indicate Active and Standby appliances as dcnm1 and dcnm2 respectively.
Step 3

Log on to the Cisco DCNM appliance using SSH as a sysadmin user.

Run the su command to enable root user. 

dcnm1# su
Enter the root password: 
[root@dcnm1]#
dcnm2# su
Enter the root password: 
[root@dcnm2]#
Step 4

Run the following command to create a screen session.

[root@dcnm1]# screen

[root@dcnm2]# screen

This creates a session which allows you to execute the commands. The commands continue to run even when the window is not visible or if you get disconnected.

Step 5

On the Active node, apply the patch.

  1. Create a folder named iso using the mkdir /mnt/iso command. 

    [root@dcnm1]# mkdir -p /mnt/iso

  2. Mount the DCNM 11.4(1) patch file on the Active node in the /mnt/iso folder. 

    [root@dcnm1]# mount dcnm-va.11.4.1-p1.iso /mnt/iso

  3. Navigate to /scripts/ directory. 

    [root@dcnm1]# cd /mnt/iso/packaged-files/scripts/

  4. Run the ./inline-upgrade.sh script. 

    [root@dcnm1]# ./inline-upgrade.sh

============================================================
============ Inline Upgrade to DCNM 11.4(1)-p1 =============
============================================================
Upgrading from version: 11.4(1)
Upgrading from install option: LAN Fabric
System type: HA
Compute only: No

Do you want to continue and perform the inline upgrade to 11.4(1)-p1? [y/n]: y
==== Sat Jul 25 15:48:12 PDT 2020 - Task confirmRootPassword started ====
==== Sat Jul 25 15:48:12 PDT 2020 - Task confirmRootPassword finished ====
==== Sat Jul 25 15:48:12 PDT 2020 - Task checkAfwStatus started ====
==== Sat Jul 25 15:48:12 PDT 2020 - Task checkAfwStatus finished ====
==== Sat Jul 25 15:48:12 PDT 2020 - Task backupLocalDB started ====
==== Sat Jul 25 15:48:12 PDT 2020 - Taking DB backup ====
Collecting DB dump...
==== Sat Jul 25 15:48:14 PDT 2020 - Task backupLocalDB finished ====
==== Sat Jul 25 15:48:14 PDT 2020 - Task updateCompliance started ====
Uploading image
Deploying new image
{"ResponseType":0,"Response":""}
{"ResponseType":0,"Response":""}
{"ResponseType":0,"Response":""}
{"ResponseType":0,"Response":""}
{"ResponseType":0,"Response":""}
{"ResponseType":0,"Response":""}
Deleting old image
==== Sat Jul 25 15:52:06 PDT 2020 - Task updateCompliance finished ====
==== Sat Jul 25 15:52:06 PDT 2020 - Task updatePackagedFiles started ====
==== Sat Jul 25 15:52:06 PDT 2020 - Updating packaged-files ====
==== Sat Jul 25 15:52:06 PDT 2020 - Task updatePackagedFiles finished ====
==== Sat Jul 25 15:52:06 PDT 2020 - Task updatePatchList started ====
==== Sat Jul 25 15:52:06 PDT 2020 - Task updatePatchList finished ====
==== Sat Jul 25 15:52:06 PDT 2020 - Task updateTelemetryInfra started ====
Preparing...                          ########################################
Updating / installing...
telemetry-infra-1.0-2                 ########################################
Cleaning up / removing...
telemetry-infra-1.0-1                 ########################################
Created symlink from /etc/systemd/system/telemetry-infra.service to /usr/lib/
systemd/system/telemetry-infra.service.
Created symlink from /etc/systemd/system/multi-user.target.wants/
telemetry-infra.service to /usr/lib/systemd/system/telemetry-infra.service.
Restarting Telemetry Infra ...
Stopped Telemetry Infra...
Started Telemetry Infra...
Check the status using 'appmgr status telemetry-infra'
==== Sat Jul 25 15:52:08 PDT 2020 - Task updateTelemetryInfra finished ====
==== Sat Jul 25 15:52:08 PDT 2020 - Task restartFMServer started ====
==== Sat Jul 25 15:53:14 PDT 2020 - Task restartFMServer finished ====
==== Sat Jul 25 15:53:14 PDT 2020 - Task completeUpgrade started ====

***********************************************************************************
Inline upgrade of this Active DCNM node is complete.
Please wait until this node is Active again
before upgrading the Standby node.
***********************************************************************************

==== Sat Jul 25 15:53:14 PDT 2020 - Task completeUpgrade finished ====
    Note 

    After the patch is applied successfully, the DCNM process restarts. This results in a momentary loss of access to the DCNM Web UI.

  5. Ensure the DCNM application is functional, by using the appmgr status all command. 

    [root@dcnm1]# appmgr status all
    Note 

    Ensure that all the services are up and running on the Cisco DCNM Active node before proceeding to apply patch on the Standby node.

Step 6

On the Standby node, apply the patch.

  1. Create a folder named iso using the mkdir /mnt/iso command. 

    [root@dcnm2]# mkdir -p /mnt/iso

  2. Mount the DCNM 11.4(1) patch file on the Active node in the /mnt/iso folder. 

    [root@dcnm2]# mount dcnm-va.11.4.1-p1.iso /mnt/iso

  3. Navigate to /scripts/ directory. 

    [root@dcnm2]# cd /mnt/iso/packaged-files/scripts/

  4. Run the ./inline-upgrade.sh script. 

    [root@dcnm2]# ./inline-upgrade.sh --standby

============================================================
============ Inline Upgrade to DCNM 11.4(1)-p1 =============
============================================================

Upgrading from version: 11.4(1)
Upgrading from install option: LAN Fabric
System type: HA
Compute only: No

Do you want to continue and perform the inline upgrade to 11.4(1)-p1? [y/n]: y
==== Sat Jul 25 15:54:53 PDT 2020 - Task confirmRootPassword started ====
==== Sat Jul 25 15:54:53 PDT 2020 - Task confirmRootPassword finished ====
==== Sat Jul 25 15:54:53 PDT 2020 - Task checkAfwStatus started ====
==== Sat Jul 25 15:54:53 PDT 2020 - Task checkAfwStatus finished ====
==== Sat Jul 25 15:54:53 PDT 2020 - Task backupLocalDB started ====
==== Sat Jul 25 15:54:53 PDT 2020 - Taking DB backup ====
Collecting DB dump...
==== Sat Jul 25 15:54:54 PDT 2020 - Task backupLocalDB finished ====
==== Sat Jul 25 15:54:54 PDT 2020 - Task updateCompliance started ====
==== Sat Jul 25 15:54:54 PDT 2020 - Task updateCompliance finished ====
==== Sat Jul 25 15:54:54 PDT 2020 - Task updatePackagedFiles started ====
==== Sat Jul 25 15:54:54 PDT 2020 - Updating packaged-files ====
==== Sat Jul 25 15:54:54 PDT 2020 - Task updatePackagedFiles finished ====
==== Sat Jul 25 15:54:54 PDT 2020 - Task updatePatchList started ====
==== Sat Jul 25 15:54:54 PDT 2020 - Task updatePatchList finished ====
==== Sat Jul 25 15:54:54 PDT 2020 - Task updateTelemetryInfra started ====
Preparing...                          ########################################
Updating / installing...
telemetry-infra-1.0-2                 ########################################
Cleaning up / removing...
telemetry-infra-1.0-1                 ########################################
==== Sat Jul 25 15:54:55 PDT 2020 - Task updateTelemetryInfra finished ====
==== Sat Jul 25 15:54:55 PDT 2020 - Task restartFMServer started ====
==== Sat Jul 25 15:54:55 PDT 2020 - Task restartFMServer finished ====
==== Sat Jul 25 15:54:55 PDT 2020 - Task completeUpgrade started ====

***********************************************************************************
Inline upgrade of the HA DCNM system is complete.
***********************************************************************************

==== Sat Jul 25 15:54:55 PDT 2020 - Task completeUpgrade finished ====

[root@dcnm2]# appmgr show ha-role
Native HA enabled.
Deployed role: Standby

  5. Ensure the DCNM application is functional, by using the appmgr status all command. 

    [root@dcnm1]# appmgr status all
Step 7

Terminate the screen session, by using the exit command.

[root@dcnm1]# exit

[root@dcnm2]# exit
Step 8

Unmount the dcnm-va.11.4.1-p1.iso file in both Active and Standby node of the DCNM setup, by using the umount /mnt/iso command.

Note 

You must terminate the screen session before unmounting the patch file. 

[root@dcnm1]# umount /mnt/iso
[root@dcnm2]# umount /mnt/iso

What to do next

Log on to the DCNM Web UI with appropriate credentials.

Choose Applications > Catalog. Verify the version of the Compliance application. It must show the version as 4.0.1 after successfully installing the maintenance update on Cisco DCNM 11.4(1).


Note

If you try to install the maintenance update again, a note appears stating that the patch is already applied on the Cisco DCNM.

You can now start the NIR 2.2.2 application on the Cisco DCNM Web UI. Refer to Installing and Deploying Applications for instructions.

To use the DCNM tracker feature after installing the maintenance update, install and start the tracker on all the NX-OS switches. Launch the Cisco DCNM Web UI, and choose Control > Fabric Builder. For more information, refer to DCNM Tracker.