Cumulus NetQ 2.2 Release Notes

Follow

Overview

These release notes support the Cumulus NetQ 2.2.0, 2.2.1 and 2.2.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.2

Cumulus NetQ is now available as a cloud service, making it even easier to scale with your network growth. Just like Cumulus NetQ deployed in your premises, real-time data collection and fabric-wide performance analysis are available through the cloud service. New functionality has also been added to the NetQ UI.

Cumulus NetQ 2.2.2 includes bug fixes and the following new features and improvements:

For on-premises and in-cloud

  • Command Line Interface (CLI)
    • Support of syslog for event notifications
    • Improved install procedure includes CLI update in NetQ upgrade process
  • Graphical User Interface (UI)
    • Improved interaction for adding cards to workbenches
    • Modified alarm reporting on Events | Alarms cards to include only alarms occurring during the designated time period on the card

For on-premises only

  • Simplified upgrade process for NetQ Appliance includes upgrade of netq-apps

For in-cloud only

  • Command Line Interface (CLI)
    • Added CLI proxy to NetQ Cloud Appliance to remove internet access requirement when installing CLI on hosts and servers
    • Improved netq install opta interface command enables download and installation of cloud software in single step

Cumulus NetQ 2.2.1 includes bug fixes and the following new features and improvements:

For on-premises and in-cloud

  • Command Line Interface (CLI)
  • Graphical User Interface (UI)
    • Added ability to save user workbenches
    • Added OSPF events
  • Reorganized documentation
    • Modified installation and upgrade procedures in Deployment Guide
    • Created Integration Guide to collect all integration options together
    • Created More Documents topic to contain generic information about Cumulus Networks documents and this NetQ release
    • Format fixes

For on-premises only

For in-cloud only

  • Command Line Interface (CLI)

Cumulus NetQ 2.2.0 includes the following new features and improvements:

For on-premises and in-cloud

  • Graphical User Interface (UI)
    • Added ability to monitor and validate OSPF network protocol operation
    • Added ability to validate MTU, Sensors, VLAN and VXLAN protocols and services
    • Added new standard user role, user, with reduced access permission compared to the administrative user
    • Added Prescriptive Topology Manager (PTM) events
  • Command Line Interface (CLI)
    • Included Interface Statistics as an early access feature

For in-cloud only

  • Released new Cumulus NetQ Cloud Appliance to speed deployment and get monitoring as quickly as possible
  • Added CLI support for installation and configuration of the Cumulus NetQ Cloud Appliance
  • Added support for multiple data centers

Licensing

Cumulus NetQ 2.2 is available on a subscription basis as part of your support contract. For details, refer to the Cumulus NetQ Versioning and Support Policy or the Cumulus NetQ Cloud Versioning and Support Policy.

Install or Upgrade to Version 2.2

Whether you are installing Cumulus NetQ 2.2 for the first time or upgrading from an earlier version, follow the steps in the Cumulus 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 generally available at the time of a release.

Issues Fixed in Cumulus NetQ 2.2.2

The following is a list of issues fixed in Cumulus NetQ 2.2.2 from earlier version of Cumulus NetQ.

Release Note ID Summary Description

RN1502
(NETQ-2638)
NetQ GUI: Count of CL Support alarms is not incrementing on the Events | Alarms cards

When a CL Support alarm occurs, it is not reflected in the total alarms count or the CL Support count on the Events | Alarms cards. The alarm message is visible, however, in the large Events | Alarms card table.

This issue is fixed in Cumulus NetQ 2.2.2.


RN1503
(NETQ-2867)
NetQ GUI: OSPF session in full state incorrectly shown as not established

OSPF sessions in a full state are being incorrectly shown as having a not established state in the UI.

This issue is fixed in Cumulus NetQ 2.2.2.

New Known Issues in Cumulus NetQ 2.2.2

The following issues are new to Cumulus NetQ, and affect the current release.RN-1590 was added December 4, 2019.

Release Note ID Summary Description

RN1528
(NETQ-2748,
NETQ-3339)
NetQ GUI: Alarm and Info event information is not displayed in charts on large BGP, EVPN and OSPF Single Session cards

On large BGP, EVPN and OSPF Single Session cards, the alarm and info event data is not displayed in the respective charts.

This is a known issue that is currently being investigated.


RN1529
(NETQ-2576)
NetQ GUI: Medium Devices | Switches card displays incorrect data

Medium Devices | Switches cards should display the distribution of overall health score for network services, interfaces, system and trace, but instead shows network-wide information.

This is a known issue that is currently being investigated.


RN1530
(NETQ-3355)
NetQ GUI: Starting time for a scheduled trace displays incorrectly on full-screen Trace Request card

When a user creates a scheduled trace and saves it in their local time, the time is incorrectly displayed on the full-screen Trace Request card. It is correctly displayed on the large Trace Request card and through the CLI.

This is a known issue that is currently being investigated.


RN1531
(NETQ-3255)
NetQ GUI: Configuration tab on large Scheduled Trace Result card missing data

Trace configuration information is not captured until the trace has been run at least once, leaving the large Trace Result card blank. The schedule information remains missing even after the trace has been run.

This is a known issue that is currently being investigated.


RN1532
(NETQ-3037)
NetQ GUI: Event count is always zero on large On-demand Validation Result card for sensors

While the number of sensor-related events is one or more, the event count in the table on the large On-demand Validation Result table always displays zero. The netq show events type sensors command shows the correct information.

This is a known issue that is currently being investigated.


RN1533
(NETQ-3327)
NetQ GUI: Default BGP Validation Result card not displaying failures

When failures are present in a BGP validation, the medium and large BGP Validation Result cards do not display the failures. Additionally, the full-screen card does not open. The failures are properly counted on the small card.

This is a known issue that is currently being investigated.


RN1534
(NETQ-3369)
NetQ CLI and GUI: Requests to view CL Support events not returning results

When running the netq show events type clsupport command or viewing CL Support alarms on the large Events| Alarms card, no data is provided.

This is a known issue that is currently being investigated.


RN1535
(NETQ-3356)
NetQ CLI: False warnings being generated for NTP service

When running the netq show events, netq check ntp, or netq show ntp commands, false warning messages are shown for the NTP service.

This is a known issue that is currently being investigated.


RN1590
(CM-18601)
NetQ Infra: On-premises NetQ Appliance might see issue with disk space management

On-premises NetQ Appliances run Cumulus Linux 3.x NOS and use the BTRFS (b-tree file system), and therefore might exhibit an issue with disk space management that requires a rebalance of the BTRFS partitions. This also applies to customer-provisioned NetQ servers with NetQ platform software used in on-premises deployments. For more information about the issue, refer to When to Rebalance BTRFS Partitions.
To work around this issue, a script has been created that monitors BTRFS and automatically rebalances the partitions if needed. To deploy the script on your NetQ Appliance:

  1. Download the script, btrfs-balance, from here.
  2. Copy the script to the /home/cumulus directory.
  3. Open crontab for editing using sudo crontab -e.
  4. Add the following entry to the last line in the crontab window: 1 * * * * sh /home/cumulus/btrfs-balance -cv / >> /var/log/btrfs-balance.log 2>&1.

The monitoring script will run every hour to check if the allocated disk space has crossed the designated threshold, and if so will initiate a rebalance of the BTRFS partitions.
NetQ Appliances and customer-provisioned NetQ servers running NetQ 2.4.0 or later are not impacted by this issue.

Issues Fixed in Cumulus NetQ 2.2.1

The following is a list of issues fixed in Cumulus NetQ 2.2.1 from earlier versions of Cumulus NetQ.

Release Note ID Summary Description

RN1431
(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 > Display card, and select a Date Format. The cards will then display both date and time.

This issue is fixed in Cumulus NetQ 2.2.1.


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 issue is fixed in Cumulus NetQ 2.2.1.


RN1464
(NETQ-2737)
The table on the large Network Services All EVPN Sessions card does not show alarm counts correctly

Some critical alarms that are seen when you run netq show events level critical type evpn do not appear in the table on the large Network Services All EVPN Sessions card.

This issue is fixed in Cumulus NetQ 2.2.1.


RN1465
(NETQ-2670)
CTRL+C does not kill the back-end `netq` process

Issuing a CTRL+C command did not send a SIGKILL to terminate the back-end netq process.

This issue is fixed in Cumulus NetQ 2.2.1.


RN1466
(NETQ-2822)
The full screen Scheduled Validation Result OSPF card does not show failed sessions and total session counts

The failed session count and total session count columns are empty on the full screen Scheduled Validation Result OSPF card, despite showing other valid data.

This issue is fixed in Cumulus NetQ 2.2.1.


RN1467
(NETQ-2810)
The Sensor tab on the full screen Network Health card displays no data

The Sensor tab on the full screen Network Health card does not display any data. All the other tabs display data for other items and protocols.

This issue is fixed in Cumulus NetQ 2.2.1.


RN1505
(NETQ-2961)
Infra: Support new kernel drivers for improved performance running on NetQ Platforms running VMware

For customers with VMware/ESXi OVA deployments, Cumulus Networks recommends deploying a fresh installation of NetQ 2.2.1, rather than the standard upgrade from 2.1.x or 2.2.0, to take advantage of the performance improvements available with the new vmxnet3 and Paravirtualization SCSI drivers. Customers _must_ backup their NetQ data prior to the fresh installation to retain their data, and then follow the installation with a restoration.

This issue is fixed in Cumulus NetQ 2.2.1.


RN1506
(NETQ-3030)
NetQ GUI: OSPF validation cards incorrectly show status when no nodes are running the protocol.

The heat map showing passing, failing, and warning conditions on the medium and large OSPF validation cards is incorrectly showing all status values at 100% when no OSPF nodes are present or validated.

This issue is fixed in Cumulus NetQ 2.2.1.

New Known Issues in Cumulus NetQ 2.2.1

The following issues are new to Cumulus NetQ, and affect the current release.

Release Note ID Summary Description

RN-1502
(NETQ-2638)
NetQ GUI: Count of CL Support alarms is not incrementing on the Events | Alarms cards

When a CL Support alarm occurs, it is not reflected in the total alarms count or the CL Support count on the Events | Alarms cards. The alarm message is visible, however, in the large Events | Alarms card table.

This is a known issue that is currently being investigated.


RN-1503
(NETQ-2867)
NetQ GUI: OSPF session in full state incorrectly shown as not established

OSPF sessions in a full state are being incorrectly shown as having a not established state in the UI.

To work around this issue, view OSPF sessions in the CLI using the netq show ospf command.

This is a known issue that is currently being investigated.


RN1507
(NETQ-3092)
NetQ GUI: Count of OSPF alarms is not incrementing on the OSPF Network Services cards

When an OSPF alarm occurs, it is not reflected in the total alarms count on the Network Services | All OSPF Sessions cards.

This is a known issue that is currently being investigated.


RN1508
(NETQ-3187)
NetQ GUI:Time zone disappears when user opens NetQ Management

When a user viewing the Cumulus Workbench opens the NetQ Management screen, the time zone shown in the application header no longer appears. Refreshing the browser window may resolve the issue.

This is a known issue that is currently being investigated.

Issues Fixed in Cumulus NetQ 2.2.0

The following is a list of issues fixed in Cumulus NetQ 2.2.0 from earlier versions of Cumulus NetQ.

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 showed no output

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

This issue is fixed in Cumulus NetQ 2.2.0.


RN-1432
(NETQ-2614)
NetQ GUI: You could 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. You can no longer delete this default workbench.

This issue is fixed in Cumulus NetQ 2.2.0.


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. If you notice this situation please restart the affected NetQ agents.

This is a known issue that is currently being investigated.

 

Known Issues in Cumulus NetQ 2.2.0

The following known issues affect the current release.

Release Note ID Summary Description

RN-1378
(NETQ-2135)
NetQ GUI: 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-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.


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.


RN-1464
(NETQ-2737)
NetQ GUI: The table on the large Network Services All EVPN Sessions card does not show alarm counts correctly

Some critical alarms that are seen when you run netq show events level critical type evpn do not appear in the table on the large Network Services All EVPN Sessions card.

This is a known issue that is currently being investigated.


RN-1465
(NETQ-2670)
CTRL+C does not kill the back-end netq process

Issuing a CTRL+C command does not send a SIGKILL to terminate the back-end netq process.

If you want to terminate the process, run sudo systemctl stop netqd.

This is a known issue that is currently being investigated.


RN-1466
(NETQ-2822)
NetQ GUI: The full screen Scheduled Validation Result OSPF card does not show failed session and total session counts

The failed session count and total session count columns are empty on the full screen Scheduled Validation Result OSPF card, despite showing other valid data.

This is a known issue that is currently being investigated.


RN-1467
(NETQ-2810)
NetQ GUI: The Sensor tab on the full screen Network Health card displays no data

The Sensor tab on the full screen Network Health card does not display any data. All the other tabs display data for other items and protocols.

This is a known issue that is currently being investigated.


RN1506
(NETQ-3030)
NetQ GUI: OSPF validation cards incorrectly show status when no nodes are running the protocol.

The heat map showing passing, failing, and warning conditions on the medium and large OSPF validation cards is incorrectly showing all status values at 100% when no OSPF nodes are present or validated.

This is a known issue that is currently being investigated.

Have more questions? Submit a request

Comments

Powered by Zendesk