T through Z Commands
This topic includes all commands that begin with netq t*, netq u*, netq v*, netq w*, netq x*, netq y*, and netq z*.
netq trace
Verifies network connectivity on-demand between two devices at layer 2 or layer 3. Results are shown in the terminal window.
The tracing function only knows about addresses that have already been learned. If you find that a path is invalid or incomplete, you may need to ping the identified device so that its address becomes known.
You can improve the readability of the output using color. Run netq config add color to turn color on. Run netq config del color to turn color off.
Syntax
Three forms of this command are available; one for layer 3 and two for layer 2 traces.
netq trace
<ip>
from (<src-hostname>|<ip-src>)
[vrf <vrf>]
[around <text-time>]
[json|detail|pretty]
netq trace
(<mac> vlan <1-4096>)
from (<src-hostname>|<ip-src>)
[vrf <vrf>]
[around <text-time>]
[json|detail|pretty]
netq trace
(<mac> vlan <1-4096>)
from <mac-src>
[around <text-time>]
[json|detail|pretty]
Required Arguments
| Argument | Value | Description |
|---|---|---|
| NA | <ip> | End trace at the device with this IPv4 or IPv6 address (no mask). IPv6 addresses must be the complete, non-truncated address. |
| NA | <mac> | End trace at the device with this MAC address |
| vlan | <1-4096> | End trace at the device with this VLAN identifier |
| NA | <src-hostname> | Start trace at the device with this hostname |
| NA | <ip-src> | Start trace at the device with this IPv4 or IPv6 address. IPv6 addresses must be the complete, non-truncated address. |
| NA | <mac-src> | Start trace at the device with this MAC address |
Options
| Option | Value | Description |
|---|---|---|
| vrf | <vrf> | Only use paths through this VRF |
| around | <text-time> | Indicates how far to go back in time for the network state information. The value is written using text (versus a UTP representation for example). Note there is no space between the number and unit of time. Valid values include:
|
| json | NA | Display results in JSON file format instead of default on-screen text format |
| detail | NA | Display results in a tabular format with a row per hop and a set of rows per path, useful for traces with higher hop counts where the pretty output wraps lines, making it harder to interpret the results. This is the default output when not specified. |
| pretty | NA | Display results lined up by paths in a pseudo-graphical manner to help visualize the multiple paths |
Command History
A release is included if there were changes to the command, otherwise it is not listed.
| Release | Description |
|---|---|
| 2.1.2 | Removed bidir option |
| 1.x | Introduced |
Sample Usage
cumulus@switch:~$ netq trace 10.10.10.63 from 10.10.10.1 pretty
Number of Paths: 12
Number of Paths with Errors: 0
Number of Paths with Warnings: 0
Path MTU: 9216
leaf01 swp54 -- swp1 spine04 swp6 -- swp54 border02 peerlink.4094 -- peerlink.4094 border01 lo
peerlink.4094 -- peerlink.4094 border01 lo
leaf01 swp53 -- swp1 spine03 swp6 -- swp53 border02 peerlink.4094 -- peerlink.4094 border01 lo
peerlink.4094 -- peerlink.4094 border01 lo
leaf01 swp52 -- swp1 spine02 swp6 -- swp52 border02 peerlink.4094 -- peerlink.4094 border01 lo
peerlink.4094 -- peerlink.4094 border01 lo
leaf01 swp51 -- swp1 spine01 swp6 -- swp51 border02 peerlink.4094 -- peerlink.4094 border01 lo
peerlink.4094 -- peerlink.4094 border01 lo
leaf01 swp54 -- swp1 spine04 swp5 -- swp54 border01 lo
leaf01 swp53 -- swp1 spine03 swp5 -- swp53 border01 lo
leaf01 swp52 -- swp1 spine02 swp5 -- swp52 border01 lo
leaf01 swp51 -- swp1 spine01 swp5 -- swp51 border01 lo
cumulus@switch:~$ netq trace 10.10.10.63 from 10.10.10.1
Number of Paths: 12
Number of Paths with Errors: 0
Number of Paths with Warnings: 0
Path MTU: 9216
Id Hop Hostname InPort InTun, RtrIf OutRtrIf, Tun OutPort
--- --- ----------- --------------- --------------- --------------- ---------------
1 1 leaf01 swp54 swp54
2 spine04 swp1 swp1 swp6 swp6
3 border02 swp54 swp54 peerlink.4094 peerlink.4094
4 border01 peerlink.4094 lo
--- --- ----------- --------------- --------------- --------------- ---------------
2 1 leaf01 swp54 swp54
2 spine04 swp1 swp1 swp6 swp6
3 border02 swp54 swp54 peerlink.4094 peerlink.4094
4 border01 peerlink.4094 lo
--- --- ----------- --------------- --------------- --------------- ---------------
3 1 leaf01 swp53 swp53
2 spine03 swp1 swp1 swp6 swp6
3 border02 swp53 swp53 peerlink.4094 peerlink.4094
4 border01 peerlink.4094 lo
--- --- ----------- --------------- --------------- --------------- ---------------
4 1 leaf01 swp53 swp53
2 spine03 swp1 swp1 swp6 swp6
3 border02 swp53 swp53 peerlink.4094 peerlink.4094
4 border01 peerlink.4094 lo
--- --- ----------- --------------- --------------- --------------- ---------------
...
cumulus@switch:~$ netq trace 44:38:39:00:00:3e vlan 10 from 44:38:39:00:00:32
Number of Paths: 16
Number of Paths with Errors: 0
Number of Paths with Warnings: 0
Path MTU: 9000
Id Hop Hostname InPort InTun, RtrIf OutRtrIf, Tun OutPort
--- --- ----------- --------------- --------------- --------------- ---------------
1 1 server01 mac:44:38:39:00
:00:38
2 leaf02 swp1 vni: 10 swp54
3 spine04 swp2 swp2 swp4 swp4
4 leaf04 swp54 vni: 10 bond1
5 server04 uplink
--- --- ----------- --------------- --------------- --------------- ---------------
2 1 server01 mac:44:38:39:00
:00:38
2 leaf02 swp1 vni: 10 swp54
3 spine04 swp2 swp2 swp3 swp3
4 leaf03 swp54 vni: 10 bond1
5 server04 uplink
--- --- ----------- --------------- --------------- --------------- ---------------
3 1 server01 mac:44:38:39:00
:00:38
2 leaf02 swp1 vni: 10 swp53
3 spine03 swp2 swp2 swp4 swp4
4 leaf04 swp53 vni: 10 bond1
5 server04 uplink
--- --- ----------- --------------- --------------- --------------- ---------------
4 1 server01 mac:44:38:39:00
:00:38
2 leaf02 swp1 vni: 10 swp53
3 spine03 swp2 swp2 swp3 swp3
4 leaf03 swp53 vni: 10 bond1
5 server04 uplink
--- --- ----------- --------------- --------------- --------------- ---------------
...
Related Commands
- netq add trace
netq upgrade
Upgrades NetQ on NetQ On-premises Appliances or VMs.
Obtain the software upgrade bundle from the My Mellanox support page.
Syntax
netq upgrade bundle <text-bundle-url>
Required Arguments
| Argument | Value | Description |
|---|---|---|
| bundle | <text-bundle-url> | Upgrade this appliance or VM with the NetQ-x.y.z.tgz package at this location; the full path is required |
Options
None
Command History
A release is included if there were changes to the command, otherwise it is not listed.
| Release | Description |
|---|---|
| 2.4.1 | Introduced; replaced netq upgrade opta config-key and netq upgrade opta tarball |
Sample Usage
cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-3.3.0.tgz
Related Commands
None