NVIDIA MLNX-GW User Manual for NVIDIA Skyway Appliance v8.1.3000
NVIDIA Docs Hub  NVIDIA Networking  Networking Software  Switch Software  NVIDIA MLNX-GW User Manual for NVIDIA Skyway Appliance v8.1.3000  MLNX-GW—Management Interface Commands
NVIDIA MLNX-GW User Manual for NVIDIA Skyway Appliance v8.2.2200

On This Page

MLNX-GW—Management Interface Commands

Interfacedhcp hostname

ip address

ip address <IP address> <netmask>
no ip address

Sets the IP address and netmask of this interface.
The no form of the command clears the IP address and netmask of this interface.

Syntax Description

IP address

IPv4 address.

netmask

Subnet mask of IP address.

Default

0.0.0.0/0

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# ip address 10.10.10.10 255.255.255.0

Related Commands

show interfaces <ifname>

Notes

If DHCP is enabled on the specified interface, then the DHCP IP assignment will hold until DHCP is disabled

ip default-gateway

ip default-gateway <next-hop-IP-address> <interface-name>
no default-gateway <next-hop-IP-address> <interface-name>

Configures a default route.
The no form of the command removes the current default route.

Syntax Description

next hop IP address

Gateway IP address.

interface name

Default gateway interface name.

Default

N/A

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# ip default-gateway mgmt1

Related Commands

Notes

alias

alias <index> ip address < IP address> <netmask>
no alias <index>

Adds an additional IP address to the specified interface. The secondary address will appear in the output of “show interface” under the data of the primary interface along with the alias.
The no form of the command removes the secondary address to the specified interface.

Syntax Description

index

A number that is to be aliased to (associated with) the secondary IP.

IP address

Additional IP address.

netmask

Subnet mask of the IP address.

Default

N/A

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# alias 2 ip address 9.9.9.9 255.255.255.255

Related Commands

show interfaces <ifname>

Notes

  • If DHCP is enabled on the specified interface, then the DHCP IP assignment will hold until DHCP is disabled

  • More than one additional IP address can be added to the interface

mtu

mtu <bytes>
no mtu <bytes>

Sets the Maximum Transmission Unit (MTU) of this interface.
The no form of the command resets the MTU to its default.

Syntax Description

bytes

The entry range is 68-1500.

Default

1500

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# mtu 1500

Related Commands

show interfaces <ifname>

Notes

duplex

duplex <duplex>
no duplex

Sets the interface duplex.
The no form of the command resets the duplex setting for this interface to its default value.

Syntax Description

duplex

Sets the duplex mode of the interface.
Possible values:

  • half—half duplex

  • full—full duplex

  • auto—auto duplex sensing (half or full)

Default

auto

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# duplex auto

Related Commands

show interfaces <ifname>

Notes

  • Setting the duplex to “auto” also sets the speed to “auto”

  • Setting the duplex to one of the settings “half” or “full” also sets the speed to a manual setting which is determined by querying the interface to find out its current auto-detected state

speed

speed <speed>
no speed

Sets the interface speed.
The no form of the command resets the speed setting for this interface to its default value.

Syntax Description

speed

Sets the speed of the interface. The following are the possible values:

  • 10—fixed to 10Mbps

  • 100—fixed to 1000Mbps

  • 1000—fixed to 1000Mbps

  • auto—auto speed sensing (10/100/1000Mbps)

Default

auto

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# speed auto

Related Commands

show interfaces <ifname>

Notes

  • Setting the speed to “auto” also sets the duplex to “auto”

  • Setting the speed to one of the manual settings (generally, “10”, “100”, or “1000”) also sets the duplex to a manual setting which is determined by querying the interface to find out its current auto-detected state

dhcp

dhcp [renew]
no dhcp

Enables DHCP on the specified interface.
The no form of the command disables DHCP on the specified interface.

Syntax Description

renew

Forces a renewal of the IP address. A restart on the DHCP client for the specified interface will be issued.

Default

N/A

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# dhcp

Related Commands

show interfaces <ifname> configured

Notes

  • When enabling DHCP, the IP address and netmask are received via DHCP hence, the static IP address configuration is ignored

  • Enabling DHCP disables zeroconf and vice versa

  • Setting a static IP address and netmask does not disable DHCP. DHCP is disabled using the “no” form of this command or by enabling zeroconf

dhcp hostname

dhcp hostname
no dhcp hostname

Enables fetching the hostname from DHCP for this interface.
The no form of the command disables fetching the hostname from DHCP for this interface.

Syntax Description

N/A

Default

Enabled

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# dhcp hostname

Related Commands

hostname <hostname>
show interfaces <ifname> configured

Notes

If a hostname is configured manually by the user, that configuration will override the “dhcp hostname” configuration.

shutdown

shutdown
no shutdown

Disables the specified interface.
The no form of the command enables the specified interface.

Syntax Description

N/A

Default

no shutdown

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# no shutdown

Related Commands

show interfaces <ifname> configured

Notes

zeroconf

zeroconf
no zeroconf

Enables zeroconf on the specified interface. It randomly chooses a unique link-local IPv4 address from the 169.254.0.0/16 block. This command is an alternative to DHCP.
The no form of the command disables the use of zeroconf on the specified interface.

Syntax Description

N/A

Default

no zeroconf

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# zeroconf

Related Commands

show interfaces <ifname> configured

Notes

Enabling zeroconf disables DHCP and vice versa.

comment

comment <comment>
no comment

Adds a comment for an interface.
The no form of the command removes a comment for an interface.

Syntax Description

comment

A free-form string that has no semantics other than being displayed when the interface records are listed.

Default

no comment

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# comment my-interface

Related Commands

Notes

show interfaces mgmt0

show interface mgmt0

Displays information on the management interface configuration and status.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

gateway (config)# show interfaces mgmt0
 
Interface mgmt0 status:
  Comment         :
  Admin up        : yes
  Link up         : yes
  DHCP running    : yes
  IP address      : 10.12.67.33
  Netmask         : 255.255.255.128
  IPv6 enabled    : yes
  Autoconf enabled: no
  Autoconf route  : yes
  Autoconf privacy: no
  DHCPv6 running  : yes (but no valid lease)
  Speed           : 1000Mb/s (auto)
  Duplex          : full (auto)
  Interface type  : ethernet
  Interface source: bridge
  MTU             : 1500
  HW address      : 24:8a:07:53:3d:8e
  Rx:
    2055054  bytes
      28830  packets
          0  mcast packets
          0  discards
          0  errors
          0  overruns
          0  frame
  Tx:
    377716  bytes
      3200  packets
         0  discards
         0  errors
         0  overruns
         0  carrier
         0  collisions
         0  queue len

Related Commands

Notes

show interfaces mgmt0 brief

show interface mgmt0 brief

Displays brief information on the management interface configuration and status.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

gateway (config)# show interfaces mgmt0 brief
  
Interface mgmt0 status:
  Comment         :
  Admin up        : yes
  Link up         : yes
  DHCP running    : yes
  IP address      : 10.12.67.33
  Netmask         : 255.255.255.128
  IPv6 enabled    : yes
  Autoconf enabled: no
  Autoconf route  : yes
  Autoconf privacy: no
  DHCPv6 running  : yes (but no valid lease)
  Speed           : 1000Mb/s (auto)
  Duplex          : full (auto)
  Interface type  : ethernet
  Interface source: bridge
  MTU             : 1500
  HW address      : 24:8a:07:53:3d:8e

Related Commands

Notes

show interfaces mgmt0 configured

show interface mgmt0 configured

Displays configuration information about the specified interface.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

gateway (config)# show interfaces mgmt0 configured
Interface mgmt0 configuration:
  Comment         :
  Enabled         : yes
  DHCP            : yes
  DHCP Hostname   : yes
  Zeroconf        : no
  IP address      :
  Netmask         :
  Autoconf enabled: no
  Autoconf route  : yes
  Autoconf privacy: no
  DHCPv6 enabled  : yes
  IPv6 addresses  : 0
  Speed           : auto
  Duplex          : auto
  MTU             : 1500

Related Commands

Notes

Hostname Resolution

hostname

hostname <hostname>
no hostname

Sets a static system hostname.
The no form of the command clears the system hostname.

Syntax Description

hostname

A free-form string

Default

Default hostname

Configuration Mode

config

History

8.0.0100

Example

gateway (config)# hostname my-gateway-hostname

Related Commands

show hosts

Notes

  • Hostname may contain letters, numbers, periods ("."), and hyphens ("-"), in any combination

  • Hostname may be 1-63 characters long

  • Hostname may not begin with a hyphen

  • Hostname may not contain other characters, such as “%”, “_”, and so forth

  • Hostname may not be set to one of the valid logging commands (i.e., debug-files, fields, files, format, level, local, monitor, receive, trap)

  • Changing the hostname stamps a new HTTPS certificate

ip name-server

ip name-server <IPv4 address>
no ip name-server <IPv4 address>

Sets the static name server.
The no form of the command clears the name server.

Syntax Description

IPv4 address

IPv4 address.

Default

No server name

Configuration Mode

config

History

8.0.0100

Example

gateway (config)# ip name-server 9.9.9.9

Related Commands

show hosts

Notes

ip domain-list

ip domain-list <domain-name>
no ip domain-list <domain-name>

Sets the static domain name.
The no form of the command clears the domain name.

Syntax Description

domain-name

The domain name in a string form.
A domain name is an identification string that defines a realm of administrative autonomy, authority, or control in the Internet.

Default

No static domain name

Configuration Mode

config

History

8.0.0100

Example

gateway (config)# ip domain-list mydomain.com

Related Commands

show hosts

Notes

show hosts

show hosts

Displays hostname, DNS configuration, and static host mappings.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

gateway (config)# show hosts
Hostname: gateway1
Name servers:
 10.7.77.192 dynamic (DHCP on mgmt0)
 10.7.77.135 dynamic (DHCP on mgmt0)
 10.198.0.169 dynamic (DHCP on mgmt0)
 (*) 10.211.0.124 dynamic (DHCP on mgmt0)
Domain names:
 mtl.labs.mlnx dynamic (DHCP on mgmt0)
(*) Inactive due to system limits on name servers and domain names.
Static IPv4 host mappings:
 10.7.144.133 --> gateway1
 127.0.0.1 --> localhost
Automatically map hostname to loopback address : yes

Related Commands

Notes

Routing

ip route

ip route{<network-prefix> <netmask> | <network-prefix>/<masklen>} <next-hop>
no ip route [vrf <vrf-name>] {<network-prefix> <netmask> | <network-prefix>/<masklen>} <next-hop>

Sets a static route for a given IP.
The no form of the command deletes the static route.

Syntax Description

network-prefix

IPv4 network prefix

netmask

IPv4 netmask formats are:

  • /24

  • 255.255.255.0

nexthop-address

The IPv4 address of the next hop router for this route.

ifname

The interface name (e.g., mgmt0, mgmt1).

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

gateway (config)# ip route 20.20.20.0 255.255.255.0 mgmt0

Related Commands

show ip route

Notes

Network to Media Resolution (ARP & NDP)

IPv4 network use Address Resolution Protocol (ARP) to resolve IP address to MAC address.

arp

arp <ip-address> <mac-address>
no arp <ip-address> <mac-address>

Sets a static ARP entry.
The no form of the command deletes the static ARP.

Syntax Description

ip-address

IPv4 address.

mac-address

MAC address.

Default

N/A

Configuration Mode

config interface management

History

8.0.0100

Example

gateway (config interface mgmt0)# arp 20.20.20.20 aa:aa:aa:aa:aa:aa

Related Commands

show arp

Notes

clear arp-cache

clear arp-cache

Clears the dynamic entries from the ARP cache.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

switch (config) # clear arp-cache

Related Commands

show arp

Notes

show arp

show arp [static]

Displays ARP table.

Syntax Description

static

Displays all statically-configured ARP entries

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

switch (config) # show arp
ARP cache contents
IP 10.7.144.1 maps to Hardware Address 00:00:5E:00:01:01 (interface mgmt0)
IP 10.7.148.8 maps to Hardware Address C4:00:AD:77:52:FD (interface mgmt0)
IP 10.7.148.64 maps to Hardware Address C4:00:AD:7A:37:BD (interface mgmt0)
IP 192.192.7.2 maps to Hardware Address 1C:34:DA:16:67:88 (interface eth po 1)
IP 193.193.7.3 maps to Hardware Address B8:CE:F6:03:00:75:6E:DA (interface ib po 1)
IP 193.193.7.4 maps to Hardware Address B8:CE:F6:03:00:68:7E:8A (interface ib po 1)
IP 193.193.7.11 maps to Hardware Address 98:03:9B:03:00:9F:D5:16 (interface ib po 1)
IP 193.193.7.31 maps to Hardware Address 98:03:9B:03:00:9F:D5:16 (interface ib po 1)
IP 193.193.7.32 maps to Hardware Address 98:03:9B:03:00:9F:D5:16 (interface ib po 1)
IP 193.193.7.33 maps to Hardware Address 98:03:9B:03:00:9F:D5:16 (interface ib po 1)
switch (config) # show arp static
Static ARP entries
IP 191.191.7.1 maps to MAC 1C:34:DA:16:67:88
IP 191.191.7.2 maps to MAC 1C:34:DA:16:67:88
IP 192.192.7.2 maps to MAC 1C:34:DA:16:67:88

Related Commands

Notes

DHCP

ip dhcp

ip dhcp {default-gateway yield-to-static | hostname <hostname>| primary-intf <ifname> | send-hostname}
no ip dhcp {default-gateway yield-to-static| hostname | | primary-intf | send-hostname}

Sets global DHCP configuration.
The no form of the command deletes the DHCP configuration.

Syntax Description

yield-to-static

Does not allow you to install a default gateway from DHCP if there is already a statically configured one.

hostname

Specifies the hostname to be sent during DHCP client negotiation if send-hostname is enabled.

primary-intf <ifname>

Sets the interface from which a non-interface-specific configuration (resolver and routes) will be accepted via DHCP.

send-hostname

Enables the DHCP client to send a hostname during negotiation.

Default

no ip dhcp yield-to-static
no ip dhcp hostname
ip ip dhcp primary-intf mgmt0
no ip dhcp send-hostname

Configuration Mode

config

History

8.0.0100

Example

gateway (config)# ip dhcp default-gateway yield-to-static

Related Commands

show ip dhcp
dhcp [renew]

Notes

DHCP is supported for IPv4 networks only.

show ip dhcp

show ip dhcp

Displays the DHCP configuration and status.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

gateway (config)# show ip dhcp
----------------------------------------
Interface     DHCP      DHCP      Valid
              Enabled   Running   lease
----------------------------------------
dummy0        no        no        no
lo            no        no        no
mgmt0         yes       yes       yes
mgmt1         no        no        no
mgmts0        no        no        no
mgmts1        no        no        no
vif1          no        no        no
IPv4 dhcp default gateway yields to static configuration: no
DHCP primary interface:
   Configured: mgmt0
   Active: mgmt0
DHCP client options:
   Send Hostname: no
   Client Hostname: 1.1.1.1

Related Commands

ip dhcp
dhcp [renew]

Notes

IP Diagnostic Tools

ping

ping [-LRUbdfnqrvVaA] [-c count] [-i interval] [-w deadline] [-p pattern] [-s packetsize] [-t ttl] [-I interface or address] [-M mtu discovery hint] [-S sndbuf] [-T timestamp option ] [-Q tos ] [hop1 ...] destination

Sends ICMP echo requests to a specified host.

Syntax Description

Linux Ping options

https://www.lifewire.com/uses-of-command-ping-2201076

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

gateway (config)# ping 172.30.2.2
PING 172.30.2.2 (172.30.2.2) 56(84) bytes of data.
64 bytes from 172.30.2.2: icmp_seq=1 ttl=64 time=0.703 ms
64 bytes from 172.30.2.2: icmp_seq=2 ttl=64 time=0.187 ms
64 bytes from 172.30.2.2: icmp_seq=3 ttl=64 time=0.166 ms
64 bytes from 172.30.2.2: icmp_seq=4 ttl=64 time=0.161 ms
64 bytes from 172.30.2.2: icmp_seq=5 ttl=64 time=0.153 ms
64 bytes from 172.30.2.2: icmp_seq=6 ttl=64 time=0.144 ms
...
--- 172.30.2.2 ping statistics ---
6 packets transmitted, 6 received, 0% packet loss, time 5004ms
rtt min/avg/max/mdev = 0.144/0.252/0.703/0.202 ms

Related Commands

traceroutes

Notes

traceroute

traceroute [-46dFITUnrAV] [-f first_ttl] [-g gate,...] [-i device] [-m max_ttl] [-N squeries] [-p port] [-t tos] [-l flow_label] [-w waittime] [-q nqueries] [-s src_addr] [-z sendwait] host [packetlen]

Traces the route packets take to a destination.

Syntax Description

-4

Uses IPv4.

-d

Enables socket level debugging.

-F

Sets DF (do not fragment bit) on.

-I

Uses ICMP ECHO for tracerouting.

-T

Uses TCP SYN for tracerouting.

-U

Uses UDP datagram (default) for tracerouting.

-n

Does not resolve IP addresses to their domain names.

-r

Bypasses the normal routing and send directly to a host on an attached network.

-A

Performs AS path lookups in routing registries and print results directly after the corresponding addresses.

-V

Prints version info and exit.

-f

Starts from the first_ttl hop (instead from 1).

-g

Routes packets through the specified gateway (maximum 8 for IPv4 and 127 for IPv6).

-i

Specifies a network interface with which to operate.

-m

Sets the max number of hops (max TTL to be reached). Default is 30.

-N

Sets the number of probes to be tried simultaneously (default is 16).

-p

Uses destination port. It is an initial value for the UDP destination port (incremented by each probe, default is 33434), for the ICMP seq number (incremented as well, default from 1), and the constant destination port for TCP tries (default is 80).

-t

Sets the TOS (IPv4 type of service) or TC (IPv6 traffic class) value for outgoing packets.

-l

Uses specified flow_label for IPv6 packets.

-w

Sets the number of seconds to wait for response to a probe (default is 5.0). Non-integer (float point) values allowed too.

-s

Uses source src_addr for outgoing packets.

-q

Sets the number of probes per each hop. Default is 3.

-z

Sets minimal time interval between probes (default is 0). If the value is more than 10, then it specifies a number in milliseconds, else it is a number of seconds (float point values allowed too).

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

gateway (config)# traceroute 192.168.10.70
traceroute to 192.168.10.70 (192.168.10.70), 30 hops max, 40 byte packets
1 172.30.0.1 (172.30.0.1) 3.632 ms 2.849 ms 3.544 ms
2 10.222.128.46 (10.222.128.46) 3.176 ms 3.289 ms 3.656 ms
3 10.158.128.30 (10.158.128.30) 15.331 ms 15.819 ms 16.388 ms
4 10.158.128.65 (10.158.128.65) 20.468 ms 7.893 ms 12.27 ms
5 10.7.34.115 (10.7.34.115) 16.405 ms 11.985 ms 12.264 ms6 192.168.10.70 (192.168.10.70) 16.377 ms 16.091 ms 20.475 ms

Related Commands

ping

Notes

tcpdump

tcpdump [-aAdDeflLnNOpqRStuUvxX] [-c count] [-C file_size] [-E algo:secret] [-F file] [-i interface] [-M secret] [-r file] [-s snaplen] [-T type] [-w file] [-W filecount] [-y datalinktype] [-Z user] [-D list possible interfaces] [expression]

Invokes standard binary, passing command line parameters straight through. Runs in foreground, printing packets as they arrive, until the user hits Ctrl+C.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

gateway (config)# tcpdump
......
09:37:38.678812 IP 192.168.10.7.ssh > 192.168.10.1.54155: P 1494624:1494800(176) ack 625 win 90
<nop,nop,timestamp 5842763 858672398>
09:37:38.678860 IP 192.168.10.7.ssh > 192.168.10.1.54155: P 1494800:1495104(304) ack 625 win 90
<nop,nop,timestamp 5842763 858672398>
...
9141 packets captured
9142 packets received by filter
0 packets dropped by kernel

Related Commands

Notes

© Copyright 2023, NVIDIA. Last updated on May 23, 2023.