MLNX-GW—Routing Overview

show interfaces ethernet [<interface>]

Displays information on Ethernet interfaces.
If the interface is not specified, then the command prints all the Ethernet interfaces.

Syntax Description

Interface

Device/port (e.g., 1/2).

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

8.0.1610

Added notes

8.0.3000

Updated example to reflect port channel field

Example

Related Commands

show interfaces ib
show interfaces ethernet port-channel

Notes

• For version 8.0.0100, the only valid interface is “1/2”

• If the peer IB port is down, the message below will appear in brackets as part of the Operational State of the Ethernet port: "IB port down". 
  The peer port of the Ethernet port is the IB port on the same device, for example "1/1" is the peer of "1/2".

• If LAG is not configured correctly on the ethernet router, the message below will appear in brackets as part of the Operational State of the Ethernet port: "Suspended". 
  This message has higher priority than the "IB port down" message.

• If an Ethernet port channel is down, the message below will appear on brackets as part of the Operational State of the Ethernet port: "inherited down".
  This message has higher priority then the "IB port down" and "Suspended" messages.

show interfaces ethernet port-channel [<port-channel>]

Displays information on Ethernet port-channel interfaces.If the port-channel number is not specified, then the command prints all the Ethernet port-channels.

Syntax Description

Port-channel

LAG  number whose properties to display (e.g., 1).

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

Example

Related Commands

show interfaces ethernet
show interfaces ib port-channel

Notes

• For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

• If IP is not configured, then the IPv4 and Broadcast addresses will not be shown

interface ethernet <interface> shutdown
no interface ethernet <interface> shutdown

Disables/Enables Ethernet physical interface.

Syntax Description

Interface

Device/port (e.g., 1/2).

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

Related Commands

show interfaces ethernet
interface ethernet port-channel shutdown

Notes

For version 8.0.0100, the only valid interface is “1/2”

interface ethernet port-channel <port-channel> shutdown
no interface ethernet port-channel <port-channel> shutdown

Disables/Enables Ethernet port-channel interface.

Syntax Description

Port-channel

LAG  number whose properties to display (e.g., : 1).

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

Related Commands

show interfaces ethernet port-channel
interface ethernet shutdown

Notes

• For version 8.0.0100, the command will not have impact—to shut down the ethernet interface use “interface ethernet shutdown”

• For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

interface ethernet port-channel <port-channel> description <description>
no interface ethernet port-channel <description> description

Adds a description for an interface.
The no form of the command removed a description for an interface.

Syntax Description

Port-channel

LAG  number whose properties to display (e.g., : 1).

Description

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

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

Related Commands

show interfaces ethernet port-channel

Notes

For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

interface ethernet port-channel <port-channel> mtu <mtu>
no interface ethernet port-channel <port-channel> mtu

Configures the Maximum Transmission Unit (MTU) frame size for the interface.
The no form of the command resets the MTU to its default value.

Syntax Description

Port-channel

LAG  number whose properties to display (e.g., : 1).

Frame-size

The range of the entry is: 1500-9216

Default

1500

Configuration Mode

config

History

8.0.0100

8.0.1600

Added note

Example

Related Commands

show interfaces ethernet port-channel

Notes

• For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

• When configuring MTU, make sure the value is 2 bytes less than the InfiniBand port channel, using the command "interface ib port-channel mtu"

interface ethernet port-channel <port-channel> ip address <ip-address> <mask>
no interface ethernet port-channel <port-channel> ip address [<ip-address>]

Enters user-defined IPv4 address for the interface.
The no form of the command removes the specified IPv4 address. If no address is specified, then all IPv4 addresses of this interface are removed.

Syntax Description

Port-channel

LAG  number whose properties to display (e.g., : 1).

Ip-address

IPv4 address

mask

There are two possible ways to the mask:

•  /length (i.e. /24)

•  Network address (i.e. 255.255.255.0) The mask length may be configured without a space (i.e. <ipv4-address>/<length>)

Default

N/A

Configuration Mode

config

History

8.0.0100

8.0.1600

Added note

Example

Related Commands

show interfaces ethernet port-channel

Notes

• For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

• In version 8.0.1600, configuring IP on IB port-channel configures additional IP on one of the physical IB interfaces which is formed by incrementing the passed IP address by one.
  For example, running the command "interface ib port-channel 1 ip address 1.1.1.1/24" will configure the IP addresses "1.1.1.1" and "1.1.1.2" on one of the physical IB interfaces.

show interfaces ib [<interface>]

Displays information on Infiniband interfaces.
If the interface is not specified, then the command prints all the Infiniband interfaces.

Syntax Description

Interface

Device/port (e.g., : 1/1).

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

8.0.1610

Added note

8.0.2300

Added note

Example

Related Commands

show interfaces ethernet
show interfaces ib port-channel

Notes

• For version 8.0.0100, the only valid interface is “1/1”

• If the peer Ethernet port is down, the message below will appear in brackets as part of the Operational State of the IB port: "ETH port down".
  The peer port of the IB port is the Ethernet port on the same device, for example "1/2" is the peer of "1/1".

• MTU shows the actual L2 MTU configured in the subnet.

show interfaces ib port-channel [<port-channel>] 

Displays information on Infiniband port-channel interfaces.
If the port-channel number is not specified, then the command prints all the Infiniband port-channels. 

Syntax Description

Port-channel

Subnet number whose properties are to be displayed (e.g., : 1). 

Default

N/A

Configuration Mode

Any command mode

History

8.0.0100

8.0.1610

Added PKEY option

8.0.2300

Removed PKEY option

Example

Related Commands

show interfaces ib
show interfaces ethernet port-channel
interface ib port-channel ip address
interface ib port-channel virtual ip address

Notes

• For versions 8.0.01xx to 8.0.23xx, the only valid port-channel number is 1

• If IP is not configured, then the IPv4 and Broadcast addresses will not be shown

• This show command takes data from the Linux and should reflect the IP addresses currently installed. In case one address was not installed, N/A will be displayed. One of the following reasons will be displayed in brackets:

interface ib <interface> shutdown
no interface ib <interface> shutdown

Disables/Enables Infiniband physical interface.

Syntax Description

Interface

Device/port (e.g., : 1/1).

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

Related Commands

show interfaces ib
interface ib port-channel shutdown

Notes

For version 8.0.0100, the only valid interface is “1/1”

interface ib port-channel <port-channel> shutdown
no interface ib port-channel <port-channel> shutdown

Disables InfiniBand port-channel interface.
The no form enables InfiniBand port-channel interface.

Syntax Description

port-channel

Subnet number (e.g., 1). 

Default

N/A

Configuration Mode

config

History

8.0.0100

8.0.1610

Added PKEY option

8.0.2300

Removed PKEY option

Example

Related Commands

show interfaces ib port-channel
interface ib shutdown

Notes

• For version 8.0.0100, the command will not have impact—to shut down the ib interface use “interface ib shutdown”

• For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

interface ib port-channel <port-channel> description <description>
no interface ib port-channel <port-channel> description

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

Syntax Description

port-channel

Subnet number whose properties to display (e.g., 1). 

Description

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

Default

N/A

Configuration Mode

config

History

8.0.0100

8.0.1610

Added PKEY option

8.0.2300

Removed PKEY option

Example

Related Commands

show interfaces ib port-channel

Notes

• For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

interface ib port-channel <port-channel> mtu <mtu>
no interface ib port-channel <port-channel> mtu

Configures the Maximum Transmission Unit (MTU) frame size for the interface.
The no form of the command resets the MTU to its default value.

Syntax Description

port-channel

Subnet number whose properties to display (e.g., 1). 

mtu

Frame-size.
Possible values for MTU:

• 252

• 508

• 1020

• 2044

• 4092

Default

2044

Configuration Mode

config

History

8.0.0100

8.0.1600

Added note

8.0.1610

Added PKEY option

8.0.2300

Removed PKEY option

Example

Related Commands

show interfaces ib port-channel

Notes

• For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

• For version 8.0.0100, possible mtu values are 2044 and 4092. If other values are configured, they will be automatically upgraded to 2044

• When configuring MTU, make sure the value is 2 bytes greater than the Ethernet port channel using the command  "interface ethernet port-channel mtu"

interface ib port-channel <port-channel> ip address <ip-address> <mask>
no interface ib port-channel <port-channel> ip address [<ip-address>]

Enters user-defined IPv4 address for the interface.
The no form of the command removes the specified IPv4 address. If no address is specified, then all IPv4 addresses of this interface are removed.

Syntax Description

port-channel

Subnet number whose properties to display (e.g., 1).

ip-address

IPv4 address.

mask

There are two possible ways to the mask:

•  /length (i.e. /24)

•  Network address (i.e. 255.255.255.0) The mask length may be configured without a space (i.e. <ipv4-address>/<length>)

Default

N/A

Configuration Mode

config

History

8.0.0100

8.0.1610

Added PKEY option

8.0.2300

Removed PKEY option

Example

Related Commands

show interfaces ib port-channel

Notes

For versions 8.0.01xx and 8.0.16xx, the only valid port-channel number is 1

interface ib port-channel <port-channel> virtual ip address <ip/mask>
no interface ib port-channel <port-channel> virtual ip address <ip/mask>

Sets virtual IP address and mask over IB port-channel interface.
The no form of the command unsets virtual IP address and mask over IB port-channel interface.

Syntax Description

ip/mask

IPv4 address and mask values

port-channel

Subnet number whose properties to display (e.g., 1)

Default

N/A

Configuration Mode

config

History

8.0.2300

Example

Related Commands

interface ib port-channel ip address
show interfaces ib port-channel

Notes

This command is related to regular IP configuration over the IB port-channel interface. To get the virtual IP set up to handle traffic, a few requirements should be met:

• Both regular and virtual IP should be configured

• Both regular and virtual IP should be from the same subnet

In case one of the definitions is not true, configuration will be accepted but not actually installed in Linux and a relevant message will appear in the CLI show command.

ip route <ip-prefix> <netmask> {<next -hop-ip-address> | ethernet <port>} [<distance>]
no ip route <ip-prefix> <netmask> [<next -hop-ip-address>]

Configures a static route.
The no form of the command removes the static route configured.

Syntax Description

ip-prefix

IP address.

netmask

There are two possible ways to input the mask:

• /<length> (e.g., /24)

• Network address (e.g., 255.255.255.0)

next-hop-ip-address

IP address of the next hop

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

Related Commands

show ip route

Notes

The route is configurable between the Ethernet and Infiniband subnets

show ip route [static] 

Displays routing table.

Syntax Description

static

Displays entries added through CLI commands.

Configuration Mode

config

History

8.0.0100

Example

Related Commands

ip route

Notes

• If no default route exists, then the message “Route not found” is printed

• Route next hop is BFD controlled, status is viewable when <all> is inserted in the command, and it will be shown as follows:

  • If route is removed from routing decision it will be marked as “Active”

  • Protected next hops are marked with “B”

  • BFD protected failed/non active neighbors are marked with “BF”

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

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

Related Commands

traceroute

Notes

When using -I option use the interface name + interface number, for example “ping -I vlan10”

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 throw the specified gateway (maximum 8 for IPv4 and 127 for IPv6)

-i

Specifies a network interface to operate with

-m

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

-N

Sets the number of probes to be tried simultaneously
Default: 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.

-q

Sets the number of probes per each hop
Default: 3

-s

Uses source src_addr for outgoing packets

-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

Related Commands

Notes

• The following flags are not supported: -6, -l, -A

• When using -i option use the interface name + interface number, for example “traceroute -i mgmt0”

tcpdump[-aAdeflLnNOpqRStuUvxX] [-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] [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

Linux Ping options

Default

N/A

Configuration Mode

config

History

8.0.0100

Example

Related Commands

Notes

• When using -i option use the interface name + interface number, for example “tcpdump -i mgmt0”

• For all flag options of this command refer to the linux ‘man page’ of tcp dump

gw ha <domain_ID> [force]
no gw ha

Create or join gateway HA cluster with a given domain ID. 
The no form of this command removes the appliance from the gateway HA cluster.

Syntax Description

domain id

Domain ID
Range:1-16

force

Force reboots the configuration and reloads without being asking for user confirmation.

Default

N/A

Configuration Mode

config

History

8.1.0500

Example

Related Commands

show gw ha

Notes

• This command requires reloading the appliance.

• If the force flag is not added, a question will appear once the command is executed and system will save configuration reload after approval is given.

gw ha priority <priority>
no gw ha priority

Configure the priority of the system.
The no form of this command resets the priority to the default value.

Syntax Description

priority

Range:1-255

Default

100

Configuration Mode

config

History

8.1.0500

Example

Related Commands

gw ha

Notes

show gw ha 

Displays information of all the appliances that are a part of the same HA cluster (i.e., that are a part of the same domain ID)

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

8.1.0500

Example

When appliance is part of HA:

When appliance is not part of HA:

Related Commands

gw ha

Notes

show gw ha brief

Displays brief gateway HA information. 

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

8.1.0500

Example

Related Commands

gw ha
show gw ha

Notes

This command will only be available if the system is configured to be part of an HA cluster. 

show gw ha vf distribution

Displays the VFs distribution between the appliances that are a part of HA cluster. 

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

8.1.0500

Example

Related Commands

gw ha
show gw ha

Notes

This command will only be available if the system is configured to be part of an HA cluster. 

show gw vf distribution

Displays the internal VFs distribution of the GW appliance.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

8.1.0500

Example

Related Commands

Notes