This document provides information about the product overview and patch installation instructions.

Overview

Cisco Crosswork Planning provides tools to create and maintain a model of the current network through the continual monitoring and analysis of the network, and the traffic demands that are placed on it. At a given time, this network model contains all relevant information about a network, including topology, configuration, and traffic information. You can use this information as a basis for analyzing the impact on the network due to changes in traffic demands, paths, node and link failures, network optimizations, or other changes.

Cisco Crosswork Planning includes design and planning tools that help network engineers and operators predict growth in their network, simulate failures, and optimize design to meet performance objectives while minimizing cost.

Resolved bugs

In this release, only the Crosswork infrastructure has been upgraded to version 7.0.3 and no bugs have been fixed in the Cisco Crosswork Planning application. For a detailed list of bugs fixed in Cisco Crosswork Infrastructure 7.0.3, see the Cisco Crosswork Network Controller 7.0.3 Release Notes.

Patch installation workflow

This section provides the high-level workflow for installing the 7.0.3 patch file from the Cisco Crosswork Planning UI.

You can upgrade to Cisco Crosswork Planning version 7.0.3 from either version 7.0 or 7.0.2.

Table 1. Patch installation workflow

Step

Action

1. Ensure that your environment meets all the installation prerequisites.

Refer to the guidelines in Installation prerequisites.

2. Extract and validate the 7.0.3 patch file.

Refer to the guidelines in Extract and validate 7.0.3 patch file.

3. Copy and execute the Crosswork Infrastructure MOP script.

Refer to the guidelines in Copy and execute the Crosswork Infrastructure MOP.

4. Add and install the Crosswork Infrastructure 7.0.3 patch file in the Cisco Crosswork Planning UI.

Refer to the guidelines in Add and install 7.0.3 patch file.


Caution


The upgrade process is disruptive and should be performed during a maintenance window. The time required for the applications to restart is typically less than 30 minutes. If you encounter any error while installing the patch, contact the Cisco Customer Experience team before attempting to move forward with the next step.


Installation prerequisites

This section describes the installation prerequisites needed to install the Cisco Crosswork Planning 7.0.3 patch.

  • Ensure that the target system has Cisco Crosswork Planning 7.0 or 7.0.2 installed. For instructions, see Cisco Crosswork Planning 7.0 Installation Guide.

  • Ensure that you have your Cisco Crosswork Administrator user credentials.

  • Ensure that you have the Management IP address used for your Crosswork VM deployment.

  • Take a backup of your data. Additionally, ensure that the server being patched has sufficient space to unarchive and copy the MOP scripts. Make sure to clean up at least 5 GB of space in the /home/cw-admin/ directory and 1 GB of space in the /tmp/ directory to prevent any space constraints during script execution.

  • Ensure that you have disabled periodic sync before infrastructure MOP and infrastructure patch are applied.


Caution


The upgrade process is disruptive and should be performed during a maintenance window. The time required for the applications to restart is typically less than 30 minutes. If you encounter any error while installing the patch, contact the Cisco Customer Experience team before attempting to move forward with the next step.


Download the patch files

This section provides an overview of the patch files related to the Cisco Crosswork Planning 7.0.3 release.

Review the list and download the required patch file from the Cisco Software Download page to a local machine. Ensure that this machine can be accessed via scp by Crosswork.

  • Crosswork Infrastructure MOP file: signed-cw-na-infra-7.0.3-MOP_250526.tar.gz

  • Crosswork Infrastructure Patch file: signed-cw-na-infra-patch-7.0.3-19-release_250609.tar.gz

Extract and validate 7.0.3 patch file

This section explains how to extract and validate the downloaded 7.0.3 patch file.


Attention


It is crucial that you extract the .tar.gz file from the signed file. You must add and install this specific file through the Cisco Crosswork Planning Ul.


Procedure


Step 1

After downloading the patch file (signed-cw-na-infra-patch-7.0.3-19-release_250609.tar.gz), navigate to the folder where the tar file was downloaded.

cd <folder where the tar file was downloaded>

Step 2

Extract the file using this command.

tar -xzvf <signed image file>

Example:

tar -xzvf signed-cw-na-infra-patch-7.0.3-19-release_250609.tar.gz

The file unpacks into the patch and the necessary tools to validate its contents.

Output:

README
cw-na-infra-patch-7.0.3-19-release_250609.tar.gz
cw-na-infra-patch-7.0.3-19-release_250609.signature
CW-CCO_RELEASE.cer
cisco_x509_verify_release.py3
cisco_x509_verify_release.py

Step 3

Validate the extracted patch file using this command.

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

Important

 
You must include this command as a single line, and the tool will wrap it according to the screen width.

Example:

python3 cisco_x509_verify_release.py3 -e CW-CCO_RELEASE.cer -i cw-na-infra-patch-7.0.3-19-release_250609.tar.gz 
-s cw-na-infra-patch-7.0.3-19-release_250609.tar.gz.signature -v dgst -sha512

Output:

Retrieving CA certificate from http://www.cisco.com/security/pki/certs/crcam2.cer ...
Successfully retrieved and verified crcam2.cer.
Retrieving SubCA certificate from http://www.cisco.com/security/pki/certs/innerspace.cer ...
Successfully retrieved and verified innerspace.cer.
Successfully verified root, subca and end-entity certificate chain.
Successfully fetched a public key from CW-CCO_RELEASE.cer.
Successfully verified the signature of cw-na-infra-patch-7.0.3-19-release_250609.tar.gz using CW-CCO_RELEASE.cer

Copy and execute the Crosswork Infrastructure MOP

This section explains how to copy and execute the Crosswork Infrastructure 7.0.3 MOP file, signed-cw-na-infra-7.0.3-MOP_250526.tar.gz.

Before you begin

Extract and validate the Crosswork Infrastructure MOP file, signed-cw-na-infra-7.0.3-MOP_250526.tar.gz, using the instructions in Extract and validate 7.0.3 patch file.

Procedure


Step 1

Copy the extracted MOP file using SCP to the /home/cw-admin/ folder on the Crosswork VM.

scp {MOP file} cw-admin@{Crosswork VIP Address}:/home/cw-admin/

Example:

scp cw-na-infra-7.0.3-MOP_250526.tar.gz cw-admin@{Crosswork VIP address}:/home/cw-admin

Step 2

SSH into the Crosswork VM where you copied the files, and change to root using the sudo su - command.

Step 3

Extract the MOP file.

tar -xzvf <MOP file>

Example:

cd /home/cw-admin
tar -xvf cw-na-infra-7.0.3-MOP_250526.tar.gz

Output:

signed-cw-na-k8s-orchestrator-7.0.3-10-release-250611.tar.gz
update_orch.sh
logRotate_fix.sh
disable_unattended_upgrades.sh

Step 4

Update the permissions.

chmod 755 update_orch.sh

Step 5

Run the script file.

./update_orch.sh

When you run the script, you will be asked for the password for the cw-admin user account.

Note

 

Do not enter the password multiple times, even if prompted repeatedly. The script will automatically reuse the password provided during the initial input.

Wait for 10 to 15 minutes for the update to complete and verify that the system is healthy.


Add and install 7.0.3 patch file

This sections explains how to add and install the 7.0.3 patch file in the Cisco Crosswork Planning UI.


Important


A patch upgrade is only supported if Cisco Crosswork Planning 7.0 or 7.0.2 version is already installed on the target system.


Before you begin

Extract and validate the required patch file using the instructions in Extract and validate 7.0.3 patch file.

Procedure


Step 1

From the main menu of the Cisco Crosswork Planning UI, choose Administration > Crosswork Manager. Then, select the Application management tab. The Crosswork Platform Infrastructure and the applications that are added are displayed here as tiles.

Step 2

Click the Add File (.tar.gz) option to add the patch file that you extracted (cw-na-infra-patch-7.0.3-19-release_250609.tar.gz).

Attention

 

It is crucial that you extract the .tar.gz file from the signed file. You must add and install this specific file through the Cisco Crosswork Planning Ul.

The Add File (tar.gz) via Secure Copy popup window is displayed.

Step 3

Enter the relevant information and click Add.

Step 4

Once the patch 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 the Job history tab to see the progress of the upgrade operation.

Step 5

After the installation is complete, go to Administration > Crosswork Manager, and confirm all the applications are reporting a Healthy status.

Note

 

It is expected that some processes will be reported as unhealthy or degraded as the upgrade is deployed (an updated status may take up to 30 minutes before reporting). If, after 30 minutes, the status does not change to Healthy, contact your Cisco Customer Experience representative. It is recommended to wait until the system is back to Healthy status before proceeding to install the next patch file.


Security

Cisco is committed to ensuring all our products conform to the latest industry recommendations. We firmly believe that security is an end-to-end commitment and are here to help secure your entire environment. Please work with your Cisco account team to review the security profile of your network.

For details on how we validate our products, see Cisco Secure Products and Solutions and Cisco Security Advisories.

If you have questions or concerns regarding the security of any Cisco products, please open a case with the Cisco Customer Experience team and include details about the tool being used and any vulnerabilities it reports.

Support and downloads

The Cisco Support and Downloads website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies.

Access to most tools on the Cisco Support and Downloads website requires a Cisco.com user ID and password.

For more information, visit https://www.cisco.com/c/en/us/support/index.html.

Communications, Services, and Additional Information

  • To receive timely, relevant information from Cisco, sign up at Cisco Profile Manager.

  • To get the business results you’re looking for with the technologies that matter, visit Cisco Services.

  • To submit a service request, visit Cisco Support.

  • To discover and browse secure, validated enterprise-class apps, products, solutions and services, visit Cisco DevNet.

  • To obtain general networking, training, and certification titles, visit Cisco Press.

  • To find warranty information for a specific product or product family, access Cisco Warranty Finder.

Cisco Bug Search Tool

Cisco Bug Search Tool (BST) is a web-based tool that acts as a gateway to the Cisco bug tracking system that maintains a comprehensive list of defects and vulnerabilities in Cisco products and software. BST provides you with detailed defect information about your products and software.