12.3.6. Routes

This section allows you to perform diagnostics and monitor route information on UserGate.

To view all routes contained in the default router, use the following command:

Admin@UGOS> show network route

Parameter

Description

ip

IP address to which you want to display the route.

connected

Routes to networks connected directly to UserGate interfaces. These routes are marked with a С in the route list.

kernel

Display routes added by the administrator. These routes are marked with a К in the route list.

summary

Number of active connections and FIB (Forwarding Information Base) records.

ospf

Display routes received using the OSPF dynamic routing protocol. These routes are marked with an О in the route list.

bgp

Display routes received using the BGP dynamic routing protocol. These routes are marked with a B in the route list.

rip

Display routes received using the RIP dynamic routing protocol. These routes are marked with an R in the route list.

virtual-router

Virtual router for which you want to display routes (<vrf-name> | all).

12.3.6.1. OSPF monitoring

To diagnose and monitor OSPF, use the following commands. Display OSPF information:

Admin@UGOS> show network ospf

Parameter

Description

virtual-router

Virtual router for which you want to preview general OSPF information: (<vrf-name> | all).

route

Display routes received using the OSPF dynamic routing protocol.

database

Display the following information:

  • Router Link States: routers use Type 1 Link State Advertisement (LSA) (Router LSA) packets to send information within the same zone; they are used to transmit information about their own and their neighbors' interfaces to their neighboring routers in the same zone.

  • Network Link States: a Designated Router (DR) generates LSA Type 2 (Network LSA) packets to describe all routers connected directly to its segment.

  • Summary Link States: Area Border Routers (ABR) generate LSA Type 3 (Summary LSA) packets. These packets contain summary messages about the directly connected zone, report information to other zones to which the ABR is connected, and are transmitted to multiple zones throughout the network.

  • ASBR-Summary Link States: LSA Type 4 (ASBR Summary LSA) packets report the presence of an Autonomous System Border Router (ASBR) in other areas.

neighbor

Display information on neighbors:

  • Neighbor ID (router ID).

  • Priority. The router with the highest priority becomes the Designated Router, DR. If router priorities are equal, the router with the highest ID will be selected.

  • Status, such as Full/DR, Full/BDR, Full/Drother.

  • Idle Interval: time until the connection to the OSPF neighbor is interrupted if no Hello packet has been received.

  • IP address of the interface to which the neighbor is connected.

  • Interface on which the router adjacency is formed.

Additional parameters:

  • interface-name: display neighbors with which adjacency is established on the specified interface.

  • all: display the table with all neighbors.

  • detail: display detailed information about neighbors.

interface

Display OSPF interface information.

Additional parameters:

  • interface-name: display information about the specified interface.

  • traffic: statistics on transmitted and received OSPF packets (Hello, Database Description, Link State Request, Link State Update, Link State Acknowledgment).

border-routers

Display information about border routers.

Restart the OSPF process:

Admin@UGOS> clear network ospf

Parameter

Description

virtual-router

Virtual router on which you want to restart OSPF (<vrf-name> | all).

interface

Interface on which you want to restart the OSPF process.

12.3.6.2. BGP monitoring

To diagnose and monitor BGP, use the following commands.

Display the default router's BGP table:

Admin@UGOS> show network bgp

Parameter

Description

virtual-router

Virtual router for which you want to display routes (<vrf-name> | all).

ip

IP address to which you want to display the route.

statistics

Display BGP statistics.

neighbors

Display information about BGP neighbors (to display information about a specific neighbor, provide its IP address).

Additional parameters available to use to specify a neighbor:

  • received-routes: routes received before the incoming policy is applied to them (Routemap and filters).

  • advertised-routes: routes advertised to the specified neighbor.

summary

Display summary information on neighbors.

Re-request information from BGP neighbors (TCP session break):

Admin@UGOS> clear network bgp

Available parameters:

Parameter

Description

ip

IP address of the neighbor to which the connection will be interrupted to update information.

virtual-router

Name of the virtual router to which the BGP neighbor belongs.

In case the neighbor devices support the Route Refresh method you can send a special message like ROUTE REFRESH instead of reinitializing the entire session with the neighbor. You can send this message to update information without interrupting the routing.

To update information without interrupting the session with the neighbor, use the following command:

Admin@UGOS> clear network bgp ip <neighbor-ip> soft in | out 

Admin@UGOS> clear network bgp virtual-router <vrf-name> ip <neighbor-ip> soft in | out

12.3.6.3. RIP monitoring

To diagnose and monitor RIP, use the following commands.

Display RIP information from the default router table (network address received via RIP, Next Hop address, route metric, route tag to separate internal and external routes, and timeout to invalidate the route if no information about it has been received):

Admin@UGOS> show network rip

Additional available parameters:

Parameter

Description

status

Current RIP status: version, timers, filters, routes distributed, etc.

virtual-router

Virtual router for which you want to preview RIP route information: <vrf-name> | all.

12.3.6.4. Multicast monitoring

To view the multicast traffic routing table on the default router, use the following command:

Admin@UGOS> show network mroute

Additional available parameters:

Parameter

Description

count

Display statistics about the group and the source.

virtual-router

Select a virtual router: <vrf-name> | all.

summary

Summary of each record in the multicast routing table.

fill

Multicast traffic routing table. Additional parameter:

  • ip: display the record for a particular IP address (the IP address should follow).

ip

Display the record for a particular IP address (provide the IP address).

12.3.6.5. IGMP monitoring

To monitor IGMP (Internet Group Management Protocol) operation, use the following command (the parameters are required). Display information for the default router:

Admin@UGOS> show network igmp

Preview information for a specific virtual router or all of them:

Admin@UGOS> show network igmp virtual-router <vrf-name> | all

One of the parameters below should follow:

Parameter

Description

statistics

Message statistics:

  • IGMP Membership Query is a message from the server to the client with a request to renew subscriptions to groups the client receives, or the server would stop broadcasting the group(s) to this network segment.

  • IGMP Leave is a message from the client to the server to report that the client wants to remove the multicast group from the list of groups it receives.

  • IGMP Membership Report is a message from the client to the server to report that the client wants to receive this group's traffic.

join

Display information about IGMP groups.

sources

Display information about multicast traffic sources.

groups

Display the multicast groups received via IGMP protocol. The following information is displayed:

  • Total number of groups.

  • Interface via which the group is available.

  • Group address.

  • INCLUDE or EXCLUDE mode.

  • Timer that determines the period for which the router will stop forwarding traffic to the interface if no IGMP Membership Report has been received.

  • How long the group is known.

interface

Display the interface information related to multicast routing:

  • Interface name, status, and address.

  • IGMP version.

  • Querier and its address.

  • Timer that is reset every time a Query message with a lower IP address arrives.

You can specify:

  • interface-name: name of the interface.

  • detail: detailed information about the interface.

12.3.6.6. PIM monitoring

To monitor PIM (Protocol-Independent Multicast), use the following command (the parameters are required). Display information for the default router:

Admin@UGOS> show network pim

Preview information for a specific virtual router or all of them:

Admin@UGOS> show network pim virtual-router <vrf-name> | all

One of the parameters below should follow:

Parameter

Description

vxlan-groups

Information about VXLAN groups used in multicast.

statistics

Protocol statistics.

join

Display information about PIM groups.

neighbor

Information about the neighbors:

  • Interface via which the neighbor information was obtained.

  • Neighbor's address.

  • Time since PIM was last started.

  • How long the neighbor is available.

  • DR priority.

next-hop

Records about the next-hop addresses.

state

Information about known S and G routes, IIF (Incoming Interface), and OIL (Outgoing Interface List).

rp-info

Display information about the Rendezvous Point (RP), such as the address and allowed ASM groups from this RP.

interface

Information about interfaces configured for PIM, such as the interface name and address, DR address, etc.

Additional parameters:

  • interface-name: name of the interface.

  • traffic: statistics of sent/received messages.

  • detail: detailed information about the interface.

group-type

List of allowed group addresses for SSM (Source Specific Multicast).

secondary

Display information about the interface by specifying an additional IP address.