Debug   14

  This chapter describes the debug commands used for troubleshooting PortMaster 4 configuration and operation.

       Summary of Debug Commands

  The debug commands in Table 14-1 are used for PortMaster debugging sessions.

  Table 14-1 Debug Commands

 

Command Syntax
set debug bgp-fsm|bgp-decision-process|bgp-opens|bgp-keepalives| bgp-updates|bgp-notifications|bgp-errors| bgp-packets|bgp-max on|off	- see page 14-2
set debug ccp-stac on|off	- see page 14-3
set debug choicenet on|off	- see page 14-4
set debug clock on|off	- see page 14-6
set debug comport on|off S0	- see page 14-4
set debug flash on|off	- see page 14-5
set debug Hex	- see page 14-6
set debug imt	- see page 14-7
set debug isdn|isdn-dframes|termination|isdn-v120 on|off	- see page 14-8
set debug l2tp max|packets Bytes|rpc|setup|stats	- see page 14-9
set debug off	- see page 14-6
set debug mdp-status|mdp-events|mdp-internal|mdp-max on|off	- see page 14-9
set debug nfas	- see page 14-10
set debug ospf-hello|ospf-event|ospf-spfcalc|ospf-lsu |ospf-lsa|ospf-dbdesc| ospf-error|ospf-routing|ospf-max on|off	- see page 14-11
set debug rip|rip-detail on|off	- see page 14-12

  Note ¯ You can stop debug sessions by turning off the individual debug commands--for example, set debug isdn off . However, any and all debug commands--except ISDN debug settings for a specific D channel--can be turned off with the set debug off  command.

       Debug Commands

       set debug bgp

  This command sets debug flags used for BGP troubleshooting. Debug information is displayed to the console.

  set debug bgp-fsm|bgp-decision-process|bgp-opens|bgp-keepalives|
bgp-updates|bgp-notifications|bgp-errors|bgp-packets|bgp-max on|off

bgp-fsm	Set on  to show events that change the state of the BGP session with any peer.
bgp-decision-process	Set on  to show decisions among routes about the best path to a destination.
bgp-opens	Set on  to show open messages sent and received between any peers.
bgp-keepalives	Set on  to show keepalive messages sent and received between any peers.
bgp-updates	Set on  to show update messages sent and received between any peers.
bgp-notifications	Set on  to show notification messages sent and received between any peers.
bgp-errors	Set on  to show protocol errors occurring between BGP peers.
bgp-packets	Set on  to enable bgp-opens , bgp-keepalives , bgp-updates , and bgp-notifications  options.
bgp-max	Set on  to enable all BGP debugging options.
off	Clears all debug settings--including Hex debug settings--currently active on the PortMaster.

 

Usage

  Use of the set debug bgp-max  command on a connection where large routing tables are exchanged between peers creates a flood of output that is useless for debugging. The set debug bgp-max  command is best used in controlled environments where problems of peer interaction are being debugged and limited routing information is exchanged.

 

Example

  To track any protocol errors occurring between BGP peers, enter the following commands:

  Command> set console
 Command> set debug bgp-errors on 

  To stop the debugging output, enter the following:

  Command> set debug off
 Command> reset console 

 

See Also

  set console - page 2-16

  reset console - page 2-13

       set debug ccp-stac

  This command sets debug flags used for troubleshooting Stac LZS compression implementation. Debug information is displayed to the console.

  set debug ccp-stac on|off

ccp-stac	Set on  to display debugging messages for Stac LZS compression.
off	Clears all debug settings--including Hex debug settings--currently active on the PortMaster.

 

Usage

  The set debug ccp-stac  command displays the allocation of compression data structures, error messages, and reinitializations if the Compression Control Protocol (CCP) is renegotiated and if resets are sent or received when decompression is not synchronized with compression.

 

Example

  To track Stac LZS compression operation, enter the following commands:

  Command> set console
 Command> set debug ccp-stac on 

  To stop the debugging output, enter the following:

  Command> set debug off
 Command> reset console 

 

See Also

  set console - page 2-16

  reset console - page 2-13

       set debug choicenet

  This command sets debug flags used for troubleshooting ChoiceNet. Debug information is displayed to the console.

  set debug choicenet on|off

on	Set on  to display the information related to choicenet events.
off	Clears all debug settings--including Hex debug settings--currently active on the PortMaster.

 

Example

  To track ChoiceNet events, enter the following commands:

  Command> set console
 Command> set debug choicenet on 

  To stop the debugging output, enter the following:

  Command> set debug off
 Command> reset console 

 

See Also

  set console - page 2-16
reset console - page 2-13

       set debug comport

  This command debugs information from a specific port. Debug information is displayed to the console.

  set debug comport on|off S0

on	Enables debugging on the specified communications port.
off	Disables debugging on the specified communications port.
S0	One of the ISDN line ports on a T1 or E1 board.

 

 

Example

  Command> set console

  Setting CONSOLE to admin session

  Command> set debug comport on s3

  Command> ==sleep_queue S3 newproc=listen modem_status=20

  flow_control_state=4(None) port_options=2 port_type=2 hw_type=10

  carrier_detect=1

 

See Also

  set console - page 2-16

  reset console - page 2-13

       set debug flash

  This command debugs information that is written to and read from the nonvolatile RAM of the PortMaster.

  set debug flash on|off

 

Usage

  To display debug information to the console, use the set console command. To stop the output use set debug off or reset console.

  Note ¯ Using the reset console command only suspends the output--debugging is still active. To resume the output to console, type set console.

 

Example

  Command> set console

  Setting CONSOLE to admin session

  Command> set debug flash on

  Enabling Flash debugging

 

See Also

  set console - page 2-16

  reset console - page 2-13

       set debug (Hex and Clock)

  These commands set debug flags for general PortMaster troubleshooting. Debug information is displayed to the console.

  set debug clock on|off

  set debug Hex

  set debug off

 

clock	Set on  to time-stamp the console debug messages. The time is measured since the last reboot and is specified in hours, minutes, seconds, and hundredths of a second. To turn the time stamp off, use the set debug clock off  command.
Hex	One of the following hex codes:   · 0x0  disables the output for a Hex debug. This is the default.
	· 0x1100  outputs information about routing table updates from RIP.
	· 0x51  allows observation of Point-to-Point Protocol (PPP), Local Management Interface (LMI), and Annex-D configuration requests and acknowledgments.
	· 0x54  allows observation of the last 60 characters sent and received on an asynchronous port, and the last two termination causes, when a show  command is entered on the port.
	· 0x72  displays interactively between ComOS and nonvolatile RAM when ComOS is reading from or writing to the nonvolatile RAM.
	· 0x74  displays the last 60 characters of I/O.
	· 0x75  same as 0x51 and 0x54 with more detail.
	· 0x78  shows Telnet negotiation options when someone is connecting to the PortMaster by Telnet.
	· 0x81  shows updates being made to the Address Resolution Protocol (ARP) cache.
off	Clears all debug settings--including Hex debug settings--currently active on the PortMaster.

 

Usage

  The debug  command is useful for troubleshooting such PortMaster activities as the PPP negotiation process.

 

Example

  To debug PPP negotiations, enter the following commands:

  Command> set console
 Command> set debug 0x51 

  To stop the debug output, enter the following:

  Command> set debug off
 Command> reset console 

  Refer to the PortMaster 4 Troubleshooting Guide for information on interpreting the output.

 

See Also

  ptrace - page 2-11

  reset console - page 2-13
set console - page 2-16

  traceroute - page 2-46

       set debug imt

  This command sets debug flags for Q.931 packet transmission. Debug information is displayed to the console.

  set debug imt on|off

on	Set on  to debug packets on a T1 line connected to an IMT.
off	Clears debug settings.

 

Usage

  Before using this command, you must first select a Quad T1 board using the set view  command and issue the set console  command to display packet transmission events to the console.

 

       set debug isdn

  This command sets debug flags for ISDN troubleshooting. Debug information is displayed to the console.

  set debug isdn|isdn-dframes|termination|isdn-v120 on|off

isdn	Set on  to show ISDN debugging information on the console.
isdn-dframes	Set on  to show ISDN frame debugging information on the console. To turn off debugging, re-enter the command.
isdn-v120	Set on  to display debugging of the V.120 protocol exchanges in V.120 connections.
termination	Set on  to display detailed port termination information.
off	Clears debug settings--including Hex debug settings--currently active on the PortMaster, except ISDN debug settings for a specific D channel.

 

Usage

  The debug  command is useful for displaying ISDN information--such as connections, disconnections--on the console.

 

Example

  To track any errors occurring while ISDN lines are in use, enter the following commands:

  Command> set console
 Command> s et debug isdn on 

  To stop the debugging output, enter the following:

  Command> set debug off
 Command> reset console 

 

See Also

  set console - page 2-16
reset console - page 2-13

       set debug l2tp

  This command displays L2TP activities to the console.

  set debug l2tp max|packets [Bytes ]|rpc|setup|stats on|off

max	Set on to display all the information generated when you use all the other debug options listed below.
packets [Bytes]	Set on to display L2TP packets. Bytes  is an optional integer between 0 and 1500 that specifies the number of bytes to display.
rpc	Set on to display remote procedure call communication between the system manager module and the Quad T1, Tri E1, or LNS boards.
setup	Set on to display control messages and errors.
stats	Set on to display L2TP session statistics.
off	Clears all L2TP debug settings currently active on the PortMaster 4.

 

Usage

  To display L2TP debug information for the entire PortMaster 4, use the set view  command to select the manager module. To display debug information about a specific Quad T1, Tri E1, or LNS board, set the view to the slot containing the desired board.

       set debug mdp

  This command sets debug flags used for troubleshooting PortMaster digital modems. Debug information is displayed to the console.

  set debug mdp-status|mdp-events|mdp-max on|off

mdp-status	Set on  to display the status of the digital modems.
mdp-events	Set on  to display the progress of the modems as they initialize.
mdp-max	Set on  to display both the status of the digital modems and their progress as they initialize.
off	Clears all debug settings--including Hex debug settings--currently active on the PortMaster.

 

Usage

  The debug  command is useful for troubleshooting PortMaster digital modems as they are initialized and while their operating code is being loaded.

 

Examples

  1. To track digital modem operation, enter the following commands:

  Command> set console
Command> set debug mdp-max on

  Enabling Maximum Modem debugging

  Command> slot2: S2: Called-Station-ID <4160150> Caller-Station-ID <9254600115>

  slot2: M2: mdp_allocate service 90

  slot2: S2: Modem M2 bound

  slot2: S2: Modem M2 connecting
slot2: M2: mdp_bind: (S2) dsl_id 0 ch_n 3 slot 12

  2. To track digital modem status only, enter the following commands:

  Command> set console
 Command> s et debug mdp-status on 

  3. To stop the debugging output, enter the following:

  Command> set debug off
 Command> reset console 

 

See Also

  set console - page 2-16
reset console - page 2-13

       set debug nfas

  This command enables or disables the PortMaster 4 to log NFAS events to the console.

  set debug nfas on|off

on	Logs NFAS events.
off	Disables the logging of NFAS events.

 

Usage

  The PortMaster 4 supports NFAS on ComOS 4.1 and later releases. Before using this command, you must first select a Quad T1 board using the set view  command and issue the set console  command to display NFAS events to the console.

 

See Also

 

reset console - page 2-13
set console - page 2-16
set Line0 nfas - page 15-13

       set debug ospf

  This command sets debug flags used for troubleshooting OSPF. Debug information is displayed to the console.

  set debug ospf-hello|ospf-event|ospf-spfcalc|ospf-lsu|ospf-lsa|
ospf-dbdesc|ospf-error|ospf-routing|ospf-max on|off

ospf-hello	Set on  to show hello packets sent between neighbors.
ospf-event	Set on  to show changes in state between neighbors.
ospf-spfcalc	Set on  to show details of the shortest path first (SPF) calculation for an area each time this calculation is run.
ospf-lsu	Set on  to show link state update packets sent or received.
ospf-lsa	Set on  to show link state advertisement packets sent or received.
ospf-dbdesc	Set on  to show the initial exchange of database information sent between OSPF neighbors when they are forming an adjacency.
ospf-error	Set on  to show information when the current PortMaster OSPF configuration does not match a neighbor's OSPF configuration.
ospf-routing	Set on  to show when the routing table receives input from the OSPF database, or the OSPF database receives input from the routing table.
ospf-max	Set on  to show all OSPF debug information.
off	Clears all debug settings--including Hex debug settings--currently active on the PortMaster.

 

Example

  To track OSPF link state update packets, enter the following commands:

  Command> set console
 Command> s et debug ospf-lsu on 

  To stop the debugging output, enter the following:

  Command> set debug off
 Command> reset console 

 

See Also

  reset console - page 2-13
set console - page 2-16

       set debug rip|rip-detail

  This command enables the PortMaster 4 to view incoming and outgoing routes and problems with RIP authentication.

  set debug rip|rip-detail on|off

rip	Set on  to show incoming and outgoing routes.
rip-detail	Set on  to show routes transferring RIP packets.
on	Enables debugging.
off	Disables debugging.

 

Usage

  The PortMaster 4 supports this command on ComOS 4.1 and later releases.

 

Example

  Command> set console
Setting CONSOLE to admin session

  Command> set debug rip on
set debug rip on

  Enabling RIP debugging
RIP: Recv ether1 (0.10) from 149.198.96.2 Version-1 length 500
RIP: Recv ether1 (0.10) from 149.198.96.2 Version-1 length 500
RIP: Recv ether1 (0.10) from 149.198.96.2 Version-1 length 500
RIP: Recv ether1 (0.10) from 149.198.96.2 Version-1 length 280
RIP: Send ether1 (0.10) Version-2
RIP: Send ptp0 (0.0) Version-1
RIP: Send ptp0 (0.0) Version-1

 

See Also

  reset console - page 2-13

  set console - page 2-16