26.6. IPRTR diagnostics, statistics and debug

26.6. IPRTR diagnostics, statistics and debug
	Chapter 26. IPRTR - IP Router

26.6.1. IPRTR diagnostics

To display the diagnostics of the IPRTR resource the following commands are used:

d d iprtr / d de iprtr: Shows diagnostic information, such as the state of the resource and the routing table, the current percentage of routings present into the routing table, the current number of routings present in the table, the maximum number of routings reached from start-up in the table and the maximum number of routings present into the table (this information indicates the MAXROUTE parameter).

[18:06:40] ABILIS_CPX:d d iprtr

RES:Iprtr ---------------------------------------------------------------------
       IP_Router_general_properties
       STATE:READY
       ROUTINGs TABLE Diagnostics
       -----------|---State---|-Current%--|--Current--|---Peak----|----Max----|
       ROUTINGS   |NORMAL     |          5|         29|         29|        500|
       ------------------------------------------------------------------------

26.6.2. IPRTR statistics

To display the statistics of the IPRTR resource the following commands are used:

d s iprtr / d se iprtr: Statistic information are divided into two groups: one dedicated to IP Router (the number of IP datagrams sent/received, number of IP datagrams discarded due to header errors and to wrong destination address, etc.), the other one to the ICMP (the number of ICMP messages sent/received, the number of bad ICMP messages received, the number of “Unreachable destination” ICMP messages, etc.).

[18:06:40] ABILIS_CPX:d s iprtr

RES:Iprtr ---------------------------------------------------------------------
       IP_Router_general_properties                                            
       --- Cleared 25 days 05:51:06 ago, on 03/08/2017 at 07:25:50 ------------
       ROUTER Statistics
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       DG         | 1033201636|   63584863|HDR-ERR    |        407|           |
       ADDR-ERR   |          1|           |FRW-DG     |           |  532994832|
       UNK-PROT   |         13|           |DISCARDS   |          0|     113726|
       LOCAL-DG   |  501151839|           |NO-ROUTE   |           |        247|
       REAS-TOUT  |        176|           |REAS-REQD  |      15507|           |
       REAS-OK    |      14938|           |REAS-FAIL  |        569|           |
       FRAG-OK    |           |         25|FRAG-FAIL  |           |          0|
       FRAG-CREATE|           |         50|ROUT-DISC  |          0|           |
       ------------------------------------------------------------------------
       ICMP Statistics
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       MSG        |     217315|    2772726|ERR        |          0|           |
       DST-UNREACH|     214402|    2709495|T-EXCEED   |       1935|      10856|
       PARM-PROB  |          0|          0|SRC-QUENCH |          0|          0|
       REDIRECT   |        190|      50431|ECHO       |        717|       1227|
       ECHO-REP   |         64|        717|TSTAMP     |          3|          0|
       TSTAMP-REP |          0|          0|ADMASK     |          0|          0|
       ADMASK-REP |          0|          0|LOST-BUF   |       2763|           |
       ------------------------------------------------------------------------

With reference to the shown interval of time («Cleared 25 days 05:51:06 ago») these counters show the number of:

`DG`	IP datagrams from all interfaces.
`HDR-ERR`	IP datagrams discarded because of header errors (e.g., checksum error, version number mismatch, TTL exceeded, etc).
`ADDR-ERR`	IP datagrams discarded because of incorrect destination address.
`FRW-DG`	IP datagrams for which an attempt was made to forward.
`UNK-PROT`	Locally addressed IP datagrams with an invalid protocol.
`DISCARDS`	IP datagrams discarded because of a lack of buffer space.
`LOCAL-DG`	IP datagrams delivered to appropriate protocol module.
`NO-ROUTE`	IP datagrams discarded because no route could be found.
`REAS-TOUT`	Maximum number of seconds that received fragments are held while awaiting reassembly.
`REAS-REQD`	IP fragments received that needed to be reassembled.
`REAS-OK`	IP datagrams successfully reassembled.
`REAS-FAIL`	Failures by IP reassembly algorithm.
`REAS-OK`	IP datagrams successfully reassembled.
`FRAG-OK`	IP datagrams that have been successfully fragmented.
`FRAG-FAIL`	IP datagrams that needed to be fragmented but couldn't because the 'don't fragment' flag was set.
`FRAG-CREATE`	IP fragments generated by fragmentation.
`ROUT-DISC`	Routing entries chosen to be discarded even though they were valid.

`MSG`	ICMP messages.
`ERR`	ICMP messages with errors (e.g., invalid ICMP checksum).
`DST-UNREACH`	ICMP destination unreachable message.
`T-EXCEED`	ICMP time exceeded message.
`PARM-PROB`	ICMP parameter problem message.
`SRC-QUENCH`	ICMP source quench messages.
`REDIRECT`	ICMP redirect messages.
`ECHO`	ICMP echo request messages.
`ECHO-REP`	ICMP echo reply messages.
`TSTAMP`	ICMP timestamp request messages.
`TSTAMP-REP`	ICMP timestamp reply messages.
`ADMASK`	ICMP address mask request messages.
`ADMASK-REP`	ICMP address mask reply messages.

26.6.3. IPRTR debug

Type the following command to view the commands allowed:

[12:28:04] ABILIS_CPX:debug res:iprtr

RES:Iprtr ---------------------------------------------------------------------
       IP_Router_general_properties                                            
       BufferLength:64512  Date/Time:08/08/2017 12:28:08 TraceTime:97326729

Usage:
   LSN:0                 == This help
   --- Debug ------------------------------------------------------------------
   LSN:1                 == Complete debug
   LSN:2                 == Upper/Lower NCB status
   --- Router and NAT ---------------------------------------------------------
   LSN:4                 == NAT/ROUTE statistics
   LSN:4   CMD:CLR       == NAT/ROUTE statistics clear
   LSN:9   CMD:src.src.src.src-dst.dst.dst.dst == Route query
   --- Queues -----------------------------------------------------------------
   LSN:10 [CMD:IP-x]     == Queue packet status information
   LSN:11  CMD:IP-x      == Queue flow information
   LSN:11  CMD:IP-x,EXT  == Queue flow information with extended format
   LSN:12  CMD:IP-x      == Queue flow virtual times
   LSN:13 [CMD:IP-x]     == Queue forced discards
   LSN:14 [CMD:IP-x]     == Queue total discards
   LSN:15  CMD:CLR       == Queue forced/total discards clear
   LSN:16 [CMD:IP-x]     == Queue BYTEs status information
   LSN:17 [CMD:IP-x]     == IP Shaping queue status information
   --- Reassembler and fragmented --------------------------------------------
   LSN:20 [CMD:<prot>]   == Reassembler statistics
   LSN:21 [CMD:<prot>]   == Reassembler descriptor information
   LSN:22 [CMD:IP-x]     == FRAG/REAS statistics by IP-RES
   LSN:22 [CMD:IP-x,]CLR == FRAG/REAS statistics by IP-RES clear
   --- IPACL ------------------------------------------------------------------
   LSN:25  CMD:IP-x      == IPACL request tracer information
   LSN:25  CMD:CLR       == IPACL request tracer information clear
   --- Speedlimit -------------------------------------------------------------
   LSN:30                == Speed-limit status information
   LSN:31                == Speed-limit error information
   LSN:31   CMD:CLR      == Speed-limit error information clear
   --- State detect -----------------------------------------------------------
   LSN:40 [CMD:IP-x]     == STATE-DETECT status information
   LSN:41  CMD:IP-x,EXT  == STATE-DETECT status information extended 
   --- Load Balancing ---------------------------------------------------------
   LSN:45                == Load balancing configuration by ID
   LSN:46                == Load balancing configuration by IP-RES
   --- LAN interfaces  --------------------------------------------------------
   LSN:50  CMD:IP-x      == Registered local IP addresses
   LSN:51  CMD:IP-x      == Registered multicast MAC addresses
   LSN:52  CMD:IP-x      == Registered virtual MAC/IP addresses
   LSN:53  CMD:IP-x      == Registered aliases
   LSN:54  CMD:IP-x      == Local Addresses summary
   LSN:55  CMD:IP-x      == Sessions to Ethernet
   LSN:56  CMD:IP-x      == Multi-Packet statistics
   LSN:57  CMD:IP-x      == DHCP client information
   --- AIPT tunnels -----------------------------------------------------------
   LSN:60 [CMD:IP-x]     == AIPT tunnels: TCP-MSS-CLAMP statistics
   LSN:61 [CMD:IP-x,]CLR == AIPT tunnels: TCP-MSS-CLAMP statistics clear
   --- Errored packets --------------------------------------------------------
   LSN:70                == ICMP header of last 10 packets with checksum error
   LSN:70  CMD:EXT       == ICMP dump of last 10 packets with checksum error
   LSN:70  CMD:CLR       == ICMP checksum failures clear
   LSN:71                == IP headers of last 100 packets with unknown protocol
   LSN:71  CMD:CLR       == Unknown protocol history clear
   --- Miscellaneous ----------------------------------------------------------
   LSN:80                == Sorted table of local IP addresses
   LSN:81  CMD:IP-x      == Lower IP-Res overhead information
   LSN:82                == Information on FIFO node manual-check corruption
   LSN:83  CMD:IP-x      == Throughput statistics

Square brackets indicate optional arguments
x indicates the index of an IP resources.

For example, type the following command to create a route query to verify the outgoing IP port and the gateway for a specific source and destination IP.

[12:28:08] ABILIS_CPX:debug res:iprtr lsn:9 cmd:192.168.29.254-8.8.8.8

RES:Iprtr ---------------------------------------------------------------------
       IP_Router_general_properties                                            
       BufferLength:64512  Date/Time:08/08/2017 12:35:04 TraceTime:97742590

Route query information

Route query for SRC:192.168.029.254 and DST:008.008.008.008.

Outgoing IP Port 2, gateway 192.168.010.001.


26.5. IP Load Balancing		26.7. IPFLOW Tracer