If you are using the current version of Cumulus NetQ, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

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:

  • <1-xx>s: number of seconds
  • <1-xx>m: number of minutes
  • <1-xx>h: number of hours
  • <1-xx>d: number of days

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
--- --- ----------- --------------- --------------- --------------- ---------------
...
  • 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

None