Skip to content

Commit 911b4e4

Browse files
stu-clarkstu-clark
committed
Update NetQ 5.1 RNs
1 parent d2bef54 commit 911b4e4

3 files changed

Lines changed: 65 additions & 24 deletions

File tree

‎content/cumulus-netq-51/Whats-New/rn.md‎

Lines changed: 20 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -14,25 +14,28 @@ pdfhidden: True
1414

1515
| Issue ID | Description | Affects | Fixed |
1616
|--- |--- |--- |--- |
17-
| <a name="4867933"></a> [4867933](#4867933) <a name="4867933"></a> <br /> | Threshold-crossing events created before version 5.1.0 may not display event values correctly after you upgrade NetQ. | 5.1.0 | |
18-
| <a name="4839716"></a> [4839716](#4839716) <a name="4839716"></a> <br /> | You cannot perform lifecycle management operations immediately after backing up an HA scale cluster deployment. To work around this issue, wait several hours before initiating LCM operations. | 5.1.0 | |
19-
| <a name="4794266"></a> [4794266](#4794266) <a name="4794266"></a> <br /> | Power sensor (PSU) events might show inconsistent sensor names. Additionally, NetQ might not generate PSU events reliably. | 5.1.0 | |
20-
| <a name="4687477"></a> [4687477](#4687477) <a name="4687477"></a> <br /> | When you run a validation against a group of devices with specific labels, NetQ ignores any pre-configured filters. | 5.0.0-5.1.0 | |
21-
| <a name="4681581"></a> [4681581](#4681581) <a name="4681581"></a> <br /> | The <code>netq bootstrap reset purge-db</code> command might take up to 60 minutes to complete on Base Command Manager scale deployments. | 5.0.0-5.1.0 | |
22-
| <a name="4399074"></a> [4399074](#4399074) <a name="4399074"></a> <br /> | When connecting a switch to NMX-T or NMX-C through the service registration workflow, use either the IP address or the hostname. Using both creates duplicate registrations, and the operation does not fail as expected. | 5.0.0-5.1.0 | |
23-
| <a name="4100882"></a> [4100882](#4100882) <a name="4100882"></a> <br /> | When you attempt to export a file that is larger than 200MB, your browser might crash or otherwise prevent you from exporting the file. To work around this issue, use filters in the UI to decrease the size of the dataset that you intend to export. | 4.12.0-4.15.1, 5.0.0-5.1.0 | |
17+
| 4977619 | NetQ might fail to load in high-availability (HA) scale deployments when ECMP is enabled. To work around this issue, disable ECMP ingestion by updating the Kafka connector configuration:<ol><li>Create a backup of the current configuration:<br><code>kubectl get kafkaconnector cassandra-sink-group-1 -n netq-infra -o yaml > /tmp/cassandra-sink-group-1.backup.yaml</code></li><li>Capture the current Kafka connector values:<pre>OLD_KCQL=$(kubectl get kafkaconnector cassandra-sink-group-1 -n netq-infra -o jsonpath='{.spec.config.connect.cassandra.kcql}')<br>OLD_TOPICS=$(kubectl get kafkaconnector cassandra-sink-group-1 -n netq-infra -o jsonpath='{.spec.config.topics}')</pre></li><li>Remove ECMP-related entries from KCQL and topics:<pre>NEW_KCQL=$(echo "$OLD_KCQL" \| tr ';' '\n' \| grep -v -E 'INTO ecmp_info SELECT\|INTO ecmp_info_aggregate SELECT\|INTO ecmp_info_group_aggregate SELECT' \| paste -sd ';' -)<br>NEW_TOPICS=$(echo "$OLD_TOPICS" \| tr ',' '\n' \| grep -v -E '^netq_obj_ecmp_info$\|^netq_obj_ecmp_info_aggregate$\|^netq_obj_ecmp_info_group_aggregate$' \| paste -sd ',' -)</pre></li><li>Verify the changes before applying them:<pre>echo "=== KCQL ECMP entries remaining (should only show ecmp_hash + arEcmpInfo) ==="<br>echo "$NEW_KCQL" \| tr ';' '\n' \| grep -i ecmpecho "=== TOPICS ECMP entries remaining (should only show netq_obj_ecmp_hash) ==="<br>echo "$NEW_TOPICS" \| tr ',' '\n' \| grep -i ecmp<br>echo "Old KCQL: $(echo "$OLD_KCQL" \| tr ';' '\n' \| wc -l) / New: $(echo "$NEW_KCQL" \| tr ';' '\n' \| wc -l) (-3)"<br>echo "Old TOPICS: $(echo "$OLD_TOPICS" \| tr ',' '\n' \| wc -l) / New: $(echo "$NEW_TOPICS" \| tr ',' '\n' \| wc -l) (-3)"<br></pre></li><li>Apply the updated configuration:<br><code>kubectl patch kafkaconnector cassandra-sink-group-1 -n netq-infra --type=merge -p "$(jq -n --arg k "$NEW_KCQL" --arg t "$NEW_TOPICS" '{spec:{config:{"connect.cassandra.kcql":$k,"topics":$t&#125;&#125;&#125;')"</code></li></ol>To revert the changes, restore the backup with <code>kubectl apply -f /tmp/cassandra-sink-group-1.backup.yaml</code><br /> | 5.1.0 | |
18+
| 4867933 | Threshold-crossing events created before version 5.1.0 may not display event values correctly after you upgrade NetQ. | 5.1.0 | |
19+
| 4854041 | When you upgrade a NetQ for NVLink and Ethernet deployment using the data backup and restoration workflow, NetQ does not preserve NVLink data. | 5.1.0 | |
20+
| 4839716 | You cannot perform lifecycle management operations immediately after backing up an HA scale cluster deployment. To work around this issue, wait several hours before initiating LCM operations. | 5.1.0 | |
21+
| 4794266 | Power sensor (PSU) events might show inconsistent sensor names. Additionally, NetQ might not generate PSU events reliably. | 5.1.0 | |
22+
| 4784336 | The NetQ for NVLink deployment option is not supported in air-gapped environments. | 5.0.0-5.1.0 | |
23+
| 4687477 | When you run a validation against a group of devices with specific labels, NetQ ignores any pre-configured filters. | 5.0.0-5.1.0 | |
24+
| 4681581 | The <code>netq bootstrap reset purge-db</code> command might take up to 60 minutes to complete on Base Command Manager scale deployments. | 5.0.0-5.1.0 | |
25+
| 4399074 | When connecting a switch to NMX-T or NMX-C through the service registration workflow, use either the IP address or the hostname. Using both creates duplicate registrations, and the operation does not fail as expected. | 5.0.0-5.1.0 | |
26+
| 4100882 | When you attempt to export a file that is larger than 200MB, your browser might crash or otherwise prevent you from exporting the file. To work around this issue, use filters in the UI to decrease the size of the dataset that you intend to export. | 4.12.0-4.15.1, 5.0.0-5.1.0 | |
2427

2528
### Fixed Issues in 5.1.0
2629
| Issue ID | Description | Affects |
2730
|--- |--- |--- |
28-
| <a name="4786996"></a> [4786996](#4786996) <a name="4786996"></a> <br /> | To use lifecycle management in NMC or BCM environments, you must edit the master node IP address in the configuration manager to match the cluster’s head node IP address. Use the <code>kubectl edit cm -n netq-eth netq-master-node-ip</code> command to edit the configuration. In the configuration file, change the <code>data/master_node</code> field to the cluster’s head node IP address. | 5.0.0 | |
29-
| <a name="4693161"></a> [4693161](#4693161) <a name="4693161"></a> <br /> | In cluster and scale cluster deployments, the snapshot comparison feature may time out when comparing MAC addresses. | 5.0.0 | |
30-
| <a name="4689932"></a> [4689932](#4689932) <a name="4689932"></a> <br /> | Node reservation for NetQ is not supported in shared multi-node clusters. To work around this issue, deploy NetQ in a dedicated single-node or three-node cluster first, and then scale the deployment by adding nodes for other applications. | 5.0.0 | |
31-
| <a name="4687241"></a> [4687241](#4687241) <a name="4687241"></a> <br /> | The activity log in the UI might display multiple entries with “unknown” or “anonymous” usernames. | 5.0.0 | |
32-
| <a name="4683830"></a> [4683830](#4683830) <a name="4683830"></a> <br /> | The Cable Validation Tool might fail to load in the NetQ UI. To work around this issue, log out of NetQ and then log back in. | 5.0.0 | |
33-
| <a name="4668341"></a> [4668341](#4668341) <a name="4668341"></a> <br /> | When you a create an LDAP server configuration, the NetQ UI incorrectly allows you to modify the default server ports. Only the standard ports (389 for insecure and 636 for secure) are permitted. | 5.0.0 | |
34-
| <a name="4667571"></a> [4667571](#4667571) <a name="4667571"></a> <br /> | NetQ might return inconsistent results when queries use the regular expression wildcard. | 5.0.0 | |
35-
| <a name="4637749"></a> [4637749](#4637749) <a name="4637749"></a> <br /> | When the master node is down, the <code>netq show status</code> command might report an incorrect status. | 5.0.0 | |
36-
| <a name="4573427"></a> [4573427](#4573427) <a name="4573427"></a> <br /> | The link health view utilization chart might display incorrect values for the top 5 links when multiple links share the same value. | 5.0.0 | |
37-
| <a name="4527529"></a> [4527529](#4527529) <a name="4527529"></a> <br /> | When there is a high volume of concurrent API requests to NetQ, some requests may fail. | 4.15.0-5.0.0 | |
31+
| 4786996 | To use lifecycle management in NMC or BCM environments, you must edit the master node IP address in the configuration manager to match the cluster’s head node IP address. Use the <code>kubectl edit cm -n netq-eth netq-master-node-ip</code> command to edit the configuration. In the configuration file, change the <code>data/master_node</code> field to the cluster’s head node IP address. | 5.0.0 | |
32+
| 4693161 | In cluster and scale cluster deployments, the snapshot comparison feature may time out when comparing MAC addresses. | 5.0.0 | |
33+
| 4689932 | Node reservation for NetQ is not supported in shared multi-node clusters. To work around this issue, deploy NetQ in a dedicated single-node or three-node cluster first, and then scale the deployment by adding nodes for other applications. | 5.0.0 | |
34+
| 4687241 | The activity log in the UI might display multiple entries with “unknown” or “anonymous” usernames. | 5.0.0 | |
35+
| 4683830 | The Cable Validation Tool might fail to load in the NetQ UI. To work around this issue, log out of NetQ and then log back in. | 5.0.0 | |
36+
| 4668341 | When you a create an LDAP server configuration, the NetQ UI incorrectly allows you to modify the default server ports. Only the standard ports (389 for insecure and 636 for secure) are permitted. | 5.0.0 | |
37+
| 4667571 | NetQ might return inconsistent results when queries use the regular expression wildcard. | 5.0.0 | |
38+
| 4637749 | When the master node is down, the <code>netq show status</code> command might report an incorrect status. | 5.0.0 | |
39+
| 4573427 | The link health view utilization chart might display incorrect values for the top 5 links when multiple links share the same value. | 5.0.0 | |
40+
| 4527529 | When there is a high volume of concurrent API requests to NetQ, some requests may fail. | 4.15.0-5.0.0 | |
3841

‎content/cumulus-netq-51/rn.xml‎

Lines changed: 44 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,20 +7,52 @@
77
<th> Fixed </th>
88
</tr>
99
<tr>
10-
<td>4867933</td>
11-
<td>Threshold-crossing events created before version 5.1.0 may not display event values correctly after you upgrade NetQ.</td>
10+
<td>4977619</td>
11+
<td>NetQ might fail to load in high-availability (HA) scale deployments when ECMP is enabled. To work around this issue, disable ECMP ingestion by updating the Kafka connector configuration:
12+
&lt;ol&gt;
13+
&lt;li&gt;Create a backup of the current configuration:
14+
&lt;code&gt;kubectl get kafkaconnector cassandra-sink-group-1 -n netq-infra -o yaml &amp;gt; /tmp/cassandra-sink-group-1.backup.yaml&lt;/code&gt;
15+
&lt;/li&gt;
16+
&lt;li&gt;Capture the current Kafka connector values:
17+
18+
OLD_KCQL=$(kubectl get kafkaconnector cassandra-sink-group-1 -n netq-infra -o jsonpath='{.spec.config.connect.cassandra.kcql}')
19+
OLD_TOPICS=$(kubectl get kafkaconnector cassandra-sink-group-1 -n netq-infra -o jsonpath='{.spec.config.topics}')
20+
21+
&lt;/li&gt;
22+
&lt;li&gt;Remove ECMP-related entries from KCQL and topics:
23+
24+
NEW_KCQL=$(echo "$OLD_KCQL" | tr ';' '\n' | grep -v -E 'INTO ecmp_info SELECT|INTO ecmp_info_aggregate SELECT|INTO ecmp_info_group_aggregate SELECT' | paste -sd ';' -)
25+
NEW_TOPICS=$(echo "$OLD_TOPICS" | tr ',' '\n' | grep -v -E '^netq_obj_ecmp_info$|^netq_obj_ecmp_info_aggregate$|^netq_obj_ecmp_info_group_aggregate$' | paste -sd ',' -)
26+
27+
&lt;/li&gt;
28+
&lt;li&gt;Verify the changes before applying them:
29+
30+
echo "=== KCQL ECMP entries remaining (should only show ecmp_hash + arEcmpInfo) ==="
31+
echo "$NEW_KCQL" | tr ';' '\n' | grep -i ecmp
32+
echo "=== TOPICS ECMP entries remaining (should only show netq_obj_ecmp_hash) ==="
33+
echo "$NEW_TOPICS" | tr ',' '\n' | grep -i ecmp
34+
echo "Old KCQL: $(echo "$OLD_KCQL" | tr ';' '\n' | wc -l) / New: $(echo "$NEW_KCQL" | tr ';' '\n' | wc -l) (-3)"
35+
echo "Old TOPICS: $(echo "$OLD_TOPICS" | tr ',' '\n' | wc -l) / New: $(echo "$NEW_TOPICS" | tr ',' '\n' | wc -l) (-3)"
36+
37+
&lt;/li&gt;
38+
&lt;li&gt;Apply the updated configuration:
39+
&lt;code&gt;kubectl patch kafkaconnector cassandra-sink-group-1 -n netq-infra --type=merge -p "$(jq -n --arg k "$NEW_KCQL" --arg t "$NEW_TOPICS" '{spec:{config:{"connect.cassandra.kcql":$k,"topics":$t&amp;#125;&amp;#125;&amp;#125;')"&lt;/code&gt;
40+
&lt;/li&gt;
41+
&lt;/ol&gt;
42+
To revert the changes, restore the backup with {{kubectl apply -f /tmp/cassandra-sink-group-1.backup.yaml}}.
43+
</td>
1244
<td>5.1.0</td>
1345
<td></td>
1446
</tr>
1547
<tr>
16-
<td>4854041</td>
17-
<td>When you upgrade a NetQ for NVLink and Ethernet deployment using the data backup and restoration workflow, NetQ does not preserve NVLink data.</td>
48+
<td>4867933</td>
49+
<td>Threshold-crossing events created before version 5.1.0 may not display event values correctly after you upgrade NetQ.</td>
1850
<td>5.1.0</td>
1951
<td></td>
2052
</tr>
2153
<tr>
22-
<td>4845405</td>
23-
<td>NetQ does not support performing a backup on version 5.1.0 and restoring it to the same version (5.1.0).</td>
54+
<td>4854041</td>
55+
<td>When you upgrade a NetQ for NVLink and Ethernet deployment using the data backup and restoration workflow, NetQ does not preserve NVLink data.</td>
2456
<td>5.1.0</td>
2557
<td></td>
2658
</tr>
@@ -37,6 +69,12 @@
3769
<td></td>
3870
</tr>
3971
<tr>
72+
<td>4784336</td>
73+
<td>The NetQ for NVLink deployment option is not supported in air-gapped environments.</td>
74+
<td>5.0.0-5.1.0</td>
75+
<td></td>
76+
</tr>
77+
<tr>
4078
<td>4687477</td>
4179
<td>When you run a validation against a group of devices with specific labels, NetQ ignores any pre-configured filters.</td>
4280
<td>5.0.0-5.1.0</td>

‎utils/build_rns.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -565,7 +565,7 @@ def build_rn_xls_files(product, version_list):
565565
# Key: product short name ("cl" or "netq"). Value: list of full version strings to skip.
566566
EXCLUDED_VERSIONS = {
567567
"cl": ["5.16.2"],
568-
"netq": ["2.4.0", "3.0.0", "3.1.0", "3.2.0", "3.2.1", "3.3.0", "3.3.1", "4.0.0", "4.0.1", "4.1.0", "4.1.1", "4.2.0", "4.3.0", "4.4.0", "4.4.1", "4.5.0", "4.6.0", "4.7.0", "4.8.0", "5.0.0", "5.0.1", "5.1.0"],
568+
"netq": ["2.4.0", "2.4.1", "3.0.0", "3.1.0", "3.2.0", "3.2.1", "3.3.0", "3.3.1", "4.0.0", "4.0.1", "4.1.0", "4.1.1", "4.2.0", "4.3.0", "4.4.0", "4.4.1", "4.5.0", "4.6.0", "4.7.0", "4.8.0", "5.0.0", "5.0.1"],
569569
}
570570

571571
def get_products():

0 commit comments

Comments
 (0)