General IP Routing Commands

ip l3 [force]
no ip l3 [force]

Enables IP routing capabilities.
The no form of the command disables IP routing and removes its configuration.

switch (config) # ip l3 force

"no ip l3" command does not remove management VRF or management services that are configured in it.

vrf definition <vrf-name> [force]
no vrf definition <vrf-name> [force]

Creates the VRF.

switch (config) # vrf definition my-vrf
switch (config vrf definition my-vrf) #

• 63 VRFs are supported aside from the default VRF
• In case of "mgmt" VRF creation, CLI will ask permission to save the current configuration (behave like "configuration write") and reload the system. If "force" option was passed, then no confirmation is needed.
  After reboot, mgmt VRF will be created with management interfaces in it. Also, clustered, mDNS, OpenFlow API and FTP/TELNET servers will run in managemtn VRF when started. All other services does not change their existing configuration.
  
  In case of management VRF removal, the CLI will ask permission to remove services that running in management VRF, save new configuration, and reboot the switch. If "force" option was passed, no confirmation is needed.
  
  After reboot, mgmt VRF will be removed and  management interfaces will be moved to "default" VRF. Also, clusterd, mDNS, OpenFlow API, and FTP/TELNET servers will run in "default" VRF when started. Other services that were enabled in management VRF will be disabled, except ones that are enabled by default (i.e., "ntp", "snmp-server", "tacacs-server", "radius-server", "ldap", "web", and so forth)—they will be reset and enabled in "default" VRF. The logic of moving/shutting down services from removed VRF could be applied for ALL user-defined VRF`s.

routing-context vrf <vrf-name>

Enters the active-context of the specified session.

Syntax Description

Default

Configuration Mode

History

Example

switch (config) # routing-context vrf my-vrf

Related Commands

Notes

• If a routing-context is configured, the user does not have to explicitly specify the VRF name parameter in this or any other VRF command
• If no routing-context is configured and the user does not specify the VRF name, default VRF is used

ip routing [vrf <vrf-name>]

Enables L3 forwarding between high speed interfaces.

switch (config) # ip routing vrf my-vrf

• RD must be configured to enable IP routing on the VRF
• If no routing-context is specified, the “routing-context” VRF is automatically configured.

switch (config vrf definition my-vrf) # description vrf-description

vrf forwarding <vrf-name>

Maps an interface to VRF.

Syntax Description

Default

Configuration Mode

config interface ethernet set as router port interface
config interface vlan
config interface loopback

History

Example

switch (config interface ethernet 1/2) # vrf forwarding my-vrf

Related Commands

Notes

clear ip routing counters

Clears counters, related to NULL interface and dropped packets by router.

Syntax Description

Default

Configuration Mode

History

Example

switch (config) # clear ip routing counters

Related Commands

Notes

show ip routing [vrf <vrf-name> | all]

Displays IP routing information per VRF.

Syntax Description

Default

Configuration Mode

History

Example

Related Commands

Notes

show ip routing [vrf <vrf-name> | all] counters

Display counters, related to NULL interface and dropped packets by router.

Syntax Description

Default

Configuration Mode

History

switch (config) # show  ip routing counters

0  packets discarded by router
0  bytes discarded by router
0  packets to null interface
0  bytes to null interface

Related Commands

Notes

show routing-context vrf

 Displays VRF active context.

Syntax Description

Default

Configuration Mode

History

Example

switch (config) # show routing-context vrf
VRF active context: my-vrf

Related Commands

Notes

show vrf [<vrf-name> | all]

Displays VRF information.

Syntax Description

Default

Configuration Mode

History

Example

switch (config) # show vrf my-vrf
VRF Info:

   Name: default
   RD: NA
   Description: NA
   IP routing state: Enabled
   IPv6 routing state: Disabled
   IP multicast routing state: Enabled
   Protocols: IPv4, PIM-SM
   Interfaces: Eth1/1

switch (config) # show vrf my-vrf
VRF Info:

   Name: default
   RD: NA
   Description: NA
   IP routing state: Enabled
   IPv6 routing state: Disabled
   IP multicast routing state: Enabled
   Protocols: IPv4, PIM-BIDIR
   Interfaces: Eth1/1

Related Commands

Notes

switchport [force]
no switchport [force]

Configures the Ethernet interface as a regular switchport.
The no form of the command configures the Ethernet interface as router port interface.

Syntax Description

force

Forces configuration even if the interface’s admin state is enabled

Default

N/A

Configuration Mode

config interface ethernet
config interface port-channel

History

3.3.5200

3.6.4006

Added storm-control support

Example

switch (config interface ethernet 1/10)# no switchport force

error message is case storm-control is configured on port:

% interface * has storm control configuration. Please remove it first

Related Commands

Notes

• When storm-control is configured on port, an error message will appear
• Force command deletes all storm-control configuration from port

encapsulation dot1q vlan <vlan-id> [force]
no encapsulation dot1q vlan [force]

Enables L2 802.1Q encapsulation of traffic on a specified router port interface in a VLAN.
The no form of the command disables L2 802.1Q encapsulation of traffic on a specified router port interface in a VLAN.

Syntax Description

vlan-id

Enables L2 802.1Q encapsulation of traffic on a router port interface in a VLAN

force

Forces admin state down

Default

N/A

Configuration Mode

config interface ethernet

History

3.3.5200

Example

switch (config interface ethernet 1/10)# encapsulation dot1q vlan 10

Related Commands

Notes

interface <vlan | ethernet | port-channel> <ifname> ip enable
no interface <vlan | ethernet | port-channel> <ifname> ip enable

Enables IP forwarding on the interface.
The no form of the command disables IP forwarding on the interface.

Syntax Description

vlan

VLAN type interface

ethernet

Ethernet type interface

Default

Disabled

Configuration Mode

config

History

3.9.0300

Example

switch (config interface vlan 10)# ip enable

Related Commands

show ip interface vrf 

Notes

interface vlan <vid>
no interface vlan <vid>

Creates a VLAN interface and enters the interface VLAN configuration mode.
The no form of the command deletes the VLAN interface.

Syntax Description

switch (config) # interface vlan 10
switch (config interface vlan 10) # 

ip routing
vlan <vlan-id>
switchport mode
switchport access
show interface vlan

• Make sure the VLAN was created, using the command “vlan <vlan-id>” in the global configuration mode
• The VLAN must be assigned to one of the L2 interfaces. To do so, run the command “swichport ...”
• At least one interface belong to that VLAN must be in UP state

interface vlan <vid> no-autostate
no interface vlan <id> no-autostate

Disables the VLAN interface autostate such that its operational state remains up as long as its admin state is up, even if no port in the relevant VLAN egress-list is operationally up.
The no form of the command enables this functionality.

Syntax Description

switch (config) # interface vlan 10 no-autostate
switch (config) # interface vlan 10-13 no-autostate

ip address <ip-address> <mask> no ip address [<ip-address> [<mask>]]

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

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>)

switch (config interface vlan 10) # ip address 10.10.10.10 /24

An interface may have up to 16 IPv4 address assignments

counters

no counters

Enables counters on the IP interface. The no form of the command disables counters gathering on the IP interface.

Syntax Description

switch (config interface vlan 10) # counters

• Enabling counters for the router interface adds delay to the traffic stream
• There are maximum of 16 counter sets

description <string>
no description

Enters a description for the interface.
The no form of the command sets the description to default.

Syntax Description

switch (config interface vlan 10) # description my-ip-interface

mtu <size> [force]
no mtu 

Sets the Maximum Transmission Unit for the interface.
The no form of the command sets the MTU to default.

Syntax Description

switch (config interface vlan 10)# mtu 9216

In switches that perform upgrade to version 3.9.2000, existing L3 interfaces will stay with MTU 1500 (or any other value that was configured). Newly created interfaces will be created with MTU 9216 (the new default).

shutdown
no shutdown

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

Syntax Description

switch (config interface vlan 20) # shutdown

clear counters

Clears the interface counters.

Syntax Description

switch (config interface vlan 10) # clear counters

ip icmp redirect
no ip icmp redirect 

Enables ICMP redirect.
The no form of the command disables ICMP redirect.

Syntax Description

switch (config interface vlan 10) # no ip icmp redirect

ICMP redirect transmits messages to hosts alerting them about the existence of more efficient routes to a specific destination

show interfaces [brief]

Displays interface configuration.

Syntax Description

switch (config) # show interfaces

Interface lo status:
  Comment         :
  Admin up        : yes
  Link up         : yes
  DHCP running    : no
...
Interface mgmt0 status:
  Comment         :
  Admin up        : yes
  Link up         : yes
  DHCP running    : yes
...
Interface mgmt1 status:
  Comment         :
  Admin up        : yes
  Link up         : yes
  DHCP running    : yes (but no valid lease)
...
Eth1/1:
  Admin state                      : Enabled
  Operational state                : Up
  Last change in operational status: 0:22:11 ago (5 oper change)
  Boot delay time                  : 0 sec
...

ICMP redirect transmits messages to hosts alerting them about the existence of more efficient routes to a specific destination

show interfaces vlan [<id>] 

Displays interface configuration.

Syntax Description

id

Specifies the VLAN ID for which to display data

Default

N/A

Configuration Mode

Any command mode

History

3.2.3000

3.6.8008

Updated example

Example

switch (config) # show interfaces vlan 100

Vlan 100:
Admin state      : Enabled
Operational state: Down
Autostate        : Enabled
Mac Address      : 24:8A:07:83:30:C8
DHCP client      : Disabled

IPv4 address:
   192.168.70.254/24 [primary]
   192.168.80.254/24

Broadcast address:
   192.168.70.255 [primary]
   192.168.80.255

IPv6 address:
   4000::1/64 [primary]
   5000::1/64

MTU              : 1500 bytes
Arp timeout      : 1500 seconds
Arp responder    : Disabled
Arp cache-update : garp
Icmp redirect    : Enabled
Description      : N/A
VRF              : default
Counters         : Disabled

Related Commands

Notes

show interfaces [<type> <id>] configured 

Displays interface configuration.

Syntax Description

<type> <id>

Specifies the interface for which to display data

Default

N/A

Configuration Mode

Any command mode

History

3.4.2008

3.6.8008

Updated example

Example

switch (config) # show interfaces mgmt0 configured

Interface mgmt0 configuration:
  Comment         :
  Enabled         : yes
  DHCP            : yes
  DHCP Hostname   : yes
  Zeroconf        : no
  IP address      :
  Netmask         :
  IPv6 enabled    : yes
  Autoconf enabled: no
  Autoconf route  : yes
  Autoconf privacy: no
  DHCPv6 enabled  : yes
  IPv6 addresses  : 0
  Speed           : auto
  Duplex          : auto
  MTU             : 1500

Related Commands

Notes

show ip interface [vrf <vrf-name>] mgmt0

Displays management interface information.

Syntax Description

vrf

VRF name

Default

N/A

Configuration Mode

Any command mode

History

3.4.2008

3.6.8008

Updated example

Example

switch (config) # show ip interface 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)
  IPv6 addresses  : 1

  IPv6 address:
    fe80::268a:7ff:fe53:3d8e/64

  Speed           : 1000Mb/s (auto)
  Duplex          : full (auto)
  Interface type  : ethernet
  Interface source: bridge
  MTU             : 1500
  HW address      : 24:8A:07:53:3D:8E

  Rx:
    1843422  bytes
      25627  packets
          0  mcast packets
          0  discards
          0  errors
          0  overruns
          0  frame

  Tx:
    236174  bytes
      1897  packets
         0  discards
         0  errors
         0  overruns
         0  carrier
         0  collisions
         0  queue len

Related Commands

Notes

show ip interface vrf {<vrf-name> | all | ethernet <slot>/<port> | loopback <id> | port-channel <id> | vlan <vid>} [brief]

Displays IP interface information per VRF.

Syntax Description

vrf

Displays IP interface information per VRF

all

Displays information on all VRF

ethernet

Displays Ethernet interface information per VRF

loopback

Displays loopback interface information per VRF

port-channel

Displays LAG information per VRF

vlan

Displays VLAN interface information per VRF

Default

N/A

Configuration Mode

Any command mode

History

3.4.2008

3.6.5000

Updated example

3.6.6000

Updated example

3.6.8008

Updated example

3.7.1000

Updated example

Example

 switch (config) # show ip interface vrf default port-channel 1

Po1:
  Admin state         : Enabled
  Operational state   : Down
  Description         : N/A
  Mac address         : 24:8a:07:83:30:c8
  MTU                 : 1500 bytes (Maximum packet size 1522 bytes)
  lacp-individual mode: Disabled
  Flow-control        : receive off send off
  Actual speed        : 25G (auto)
  Auto-negotiation    : N/A
  Width reduction mode: Not supported
  DHCP client         : Disabled
  Autoconfig          : Disabled
...

Related Commands

Notes

If no routing-context is specified, the “routing-context” VRF is automatically displayed.

show ip interface vrf <vrf-name> vrf

Displays VRF loopback information for a specific VRF.

Syntax Description

vrf-name

VRF name

Default

N/A

Configuration Mode

Any command mode

History

3.9.0300

Example

switch (config) # show ip interface vrf default

Related Commands

show ip interface vrf 

Notes

show ipv6 interface 

Displays IPv6 interface information.

Syntax Description

vrf

VRF name

Default

N/A

Configuration Mode

Any command mode

History

3.6.8008

Example

switch (config) # show ipv6 interface

Eth1/1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled

  IPv6 address:
    2000::1/64 [primary]
    3000::1/64

  Local Link Address:
    fe80::268a:7ff:fe83:30c8/64

  Joined group address:
    ff02::1:ff00:1

  ND retransmit interval (usec): 1000
  ND DAD                       : enabled
  Number of DAD attempts       : 1
  ND reachable time            : 0

Po1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled

  IPv6 address:
    6000::1/64 [primary]
    7000::1/64

ND retransmit interval (usec): 1000
  ND DAD                       : enabled
  Number of DAD attempts       : 1
  ND reachable time            : 0

vlan100:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled

 IPv6 address:
    4000::1/64 [primary]
    5000::1/64

  ICMPv6 redirect              : enabled
  ND retransmit interval (usec): 1000
  ND DAD                       : enabled
  Number of DAD attempts       : 1
  ND reachable time            : 0

loopback1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled

  IPv6 address:
    2001::1/128 [primary]
    2002::1/128

  Local Link Address:
    fe80::4c01:40ff:feb3:b753/64

  Joined group address:
    ff02::1:ff00:1

Related Commands

Notes

show ipv6 interface [vrf <vrf-name>] ethernet <slot>/<port>

Display IPv6 information of the specified Ethernet interface.

Syntax Description

<slot>/<port>

Port number

vrf

VRF name

Default

N/A

Configuration Mode

Any command mode

History

3.6.8008

Example

switch (config) # show ipv6 interface ethernet 1/1

Eth1/1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled

  IPv6 address:
    2000::1/64 [primary]
    3000::1/64

  Local Link Address:
    fe80::268a:7ff:fe83:30c8/64

  Joined group address:
    ff02::1:ff00:1

  ND retransmit interval (usec): 1000
  ND DAD                       : enabled
  Number of DAD attempts       : 1
  ND reachable time            : 0

Related Commands

Notes

show ipv6 interface [vrf <vrf-name>] loopback <id>

Display IPv6 information of the specified loopback interface.

Syntax Description

id

Loopback port ID

vrf

VRF name

Default

N/A

Configuration Mode

Any command mode

History

3.6.8008

Example

switch (config) # show ipv6 interface loopback 1

loopback1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled

  IPv6 address:
    2001::1/128 [primary]
    2002::1/128

  Local Link Address:
    fe80::4c01:40ff:feb3:b753/64

  Joined group address:
    ff02::1:ff00:1

Related Commands

Notes

show ipv6 interface [vrf <vrf-name>] port-channel <id>

Display IPv6 information of the specified LAG interface.

Syntax Description

id

LAG ID

vrf

VRF name

Default

N/A

Configuration Mode

Any command mode

History

3.6.8008

Example

switch (config) # show ipv6 interface port-channel 1

Po1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled

  IPv6 address:
    6000::1/64 [primary]
    7000::1/64

  ND retransmit interval (usec): 1000
  ND DAD                       : enabled
  Number of DAD attempts       : 1
  ND reachable time            : 0

Related Commands

Notes

show ipv6 interface [vrf <vrf-name>] vlan <vid>

Display IPv6 information of the specified VLAN interface.

Syntax Description

vid

VLAN ID

vrf

VRF name

Default

N/A

Configuration Mode

Any command mode

History

3.6.8008

Example

switch (config) # show ipv6 interface vlan 100

vlan100:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled

  IPv6 address:
    4000::1/64 [primary]
    5000::1/64

  ICMPv6 redirect              : disabled
  ND retransmit interval (usec): 1000
  ND DAD                       : enabled
  Number of DAD attempts       : 1
  ND reachable time            : 0

Related Commands

Notes

show ipv6 interface vrf <vrf-name>

Display IPv6 information of the specified VRF.

Syntax Description

name

VRF name

Default

N/A

Configuration Mode

Any command mode

History

3.6.8008

switch (config) # show ipv6 interface vrf default

Eth1/1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled
...
Po1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled
...
vlan100:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled
...
loopback1:
  VRF        : default
  Admin state: enabled
  IPv6       : enabled
...

Related Commands

Notes

interface loopback <id>
no interface loopback <id> 

Creates a loopback interface and enters the interface configuration mode.
The no form of the command deletes the interface.

Syntax Description

id

Range: 0-31

Default

N/A

Configuration Mode

config

History

3.2.3000

switch (config) # interface loopback 10
switch (config interface loopback 10) #

Related Commands

Notes

• Up to 32 loopback interfaces can be configured
• Within the loopback configuration mode, you can configure description and ip-address
• MTU cannot be configured on the loopback interface

interface vrf <vrf-name> ip address alias <loopback<N> | loopback N>
no interface vrf <vrf-name> ip address alias

Copies addresses from given loopback interface.
The no form of the command disables the copied addresses from given loopback interface.

Syntax Description

vrf-name

VRF name

Default

Disabled

Configuration Mode

config

History

3.9.0300

switch (config)# interface vrf vrf-default ip address alias loopback1

Related Commands

show ip interface [vrf]

Notes

ip address <ip-address> <mask>
no ip address [<ip-address> [<mask>]] 

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

ip-address

IPv4 address

There are two possible ways to the mask:

• /length – only /32 is possible
• Network address (i.e. 255.255.255.0)

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

Default

0.0.0.0/0

Configuration Mode

config

History

3.3.5006

switch (config interface loopback 10) # ip address 10.10.10.10 /32

Related Commands

Notes

An interface may have up to 16 IPv4 address assignments.

description <string>
no description

Enters a description for the interface.
The no form of the command sets the description to default.

Syntax Description

string

User defined string

There are two possible ways to the mask:

• /length – only /32 is possible
• Network address (i.e. 255.255.255.0)

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

Default

“”

Configuration Mode

config interface loopback

History

3.3.5006

switch (config interface loopback 10) # description my-ip-interface

Related Commands

Notes

show interface loopback <id>

Displays the attribute of the interface loopback.

Syntax Description

id

Range: 1-32

Default

N/A

Configuration Mode

config interface loopback

History

3.2.3000

switch (config) # show interfaces loopback 1

Loopback 1:
 IPv4 address:
   192.168.1.1/32 [primary]
   192.168.2.1/32

 Broadcast address:
   192.168.1.1 [primary]
   192.168.2.1

 IPv6 address:
   2001::1/128 [primary]
   2002::1/128
   fe80::4c01:40ff:feb3:b753/64

 MTU : 1500 bytes
 Description: N/A
 VRF : default

Related Commands

Notes

ip route [vrf <vrf-name>] <ip-prefix> <netmask> {<next -hop-ip-address> | null0} [<distance>]
no ip route [vrf <vrf-name>] <ip-prefix> <netmask> [<next -hop-ip-address>]

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

Syntax Description

vrf-name

VRF session name

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

null0

Sets a static drop-route

distance

Administrative distance assigned to route. Options include:

• No parameter - route is assigned a default administrative distance of 1
• 1-255 - the administrative distance assigned to route

Default

N/A

Configuration Mode

config

History

3.1.0000

3.4.2008

Added VRF parameter

Example

switch (config) # ip route vrf my-vrf 80.80.80.0 /24 20.20.20.2

Related Commands

Notes

If no routing-context is specified, the “routing-context” VRF is automatically configured.

ip load-sharing <type> [ecmp-group-size <size> [ max-ecmp-groups <max>]]
no ip load-sharing 

This command sets the ECMP load sharing mode.
The no form of the command sets the load-sharing to default.

• source-ip-port – source ip and TCP/UDP port
• destination-ip-port – destination ip and TCP/UDP port
• source-destination-ip-port – source & destination ip and TCP/UDP port
• flow-label – flow label
• udk – user-defined keys
• all – all options
• consistent – consistent hashing mode

max-ecmp-groups

Default

Configuration Mode

config

History

3.2.0230

3.7.1100

Updated syntax

Example

switch (config) # ip load-sharing all switch (config) # ip load-sharing consistent [ecmp-group-size<size>]

Related Commands

Notes

If no routing-context is specified, the “routing-context” VRF is automatically configured.

show ip route [vrf {<vrf-name> | all}] summary 

Displays route summary of VRF instance.

Syntax Description

vrf-name

Name of VRF

all

Displays routing tables for all VRF instances

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.6.5000

Updated example

switch (config) # show ip route vrf my-vrf summary
VRF Name:         default           

------------------------
Route Source    Routes 
------------------------
direct          3
static          0
ospf            0
bgp             0
DHCP            1
Total           4

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”
• If no routing-context is specified, the “routing-context” VRF is automatically displayed

show ip load-sharing 

Displays ECMP hash attribute.

Default

N/A

Configuration Mode

Any command mode

History

3.4.2008

3.7.1100

Updated example

Example

(config) # show ip load-sharing
Load sharing: all
Type: static

(config) # show ip load-sharing
Load sharing: destination-ip-port
Type: consistent
Operational state: stable
Container size: 512
Max number of containers: 40
Used containers: 5

Related Commands

ip load-sharing

Notes

The command’s output is different for static & consistent hashing

ip arp [vrf <vrf-name>] <ip-address> <mac-address>
no ip arp <ip-address> 

Configures IP ARP properties of VRF.
The no form of the command deletes the static ARP configuration.

Syntax Description

vrf-name

VRF session name

IP address

IPv4 address

mac-address

MAC address (format XX:XX:XX:XX:XX:XX)

Default

N/A

Configuration Mode

config

History

3.4.2008

Example

switch (config) # ip arp vrf my-vrf 20.20.20.2 aa:bb:cc:dd:ee:ff

Related Commands

Notes

If no routing-context is specified, the “routing-context” VRF is automatically configured.

ip arp responder

Initiates ARP responder functionality.

Syntax Description

N/A

Default

N/A

Configuration Mode

config interface ethernet
config interface port-channel
config interface vlan

History

3.6.8008

Example

switch (config interface vlan 10) # ip arp responder

Related Commands

ip arp
show ip arp

Note

ip arp timeout <timeout-value>
no ip arp timeout 

Sets the dynamic ARP cache timeout.
The no form of the command sets the timeout to default.

Syntax Description

timeout-value

Time that an entry remains in the ARP cache
Range: 240-28800 seconds

Default

1500 seconds

Configuration Mode

config interface ethernet
config interface port-channel
config interface vlan

History

3.2.0230

Example

switch (config interface vlan 10) # ip arp timeout 2000

Related Commands

ip arp
show ip arp

Note

• This configuration may take up to 5 minutes to take effect
• The time interval after which each ARP entry becomes stale may actually vary from 50-150% of the configured value

clear ip arp [vrf <vrf-name>] [interface <type> | <IP-address>] 

Clears the dynamic ARP cache for the specific VRF session.

Syntax Description

vrf-name

VRF session name

interface

Clears dynamic ARP entries for a interface

ip-address

Clears dynamic ARP entries for a specific IP address

Default

N/A

Configuration Mode

config

History

3.2.0230

3.4.2008

Added VRF parameter

Example

switch (config) # clear ip arp vrf my-vrf

Related Commands

ip arp
show ip arp

Notes

If no routing-context is specified, the “routing-context” VRF is automatically configured.

ping [vrf <vrf-name>] [-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

vrf

 Specifies VRF instance name

Linux Ping options

Default

N/A

Configuration Mode

config

History

3.1.0000

3.4.2008

Added VRF parameter

switch (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
^C
--- 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

traceroute

Notes

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

qos map dscp-to-pcp preserve-pcp
no qos map dscp-to-pcp preserve-pcp 

Configures the router to copy PCP bits when transferring data from one subnet to another.
The no form of the command disables this ability.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.3.4000

Example

switch (config) # qos map dscp-to-pcp preserve-pcp

Related Commands

Notes

<ip|ipv6> pbr nexthop-group <group_name> [recursive]
no <ip|ipv6> pbr nexthop-group <group_name>

Creates direct or recursive nexthop-group and enter to the nexthop-group CLI context.
The no form of the command deletes the nexthop-group.

Syntax Description

group_name

Name of the desired nexthop-group

Default

Disabled

Configuration Mode

config

History

3.9.2000

Example

switch (config) # ip pbr nexthop-group n_ggg_v4
switch (config) # ipv6 pbr nexthop-group n_ggg_v6

Related Commands

show pbr nexthop-group
pbr route-map seq set nexthop-group

Notes

<ip|ipv6> pbr nexthop-group <group_name> nexthop interface {ethernet <port/slot>|port-channel <ID> | vlan <ID>} <next-hop IP address>
no <ip|ipv6> pbr nexthop-group <group_name> nexthop interface {ethernet <port/slot>|port-channel <ID> | vlan <ID>} <next-hop IP address>

Adds nexthop (L3 interface and nexthop IP address) to requested nexthop-group.
The no form of the command deletes the desired nexthop from the nexthop-group.

Syntax Description

group_name

Name of the desired nexthop-group

Default

Disabled

Configuration Mode

config

History

3.9.2000

Example

switch (config) # ip pbr nexthop-group n_ggg_v4 nexthop interface ethernet 1/4 10.10.10.23

switch (config) # ipv6 pbr nexthop-group n_ggg_v6 nexthop interface vlan 5 194:23::2

Related Commands

show pbr nexthop-group

Notes

Maximum number of configured direct nexthops in one group is 128. One nexthop can be configured only once in one nexthop-group.

<ip|ipv6}>pbr nexthop-group <group_name> recursive nexthop vrf <vrf_name> <next-hop IP address>
no <ip|ipv6> pbr nexthop-group <group_name> recursive no nexthop

Adds recursive nexthop to requested nexthop-group.
The no form of the command deletes the desired nexthop from the nexthop-group.

Syntax Description

group_name

Name of the desired nexthop-group

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # ip pbr nexthop-group n_ggg_v4 recursive nexthop vrf default 10.10.10.23

switch (config) # ipv6 pbr nexthop-group n_ggg_v6 recursive nexthop vrf default 194:23::2

Related Commands

show pbr nexthop-group

Notes

Maximum number of configured recursive nexthops in one nexthop-group is 1.

<ip|ipv6> pbr route-map <map_name>
no <ip|ipv6> pbr route-map <map_name>

Creates route-map and enter to the route-map CLI context.
The no form of the command deletes the route-map.

Syntax Description

map_name

Name of the desired nexthop-group

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # ip pbr route-map r_ttt_v4

switch (config) # ipv6 pbr route-map r_ttt_v6

Related Commands

show pbr route-map

Notes

<ip|ipv6> pbr route-map <map_name> seq <number> match {dest-addr <IP address/prefix length>|source-addr <IP address/prefix length>|protocol <tcp|udp>|source-port <port>|dest-port<port>|dscp <value>}
no <ip|ipv6> pbr route-map <map_name> seq <number> match

Create or modify sequence with new match rule. No form deletes match rule from the sequence.

Syntax Description

map_name

Name of the desired nexthop-group

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # ip pbr route-map r_ttt_v4 seq 3 match dest-addr 1.2.3.0/24 source-addr 4.5.6.0/24 dest-port 656 source-port 757 protocol tcp

switch (config) # ipv6 pbr route-map r_ttt_v6 seq 3 match dest-addr 23:23::/64 source-addr 90:23::/64 dest-port 656 source-port 757 protocol tcp

Related Commands

show pbr route-map

Notes

<ip|ipv6> pbr route-map <map_name> seq <number> set nexthop-group <group_name>
no <ip|ipv6> pbr route-map <map_name> seq <number> set nexthop-group

Specify desired nexthop-group for sending matched traffic.
The no form of the command deletes the biding.

Syntax Description

map_name

Name of the desired nexthop-group

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # ip pbr route-map r_ttt_v4 seq 3 set nexthop-group n_ggg_v4

switch (config) # ipv6 pbr route-map r_ttt_v6 seq 3 set nexthop-group n_ggg_v6

Related Commands

show pbr route-map

Notes

One nexthop-group can be specified in more than one sequence.

<ip|ipv6> pbr route-map <map_name> seq <number> counter
no <ip|ipv6> pbr route-map <map_name> seq <number> counter

Request counter to be allocated and count matched packets by match rule.
The no form of the command de-allocate the counter.

Syntax Description

map_name

Name of the desired nexthop-group

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # ip pbr route-map r_ttt_v4 seq 3 counter

switch (config) # ipv6 pbr route-map r_ttt_v6 seq 3 counter

Related Commands

show pbr route-map

Notes

interface {ethernet <slot/port>|port-channel <ID> | vlan <ID>} {ip|ipv6} pbr route-map <map_name>
no interface {ethernet <slot/port>|port-channel <ID> | vlan <ID>} {ip|ipv6} pbr route-map <map_name>

Bind requested route-map on the ingress router port.
Te no form of the command unbinds requested route-map from the interface.

Syntax Description

map_name

Name of the desired nexthop-group

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # interface ethernet 1/2 ip pbr route-map r_ttt_v4

switch (config) # interface vlan 3 ipv6 pbr route-map r_ttt_v6

Related Commands

show ip interface

Notes

In one time one IPv4 and one IPv6 route-map can be bound on interface

show {ip|ipv6} pbr nexthop-group brief | <name>

Shows brief information about the all configured nexthop-groups. In case of specifying nexthop-group name show details.

Syntax Description

name

Name of the desired nexthop-group

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # show ip pbr nexthop-group brief

Flags:
  A: active
  I: inactive
  F: failed to install in H/W
-------------------------------------------------------------------------------------------
Name                       Type          Flags     Notes                                  
-------------------------------------------------------------------------------------------
n_ggg_v4                   direct        I         Group doesn't have active/resolved next-
                                                                  hops
switch (config) # show ip pbr nexthop-group bbb

Flags:
  A: active
  I: inactive
  F: failed to install in H/W

bbb:
  Type            : direct
  Egress interface: vlan 4 (10.10.10.23)
  Flags           : A

  Notes:
    N/A

Related Commands

Notes

In case of any misconfiguration field “Notes” will reflect it.

show {ip|ipv6} pbr route-map brief |<name>

Shows brief information about the all configured route-maps. In case of specifying route-map name show details.

Syntax Description

name

Name of the desired nexthop-group

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # show ip pbr route-map brief

Flags:
  A: active
  I: inactive
  F: failed to install in H/W
-------------------------------------------------------------------------------------------------
Name                                      Total sequences  Active/Inactive  Bound to interfaces  
-------------------------------------------------------------------------------------------------
r_ttt_v4                                   1                0/1             

switch (config) # show ip pbr route-map r_ttt_v4
Flags:
  A: active
  I: inactive
  F: failed to install in H/W

tests:
  --------------------------------------------------------------------
  seq     match                  counter   nexthop-group        flags
  --------------------------------------------------------------------
  1       protocol tcp            0         n_ggg_v4            A

Related Commands

Notes

In case of any misconfiguration field “Notes” will reflect it.

show {ip|ipv6} interface {ethernet <slot/port>| port-channel <ID> | vlan <ID>}

Show binding the route-map to interface and its route-map state.

Syntax Description

ethernet <port/slot>

Physical port

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # show ip interface vlan 3

Vlan 3:
  Admin state        : Enabled
  Operational state  : Down
  Autostate          : Enabled
  Mac Address        : 7c:fe:90:f6:aa:08
  DHCP client        : Disabled
  PBR route-map      : r_ttt_v4
  PBR route-map state: Active
…

switch (config) # show ipv6 interface vlan 3
vlan3:
  VRF                          : default
  Admin state                  : enabled
  IPv6                         : enabled
  ICMPv6 redirect              : disabled
  ND retransmit interval (usec): 1000
  ND DAD                       : enabled
  Number of DAD attempts       : 1
  ND reachable time            : 0
  PBR route-map                : r_ttt_v6
  PBR route-map state          : Active

Related Commands

Notes

In case of any misconfiguration field “Notes” will reflect it.

show ip pbr [exceptions [nexthop-group | route-map | interface]]

Shows number of configured nexthop-groups and route-maps. Also shows misconfiguration for all PBR configuration or per selected category.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

3.9.2000

Example

switch (config) # show ip pbr

Configured nexthop-groups (active/inactive/not installed): 1 (0/1/0)
Configured route-maps (bind/unbind)                      : 1 (1/0)


switch (config) # show ip pbr exceptions

Configured nexthop-groups (active/inactive/not installed): 1 (0/1/0)
Configured route-maps (bind/unbind)                      : 1 (1/0)

Exceptions:
  Nexthop-groups:
    Nexthop-group n_ggg_v4 doesn't have active/resolved next-hops

  Route-maps:
    Route-map r_ttt_v4 sequence 1 assigned nexthop-group is not Active

  Interfaces:
    Interface vlan 3 assigned route-map is not Active

Related Commands

Notes

Information about the total amount of configured nexthop-groups and route-maps includes both IPv4 and IPv6 families and does not depend on the specified IP family in CLI command.