MLNX-GW—Routing Overview
The following pages provide information on configuring IP routing (L3) protocols and features.
show interfaces ethernet
show interfaces ethernet [<interface>] Displays information on 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 | gateway (config) # show interfaces ethernet 1/2 Eth1/2: Admin state : Enabled Rx: Tx: | |
Related Commands | show interfaces ib | |
Notes |
|
show interfaces ethernet port-channel
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 | gateway (config) # show interfaces ethernet port-channel 1 Admin state : Enabled Rx: Tx: | |
Related Commands | show interfaces ethernet | |
Notes |
|
interface ethernet shutdown
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 | gateway (config) # interface ethernet 1/2 shutdown | |
Related Commands | show interfaces ethernet | |
Notes | For version 8.0.0100, the only valid interface is “1/2” |
interface ethernet port-channel shutdown
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 | gateway (config) # interface ethernet port-channel 1 shutdown | |
Related Commands | show interfaces ethernet port-channel | |
Notes |
|
interface ethernet port-channel description
interface ethernet port-channel <port-channel> description <description> Adds 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 | gateway (config) # interface ethernet port-channel 1 description | |
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 mtu
interface ethernet port-channel <port-channel> mtu <mtu> Configures the Maximum Transmission Unit (MTU) frame size for the interface. | ||
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 | gateway (config) # interface ethernet port-channel 1 mtu 1600 | |
Related Commands | show interfaces ethernet port-channel | |
Notes |
|
interface ethernet port-channel ip address
interface ethernet port-channel <port-channel> ip address <ip-address> <mask> Enters user-defined IPv4 address for the interface. | ||
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:
| |
Default | N/A | |
Configuration Mode | config | |
History | 8.0.0100 | |
8.0.1600 | Added note | |
Example | gateway (config) # interface ethernet port-channel 1 ip address 1.1.1.1/24 | |
Related Commands | show interfaces ethernet port-channel | |
Notes |
|
show interfaces ib
show interfaces ib [<interface>] Displays information on 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 | gateway (config) # show interfaces ib 1/1 IB1/1 state: Logical port state : Active RX bytes : 7200 TX bytes : 7200 | |
Related Commands | show interfaces ethernet | |
Notes |
|
show interfaces ib port-channel
show interfaces ib port-channel [<port-channel>] Displays information on Infiniband port-channel interfaces. | ||
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 | |
Notes |
|
interface ib shutdown
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 | gateway (config) # interface ib 1/1 shutdown | |
Related Commands | show interfaces ib | |
Notes | For version 8.0.0100, the only valid interface is “1/1” |
interface ib port-channel shutdown
interface ib port-channel <port-channel> shutdown Disables 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 | gateway (config) # interface ib port-channel 1 shutdown | |
Related Commands | show interfaces ib port-channel | |
Notes |
|
interface ib port-channel description
interface ib port-channel <port-channel> description <description> Adds 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 | gateway (config) # interface ib port-channel 1 description | |
Related Commands | show interfaces ib port-channel | |
Notes |
|
interface ib port-channel mtu
interface ib port-channel <port-channel> mtu <mtu> Configures the Maximum Transmission Unit (MTU) frame size for the interface. | ||
Syntax Description | port-channel | Subnet number whose properties to display (e.g., 1). |
mtu | Frame-size.
| |
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 | gateway (config) # interface ib port-channel 1 mtu 4092 | |
Related Commands | show interfaces ib port-channel | |
Notes |
|
interface ib port-channel ip address
interface ib port-channel <port-channel> ip address <ip-address> <mask> Enters user-defined IPv4 address for the interface. | ||
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:
| |
Default | N/A | |
Configuration Mode | config | |
History | 8.0.0100 | |
8.0.1610 | Added PKEY option | |
8.0.2300 | Removed PKEY option | |
Example | gateway (config) # interface ib port-channel 1 ip address 1.1.1.1/24 | |
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 virtual ip address
interface ib port-channel <port-channel> virtual ip address <ip/mask> Sets 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 | gateway (config) # interface ib port-channel 1 virtual ip address 4.4.4.4/24 | |
Related Commands | interface ib port-channel ip address | |
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:
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 route <ip-prefix> <netmask> {<next -hop-ip-address> | ethernet <port>} [<distance>] Configures a static route. | |||
Syntax Description | ip-prefix | IP address. | |
netmask | There are two possible ways to input the mask:
| ||
next-hop-ip-address | IP address of the next hop | ||
Default | N/A | ||
Configuration Mode | config | ||
History | 8.0.0100 | ||
Example | gateway (config) # ip route 80.80.80.0 /24 20.20.20.2 | ||
Related Commands | show ip route | ||
Notes | The route is configurable between the Ethernet and Infiniband subnets |
show ip route
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 |
|
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 | |
Default | N/A | |
Configuration Mode | config | |
History | 8.0.0100 | |
Example | gateway (config) # ping 172.30.2.2 | |
Related Commands | traceroute | |
Notes | When using -I option use the interface name + interface number, for example “ping -I vlan10” |
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 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) | |
-N | Sets the number of probes to be tried simultaneously | |
-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 | |
-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 | gateway (config) # traceroute 192.168.10.70 | |
Related Commands | ||
Notes |
|
tcpdump
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 | ||
gateway (config) # tcpdump | ||
Related Commands | ||
Notes |
|
gw ha
gw ha <domain_ID> [force] Create or join gateway HA cluster with a given domain ID. | ||
Syntax Description | domain id | Domain ID |
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 |
|
gw ha priority
gw ha priority <priority> Configure the priority of the system. | ||
Syntax Description | priority | Range:1-255 |
Default | 100 | |
Configuration Mode | config | |
History | 8.1.0500 | |
Example | gateway (config) # gw ha priority 3 | |
Related Commands | gw ha | |
Notes |
show gw ha
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
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 | |
Notes | This command will only be available if the system is configured to be part of an HA cluster. |
show gw ha vf distribution
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 | |
Notes | This command will only be available if the system is configured to be part of an HA cluster. |
show gw vf distribution
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 |
-------------------------------------------------------------------- 1/1 0,1 2 | |
Related Commands | ||
Notes |