A newer version of this product documentation is available. If you are redirected to the main page of the user guide, then this page might have been renamed or removed.

NVIDIA NetQ 4.9 Release Notes

Download 4.9 Release Notes xls    Download all 4.9 release notes as .xls

4.9.0 Release Notes

Open Issues in 4.9.0

Issue ID Description Affects Fixed
4466349
When you upgrade an HA cluster deployment from a version that is not part of the supported upgrade path, the upgrade might fail and the UI might not load due to expired control plane certificates on the worker nodes.

To check whether the certificates have expired, run sudo su followed by kubeadm certs check-expiration. If the output displays a date in the past, your certificates are expired. To update the certificates, run kubeadm certs renew all on each worker node in the cluster. Next, restart the control plane components with crictl stop CONTAINER_ID, followed by systemctl restart kubelet.
4.8.0-4.13.0
3824873
When you upgrade an on-premises NetQ deployment, the upgrade might fail with the following message:
master-node-installer: Upgrading NetQ Appliance with tarball : /mnt/installables/NetQ-4.9.0.tgz
master-node-installer: Migrating H2 db list index out of range.
To work around this issue, re-run the netq upgrade command.
4.9.0 4.10.0-4.13.0
3820671
When you upgrade NetQ cluster deployments with DPUs in the device inventory, the DPUs might not be visible in the NetQ UI after the upgrade. To work around this issue, restart the DTS container on the DPUs in your network. 4.9.0 4.10.0-4.13.0
3819688
When you upgrade NetQ cluster deployments, the configured LCM credential profile assigned to switches in the inventory is reset to the default access profile. To work around this issue, reconfigure the correct access profile on switches before managing them with LCM after the upgrade. 4.9.0 4.10.0-4.13.0
3819364
When you attempt to delete a scheduled trace using the NetQ UI, the trace record is not deleted. 4.7.0-4.9.0 4.10.0-4.13.0
3813819
When you perform a switch discovery by specifying an IP range, an error message is displayed if switches included in the range have different credentials. To work around this issue, batch switches based on their credentials and run a switch discovery for each batch. 4.9.0 4.10.0-4.13.0
3813078
When you perform a NetQ upgrade, the upgrade might fail with the following error message:
Command ‘[‘kubectl’, ‘version –client’]’ returned non-zero exit status 1.
To work around this issue, run the netq bootstrap reset keep-db command and then reinstall NetQ using the netq install command for your deployment.
4.9.0 4.10.0-4.13.0
3808200
When you perform a netq bootstrap reset on a NetQ cluster VM and perform a fresh install with the netq install command, the install might fail with the following error:
 master-node-installer: Running sanity check on cluster_vip: 10.10.10.10 Virtual IP 10.10.10.10 is already used
To work around this issue, run the netq install command again.
4.9.0 4.10.0-4.13.0
3800434
When you upgrade NetQ from a version prior to 4.9.0, What Just Happened data that was collected before the upgrade is no longer present. 4.9.0-4.13.0
3773879
When you upgrade a switch running Cumulus Linux using NetQ LCM, any configuration files in /etc/cumulus/switchd.d for adaptive routing or other features are not restored after the upgrade. To work around this issue, manually back up these files and restore them after the upgrade. 4.9.0 4.10.0-4.13.0
3772274
After you upgrade NetQ, data from snapshots taken prior to the NetQ upgrade will contain unreliable data and should not be compared to any snapshots taken after the upgrade. In cluster deployments, snapshots from prior NetQ versions will not be visible in the UI. 4.9.0-4.13.0
3771124
When you reconfigure a VNI to map to a different VRF or remove and recreate a VNI in the same VRF, NetQ EVPN validations might incorrectly indicate a failure for the VRF consistency test. 4.9.0 4.10.0-4.13.0
3769936
When there is a NetQ interface validation failure for admin state mismatch, the validation failure might clear unexpectedly while one side of the link is still administratively down. 4.9.0-4.13.0
3760442
When you export events from NetQ to a CSV file, the timestamp of the exported events does not match the timestamp reported in the NetQ UI based on the user profile’s time zone setting. 4.9.0 4.10.0-4.13.0
3738840
When you upgrade a Cumulus Linux switch configured for TACACS authentication using NetQ LCM, the switch’s TACACS configuration is not restored after upgrade. 4.8.0-4.9.0 4.10.0-4.13.0
3721754
After you decommission a switch, the switch’s interfaces are still displayed in the NetQ UI in the Interfaces view. 4.9.0-4.10.1 4.11.0-4.13.0
3613811
LCM operations using in-band management are unsupported on switches that use eth0 connected to an out-of-band network. To work around this issue, configure NetQ to use out-of-band management in the mgmt VRF on Cumulus Linux switches when interface eth0 is in use. 4.8.0-4.13.0

Fixed Issues in 4.9.0

Issue ID Description Affects
3782784
After performing a new NetQ cluster installation, some MLAG and EVPN NetQ validations might incorrectly report errors. To work around this issue, run the netq check mlag legacy and netq check evpn legacy commands instead of running a default streaming check. 4.8.0
3781503
When you upgrade a Cumulus Linux switch running the nslcd service with NetQ LCM, the nslcd service fails to start after the upgrade. To work around this issue, manually back up your nslcd configuration and restore it after the upgrade. 4.8.0
3761602
NetQ does not display queue histogram data for switches running Cumulus Linux 5.8.0 and NetQ agent version 4.8.0. To work around this issue, upgrade the NetQ agent package to 4.9.0. 4.8.0
3739222
The opta-check command does not properly validate if the required 16 CPU cores are present on the system for NetQ. The command only presents an error if there are fewer than 8 CPU cores detected. 4.2.0-4.8.0
3688985
After upgrading a NetQ VM with LDAP authentication configured, adding a new LDAP user to NetQ fails with the error message “LDAP not enabled.” 4.8.0
3676723
When you use the NetQ agent on a Cumulus Linux switch to export gNMI data and there is a period of inactivity in the gNMI stream, the NetQ agent service might stop. To recover from this issue, restart the service with the netq config restart agent command. 4.7.0-4.8.0
3670180
The medium Validation Summary card might incorrectly display a failure or lack of data for the latest time interval. To work around this issue, expand the card to the largest view for an accurate representation of validation results. 4.8.0
3650422
The OPTA-on-switch service does not send agent data when the NetQ CLI is not configured. To work around this issue, configure the NetQ CLI on the switch. 4.8.0
3644644
When you perform an LCM upgrade of Cumulus Linux on a switch using the netq lcm upgrade cl-image CLI command, an error message of NetQ cloud token invalid is displayed though the upgrade completes successfully. This issue is not encountered when using the NetQ LCM UI to perform the upgrade. 4.8.0
3634648
The topology graph might show unexpected connections when devices in the topology do not have LLDP adjacencies. 4.8.0
3632378
After you upgrade your on-premises NetQ VM from version 4.7.0 to 4.8.0, NIC telemetry using the Prometheus adapter is not collected. To work around this issue, run the following commands on your NetQ VM:
sudo kubectl set image deployment/netq-prom-adapter netq-prom-adapter=docker-registry:5000/netq-prom-adapter:4.8.0
sudo kubectl set image deployment/netq-prom-adapter prometheus=docker-registry:5000/prometheus-v2.41.0:4.8.0
4.8.0
3549877
NetQ cloud deployments might unexpectedly display validation results for checks that did not run on any nodes. 4.6.0-4.8.0
3429528
EVPN and RoCE validation cards in the NetQ UI might not display data when Cumulus Linux switches are configured with high VNI scale. 4.6.0-4.8.0