Cisco Crosswork Data Gateway 2.0.x Release Notes for Cloud Applications

Change History

The following table lists changes to this document since its initial release.

Table 1. Document Change History
Date	Change
2021-12-21	Added details about the Crosswork Data Gateway 2.0.2 patch release.
2021-07-29	Initial Release.

Crosswork Data Gateway, Release 2.0.2

The following table provides details of Crosswork Data Gateway, Release 2.0.2.


Update Type and Version	Date	Description
Patch: Crosswork Data Gateway 2.0.2	2021-12-21	This patch resolves the following defect: CSCwa47257: Vulnerability in Apache Log4j Library Affecting Cisco Products: December 2021

Introduction

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

Cisco Crosswork Data Gateway offers central visibility into services collecting data and the type of data being collected. It can also be used to feed external data destinations (such as, an external Kafka or gRPC server) in addition to Crosswork applications.

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

Use of Cisco Crosswork Data Gateway to forward data to third-party destinations is only supported when using the Crosswork Data Gateway with Crosswork On Premise applications and requires a separate license.

Release Details

Cisco releases updated builds on the Cisco Support & Download site when needed.

Table 2. Crosswork Data Gateway Release Details
Version	File name	Date
2.0.2	`cw-na-dg-2.0.2-26-release-20211214.ova`	2021-12-21
2.0.2	`cw-na-dg-2.0.2-26-release-qcow2-pkg.tar.gz`	2021-12-21
2.0.1	`cw-na-dg-2.0.1-33-release-20210726.ova`	2021-07-29
2.0.1	`cw-na-dg-2.0.1-33-release-20210726-qcow2-pkg.tar.gz`	2021-07-29

Cisco Crosswork Data Gateway can be installed into a data center using either the Cisco 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.
*.qcow2 file - to deploy Crosswork Data Gateway on Cisco Cloud Services Platform (CSP).

New Features and Enhancements in Crosswork Data Gateway 2.0.1

The following table provides details of enhancements provided in the Crosswork Data Gateway 2.0.1 release.

Table 3. Features and Enhancements in Crosswork Data Gateway 2.0.1
Feature	Description
Enable TAC Shell access	Option to enable the dg-tac user for Cloud deployment.
Audit TAC Shell events	Added a new log file tac_shell.log. This log is available in the showtech bundle of the Crosswork Data Gateway VM. Timestamp information of specific TAC shell events such as, enabling and disabling the TAC shell, dg-tac user log in and log out, is logged to this file. The TAC shell events are also sent to the Crosswork Cloud controller.
Deploy Cisco Crosswork Data Gateway on Cisco Cloud Services Platform(CSP) 5000	Option to deploy Cisco Crosswork Data Gateway on Cisco Cloud Services Platform (Cisco CSP) 5000
Option to change the MTU of vNIC2 when deployed with 3 vNICs	Cisco Crosswork Data Gateway provides you the option to change the MTU of vNIC2 when you deploy it with 3 NICs.
Configure timezone of Base VM	Option to configure the operational timezone of the Cisco Crosswork Data Gateway.

Compatibility Information for Crosswork Data Gateway 2.0.1

Crosswork Data Gateway, Release 2.0.1 has been qualified for use with Crosswork Cloud applications only.

Crosswork Data Gateway, Release 2.0.1 has been validated in conjunction with the following Crosswork applications:

Cisco Crosswork Trust Insights
Cisco Crosswork Traffic Analysis

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

Table 4. Cisco Crosswork Data Gateway 2.0.1 VM Requirements for Cloud Deployment

Requirement

Description

Data Center

VMware

VMware vCenter Server 6.7 Update 3g or later (ESXi 6.7 Update 1 installed on hosts)
VMware vCenter Server 6.5 Update 2d or later (ESXi 6.5 Update 2 installed on hosts)

Cisco CSP

Cisco CSP 2.8.0.276 or later

Allowed_hardware_list = ['UCSC-C220-M4S', 'UCSC-C240-M4SX', 'N1K-1110-X', 'N1K-1110-S','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

Disk space

70 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 Interactive console and troubleshooting the Crosswork Data Gateway VM as a dg-tac user
Control/Data traffic: for data and configuration transfer between Crosswork Data Gateway and Crosswork applications and other external data destinations.
Device access traffic: for device management and telemetry data.

(*) - For live deployments, we recommend 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 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 Cisco Crosswork Data Gateway VM must must be synchronized to an NTP server, or the 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.

Cisco Crosswork Data Gateway Documentation

The following table lists the guides provided for Cisco Crosswork Data Gateway 2.0.x:


Document Title	What is included
Cisco Crosswork Data Gateway 2.0.x Release Notes	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 2.0.1 Installation and Configuration Guide for Cloud Deployment	System requirements Installation prerequisites Installation instructions Upgrade instructions Uninstallation Configure Cisco Crosswork Data Gateway

Additional Related Documentation

This section provides links to documentation for products related to Cisco Crosswork Data Gateway 2.0.x at:

Cisco Crosswork Trust Insights

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 the Cisco Crosswork Network Automation API Documentation on Cisco DevNet.

Open Bugs in Crosswork Data Gateway 2.0.1

There are no open bugs in Crosswork Data Gateway 2.0.1.

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

Go to the Cisco Bug Search Tool.

Enter your registered Cisco.com username and password, and click Log In.

The Bug Search page opens.

Note

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

To search for a specific bug, enter the bug ID in the Search For field.
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.

Open Source

A list of open source software used in Cisco Crosswork can be found in Open Source Software Used in Crosswork Data Gateway.

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.

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.