First Published: December 21, 2021

Last Updated: March 4, 2022

This document provides information about Crosswork Data Gateway 3.0.2, including features, compatibility information and updates.

Product Overview

Crosswork Data Gateway is a model-driven scalable data collection platform that enables real-time data collection from multi-protocol capable devices, thereby reducing the need for multiple collection points for multiple applications requiring data from the network.

Crosswork Data Gateway offers central visibility into services collecting data and the type of data being collected.

Cisco Crosswork Data Gateway is not a standalone product and is expected to be used with Crosswork on-premise or Crosswork Cloud applications. There is no separate software license needed for Cisco Crosswork Data Gateway.

Release Details

Cisco releases updated builds of Crosswork Data Gateway on the Cisco Support & Software Download site.

Cisco Crosswork Data Gateway can be installed into a data center using either the Cisco Cloud Services Platform (CSP) or VMware. The file used for deployment is unique to each of these environments. Use:

  • *.ova file - to install Crosswork Data Gateway on VMware.


    Note

    When using the latest Mozilla Firefox version to download the .ova image, if the downloaded file has the extension as .dms, change the extension back to .ova before installation.

  • *.qcow2 file - to deploy Crosswork Data Gateway on Cisco Cloud Services Platform (CSP).

Features and Enhancements in Crosswork Data Gateway 3.0.2

This section lists the features and enhancements delivered in this release.

Table 1. New Features in Crosswork Data Gateway 3.0.2

Feature

Description
Enhanced Monitoring and Troubleshooting

Added the Diagnostics sub-menu in the Interactive Console of the Crosswork Data Gateway VM to view the state and health of the Crosswork Data Gateway VM.

The following bugs were resolved in this release:

  • CSCwa95058: Image-manager to controller-gateway timeout issue while downloading images

  • CSCwa47257: Vulnerability in Apache Log4j Library Affecting Cisco Products: December 2021

  • CSCwa40432: Refactor tcpdump filter option to work with bash quote handling

  • CSCwa38262: Reboot counter issue

Compatibility Information

Crosswork Data Gateway release 3.0.2 has been validated for use with the following Crosswork Cloud applications:

  • Cisco Crosswork Trust Insights

  • Cisco Crosswork Traffic Analysis

You can deploy Crosswork Data Gateway as a VM on a host that meets the following minimum requirements:

Table 2. Crosswork Data Gateway 3.0.2 VM Requirements for Cloud Applications

Requirement

Description

Data Center

VMware

  • VMware vCenter Server 7.0, ESXi 7.0 installed on hosts.

  • VMware vCenter Server 6.7 (Update 3g or later), ESXi 6.7 Update 1 installed on hosts

    Note 
    Support for VMware vCenter Server 6.5 is deprecated.

Cisco CSP

  • Cisco CSP 2.8.0.276 or later

    Allowed_hardware_list = ['CSP-2100', 'CSP-2100-UCSD', 'CSP-2100-X1', 'CSP-2100-X2','CSP-5200', 'CSP-5216', 'CSP-5228','CSP-5400', 'CSP-5436', 'CSP-5444', 'CSP-5456']

Memory

32 GB

Total Disk space

74 GB

vCPU

8

Interfaces

Minimum: 1

Maximum: 3

Crosswork Data Gateway can be deployed with either 1, 2, or 3 interfaces as per the combinations below:

No. of NICs

vNIC0

vNIC1

vNIC2
1

  • Management Traffic

  • Control/Data Traffic

  • Device Access Traffic

—

—
2*

  • Management Traffic

  • Control/Data Traffic

  • Device Access Traffic

—
3*

  • Management Traffic

  • Control/Data Traffic

  • Device Access Traffic

  • Management traffic: for accessing the UIs and command line and passing configuration information between servers (for example, a Crosswork application to Crosswork Data Gateway)

  • Control/Data traffic: for data and configuration transfer between Crosswork Data Gateway and Crosswork applications.

  • Device access traffic: for device management and telemetry data.

(*) - For live deployments, we recommend 3 NIC deployment, that is one interface for all management traffic (VMs to DNS, NTP, and the network you will use to access and manage the applications), second interface for the data network (connection between Cisco Crosswork and the Cisco Crosswork Data Gateway VM) and and third interface to communicate with devices in the network.

IP Addresses

1, 2, or 3 IPv4/IPv6 addresses based on the number of interfaces you choose to use.

Note 
Cisco Crosswork does not support dual stack configurations. Therefore, ALL addresses for the environment must be either IPv4 or IPv6.

NTP Servers

The IPv4/IPv6 addresses or host names of the NTP servers you plan to use. If you want to enter multiple NTP servers, separate them with spaces. These should be the same NTP servers you use to synchronize devices, clients, and servers across your network. Confirm that the NTP IP address or host name is reachable on the network or installation will fail.

The Crosswork Cloud application and Crosswork Data Gateway VM must must be synchronized to an NTP server, or enrollement with Crosswork Cloud may not go through.

DNS Servers

The IPv4/IPv6 addresses of the DNS servers you plan to use. These should be the same DNS servers you use to resolve host names across your network.

DNS Search Domain

The search domain you want to use with the DNS servers (for example, cisco.com). You can only have one search domain.

Related Documentation

The following table lists the guides provided for Cisco Crosswork Data Gateway 3.0.2 for Cloud applications.

Document Title

What is included

Cisco Crosswork Data Gateway 3.0.2 Release Notes

This document.

Provides an overview of the product, compatibility information, and important information that should be taken into consideration before using the product.

Cisco Crosswork Data Gateway 3.0.2 Installation and Configuration Guide for Cloud Deployment

  • System requirements

  • Installation prerequisites

  • Installation instructions

  • Upgrade instructions

  • Uninstalling Crosswork Data Gateway

  • Configure Crosswork Data Gateway

Additional Related Documentation

This section provides links to additional related documentation for Cisco Crosswork Data Gateway 3.0.2.

You can access documentation for all Cisco Crosswork products at https://www.cisco.com/c/en/us/support/cloud-systems-management/crosswork-network-automation/tsd-products-support-series-home.html.

Cisco Crosswork API Documentation

Advanced users can extend Cisco Crosswork product functions by using the product APIs. For more about the product APIs, see Cisco Crosswork Network Automation API Documentation on Cisco DevNet.

Accessibility Features

All product documents are accessible except for images, graphics and some charts. If you would like to receive the product documentation in audio format, braille, or large print, contact accessibility@cisco.com.

If any product document could not be converted to the accessible formats, please contact the Cisco Customer Experience team.

Obtain Documentation and Submit a Service Request

For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation.

To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the Cisco Notification Tool.