Cumulus NetQ 2.1 Release Notes

Follow

Overview

These release notes support the Cumulus NetQ 2.1.0, 2.1.1, and 2.1.2 releases and describe currently available features and known issues.

Stay up to Date

  • Please sign in and click Follow above so you can receive a notification when we update these release notes.
  • Subscribe to our product bulletin mailing list to receive important announcements and updates about issues that arise in our products.
  • Subscribe to our security announcement mailing list to receive alerts whenever we update our software for security issues.

{{table_of_contents}}

What's New in Cumulus NetQ 2.1

Cumulus NetQ has been reinvented to scale with the fast adoption rate of open networks and rapid network growth. In addition to the real-time data collection and fabric-wide performance analysis that are already supported in Cumulus NetQ 1.4.1, Cumulus NetQ now offers a graphical user interface for:

  • Data visualizations of the overlay and underlay networks,
  • Simplified network troubleshooting with network-wide roll-ups of health and alarm status in a single card, and
  • Proactive validation of the network status and configuration to regularly detect network issues.

Cumulus NetQ 2.1.2 includes the following new features and improvements:

  • Updates to the NetQ UI, including:
    • Added user-defined settings for display of date format and time zone
    • Added support for OSPF validation, both on-demand and scheduled
    • Added ability for user to change their account password
    • Updated the Events Reference to include additional events for BGP, license, sensors, and services
    • Added views of all MACs and VLANs in the network
  • Updates to the NetQ CLI, including:
    • Added netq add notification proxy command to enable configuration of a proxy server for event notification management
    • Added netq show opta-health to view the status of the various applications and services running on the NetQ Platform or Appliance
    • Simplified the netq check interfaces command
  • Fixes for a number of issues. See Issues Fixed in Cumulus NetQ 2.1.2 below.

Cumulus NetQ 2.1.1 includes the following new features and improvements:

  • Updates to the NetQ UI, including:
    • Added scheduled validations that let you schedule when to validate the operation of the network protocols and services running in your network
    • Added Management workbench which provides a single location to manage access to the NetQ UI, as well as view, add, and export scheduled validations and traces
    • Improved display of trace results on the full screen Trace Results card
    • Collapsed Navigation History into a menu to provide additional space for cards on the workbench
    • Added user option to display the application in a light or dark color theme
  • Fixes for a number of issues. See Issues Fixed in Cumulus NetQ 2.1.1 below.
  • The LNV protocol is deprecated with this NetQ release. It is supported only through the NetQ CLI and API for users on Cumulus Linux 3.7.x and earlier.

Cumulus NetQ 2.1.0 includes the following new features and improvements:

  • Modern microservices architecture enables scalable and agile network with real-time data collection
  • Supports up to 1,000 nodes
  • Graphical User Interface (UI) provides a visual representation of the health and operation of the network, network devices and events
    • Monitor network-wide health
    • Monitor individual device health and configuration
    • View network devices inventory and device component inventory
    • Monitor and validate network protocol and services operation
    • Track alarms and informational events across the network and for individual devices and components, protocols and services
    • Monitor connectivity with network tracing
    • Customize your own monitoring workbench to meet your needs
    • RESTful API provides access to data for use in third-party analytic tools
    • NetQ Appliance with the NetQ Platform pre-installed to speed deployment and get monitoring as quickly as possible
  • Several CLI improvements have been made. To view all changes, refer to the CLI user guide.
    • Instead of using the netq show commands to display changes between two points in time, a new netq show events command is available to see these changes.
    • The netq config ts commands used to configure the Telemetry Server has been deprecated. netq config commands remain for local file-based configuration and netq notification commands have been added for configuring event notifications.
    • Timestamps which indicate when a change occurred are displayed as an absolute time (Mon Feb 4 07:23:18 2019) versus relative to the current time (0d:2h:58m:34s ago). Uptimes remain relative to the current time.

Features supported in Cumulus NetQ 1.4.1 and earlier continue to be supported, with the following exceptions:

  • The early access features provided with NetQ 1.4 that were not fully productized are not available with this release.
    • Extension of NetQ CLI with custom commands
    • NetQL, query language for directly accessing the database. This data will be available through the NetQ UI or API over time.
    • Export of interface statistics to third-party analytics tools (like Grafana). This data will be available through the NetQ UI or API over time.
    • Image and Provisioning Management (IPM) application. Life cycle management is in development for a future release.
  • Support for Docker and Docker Swarm. Use Kubernetes to manage containers instead.
  • netq-shell command. A subset of NetQ commands had to be run on the Telemetry Server. Commands that ran on the Telemetry Server have been removed and the replacement commands can be run from any node.
  • Service Console. Web-based UI access to the CLI is not currently available. Access the CLI directly through a terminal window.

Licensing

Cumulus NetQ 2.1 is available on a subscription basis as part of your support contract. For details, refer to the Support Policy.

Install or Upgrade to Version 2.1

Whether you are installing Cumulus NetQ 2.1 for the first time or upgrading from an earlier version, follow the steps in the NetQ Deployment Guide.

Documentation

The Cumulus NetQ user documentation is available online at docs.cumulusnetworks.com. You are able to provide feedback with corrections and suggestions there. This documentation is updated at every release, and periodically with corrections. Note that an updated UI User Guide may not be available for up to five days after a release. All other documents are available at the time of a release.

Issues Fixed in Cumulus NetQ 2.1.2

The following is a list of fixed issues in Cumulus NetQ 2.1.2 release.

Release Note ID Summary Description

RN-1283 (NETQ-1690)
CLAG services card displays incorrect count of inactive backup IP addresses.

Medium size CLAG services card summary banner incorrectly displays count of devices with inactive backup IP addresses.

This issue is fixed in Cumulus NetQ 2.1.2.


RN-1367 (NETQ-2032)
NetQ UI: When protocol session goes away, and associated cards are refreshed, cards are not properly populated

When you have a Network Services card for a protocol already open and a session is deleted, when the card is refreshed it shows either a completely or partially blank card.

This issue is fixed in Cumulus NetQ 2.1.2.


RN-1374 (NETQ-2173)
CPU usage spikes on ARM-based switches after NetQ Agent is started

On switches with the ARMv7 CPU arch, netq-agent starts normally, but spikes in CPU usage are seen with each poll thereafter.

This issue is fixed in Cumulus NetQ 2.1.2.


RN-1380 (NETQ-2182)
NetQ UI: Devices|Switches Card presentation errors

The medium size Devices|Switches card displays incorrect data when the CHARTS filter is selected. The card displays network health data instead of displaying device health data. The card icon is also incorrect, and the card title is truncated on hover.

The Utilization tab on the large size Devices|Switches card incorrectly colors performance trend arrows. A smaller usage value is good, so when the trend is decreasing, the arrow should be green, not red.

These issues are fixed in Cumulus NetQ 2.1.2.

New Known Issues in Cumulus NetQ 2.1.2

The following is a list of known issues in Cumulus NetQ 2.1.2 release.

Release Note ID Summary Description

RN-1428 (NETQ-2600)
NetQ GUI: The Configuration File Evolution tab on the large Network Services EVPN Session and LLDP Session cards occasionally shows no output

Sometimes the Configuration File Evolution tab on the large Network Services EVPN Session and LLDP Session cards do not show the configuration file when you click the time of change.

This is a known issue that is currently being investigated.


RN-1429 (NETQ-2601)
NetQ GUI: The Configuration File Evolution tab on the large Network Services CLAG Session card shows changes to FRRouting config

The Configuration File Evolution tab on the large Network Services CLAG Session card shows changes to the FRRouting configuration file, rather than the CLAG configuration file.

This is a known issue that is currently being investigated.


RN-1430 (NETQ-2567)
NetQ GUI: Warnings and failures on the medium Scheduled Trace Result card always show 100% when the past 24 hour timeframe is selected

When the past 24 hour time period is selected on the medium Scheduled Trace Result card, the heat maps for both warnings and failures are incorrectly displaying a saturation value of 100%. The total of the two values should equal 100%. Other time periods display correctly.

This is a known issue that is currently being investigated.


RN-1431 (NETQ-2511)
NetQ GUI: All full screen cards show only the date by default

By default, only the date is shown in all full screen cards; no time is presented.

To work around this issue, click the user account icon > User Settings > Profile & Preferences. On the Display card, select any Date Format. The cards will then display both date and time. 

This is a known issue that is currently being investigated.


RN-1432 (NETQ-2614)
NetQ GUI: You can delete the default Cumulus Workbench

In the NetQ GUI, if you click the user account icon > User Settings > Profile & Preferences > Workbenches card, you can delete the default Cumulus Workbench from the application. If you accidentally delete it, you must recreate the workbench yourself, or contact support to have it reinstalled.

This is a known issue that is currently being investigated.


RN1433 (NETQ-2648)
NetQ GUI: Full Screen On-Demand Trace results for new trace may show old trace results/paths

When a user creates the same on-demand trace as they created at some time in the past, and the results indicate a different number of available paths, the full screen On-demand Trace Results card may not show the updated results. The medium and large On-demand Trace Results cards do show the updated results.

To work around this issue, perform a browser refresh.

This is a known issue that is currently being investigated.


RN1491 (NETQ-2606)
NetQ Agent may fail to recognize when it loses connectivity to the NetQ server

A NetQ Agent may fail to recognize when it loses connectivity with a NetQ server (OPTA). This can occur when the NetQ server is rebooted or when network connectivity is lost for some other reason. A symptom of this connectivity loss is that NetQ Agents that do detect the situation cause high CPU utilization in their attempt to reconnect. As a result, NetQ Agents becomes out-of-sync with the NetQ server. If you notice this situation please restart the affected NetQ agents.

This is a known issue that is currently being investigated.

Issues Fixed in Cumulus NetQ 2.1.1

The following is a list of fixed issues in Cumulus NetQ 2.1.1 release.

Release Note ID Summary Description

RN-1360 (NETQ-2031)
NetQ UI: Only default validations could be run on demand.

New on-demand validations would not run from the Validation Request card workflow. Only the provided default validations worked.

This issue is fixed in Cumulus NetQ 2.1.1.


RN-1375 (NETQ-2146)
NetQ UI: Inventory|Switches card was missing legend icon when more that five items were present

When there were more than five vendors, models, or agent versions to display in the corresponding pie charts on the ASIC and Software tabs of the large size Inventory|Switches card, the legend did not display the associated square icon.

This issue is fixed in Cumulus NetQ 2.1.1.


RN-1376 (NETQ-2062)
NetQ CLI: `netq check mtu` command stalled

Running the netq check mtu command took a long time to complete.

This issue is fixed in Cumulus NetQ 2.1.1.


RN-1377 (NETQ-2140)
NetQ UI: Network Health Card showed incorrect services for some devices

The Network Health tab on the large size Network Health card indicated that the BGP service was running on some nodes where it was not actually running.

This issue is fixed in Cumulus NetQ 2.1.1.


RN-1379 (NETQ-1933)
NetQ UI: Single BGP Session card displayed incorrect time segments

When a session entered the Not Established state, the large size Single BGP Session card failed to display the affected time segment. This information is presented correctly on the medium size card.

This issue is fixed in Cumulus NetQ 2.1.1.

New Known Issues in Cumulus NetQ 2.1.1

There are no new known issues in Cumulus NetQ 2.1.1 release.

Known Issues in Cumulus NetQ 2.1.0

The following is a list of known issues in Cumulus NetQ 2.1.0 release.

Release Note ID Summary Description

RN-1283 (NETQ-1690)
CLAG services card displays some incorrect backup IP addresses.

Medium size CLAG services card summary banner incorrectly displays count of devices with inactive backup IP addresses.

This is a known issue that is currently being investigated.


RN-1360 (NETQ-2031)
Only default validations can be run on demand in NetQ UI

New on-demand validations cannot be run from the Validation Request card workflow. Only the provided default validations can be run.

This is a known issue that is currently being investigated.


RN-1367 (NETQ-2032)
NetQ UI: When protocol session goes away, and associated cards are refreshed, cards are not properly populated

When you have a Network Services card for a protocol already open and a session is deleted, when the card is refreshed it shows either a completely or partially blank card.

This is a known issue that is currently being investigated.


RN-1374 (NETQ-2173)
CPU usage spikes on ARM-based switches after NetQ Agent is started

On switches with the ARMv7 CPU arch, netq-agent starts normally, but spikes in CPU usage are seen with each poll thereafter.

This is a known issue that is currently being investigated.


RN-1375 (NETQ-2146)
NetQ UI: Inventory|Switches card missing legend icon when more that five items are present

When there are more than five vendors, models, or agent versions to display in the corresponding pie charts on the ASIC and Software tabs of the large size Inventory|Switches card, the legend does not display the associated square icon. You must hover on the chart to view which segment belongs to the sixth and greater items.

This is a known issue that is currently being investigated.


RN-1376 (NETQ-2062)
NetQ CLI: netq check mtu command stalls

Running the netq check mtu command takes a long time to complete.

This is a known issue that is currently being investigated.


RN-1377 (NETQ-2140)
NetQ UI: Network Health Card shows incorrect services for some devices

The Network Health tab on the large size Network Health card indicates that the BGP service is running on some nodes where it is not actually running.

This is a known issue that is currently being investigated.


RN-1378 (NETQ-2135)
NETQ UI: Default BGP and CLAG Validation results do not display rotten node count

Default BGP and CLAG validation requests that produce results with rotten nodes do not display the count of these nodes on the full screen On-Demand Validation Results cards.

This is a known issue that is currently being investigated.


RN-1379 (NETQ-1933)
NetQ UI: Single BGP Session card displays incorrect time segments

When a session enters the Not Established state, the large size Single BGP Session card fails to display the affected time segment. This information is presented correctly on the medium size card.

This is a known issue that is currently being investigated.


RN-1380 (NETQ-2182)
NetQ UI: Devices|Switches Card presentation errors

The medium size Devices|Switches card displays incorrect data when the CHARTS filter is selected. The card displays network health data instead of displaying device health data. The card icon is also incorrect, and the card title is truncated on hover.

The Utilization tab on the large size Devices|Switches card incorrectly colors performance trend arrows. A smaller usage value is good, so when the trend is decreasing, the arrow should be green, not red.

These are known issues that are currently being investigated.

Have more questions? Submit a request

Comments

Powered by Zendesk