First Published: June 28, 2023

This document provides information about Cisco Crosswork Network Controller 4.1.2, including patch release versions for Cisco Crosswork products and their associated defects, and the patch installation workflow.

Patch Release Versions for Cisco Crosswork Products

The patch files (.tar.gz) are available on the Cisco Software Download page.

Table 1. Patch Releases

Cisco Crosswork Product

New Releases with Fix

Defect ID

Crosswork Infrastructure

4.4.2

CSCwe42699

CSCwf01491

CSCwe08981

CSCwe54949

CSCwe11474

CSCwf36299

CSCwe04908

CSCwf68137

CSCwd43193

CSCwf22091

CSCwd66689

CSCwe22037

CSCwf50051

CSCwe54949

CSCwe11474

CSCwe12462

CSCwe32386

CSCwe80159

CSCwe02427

CSCwc82339

CSCwe11474

CSCwe54946

CSCwf36984

Cisco Element Management System (EMS)

4.1.2

CSCwf58757

CSCwf58758

Crosswork Health Insights

4.4.2

CSCwe54949

CSCwf83783

Crosswork Change Automation

4.4.2

CSCwd76567

CSCwd72593

Crosswork Active Topology

4.1.2

CSCwf17871

CSCwe61638

Crosswork Optimization Engine

4.1.2

CSCwe24294

CSCwe63203

CSCwc79966

CSCwd98343

CSCwe27318

CSCwc93346

CSCwd41392

CSCwd44001

Crosswork Zero Touch Provisioning

4.1.2

CSCwe20779

CSCwa54706

CSCwd36347

CSCwd37478

Patch Installation Workflow

This section explains how to install patch files from the Cisco Crosswork UI.

Before you begin, ensure that you have the following:

  • Patch image file (.tar.gz) downloaded from Cisco Software Download to your local machine.

  • Cisco Crosswork Administrator user credentials.

  • Management IP address used for your Crosswork VM deployment.


Important

Please use the following sequence for the patch installation:

  1. Crosswork Infrastructure

  2. Crosswork Optimization Engine

  3. Crosswork Active Topology

  4. Element Management System (EMS)

Note

If you encounter any error while installing the patch, please contact the Cisco Customer Experience team.

Procedure

Step 1

Extract and validate the downloaded image(s): After downloading the patch files you need, extract and validate them.

To extract the signed image package, run the following command: 

tar -xzvf <signed image file>

The signed image package will contain the patch file (.tar.gz) and relevant certificates.

Run the following command to validate the extracted patch file.

python3 cisco_x509_verify_release.py3 -e <.cer file> -i <.tar.gz file> -s <.tar.gz.signature file>
-v dgst -sha512

Step 2

Add and install the patch files in the Crosswork UI:

  1. Click on Administration > Crosswork Management, and select the Application Management tab. The Crosswork Platform Infrastructure and any applications that are added are displayed here as tiles.

  2. Click on the Add File (.tar.gz) option to add the patch file (for example, cw-na-infra-patch-4.4.2-27-release-230718.tar.gz) that you extracted. In the Add File dialog box, enter the relevant information and click Add.

  3. Once the file is added, you can observe the existing application tile displaying an upgrade prompt. Click the upgrade prompt to install the patch file.

    In the Upgrade pop up screen, select the new version that you want to upgrade to, and click Upgrade. Click on Job History to see the progress of the upgrade operation.

  4. Once the installation is complete, go to Administration > Crosswork Manager and confirm all of the applications are reporting Healthy (an updated status may take up to 20 minutes before reporting). If no status change persists, contact your Cisco Customer Experience representative.

Step 3

Install the Crosswork Infrastructure script: After executing the above steps, please execute the additional steps below for full activation of the Crosswork Infrastructure patch file.

Note

 

The following steps are required only for Crosswork Infrastructure 4.4.2 patch and are not needed for any other patch file.

Note

 

Currently, there is no uninstall function for installed applications.

  1. After downloading the Crosswork Infrastructure script (cw-na-infra-script-4.4.2.tar.gz), verify the checksum (either MD5 or SHA512) before proceeding. Hover the cursor over the image file and copy the checksum from cisco.com. Execute the below commands to check the file integrity. 

    cd <directory consisting .tar.gz file>
md5sum ./cw-na-infra-script-4.4.2.tar.gz
(OR)
sha512sum ./cw-na-infra-script-4.4.2.tar.gz

    Compare the checksum displayed against the value copied from cisco.com. If the checksum do not match, please stop and download the file again, and repeat this step. Proceed to next step only after successful match of the checksum.

  2. Uncompress the tar file. 

    cd <folder where tar was download>
tar -xvf ./cw-na-infra-script-4.4.2.tar.gz

    The following files (bash script and instructions) are displayed:

    -- cw-na-infra-script-4.4.2.sh
-- cleanupOldCasLogs.sh
-- README.txt

  3. Execute the following commands from the directory containing the bash script.

    scp ./cw-na-infra-script-4.4.2.sh cw-admin@<cw mgmt-ip>:/home/cw-admin/

    Note

     
    Replace <cw mgmt-ip> with the management IP address used for your Crosswork deployment.

  4. Execute the bash script.

    Note

     

    The infra script must be executed as root (you must have root user privileges).

    Note

     

    The script requires user input, follow instructions as per script execution.

    		 
    cd /home/cw-admin
chmod +x ./cw-na-infra-script-4.4.2.sh
chmod +r ./cleanupOldCasLogs.sh
./cw-na-infra-script-4.4.2.sh

    This script restarts the Crosswork Infrastructure pods that were patched for the new patched image to take effect. Monitor the script and enter yes for each of the pods as prompted.