Cisco Crosswork Optimization Engine 1.1.x Release Notes

This document provides an overview of Cisco Crosswork Optimization Engine, new features, and any limitations for this release.

Overview of Cisco Crosswork Optimization Engine

Network operators are facing challenges to support the exponential growth of network traffic while addressing the pressure to efficiently run network operations. Providing quick service and network resolutions is vital for the business to remain viable. Network operators need a toolset to help automate bandwidth optimization and efficiently steer traffic with little operator intervention. Cisco Crosswork Optimization Engine fulfills this need by providing real-time network optimization capabilities that allow operators to effectively maximize network utility as well as increase service velocity.

In a typical lifecycle, there is always a feedback loop that traditionally is done manually through human intervention. With network automation, the objective is to automate the feedback loop to enable quicker reaction to network events and faster determination on actions to perform on the network. Looking at the following figure, Crosswork Optimization Engine is built to fulfill the need for a closed-loop optimization loop as described under “Near Real-Time Feedback Loop”. Through Crosswork Optimization Engine, the operator would be able to define the optimization intent, implement the intent, and continuously monitor, track, and react to maintain the original intent.

Figure 1. Network Resolution Lifecycle
Network Resolution Lifecycle

Real-time Visibility

End-to-end visibility is important to any network operator to run their network effectively. Crosswork Optimization Engine not only provides this visibility, but also the ability to visualize the network across different layers (optical to IP) and the relationship between each layer. Crosswork Optimization Engine leverages IETF-standard BGP-LS protocol to discover IP network automatically, including the following features:

  • Real-time visibility: Provides the network operator with a true representation of the actual topology

  • Hierarchical topology view: Enables operators to define the different levels of granularity in the topology visualization

Simplified SR Policy and RSVP-TE Tunnel Lifecycle Management

Crosswork Optimization Engine also provides an easy to use UI to manage the TE tunnel lifecycle. The UI enables the network operator to perform the following tasks:

  • Create, modify, and remove TE tunnels using an intuitive workflow

  • Continuously track TE tunnel dynamic path computations to maintain SLA objectives

  • Preview a TE tunnel before deploying it to the network

Extensibility through Function Packs

In Crosswork Optimization Engine 1.1, there are two function packs available for purchase: Bandwidth on Demand (BWoD) and Bandwidth Optimization (BWopt). For information on these function packs and instructions on how to use and enable them, see the Cisco Crosswork Optimization Engine Function Packs document.

Change History

The following table lists updates since the initial release of Cisco Crosswork Optimization Engine 1.1.

Table 1. Change History




The following bugs have been resolved in the Cisco Crosswork Optimization Engine 1.1.1 Patch:

The following bug has been resolved in the Cisco Crosswork Optimization Engine 1.1.2 Patch:

Removed Open Bugs table. To search for bugs, see Cisco Bug Search Tool.

Crosswork Patch Framework

There are three types of patches in Crosswork Optimization Engine:

  • Crosswork Application Patching (PATCH_IMAGE): This is a patch on the Crosswork applications such as Crosswork Optimization Engine, and the configuration packages within the application layer. One or more applications can be patched simultaneously.

  • Crosswork Data Gateway Patching (PATCH_CDG): This is a patch on the collector images for Cisco Crosswork Data Gateway VM.

  • Crosswork Data Patching (PATCH_DATA): This is a patch to dynamically update the pre-built set of fundamental data such as YANG models and system MIB packages used by the Crosswork applications.

The patch versioning is done in the [MAJOR: MINOR: PATCH] format, where MAJOR corresponds to every major release of the Crosswork Optimization Engine, MINOR corresponds to every critical (backward incompatible) change made during a release, and PATCH corresponds to every patch created in a release.

The unit of a patch is a TAR file. The TAR file consists of the patch metadata, list of docker images, checksum and signature. The metadata contains platform and product details, patch version, type of patch and other creation details. Signature is a security requirement in order to safeguard the patch; the signature is verified by the patch framework. It also helps to perform error correction mechanisms and detect if the patch is corrupted or not.

The platform orchestrator (such as Robot orchestrator) maintains and manages the lifecycle of all applications in the Crosswork platform. Each Crosswork product has its own centralized manifest file <orchmanifest.json> which contains the list of applications and the corresponding configurations. When the orchestrator is up, it goes through the manifest. Along with the manifest, the dependency diagram <orch.yaml> explains the logical grouping of applications and their dependencies. Currently, simultaneous application patching is possible as the applications are independent of each other. Patching the Collection Infra is a system-wide change and requires shutting down other dependent applications. A patch on the Core Infra is not allowed and is considered as a VM upgrade. Schema changes are not allowed during patching. Users are recommended to take backup of the system before patching, to restore in case of any error.

Patching Activation Workflow:

Before You Begin

  • Delete existing Providers and devices from the Crosswork Optimization Engine installation, if applicable.

Each stage of the patching workflow, performed using APIs, are explained below:

  1. Validate

    • API: /crosswork/platform/v1/patch/validate

    • User downloads the patch to any reachable host from the Crosswork VM. After the download, the patch is validated for accuracy and compatibility to the product version.

  2. Add

    • API: /crosswork/platform/v1/patch/add

    • After the patch is validated, it is added to the corresponding registry in the system, such as updating the IMAGE registry in case of an IMAGE patch. The add operation prepares the system for the patch to be activated. It is an asynchronous operation and may take around 15 mins. Once add is initiated, user receives a corresponding job ID and the operation is performed in the background.

  3. Status

    • There are 2 status APIs:

    • Status - which displays the current status of the Patch framework.

      • API: /crosswork/platform/v1/patch/status

      • This API displays the current status of the patch framework, such as if add is successful or ongoing, or if activate has been triggered.

    • Job Status - which displays the specific job status.

      • API: /crosswork/platform/v1/patch/jobstatus

      • This API return the status of a specific job based on the Job ID.

  4. Activate

    • API: /crosswork/platform/v1/patch/activate

    • After successful addition, the patching is locked. If a patch is added, it needs to be activated before another patch can be added to the application. Activate, like add, is an asynchronous operation that generates a job ID for the user and continues the process in the background. Activation takes the backup of the current state and updates the configuration. If the patch fails, the auto-roll back functionality rolls back to the previous version and the status is updated with the failure details.

  5. Summary

    • API: /crosswork/platform/v1/patch/summary

    • Summary provides the overall summary of the Patch framework, and summary of the different patch types including patch version. This information changes each time a new patch is added and activated:

      • PATCH_IMAGE - Patch version and the applications changed as part of the patch.

      • PATCH_CDG - Patch version

      • PATCH_DATA - Patch version and the applications to which the new data has been uploaded.

  6. Remove

    • API: /crosswork/platform/v1/patch/remove

    • A patch can be removed in 2 ways:

      • Flow 1: A patch can be removed after it is validated and added. For example, if user chooses to cancels after the add is successful, remove can be used.

      • Flow 2: A patch can be removed after it is validated, added and activated. For example, if user chooses to go back to a previous version after a patch is applied successfully, remove can be used.

  7. Add Providers and devices back to Crosswork Optimization Engine.

For more information, refer the Swagger file for Payload in!platform.

Upon successful activation of a patch, user can verify the health of the application using the Crosswork Manager or Data Gateway Management feature in Crosswork Optimization Engine, depending on the type of the patch. For more information, see the Perform Administrative Tasks chapter in the Cisco Crosswork Optimization Engine User Guide .

What's New in Cisco Crosswork Optimization Engine 1.1

This section lists the new features delivered in Cisco Crosswork Optimization Engine 1.1. Throughout this document TE tunnels refer to both SR policies and RSVP-TE tunnels.

TE Tunnel and Network Visualization

  • Support for RSVP-TE Tunnel visualization.

  • Segment hops for selected SR policies are shown by default.

  • Ability to change display settings for links, devices, and TE tunnel metrics using the Display Preferences icon available from the topology map.

  • Topology map icons have changed.

  • Associated node SID and adjacency SID values are displayed when hovering over a selected policy in the SR Policies table. Also, hovering over a policy, de-emphasizes other selected policies.

  • Configuration and management of Custom Maps have changed.

  • In a multiple IGP setup, you can view all IGP, ISIS, and OSPF processes. To do this, click on a device icon to open the Device Details window.

TE Tunnel Provisioning

  • Support for RSVP-TE Tunnel provisioning.

  • When creating TE tunnels, the headend and endpoint node IP addresses (along with the host name) are displayed during selection.

  • Node Prefix has been added to the SR policy details and provisioning windows.

  • Node IP information is displayed in the TE tunnel details window.

  • Configuration of affinity mapping while provisioning an SR policy has been made easier.

TE Tunnel Tables

  • A new icon to clear all selections in the table has been added.

  • Columns can be filtered.

  • Filters and selections are saved. When navigating

  • Details link has been replaced with an icon.

  • Ability to export TE tunnel information as a CSV file.

  • Additional attribute columns are available and can be hidden or displayed.

Function Packs

  • Ability to set bandwidth threshold for individual interfaces in Bandwidth Optimization (BWOpt). Previously, only one threshold value could be set for the network.

  • Ability to set a number of parallel tactical policies that BWOpt can create between the same source and destination to obtain the utilization threshold. This feature allows for a higher success rate of creating tactical policies when elephant demands (traffic demands that are larger than the available link capacity) are in the network since it allows traffic to be split up.

  • New Traffic Matrix (TM) Deduction function pack that allows customers to add demands to the Cisco Crosswork Optimization Engine model without a demand matrix derived from Segment Routing Traffic Matrix (SRTM). For more information about this feature contact your Cisco Crosswork Optimization Engine representative.


For a list of available APIs, see Cisco Crosswork Network API Documentation on Cisco DevNet.

Inventory Management

  • Inventory Key usage is deprecated for Cisco Crosswork Optimization Engine 1.1.

  • Information about elements impacted has been added to the job information.

  • Search Criteria support has been added.

Monitor and Troubleshoot

  • Smart licensing registration, and integration with Cisco Smart Software Manager (direct mode, on-prem and proxy support).

  • Backup and restore support for database and configuration.

  • Ability to update the default user properties.

  • Lightweight Directory Access Protocol (LDAP) server support for OpenLDAP.

  • API grouping for user role creation.

  • Password policies updated.

Collection Services

  • Cisco Crosswork Data Gateway is used as the scalable collection architecture between the network and application to collect data.

  • Support for CLI, SNMP and MDT data collection methods.

  • Ability to optimize collection requests to reduce redundancy.

  • External data destination support for third party applications (Kafka, gRPC) access to network data.

  • Ability to monitor collection jobs.

  • Custom device package support for third party device data collection.

Cisco Bug Search Tool

You can use the Cisco Bug Search Tool to search for a specific bug or to search for all bugs in a release.

  1. Go to the Cisco Bug Search Tool.

  2. Enter your registered username and password, and click Log In.

    The Bug Search page opens.


    If you do not have a username and password, you can register here.

  3. Use any of these options to search for bugs, and then press Enter (Return) to initiate the search:

    — To search for a specific bug, enter the bug ID in the Search For field.

    — To search for bugs based on specific criteria, enter search criteria, such as a problem description, a feature, or a product name, in the Search For field.

    — To search for bugs based on products, enter or choose the product from the Product list. For example, enter Cisco Crosswork Optimization Engine.

    — To search for bugs based on releases, in the Releases list choose whether to search for bugs affecting a specific release, bugs that were fixed in a specific release, or both. Then enter one or more release numbers in the Releases field.

  4. When the search results are displayed, use the filter tools to narrow the results. You can filter the bugs by status, severity, and so on.


To export the results to a spreadsheet, click Export Results to Excel.