Cumulus NetQ 1.0.0 Release Notes

Follow

Overview

These release notes support Cumulus NetQ 1.0.0 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 1.0.0

Cumulus NetQ 1.0.0 includes the following features:

  • Telemetry server: A distributed key/value store manifest as a series of containers that receives data from NetQ agents.
  • Agent: Network telemetry agents that feed data about the network fabric to the telemetry server.
  • Service console: A graphical user interface to the NetQ shell.
  • Analysis engine: The backend engine utilized when querying NetQ via the CLI, service console or NetQ Notifier. 
  • Notifier: A service that runs on the telemetry server, responding to events pushed by NetQ agents, sending alerts to a configured channel, such as Slack, PagerDuty or syslog.
  • Export NetQ data to Slack, PagerDuty or syslog

Documentation

You can read the technical documentation here.

Known Issues in Cumulus NetQ 1.0.0

Issues are categorized for easy review. Some issues are fixed but will be available in a later release.

Release Note ID Summary Description

RN-618 (CM-16660)
Some platforms display "N/A" when `netq show inventory asic` is run

NetQ does not return data for certain platforms when netq show inventory asic is run. The text "N/A" appears instead:

cumulus@leaf01:~$ netq show inventory asic
Node                Vendor    Model     Model ID    Core B/W    Ports
------------------  --------  --------  ----------  ----------  -----------------------------
act-7412-03         N/A       N/A       N/A         N/A         N/A
dell-s4000-04       Broadcom  Trident2  BCM56854    720G        48 x 10G-SFP+ & 6 x 40G-QSFP+
dell-s4000-05       Broadcom  Trident2  BCM56854    720G        48 x 10G-SFP+ & 6 x 40G-QSFP+
dell-z9100-03       Broadcom  Tomahawk  BCM56960    2.0T        32 x 100G-QSFP28
mlx-2700b-01        N/A       N/A       N/A         N/A         N/A
qct-ix1-08          N/A       N/A       N/A         N/A         N/A
qct-ly9rangeley-06  Broadcom  Trident2  BCM56854    720G        48 x 10G-T & 6 x 40G-QSFP+
qct-ly9rangeley-07  Broadcom  Trident2  BCM56854    720G        48 x 10G-T & 6 x 40G-QSFP+

RN-619 (CM-16684)
`netq NODE show stp topology` shows wrong information when on node bridge link is down

When the hard node bridge link is brought down, running netq NODE show stp topology displays incorrect information. The expected output should be similar to what is displayed when mstpd is stopped:

No bridges found

RN-620 (CM-16432)
When stopping and starting mstpd, `netq show services changes` displays two events

In this instance, the NetQ agent is reporting two events, because one reports the service is in "error" and the other says the service is "failed". However, in both cases the service is actually stopped, so the NetQ CLI shows the status as "n/a", causing them to look like two events without any difference.

There is no workaround at this time. While the issue is benign, it can potentially trigger an alarm event, even when the service did not actually change state.

cumulus@leaf01:~$ sudo systemctl stop mstpd ; sudo systemctl start mstpd 
cumulus@leaf01:~$ netq mlx-2700-03 show services mstpd changes 
Matching services records are:
Node         Service      PID  VRF      Enabled    Active    Monitored    Status    Up Time    DbState    Last Changed
-----------  ---------  -----  -------  ---------  --------  -----------  --------  ---------  ---------  --------------
mlx-2700-03  mstpd      10917  default  yes        yes       yes          ok        14s ago    Add        2s ago
mlx-2700-03  mstpd          0  default  yes        no        yes          n/a       22m ago    Add        14s ago
mlx-2700-03  mstpd          0  default  yes        no        yes          n/a       22m ago    Add        17s ago
mlx-2700-03  mstpd       9211  default  yes        yes       yes          ok        22m ago    Add        22m ago
mlx-2700-03  mstpd          0  default  yes        no        yes          n/a       24m ago    Add        22m ago
mlx-2700-03  mstpd          0  default  yes        no        yes          n/a       24m ago    Add        22m ago
mlx-2700-03  mstpd       9015  default  yes        yes       yes          error     24m ago    Add        22m ago
mlx-2700-03  mstpd       9015  default  yes        yes       yes          ok        24m ago    Add        24m ago
mlx-2700-03  mstpd          0  default  yes        no        yes          n/a       56m ago    Add        24m ago
mlx-2700-03  mstpd          0  default  yes        no        yes          n/a       56m ago    Add        24m ago
mlx-2700-03  mstpd        429  default  yes        yes       yes          ok        56m ago    Add        37m ago
mlx-2700-03  mstpd        429  default  yes        yes       no           ok        56m ago    Add        37m ago
mlx-2700-03  mstpd        429  default  yes        yes       yes          ok        56m ago    Add        50m ago
mlx-2700-03  mstpd        429  default  yes        yes       no           ok        56m ago    Add        50m ago

RN-621 (CM-16710)
The regular expression for hostname does not work with the `netq NODE show agents command`

The regular expression syntax between Python and the backend database are different, causing support for more complex regular expressions difficult at this time.

 

To work around this issue, use tab completion to get the full hostname and specify it directly.

The regular expressions that are usable are:

    - '*': matches zero or more of any char, so leaf* matches leaf01, leaf02 ...
    - '?': matches exactly zero or one char
    - [0-9]: matches exactly one char that is a number between 0-9
    - [a-zA-Z]: matches exactly one char that is a letter between a-z or A-Z
    - [-1-2]*: matches zero or more chars that are either -, 1 or 2

RN-622 (CM-14421)
NetQ does not support traditional mode bridges Support for traditional mode bridges should come in a future release of NetQ.

RN-623 (CM-14541)
Rotten nodes are not highlighted in `netq show` commands  

If a node is in rotten state, it doesn't get highlighted in any netq show output. For example:

cumulus@leaf01:~$ netq show ip route 1.2.3.4
Route info about prefix 1.2.3.4 on host *
Origin Table    IP               Node             Nexthops                  Last Changed
------ -------- ---------------- ---------------- ------------------------- ----------------
0      DataVrf1 0.0.0.0/0        msp1             Blackhole                 47m ago
       080
0      DataVrf1 0.0.0.0/0        msp2             Blackhole                 47m ago  >> From rotten node
       080
0      DataVrf1 0.0.0.0/0        superm-redxp-01  Blackhole                 46m ago  >> From rotten node
       080
0      DataVrf1 0.0.0.0/0        torb1            Blackhole                 46m ago
       080

RN-624 (CM-16342)
You cannot pipe a `netq` command to another `netq` command

Attempting to pipe a netq command into another netq command results in an interrupt in the console. For example:

cumulus@oob-mgmt-server:~$ netq show ip routes |netq resolve
^CTraceback (most recent call last):
  File "/usr/bin/netq", line 316, in 
    reply = rx_reply(sock)
  File "/usr/bin/netq", line 131, in rx_reply
    ready = select([sock], [], [], timeout)
KeyboardInterrupt

RN-625 (CM-16717)
NetQ does not support high availability (HA) mode HA support should be available in a future release of NetQ.

RN-626 (TSG-20)
Issues resizing NetQ Service Console window

The NetQ Service Console does not handle resizing of the browser window very well, which may cause text in the console to wrap.

To work around this issue, do not resize the browser window once you launch the console.


RN-627 (CM-)
No synchronization between users added via the service console and the telemetry server users

Users created in the NetQ Service Console are not synchronized with the users for the NetQ Telemetry Server.

To work around this issue, you must manually sync the user IDs between the telemetry server and the service console.


RN-628 (CM-)
The NetQ CLI and NetQ Notifier are supported on x86 platforms only At this time, the NetQ command line interface and NetQ Notifier can run on x86 switches and hosts only.
Have more questions? Submit a request

Comments

Powered by Zendesk