Cisco Crosswork Data Gateway 1.1.4 Release Notes

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 is not a standalone product and needs to be deployed in either a Cloud or On Premise configuration. See Compatibility Information.

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

New Features, Enhancements, and Requirements

New features and enhancements provided in the Cisco Crosswork Data Gateway 1.1.4 release include:

  • Changes in VM Requirements:

    • Disk space requirement increased from 50 GB to 70 GB.

Release Dates

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

Table 1. Cisco Crosswork Data Gateway 1.1.4 Release Dates

Version

Build

Filename

Date

1.1.4

14

cw-na-dg-1.1.4-14-release-20200723.ova

2020-12-14

Compatibility Information

  • Cisco Crosswork Data Gateway 1.1.4 has been qualified to be used only with Crosswork Cloud applications.

  • Cisco Crosswork Data Gateway release 1.1.4 has been validated in conjunction with the following Crosswork applications:

    • Cisco Crosswork Trust Insights

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

Table 2. Cisco Crosswork Data Gateway VM requirements

Requirement

Description

Hypervisor

  • 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)

Memory

32 GB

Disk space

50 GB

vCPU

8 vCPUs

Interfaces

Minimum: 1

Maximum: 3

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

Combination #

vNIC0

vNIC1

vNIC2

1
  • Management Traffic

  • Device Access Traffic

  • Control/Data Traffic

2
  • Management Traffic

  • Device Access Traffic

  • Control/Data Traffic

3
  • Management Traffic

  • Device Access Traffic

  • Control/Data Traffic

  • Management traffic: for accessing the UIs and command line and passing Control/Data information between servers (for example, Cisco Crosswork Change Automation and Health Insights to Cisco Crosswork Data Gateway or NSO).

  • Device access traffic: for device configuration and management (NSO or to the devices as a result of KPI configuration or playbook execution) and telemetry data being forwarded to the Cisco Crosswork Data Gateway.

  • Control/Data traffic: for data and configuration transfer between Cisco Crosswork Data Gateway and and other data destinations.

IP Addresses

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

Note 

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.

Also, the ESXi hosts that will run the and Cisco Crosswork Data Gateway VM must have NTP configured, or the initial handshake may fail with "certificate not valid" errors.

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.

Destination Networks

For live deployments, we recommend one virtual switch for the Data Network (connection between the VM and the Cisco Crosswork Data Gateway VM) and second virtual switch for all the management traffic (vms to dns, ntp and the network you will use to access and manage the applications).

Table 3. VM Requirements

Requirement

Description

Hypervisor

  • 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)

Memory

32 GB

Disk space

70 GB

vCPU

8 vCPUs

Interfaces

There are three interfaces available. However, only two interfaces (i.e., vNIC0 and vNIC1) are applicable for cloud deployment.

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

Combination #

vNIC0

vNIC1

1
  • Management Traffic

  • Control/Data Traffic

2
  • Management Traffic

  • Control/Data Traffic

  • Management traffic: for accessing the UIs and command line and passing Control/Data information between servers (for example, Crosswork application to Cisco Crosswork Data Gateway or NSO).

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

IP Addresses

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

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.

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.

Destination Networks

For live deployments, we recommend one virtual switch for the Data Network (connection between the Crosswork application VM and the Cisco Crosswork Data Gateway VM) and second virtual switch for all the management traffic (vms to dns, ntp and the network you will use to access and manage the applications).

Features and Enhancements in Cisco Crosswork Data Gateway 1.1.4

This section lists the features/functionalities delivered in Cisco Crosswork Data Gateway 1.1.4:

Feature

Description

Accessing SCP server via a custom port

Cisco Crosswork Data Gateway allows you to use a custom port instead of the default SCP Port 22.

You can specify the port as a part of the SCP command. For example,

-P55 user@host:path/to/file

where 55 is a custom port.

Load Monitoring

Cisco Crosswork Data Gateway provides report of its available bandwidth and performance. This includes Network I/O, Disk I/O, Memory, and CPU utilization.

Centralized logging

Lets you use an external syslog server.

Deploy Cisco Crosswork Data Gateway with either 1 or 2 NICs configurations

You can choose to use either 1 or 2 vNICs as per the following combinations:

  1. Send all traffic through vNIC0.

  2. Send management traffic through vNIC0 and all data traffic through vNIC1.

Test SSH Connection

Cisco Crosswork Data Gateway allows you to test the SSH connection between itself and a remote host.

Usage Guidelines and Important Notes

Installing Cisco Crosswork Data Gateway

For information on how to install and configure Cisco Crosswork Data Gateway for a Crosswork application, refer the respective guide:

To install Cisco Crosswork Data Gateway for...

Refer...

Cisco Crosswork Trust Insights

Cisco Crosswork Data Gateway 1.1.4 Installation and Customization Guide for Cloud Deployment

Using Cisco Crosswork Data Gateway

For information on how to use Cisco Crosswork Data Gateway for a Crosswork application, refer the respective guide:

For information on how to use Cisco Crosswork Data Gateway for...

Refer...

Cisco Crosswork Trust Insights

Cisco Crosswork Trust Insights User Guide

Known Issues and Limitations in Cisco Crosswork Data Gateway 1.1.4

The following are known issues, limitations, and workarounds in Cisco Crosswork Data Gateway.

Caveat ID Number

Description

None.

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


  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 Data Gateway.

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


Tip

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


Related Documentation

For related documentation, see the Cisco Crosswork Data Gateway 1.1.4 Documentation Roadmap.

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 What’s New in Cisco Product Documentation RSS feed. The RSS feeds are a free service.