ram_monitor(1M)

NAME

ram_monitor — the Route Administration Manager (RAM) monitor

SYNOPSIS

/usr/bin/ram_monitor (ripng | bgp | isis) [IP_address] CLI_Port_Number

DESCRIPTION

ram_monitor is an interactive command line utility used to query routing protocol daemons ripngd(1M), bgpd(1M), and isisd(1M). ram_monitor can be used to view detailed information on the IO statistics, the error logs, the routing table, the configured protocol interfaces, and the configured filter policies.

ram_monitor establishes a TCP connection to the routing daemon through the IP address specified at startup. If an IP address is not specified, ram_monitor connects to the routing protocol daemon running on the local machine.

Commands

In the interactive mode, ram_monitor displays one of the following prompt:

daemon>

When connected to the local machine.

daemon#

When connected to the IP address specified. The daemon can be ripng, bgp, or isis.

Any of the ram_monitor interactive commands can be run at this prompt. The interactive commands can be interrupted at any time via a keyboard interrupt.

General Commands

?: Displays all local commands and their functions.
help [command]: Displays the list of commands available in the current mode, if command is not specified. If the command name is specified, the help topic corresponding to the specified command is displayed.
history: Displays the history of commands executed in the interactive session.
!!: Executes the previous command.
! command_num: Executes the command specified by command number, command_num, in the history of commands.
redirect filename: Redirects the command output to the specified file.
exit: Exits ram_monitor.

RIPng-Specific Commands

The following are valid RIPng-specific command:

show filter [gw|route]

Displays the filters configured for RIPng.

gw: All the gateway filters are displayed.
route: All the route filters are displayed.

By default, both gateway and route filters are displayed.

show route

Displays the RIPng routing table.

query destination [-t secs ]

Requests the routing table of the gateway using RIPng's protocol request.

destination specifies the gateway address to which the request has to be sent.

The -t option specifies the wait time in seconds for the responses. The default value is 5 seconds if -t is not specified.

trace (on|off)

Toggles the tracing of the protocol daemon.

show log

Displays the RIPng protocol statistics.

show error

Displays the RIPng Error counters.

show interface

Displays the RIPng interface configuration.

show profile

Displays configured profiles of RIPng.

BGP-Specific Commands

The following are valid BGP-specific commands:

show filter: Displays the list of BGP route filters.
show route: Displays the BGP routing table.
trace (on|off): Toggles the tracing of the protocol daemon.
show log: Displays the BGP protocol statistics.
show error: Displays the list of notification sent to peers.
show peers: Displays the list of BGP peers.
show eventlog: Displays the list of BGP FSM transition events for all peers.

IS-IS-Specific Commands

The following are IS-IS-specific commands:

show adj: Displays the isisd adjacency information.
show interface: Displays the information on isisd interfaces.
show lsp: Displays the LSP database for L1, L2, and L1/L2.
show log: Displays isisd statistics.
show eventlog: Displays the list of isisd cumulative event log.
show error: Displays the list of cumulative errors.
show nexthop: Displays the next hop list derived from the SPF calculation.
trace (on|off): Toggles the trace.
show filter: Displays the list of isisd configured summary filters.

EXAMPLES

RIPng Examples

To invoke ram_monitor and connect to ripngd, type the following at the HP-UX command prompt:

/usr/bin/ram_monitor ripng 15000 

Following is sample output of the ram_monitor commands:

ripng> show interface

If : lan0
        Status              :  UP, ENABLED
        Profile             :  0
        Cost                :  1
        Mtu                 :  1500
        Primary Address     :  fe80::230:6eff:fe2c:b619
        Site Local Access   :  allow
        Route Filter Access :  deny

ripng> show route

5511::230:6eff:fe2c:b619/64   5511::230:6eff:fe2c:b619  1 local lan0
5555::230:6eff:fe2c:b619/64   5555::230:6eff:fe2c:b619  1 local lan0
6666::230:6eff:fe2c:b619/64   6666::230:6eff:fe2c:b619  1 local lan0

ripng> show profile

Profile id -  0
        Horizon (2 - split/ 3 - poison reverse)     :  3
        Route Age (in sec)                          :  180
        Periodic Update Timer Interval (in sec)     :  30
        Triggered Update Timer Interval (in sec)    :  5
        Garbage Collection Timer Interval (in sec)  :  120

Profile id -  1
        Horizon (2 - split/ 3 - poison reverse)     :  3
        Route Age (in sec)                          :  180
        Periodic Update Timer Interval (in sec)     :  50
        Triggered Update Timer Interval (in sec)    :  5
        Garbage Collection Timer Interval (in sec)  :  120

ripng> show log

If : lan0
        In Messages              :  2
        Out Messages             :  6
        Discarded Messages       :  2
        RIPng In Requests        :  0
        RIPng In Responses       :  2
        RIPng Out Requests       :  0
        RIPng Out Responses      :  6
        Unknown Commands         :  0
        Invalid Version          :  0
        Total Trig Upd sent      :  4

ripng> show error

If : lan0
        Discarded Messages       :  10
        Unknown Commands         :  0
        Invalid Version          :  0
        Martian Discards         :  0
        Ripin Discards           :  0
        Ripout Discards          :  0
        Route Filter Discards    :  0
        Trusted Gateway Discards :  0
        Import Discards          :  0

BGP Examples

To invoke ram_monitor and connect to bgpd, type the following at the HP-UX command prompt:

/usr/bin/ram_monitor bgp 15000 

Following is sample output of the ram_monitor commands:

bgp> show

Command making ambiguity
Available commands :
[Syntax]    : show peers
[Syntax]    : show eventlog
[Syntax]    : show filter
[Syntax]    : show route
[Syntax]    : show log
[Syntax]    : show error

bgp> show peers

No.of peers configured:2

=====================================

  BGP neighbor is 4222::1112, remote AS 700, internal link
  BGP version 4, remote router ID 10.4.7.192
  BGP state = Established, up for 51 seconds
  Rcvd update before 51 secs, hold time is 120 secs,
      keepalive interval is 40 secs
  Received 19 messages, 14 Updates
  Sent 13 messages, 8 Updates
  Minimum time between advertisement runs is 15 seconds
  Peer Preference: 0
  Peer Related to NONE Group
  Peer Capability type MP for IPV6
  Peer Connection type: ACTIVE
  Peer Authentication type: MD5
  Local host: 4222::1111, Local port: 179
  Foreign host: 4222::1112, Foreign port: 64180
  No Peer Gateway
  BGP neighbor is 6222::1111, remote AS 800, external link
  BGP version 0, remote router ID 0.0.0.0
  BGP state = Idle
  Rcvd update before 0 secs, hold time is 180 secs,
      keepalive interval is 60 secs
  Received 0 messages, 0 Updates
  Sent 0 messages, 0 Updates
  Minimum time between advertisement runs is 15 seconds
  Peer Preference: 0
  Peer Related to NONE Group
  Peer Capability type NONE for NONE
  Peer Connection type: ACTIVE
  Peer Authentication type: MD5
  Local host: 6222::1112, Local port: 0
  Foreign host: 6222::1111, Foreign port: 0
  No Peer Gateway

bgp> show route

IPV6 BGP ROUTE TABLE
No.of Routes configured:25

ORIGIN: I-IGP, E-EGP, ?-INCOMPLETE
=====================================================================
Dest/PrefixLength       Nexthop        Metric Protocol  LP  Origin

=====================================================================
::/96   4222::1112      0       bgp     300     I

1666::/64       4222::1112      0      bgp     300     I

2111::/24       4222::1112      0      bgp     300     I

2222::/64       2222::2 0       local  300     I

3111::/24       4222::1112      0      bgp     300     I

4222::/64       4222::1111      0      local   300     I

4333::/64       4333::230:6eff:fe2c:b619        0      local 300  I

5511::/64       5511::1112      0      local   300     I

5555::/64       5555::230:6eff:fe2c:b619       0       local 300  I

5599::/64       5599::230:6eff:fe2c:b619       0       local 300  I

6666::/64       6666::230:6eff:fe2c:b619       0       local 300  I

bgp> show filter

BGP FILTER INFORMATION
No.of Filters Configured:2
=================================================================
FilterName   ASNO     RP              ASP          DIR     ACTION

=================================================================
filter1      100      3333::2222      12,3,4       OUT     DENY

filter1      100      3333::2222      12,3,4       OUT     DENY

bgp> show eventlog

BGP PEER EVENT LOG INFORMATION
BGP neighbor is 4222::1112, remote AS 700, internal link
  BGP peer state = Established, up for 51 seconds
  No.of FSM Transitions = 1
  FSM Transition History = idle,connect,connect,opensent,active,
                           opensent,openconfirm,established

BGP PEER EVENT LOG INFORMATION
BGP neighbor is 6222::1111, remote AS 800, external link
  BGP peer state = Idle
  No.of FSM Transitions = 0
  FSM Transition History =

bgp> show error

BGP PEER ERROR INFORMATION
BGP neighbor is 4222::1112, remote AS 700, internal link
Last Error Received NONE
Last Error Subcode Received NONE
Last Error Sent NONE
Last Error Subcode Sent NONE

BGP PEER ERROR INFORMATION
BGP neighbor is 6222::1111, remote AS 800, external link
Last Error Received NONE
Last Error Subcode Received NONE
Last Error Sent NONE
Last Error Subcode Sent NONE

bgp> show log

BGP PEER LOG INFORMATION
BGP neighbor is 4222::1112, remote AS 700, internal link
  Received 20 messages, 14 Updates
  Sent 14 messages, 8 Updates

BGP PEER LOG INFORMATION
BGP neighbor is 6222::1111, remote AS 800, external link
  Received 0 messages, 0 Updates
  Sent 0 messages, 0 Updates

IS-IS Example

To invoke ram_monitor and connect to isisd, type the following at the HP-UX command prompt:

/usr/bin/ram_monitor isis 15000 