First Published: September 29, 2025

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

This table lists the resolved issues in this specific software release.

In this release, the Crosswork infrastructure has been upgraded to version 7.1.1. For a detailed list of bugs fixed in Cisco Crosswork Infrastructure 7.1.1, see the Cisco Crosswork Network Controller 7.1.1 Release Notes.

Table 1. Resolved bugs in Cisco Crosswork Planning 7.1.1

Bug ID

Bug description

CSCwp81204

CS RSVP Optimizer tool issue with SRLG disjointness during re-optimization

CSCwq50047

Affinities are not inherited when Include, IncludeAny, or Exclude are configured using the CS-RSVP LSP optimizer

CSCwr00232

Issue encountered with multicast measured traffic levels collection

Patch installation workflow

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

You can upgrade to Cisco Crosswork Planning version 7.1.1 only from version 7.1.

Table 2. Patch installation workflow

Step

Action

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

See Installation prerequisites.

2. Extract and validate the 7.1.1 patch files.

See Extract and validate 7.1.1 patch files.

3. Add and install System OS patch file.

See Add and install System OS patch.

4. Add and install the 7.1.1 patch files in the Cisco Crosswork Planning UI.

See Add and install 7.1.1 patch files.

Upgrade process considerations

The upgrade process is disruptive and must be performed during a maintenance window. While the upgrade is deploying, some processes may temporarily report as unhealthy or degraded. The system status typically updates and applications restart within 30 minutes per application.


Important

  • Wait until the system status reflects "Healthy" before proceeding to install the next patch file.

  • If the system status does not return to "Healthy" within 30 minutes, or 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.1.1 patch.

  • Install Cisco Crosswork Planning 7.1. For installation instructions, see Cisco Crosswork Planning 7.1 Installation Guide.

  • Ensure you have your Cisco Crosswork Administrator user credentials.

  • Ensure you have the Management IP address (either a physical IP address or the Virtual IP address) used for your Crosswork VM deployment.

  • Backup your data. Additionally, ensure that the server being patched has sufficient space to unarchive and copy the files.

    • at least 5 GB of free space in the /home/cw-admin/ directory

    • at least 1 GB of free space in the /tmp/ directory


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.

Patch files

This section provides an overview of the patch files related to the Cisco Crosswork Planning 7.1.1 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 System OS Patch file: signed-cw-system-patch-7.1.1-90.tar.gz

  • Crosswork Infrastructure Patch file: signed-cw-na-infra-patch-7.1.1-28-release_250922.tar.gz

  • Cisco Crosswork Planning Design: signed-cw-na-design-patch-7.1.1-7-release-250730.tar.gz

  • Cisco Crosswork Planning Collector: signed-cw-na-collector-patch-7.1.1-3-release-250829.tar.gz

Extract and validate 7.1.1 patch files

This section explains how to extract and validate the downloaded 7.1.1 patch files.


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 UI.

Procedure

Step 1

Navigate to the folder where the tar file. As an example, consider the Crosswork Infrastructure signed patch image (signed-cw-na-infra-patch-7.1.1-28-release_250922.tar.gz) for this procedure. 

cd <folder where the tar file was downloaded>

Step 2

Extract the signed file using this command.

tar -xzvf <signed image file>

The signed image package contains the patch file (.tar.gz) and relevant certificates for validation.

Example:

tar -xzvf signed-cw-na-infra-patch-7.1.1-28-release_250922.tar.gz

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

Output:

README
cw-na-infra-patch-7.1.1-28-release-250922.tar.gz
cw-na-infra-patch-7.1.1-28-release-250922.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.1.1-28-release-250922.tar.gz 
-s cw-na-infra-patch-7.1.1-28-release-250922.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.1.1-28-release-250922.tar.gz using CW-CCO_RELEASE.cer

Add and install System OS patch

This section explains how to add and install an OS patch (signed-cw-system-patch-7.1.1-90.tar.gz) from the Cisco Crosswork Planning UI.

Before you begin

For non-docker based deployments such KVM, before installing the OS patch, verify that all inventory details are visible in the System summary page.

Procedure

Step 1

Create a new backup if you do not already have one.

Step 2

From the main menu of the Cisco Crosswork Planning UI, click Administration > Crosswork Manager.

Step 3

Click the System Management tab.

Step 4

Click Add OS patch. In the popup window choose either URL or SCP as your preferred protocol. Based on your selection, fill in the additional fields with the required information. Click Add to proceed.

Individual jobs are created to add the patch to repository, and to apply the package to VM.

Step 5

Click System Management > Job History to monitor the status of each job. For details on each node’s operation, open the Job Details page.

Step 6

Once jobs complete successfully, check that the newly added OS patch is listed under the System updates tab.

Step 7

To upgrade an installed OS patch, use the Upgrade button in the System updates tab.

Step 8

(Optional) To see patch details, select the patch file and click Package details. You will see information such as package name, version, and description.

Step 9

(Optional) After all jobs are completed successfully, verify the updated package list for each node by navigating to Administration > Crosswork Manager > System Summary > <Node-Name> > View details > Package details tab.

Note

 

It is normal for some processes will be reported as unhealthy or degraded as the upgrade is deployed. The updated status may take up to 30 minutes to reflect correctly. If, after 30 minutes, the status has not changed to Healthy, contact your Cisco Customer Experience representative. It is recommended to wait until the system is back to Healthy status before proceeding.

Add and install 7.1.1 patch files

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


Important

A patch upgrade is only supported if Cisco Crosswork Planning 7.1 is already installed on the target system.

Before you begin

Extract and validate the required patch files using the instructions in Extract and validate 7.1.1 patch files.

Procedure

Step 1

Create a new backup if you do not already have one.

Step 2

Check the health status of your system. If any components are unhealthy or degraded, resolve the issues or contact your Cisco Customer Experience representative before proceeding.

Step 3

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

Step 4

Click the Add new file > Upload application bundle file (.tar.gz) option to add the patch file that you extracted. As an example, consider Crosswork Infrastructure patch file, cw-na-infra-patch-7.1.1-28-release-250922.tar.gz.

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

Step 5

Enter the relevant information and click Add.

Step 6

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.

Step 7

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 8

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

Note

 

It is normal for some processes will be reported as unhealthy or degraded as the upgrade is deployed. The updated status may take up to 30 minutes to reflect correctly. If, after 30 minutes, the status has not changed to Healthy, contact your Cisco Customer Experience representative. It is recommended to wait until the system is back to Healthy status before proceeding.

Step 9

Repeat steps 3 to 8 to add and install the remaining Cisco Crosswork Planning application patch files that you need.

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.