[Top][Contents][Prev][Next][Last]Search


Using the MAX TNT Debug Commands


This chapter covers the following topics:
Enabling debug permissions
Enabling debug output
Debug levels
Getting online help for debug commands
Using combinations of commands
Using the debug commands


Note: Every attempt has been made to confirm that this chapter correctly describes the functionality and output of the MAX TNT debug commands. However, while debug mode can be a very valuable troubleshooting tool for anyone, its primary focus is on the requirements of Ascend's development engineers. For this reason, Ascend does not guarantee the completeness of the list of commands published for a given release nor the exhaustive cataloging of their functionality.

Caution: Under most circumstances, debug commands are not required for correct operation of the MAX TNT. And in some circumstances they might produce undesirable results. Please use the following information with caution. Contact Ascend Technical Support with any questions or concerns.

Enabling debug permissions

Before you can access the debug commands, you must log into the MAX TNT with a User profile that specifies debug privileges.

To enable debugging privileges:

  1. Open a user profile:

  2. Enable debug permissions:

    This is a hidden parameter. It does not appear in the interface.

  3. Write the profile to save the changes:

Note that when you are logged into the MAX TNT with debug privileges, the interface might display normally unavailable parameters and commands, some of which are not configurable in certain situations. For this reason, you should create a special profile for debugging purposes, and only use that profile when you are debugging the MAX TNT.

Enabling debug output

To enable debug output for all commands on the system or on a card, use the Debug command as in the following examples.

To enable debug:

To disable debug:

When you enable debug output, the MAX TNT displays the debug messages on the terminal screen.

Debug levels

Debug levels vary depending on the command. But generally, the lower you set the debug level, the fewer messages the MAX TNT displays. Setting the debug level to 0 (zero) disables the debug output for the command.

Set the debug level with the -t option, as in the following examples:

admin> ifmgr -t 0
ifmgr debug level is now 0 (disabled)


admin> ifmgr -t 4
ifmgr debug level is now 4 (enabled)

Getting online help for debug commands

To see a list of all commands, including the debug commands, enter ? at the command prompt, as in the following example:

To get basic help for a debug command, enter the Help command, followed by the name of the debug command, as in the following example:

Using combinations of commands

Since most debug commands are designed to give a developer information about specific portions of MAX TNT functionality, you might find it helpful to use commands in combination to troubleshoot different problems.

For example, if you see problems with the initial connection of remote users, you might want to use a combination of Networki, Routmgr and Wantoggle to obtain a complete view of three functions involved in establishing a call.

When troubleshooting modem-related issues, you might want to use Modemdrvstate, Modemdiag and Mdialout (if modem outdial is supported on your MAX TNT) to get all modem-related information for your calls.

Using several commands simultaneously not only gives you a clearer picture of a given situation, it also shows you a chronological timeline of the events that are happening.

Using the debug commands

Debug commands allow you to monitor and diagnose different areas of the MAX TNT functionality. This section lists some of the more common debug commands and the areas of the MAX TNT they apply to.

Frame Relay

The following commands display information about Frame Relay interfaces.

Calls

The following commands display information about how the MAX TNT handles calls.

Authentication

The following commands display information about how the MAX TNT authenticates calls.

Multishelf

The following commands display information about the MAX TNT multishelf system.

Host-side devices

The following commands display information about the MAX TNT host devices.

Network-side devices

The following commands display information about the MAX TNT network devices.

Protocols

The following commands display information about MAX TNT protocols.

Tunneling

The following commands display information about the MAX TNT tunneling.

System and devices

The following commands display information about the MAX TNT system and devices.

Terminal server

The following commands display information about the MAX TNT terminal server.

Special administrative commands

The following command should only be used when requested to by Ascend technical support.

Alphabetical list of debug commands

This section describes the MAX TNT debug commands in alphabetic order. The information is organized for quick reference, and does not include tutorials.

Acct-Failsafe

Description: The Acct-Failsafe debug command is available on the master shelf or the slot host cards for verifying correct accounting proxying. Slave shelf controllers and slot line cards do not support this command.

admin> acct-failsafe
usage: acct-failsafe -option [ params ]
-d <shelf> <slot>
(d)isplay AFS info for <shelf> <slot>
-d (d)isplay AFS info for all relevant slots (Slot host cards do not include the "-d" option.)
-t (t)oggle module debug level
-? display this summary
To display information about the calls on any slot which are candidates for proxy accounting.:

admin> acct-failsafe -d    
Slot 1/8:
HashTable @ 10542160, bucketCount: 192, callCount: 23, hashName <afs- 1:8>
Slot 2/5:
HashTable @ 10585730, bucketCount: 48, callCount: 7, hashName <afs- 2:5>
To display the same information for a single slot card in shelf 1, slot 8:

admin> acct-failsafe -d 1 8
Slot 1/8:
HashTable @ 10542160, bucketCount: 192, callCount: 23, hashName <afs- 1:8>
To specify which level of debug to use for the command, use the -t option. A debug level of zero indicates none (no messages). A level of 7 is fairly verbose.

Addrpool

Description: Displays messages related to dynamic address pooling. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter addrpool at the command prompt.

Example: Following are several examples of output produced when Addrpool is active.

With 18 addresses currently allocated from a pool:

The address 208.147.145.155 was just allocated:

The address 208.147.145.141 is to be freed because the user of that address has hung up. The MAX TNT must find the pool to which the address belonged, then free the address so it is available for another user:

In the IP Global profile, the Pool-Base-Address [1] is set to 192.168.8.8, and Assign-Count [1] is set to 4:

The Assign-Address parameter of an existing pool is changed from 4 to 3:

A second pool is created. In the IP Global profile, the Pool-Base-Address [2] is set to 192.168.8.8, and Assign-Count [2] is set to 10:

The second pool is deleted:

ATMPdebug

Description: Displays messages related to Ascend Tunnel Management Protocol (ATMP) sessions. (ATMP is described in RFC 2107.) The command is a toggle that alternately enables and disables the debug display. You would normally use this command with the Tunneldebug command.

Usage: atmpdebug

Example:

The mobile node sends a request to foreign agent asking for connection to the home agent:

ATMP: sendRegReq: HA=200.67.1.254:5150  RcvUdp=5150
ATMP: Id=162, FA=130.67.40.254
ATMP: MC=141.111.40.82, HomeNetName=[]
The home agent sets up a tunnel:

ATMP: received cmd <RegisterRequest> from 130.67.40.254:5150
ATMP: procRegReq: from=130.67.40.254:5150
ATMP: FA=130.67.40.254, MC=141.111.40.82, HomeNet=
ATMP: sendChallReq: to 130.67.40.254:5150, Id=162, EC=Good completion
ATMP: received cmd <ChallengeReply> from 130.67.40.254:5150
ATMP: procChallReply: from 130.67.40.254:5150, Id=162
ATMP: sendRegisterReply: to udp=5150, Id=162, Tunnel=156, EC=Good completion

AuthenDebug

Description: Displays messages related to Link Control Protocol (LCP) authentication on the MAX TNT. The command is a toggle that alternately enables and disables the debug display. This command is available on host cards such as the HDLC card and the modem card, and on dual host and network cards such as the SWAN card and the FrameLine card.

Usage: authendebug

Example: The following display indicates a successful PAP authentication.

AUTH: lcp_pap_req(remote=0)
AUTH-3: verify_pap(given<len.id=13:140.57.40.135, pwdLen=6>)
AUTH-3: verify_pap No authData - getting one
AUTH-3: verify_pap: authDispatcher() == OK
AUTH-3: verify_pap_callback: AUTHCOMMAND_SUCCESS

BrouterDebug

Description: Displays messages related to the router functionality of the MAX TNT. The command is a toggle that alternately enables and disables the debug display.

You can use this command for a general view of the load experienced by the MAX TNT.

Usage: Enter brouterdebug at the command prompt.

Example: Typically, brouterdebug displays very few messages. The following session took place over a period of several minutes on a MAX TNT with 40-45 users active.

The BROUTER_LOAD_MSG message is an indication of how busy the MAX TNT router function is. A low number, as is illustrated here, indicates the router is not experiencing any problems.

BrouterLoad

Description: Reports router backlog time, which indicates whether the MAX TNT is experiencing any delay. The time is shown in ticks. Multiply the number of ticks by ten to get the time in milliseconds.

You can use this command for a general view of the load experienced by the MAX TNT.

Usage: Enter brouterload at the command prompt.

Example: The following display indicates no delays in the router.

Coredump

Description: Enables or disables the ability of the MAX TNT to send the contents of its memory (core) to a specified UNIX host. The UNIX host must be running the Ascendump daemon, which is available by contacting Ascend Technical Support. For details of using core dumps, see Appendix A, "Getting MAX TNT Core Dumps. "

Coredump is a particularly useful tool for Ascend's development engineering, and is occasionally requested by Technical Support for troubleshooting specific issues.

Caution: Using this command will cause the MAX TNT to reboot after its memory (core) has been dumped. Do not use this command unless specifically requested by an Ascend representative.

The Coredump command's syntax provides the following valid entries:

Example: Following are examples of use of the Coredump command:

Ctcheck

Description: Analyzes the CIDR tree and displays general statistics about the quantity of nodes and levels in the CIDR tree.

Usage: Enter ctcheck at the command prompt.

Example:

Ctdebug

Description: Displays messages related to CIDR routing. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter ctdebug at the command prompt.

Example:

Cubit

Description: Displays the statistics of the shelf controller's 3 cubit chips. The command used to gather statistics from the chips. The cubit chips direct packet-bus traffic between each other, between each other and the shelf-controller SAR and slot card SAR, and intershelf to other cubits.

Usage: cubit -s|-r|-w|-d|-i|-z [ parameters ]

Syntax element

Description

-s

Show the statistics of all 3 cubits.

-r cubit vpi

Read the content of the cubit at the specified VPI.

-w cubit vpi type fwcubit on|off

Write to the cubit at the specified VPI. This command is only useful for Ascend development engineers.

-d cubit startVPI

Dump the content of the cubit.

-i

Re-initialize the cubits.

-z

Reset the cubits.

Example:

In the following example, cubit B is not operating normally and the shelf controller might be defective. Note that receive errors are logged as resets:

admin> cubit -s
Cells CUBIT_A CUBIT_B CUBIT_I
----- ------- ------- -------
received: 1316806 0 2740761
discarded: 0 0 0
misrouted: 0 0 0
HEC Error: 0 0 0
Resets: 0 5151 0
The following example indicates that the multishelf is operating normally:

admin> cubit -s
Cells     CUBIT_A     CUBIT_B     CUBIT_I
----- ------- ------- -------
received: 557088 3990584 3497345
discarded: 0 0 0
misrouted: 0 0 0
HEC Error: 0 0 0
Resets: 0 0 0

DTunnel

Description: Displays the status of enabled tunnels on the MAX TNT.

Usage: Enter dtunnel at the command prompt.

Example:

admin> dtunnel
MajDev  Proto  Agent Mode      HA Type  IPX sap   UDP   password
------ ----- ---------- ------- ------- ----- --------
7 ATMP Home-Agent Router disabled 5150 ascend
Idle-Limit 120 mins

Tunnels:
--------------------------------------------------
Tunnel 36734 IfNum 65535 Majdev 7 Agent Address 130.67.40.254:5150
Ident=0x56 TN=0x47BF DnsSN=0
ATMP Home-Agent
State 5 (UP) Router Mode Home Network Name
Remote client Idle-Limit 120 mins
Client IP Address 141.111.40.86/32
--------------------------------------------------
Tunnel 36732 IfNum 65535 Majdev 7 Agent Address 130.67.40.254:5150
Ident=0x55 TN=0x47BE DnsSN=0
ATMP Home-Agent
State 5 (UP) Router Mode Home Network Name
Remote client Idle-Limit 120 mins
Client IP Address 141.111.40.85/32

Ether-Stats

Description: Displays all statistics and error counters maintained by the 10Base-T Ethernet driver.

Usage: ether-stats 0 n

Where 0 is the first Ethernet port for which to display statistics and n is the last.

Example:

admin> ether-stats 0
Tx unicast: 48382
non-unicast: 23736
octets: 10746332
collisions: 443
dma under: 0
cts loss: 0
no carrier: 0
late coll: 0
Rx unicast: 45952
non-unicast: 31307
octets: 13491043
collisions: 0
short frame: 0
dma over: 0
no resource: 0
Alignment: 0
Unaligns: 0
Length Errs: 0
Restarts: 0

FRDLstate

Description: Displays information regarding the state of the Frame Relay connections, focusing mostly on Data Link information. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter frdlstate at the command prompt.

Example:

In this example, an outgoing call is to be placed. A route to the destination is available over a Frame Relay link. The following message appears:

FRDLCALL: Clear Call for route: 136
The following message indicates that an outgoing call is connected:

FRDLCALL-136: call complete, status 1, 0 channels
The next message indicates that either the MAX TNT or the far end device has destroyed a route. The MAX TNT updates its table to reflect this routing change.

FRDLCALL-136: dead call
FRDLCALL-136: route destroyed

FRdump

Description: Displays a snapshot of the Frame Relay Interface table. The display shows data for each DLCI assigned to a Frame Relay link.

Usage: Enter frdump at the command prompt.

Example:

admin> frdump 
* Frname State DLinkAddr routeID.id frmgrLink dlIfNum dlIfSpeed
frt14 CONNECTED 1012c920 15 0 738 512000
*dlci Addr ifNum routeID dataLink state
304 100cada0 23 136 1012c920 INACTIVE
frt18 CONNECTED 1012ffa0 14 0 742 1536000
*dlci Addr ifNum routeID dataLink state
306 101719a0 33 36 1012ffa0 ACTIVE
604 10193c60 27 32 1012ffa0 ACTIVE
603 10191fe0 26 31 1012ffa0 ACTIVE
frt17 CONNECTED 10149b60 13 0 741 1536000
*dlci Addr ifNum routeID dataLink state
305 101975e0 32 35 10149b60 ACTIVE
600 101910a0 24 30 10149b60 ACTIVE
303 1018cea0 22 28 10149b60 ACTIVE
301 10186360 20 26 10149b60 ACTIVE
frt16 CONNECTED 1017ad20 7 0 740 1536000
*dlci Addr ifNum routeID dataLink state
605 101961e0 29 34 1017ad20 ACTIVE
300 1018a820 21 27 1017ad20 ACTIVE
frswan4 CONNECTED 10125ba0 2 0 734 64000
*dlci Addr ifNum routeID dataLink state
411 101592a0 31 5 10125ba0 ACTIVE
407 10155ae0 30 4 10125ba0 ACTIVE
403 10153be0 25 3 10125ba0 ACTIVE

FRinARP

Description: Performs an Inverse ARP test over the specified Frame Relay link and DLCI. You can use FRinARP to help troubleshoot connectivity and routing problems over a Frame Relay link.

Usage: frinarp Frame_Relay_profile_name DLCI

Example:

admin> frinarp FR-1 38
frInArp: frinarp frname dlci
Inverse Arp op 2304 hw type 3840 prot type 8 hw len 2 prot len 4
Source Hw address 0401 Target Hw address 0000
Source Protocol address cd933401 Target Protocol address cd930005

FRLinkState

Description: Displays Frame Relay control messages. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter frlinkstate at the command prompt.

Example:

The following message indicates that the MAX TNT sent a Frame Relay Status Enquiry. The Send sequence number is 135. The Receive sequence number is 134.

The next message indicates that DLCI 16 is being processed. This is a normal message. You should see one process message for each DLCI.

FRLMI

Description: Displays Frame Relay Link Management Interface (LMI) information. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter frlmi at the command prompt.

Example:

The following message validates the consistency of sequence numbers in LMI messages. The 144 after want indicates the original sequence number the MAX TNT sent. The two numbers after the second got indicate the switch's Send sequence number and the Switch's report of the last sequence number it received from the MAX TNT, respectively. The original sequence number should match the switch's report of the last sequence number it received.

FRMgrDump

Description: Displays the Frame Relay link and DLCI information, including states and counters.

Usage: Enter frmgrdump at the command prompt.

Example:



FRPriorityErrors

Description: Reports statistics about Frame Relay priority errors on a host card. All values in its output should be zero. A non-zero value indicates an extreme shortage of memory.

For example:

FRScert

Description: Toggles between Sprint and Frame Relay Forum LMI checks. The default is the Sprint certification policy. In most cases, the default setting is correct and should not be changed.

Usage: Enter frscert at the command prompt.

Example:

FRstate

Description: Displays messages related to Frame Relay state changes. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter frstate at the command prompt.

Example: An administrator enables the display, data is received from the Frame Relay interface and processed, and the administrator disables the display.

GRE

Description: Displays the MAX TNT Generic Routing Encapsulation (GRE) information. The command has little practical use other than as a tool for developmental engineering.

IFMgr

Description: Displays interface-table entries for the Ethernet interface, toggles the debug display, and marks an interface as enabled or disabled. This command is available on the shelf controller and on host cards such as the Ethernet, modem, HDLC, SWAN, and FrameLine cards. The output differs slightly depending on where the command is executed.

Usage: ifmgr [-d [ifnam/ifnum] | -t ] [up|down ifnum|ifname]

Syntax element

Description

-d

Display interface table entries.

-d ifname/ifnum

Display details of the specified interface name or number.

-t

Toggle debug display.

up | down ifnum | ifname

Enable or disable the specified interface. These options have the same effect as setting the Enabled parameter in the Ethernet profile, and are subject to the same limitations.

Example: To view the IFMgr usage summary for an Ethernet card in slot 4, first open a session to the card:

admin> open 1 4
Then you can use the -d option to view the interface number and name:

ether-1/4> ifmgr -d
if slot:if u p ifname mac addr local-addr
---------------------------------------------------
000 0:00:000 * pb0 000000000000 0.0.0.0/32
001 1:17:011 * ie1-4-1 00c07b6d23f0 11.1.1.1/32
002 1:17:013 * ie1-4-2 00c07b6d23f1 11.1.2.1/32
003 1:17:015 * ie1-4-3 00c07b6d23f2 11.1.3.1/32
004 1:17:017 * ie1-4-4 00c07b6d23f3 11.1.4.1/32
005 1:17:019 * ie1-4-5 00c07b6d23f4 11.1.5.1/32
<end>
The IFMgr -d output for an Ethernet card contains the following fields:

Field

Description

if

Ethernet interface number.

slot:if

Shelf, slot and system-wide interface number. (This interface number is reported by excuting the IFMgr command on the shelf controller.)

u

Flag indicating whether the interface is up (*) or down (-).

p

Flag indicating whether the interface is permanent. A P indicates a permanent interface. A hyphen (-) or a blank indicates that it is not.

A permanent interface is an interface configured in the command-line interface and stored in MAX TNT NVRAM. All the Ethernet interfaces and the virtual interfaces made for Connection profiles are permanent. Transient interfaces are those the MAX TNT builds from RADIUS, TACACS, or an Answer profile. These interfaces have no interface entry when the connection is down.

ifname

Interface name.

mac addr

Interface MAC address.

local-addr

Interface local address.

Following is an example of disabling an interface:

ether-1/4> ifmgr down ie1-4-1
The IFMgr -d output indicates that the interface is disabled by displaying a hyphen instead of an asterisk in the Up column:

ether-1/4> ifmgr -d
if slot:if u p ifname mac addr local-addr
---------------------------------------------------
000 0:00:000 * pb0 000000000000 0.0.0.0/32
001 1:17:011 - ie1-4-1 00c07b6d23f0 0.0.0.0/32
002 1:17:013 * ie1-4-2 00c07b6d23f1 11.1.2.1/32
003 1:17:015 * ie1-4-3 00c07b6d23f2 11.1.3.1/32
004 1:17:017 * ie1-4-4 00c07b6d23f3 11.1.4.1/32
005 1:17:019 * ie1-4-5 00c07b6d23f4 11.1.5.1/32
<end>

Note: The Netstat command also displays a hyphen to indicate a disabled Ethernet interface.

To mark an interface as up, use the up option:

ether-1/4> ifmgr up ie1-4-1
An interface can be administratively disabled by using the IFMgr command or by updating the Ethernet profile, or it can be marked as down by the Ethernet driver when Link-State-Enabled is Yes and Link-State is Down. Therefore, using the Up option to the IFMgr command does not necessarily enable the interface. However, it does mark the interface as up.

Following is an example of using the IFMgr command on the shelf controller:

admin> ifmgr -d
bif slot sif u m p ifname host-name remote-addr local-addr
----------------------------------------------------------------------------
000 1:17 000 * ie0 - 0.0.0.0/32 192.168.7.133/32
001 1:17 001 * lo0 - 0.0.0.0/32 127.0.0.1/32
002 0:00 000 * rj0 - 0.0.0.0/32 127.0.0.2/32
003 0:00 000 * bh0 - 0.0.0.0/32 127.0.0.3/32
004 0:00 000 * wanabe - 0.0.0.0/32 127.0.0.3/32
005 0:00 000 * local - 0.0.0.0/32 127.0.0.1/32
006 0:00 000 * mcast - 0.0.0.0/32 224.0.0.0/32
007 0:00 000 - tunnel7 - 0.0.0.0/32 192.168.7.133/32
008 1:11 001 * p wan8 tnt-t1-t32 200.2.1.2/32 192.168.7.133/32
009 1:11 002 * p wan9 tnt-t1-t32 200.2.2.2/32 192.168.7.133/32
010 1:11 003 * p wan10 tnt-e1-t22 200.3.2.2/32 192.168.7.133/32
011 1:11 004 * p wan11 tnt-e1-t32 200.5.1.2/32 192.168.7.133/32
012 1:11 005 * p wan12 tnt-e1-t32 200.5.2.2/32 192.168.7.133/32
013 1:11 006 * p wan13 tnt-t1-t22 200.1.1.2/32 192.168.7.133/32
014 1:15 001 * p wan14 tnt-t1-s1- 100.1.100.2/32 100.6.100.2/32
015 1:11 007 * p wan15 tnt-e1-t22 200.3.1.2/32 192.168.7.133/32
016 1:11 008 * p wan16 cisco-t221 200.4.103.2/32 192.168.7.133/32
017 1:11 009 * p wan17 m-e1-t2211 200.4.4.2/32 192.168.7.133/32
018 1:11 010 * p wan18 m-e1-t2212 200.4.4.3/32 192.168.7.133/32
019 1:17 000 - p wan19 m2t81 200.8.1.2/32 192.168.7.133/32
020 1:17 000 - p wan20 m41 200.4.1.2/32 200.6.1.2/32
021 1:16 001 * p wan21 p1321n<>p1 0.0.0.0/32 0.0.0.0/32
[More? <ret>=next entry, <sp>=next page, <^C>=abort]
The IFMgr output on cards other than the Ethernet card includes the following fields:

Field

Description

bif

Bundle interface number. There is one interface number per bundle, including MPP connections. It is the global interface-table number.

slot

Shelf and slot the interface is assigned to.

sif

Slot interface.

u

Flag indicating whether the interface is up (*) or down (-).

m

Indicates that the interface is part of an MP bundle.

p

Flag indicating whether the interface is permanent. A P indicates a permanent interface. A hyphen (-) or a blank indicates that it is not.

A permanent interface is an interface that is configured in the command-line interface and stored in MAX TNT NVRAM. All the Ethernet interfaces and the interfaces based on Connection profiles are permanent. Transient interfaces are those the MAX TNT builds from RADIUS, TACACS, or an Answer profile. These interfaces have no interface entry when the connection is down.

ifname

Interface name.

host-name

Host name of remote device.

remote-addr

Remote address of device as configured in a Connection profile.

local-addr

Local address of device as configured in a Connection profile.

Following is an example of displaying information about a particular interface:

admin> ifmgr -d 009
inUse: Yes
hostName: tnt-t1-t3212-s4
dialoutName:
ExternalAuth: No
ExternFilters: No
ExternRoutes @ 0
ExternIpxRoutes @ 0
miscInfo @ 0
reDirectDest: 0.0.0.0
DLCI routeId: 34
MP(P) id: 0
Logical iff: 2
virtual id: 0, virtual next @ 0, virtual main @ 0
minor device: 9
device status: 0x303
mtu: 1528
ip_addr: 192.168.9.133
dstip_addr: 100.2.1.2
netmask: 255.255.255.0
net: 192.168.9.0
subnet: 192.168.9.133
bcast: 192.168.9.255
nbcast: 192.168.9.133
directed-bcast: no
macaddr: 000000000000
inp_qcnt: 0
out_qcnt: 0
nexthop: 0.0.0.0
Num pkts queued for brouter: 0
proxy_arp_mode: 0
proxy_arp_head: 0
No associated connection profile
The ICMP-Reply-Directed-Bcast parameter in the IP-Global profile specifies whether the MAX TNT responds to directed-broadcast ICMP echo requests. If set to No, the system does not respond to any directed-broadcast ICMP requests. The setting of this parameter is shown in the Directed-Bcast field in the Ifmgr output.

IPXRIPdebug

Description: Displays incoming and outgoing IPX RIP traffic. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter ipxripdebug at the command prompt.

Example:

admin> ipxripdebug
IPX-RIP state display is ON
The following message appears as the MAX TNT sends an IPX RIP packet announcing its route:

IPXRIP: 10000a17 announced 0 routes on interface 1000:
Next, a Pipeline 50 has dialed the MAX TNT. The MAX TNT receives a RIP route from the Pipeline.

IPXRIP: received response from ac1b0001:00c07b5e04c0 (1 nets).
The following message indicates that the MAX TNT is delaying sending a RIP packet to prevent the interpacket arrival time from being shorter than busy/slow boxes can handle. An IPX router should never violate the minimum broadcast delay.

IPX-RIP: too soon to send on interface 1000.
IPXRIP: 10000a81 announced 0 routes on interface 1000:
IPXRIP: received response from ac1b0001:00c07b6204c0 (1 nets).
IPXRIP: 10000aa6 announced 0 routes on interface 1000:
IPXRIP: received response from ac1b0001:00c07b5504c0 (1 nets).
IPXRIP: 10000abc announced 0 routes on interface 1000:

Lanval

Description: Displays messages related to external validation requests. You can use this command in conjunction with radif to troubleshoot authentication issues.

Usage: Enter lanval at the command prompt.

Example:

LifDebug

Description: Displays ISDN layer 2 and layer 3 information. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter lifdebug at the command prompt.

Example: Following are several examples of LifDebug output:

admin> lifdebug
LIF debug is now ON
A packet is being sent over the WAN. The packet is constructed:

LIF_SendPkt(): DSL 0, source 0x400, destination 0x300,
event 0x340, SAPI 0, CES 1, Call_Id 77, Chan_Id 0
The following message displays the contents of the packet:

PACKET:
Header (4): a0 50 59 b0 Info (9): 08 02 00 00 84 08 02 80 90 01
L3_Go: source 0x400, event 0x340, DSL 0, call_id 77, ces 1
L3_ProcessUserEvent(): State 0x9, Event 0x84, Index 6,
DSL 0, CallID 77
Another packet is sent:

LIF_SendPkt(): DSL 0, source 0x300, destination 0x205,
event 0x240, SAPI 0, CES 1, Call_Id 77, Chan_Id 0
PACKET:
Header (4): a0 50 59 b0 Info (9): 08 02 83 fe 45 08 02 80 90 00
L3_Go(): end of L3 task, NLCB State 10
L2_Go(): DSL_Id=0, SAPI=0, CES=1, TEI=0, Event=240
L2_ProcessEvent(): DSL 0, index 13, state 7
L2_ProcessEvent(): DSL 0, index 19, state 7
L2_Go(): DSL_Id=0, SAPI=0, CES=1, TEI=0, Event=1
L2_ProcessEvent(): DSL 0, index 1, state 7
L2_Go() end: DLCB->State 7

MdbStr

Description: Modifies the default modem AT command strings used by the modems on the MAX TNT for both incoming and for outgoing calls. Previously, you could not modify the AT command for modems on the MAX TNT. You could only affect the string in minor ways by modifying the parameters in the Terminal-Server>Modem-Configuration subprofile. Note that when the modem card or the MAX TNT is reset, the AT command strings revert to their defaults.

The MdbStr command also allows you to return the string to its factory default settings.

The modem chip in the MAX TNT supports AT commands up to 56 characters in length. To fully support all possible functionality, each command is sent as two separate strings. You can modify one or both strings.

Caution: The AT command string initializes the modems it supports. When you change the AT command string, you are changing the functionality of the modems. Use this command with caution.

Here are the two default strings for the MAX TNT:

  1. AT&F0&C1V0W1X4

  2. AT%C3\N3S2=255S95=44S91=10+MS=11,1,300,33600A

Usage: mdbstr [ 0 ] [ 1 ] [ 2 ] [ AT-command-string ]

Example: The following examples show you how to modify each portion of the AT command string:

To override the existing first string with a new string:

mdbstr 1 AT&F0&C1V1W1
This will override the second portion of the AT command string:

mdbstr 2 AT%C3\N3S2=255S95=44S91=10+MS=11,1,300,14400A
This will return both strings to their factory default settings:

mdbstr 0

MDialout

Description: Displays messages related to modem dial out. This command can used in conjunction with the ModemDrvState command to get detailed information about outbound modem calls.

The command is a toggle that alternately enables and disables the debug display.

Usage: Enter mdialout at the command prompt.

Example: In the following example, a modem on the MAX TNT prepares to make an outbound modem call, but never receives a dialtone.

MDialSess

Description: Displays all the active modem dialout sessions.

Usage: Enter mdialsess at the command prompt.

Example:



ModemD1Stats, ModemD2Stats, ModemD3Stats

Description: Displays modem statistics. ModemD1Stats displays statistics for the first 16 modems, ModemD2Stats displays statistics for the second 16 modems, and ModemD3Stats displays statistics for the last 16 modems.

Usage: modemd1stats

To use this command, first open a session with a modem card, then enter the command.

Example:

modem-1/2> modemd1stats
modem: ansFail ansOK 1-2400 2.4-14.4 14.4-up 21.6+up 28.8+up
1/ 0: 3 171 0 0 171 171 171
1/ 1: 3 171 0 0 171 171 171
1/ 2: 2 172 0 0 172 172 172
1/ 3: 2 172 0 0 172 172 171
1/ 4: 4 170 0 0 170 170 170
1/ 5: 1 173 0 0 173 173 172
1/ 6: 0 174 0 0 174 174 174
1/ 7: 1 173 0 0 173 173 173
1/ 8: 1 173 0 0 173 173 173
1/ 9: 0 174 0 0 174 174 174
1/10: 2 172 0 0 172 172 172
1/11: 1 173 0 0 173 173 173
1/12: 1 173 0 0 173 173 173
1/13: 0 174 0 0 174 174 174
1/14: 1 173 0 0 173 173 173
1/15: 3 171 0 0 171 171 170

ModemDrvDump

Description: Displays information about the status of each modem.

Usage: Enter modemdrvdump at the command prompt.

Example: Following is a message about modem 0 (the first modem) in the modem card in slot 3 on the MAX TNT. The numbers in brackets indicate number of calls with unexpected open requests, unexpected Rcode events, unexpected release events, and unexpected timeouts:

MODEMDRV-3/0: Unexp Open/Rcode/Rlsd/TimOut=[0,0,0,0] 

ModemDrvState

Description: Displays communication to and from the modem driver on the MAX TNT. You can see which buffers are allocated and which AT command strings are being used to establish modem connections.

You can also determine whether data is received from the modem in an understandable format. If line quality is poor, the modem driver attempts to parse incoming data from the modem, but it might not be successful. This command can used in conjunction with the MDialout command to get detailed information about outbound modem calls.

The command is a toggle that alternately enables and disables the debug display.


Note: Once a connection is negotiated, a series of numerical result codes are passed between the modems. You can see and decipher these result codes to determine the negotiated connection rate and error correction/compression protocols. Following is a list of several result codes and their meanings:

Usage: Enter modemdrvstate at the command prompt.

Example: Following are examples of a modem call coming into the MAX TNT, and a modem call being cleared from the MAX TNT:

admin> modemdrvstate
MODEMDRV debug display is ON
Modem 1 on the modem card in slot 3 has been assigned to answer an incoming modem call:

MODEMDRV-3/1: modemOpen modemHandle B04E3898, hdlcHandle B026809C, 
orig 0
The modem is idle, so it is available to answer the call:

MODEMDRV-3/1: _processOpen/IDLE
The next two lines show the MAX TNT modem sending the first string:

MODEMDRV: Answer String, Part 1 - AT&F0E0+A8E=,,,0
A buffer needs to be allocated for sending the command out to the WAN:

MODEMDRV-3/1: _hdlcBufSentFnc: buffer = 2E12EAE0, status = SENT
Buffers are allocated for data being received from the WAN:

MODEMDRV-3/1: _hdlcBufRcvdFnc: data=2E13ADF0, len=8, parseState[n,v]=[0,0],
status= RCVD
MODEMDRV-3/1: _hdlcBufRcvdFnc: data=2E13BA20, len=5, parseState[n,v]=[0,0], status= RCVD
The MAX TNT modem receives an OK from the calling modem:

MODEMDRV-3/1: data =OK
The process is repeated for strings 2 and 3:

MODEMDRV-3/1: processTimeout/DIAL_STR2[2D]
MODEMDRV: Answer String, Part 2 - AT&C1V1\V1W1X4S10=60
MODEMDRV-3/1: _hdlcBufSentFnc: buffer = 2E12EAE0, status = SENT
MODEMDRV-3/1: _hdlcBufRcvdFnc: data=2E13C038, len=2, parseState[n,v]=[0,0], status= RCVD
MODEMDRV-3/1: data = 0
MODEMDRV-3/1: _processTimeout/DIAL_STR3
MODEMDRV: Answer String, Part 3 - AT%C3\N3S2=255S95=44S91=10+MS=11,1,300,33600,A
Now result codes are processed to clarify the characteristics of the connection.

MODEMDRV-1/1: _hdlcBufRcvdFnc: data=9880C628, len=48, parseState[n,v]=[1,0],
stD
MODEMDRV-1/1: data =
CONNECT 115200/V34/LAPM/V42BIS/28800:TX/33600:
MODEMDRV-1/1: decodeSLC[15]=<CONNECT 115200/> checking for error correction
MODEMDRV-1/1: decodeSLC[4]=<V34/> checking for error correction
MODEMDRV-1/1: decodeSLC[5]=<LAPM/> checking for error correction[29]
MODEMDRV-1/1: decodeSLC[7]=<V42BIS/> checking for compression[21]
MODEMDRV-1/1: decodeSLC[9]=<28800:TX/> checking for xmit[1]
MODEMDRV-1/1: _hdlcBufRcvdFnc: data=9880C828, len=4, parseState[n,v]=[4,0], staD
MODEMDRV-1/1: data = RX
> checking for recv[0]C[9]=<33600:RX
decodeSLC complete
At this point the modem call is up, and the modem driver has completed tis tasks. The call will be passed to Ethernet resources:

MODEMDRV-3/1: _processRcodeEvent/AWAITING RLSD, mType=5, RLSD=0
MODEMDRV-3/1: _processRlsdChange/AWAITING RLSD = 1
Following is the normal sequence of steps for a modem call that is cleared (by either modem). Modem 5 on the modem card in slot 7 of the MAX TNT is freed from the previous call, and it is reinitialized (so it is available for the next call).

MODEMDRV-7/5: modemClose modemHandle B04E6F38
MODEMDRV-7/5: _closeConnection:ONLINE, event=3
MODEMDRV-7/5: _processTimeout/INIT

MPCMtoggle

Description: Displays information about related channel addition with Multilink Point-to- Point connections. This information is not related to MP+ or BACP connections. This command displays only information from connections established as MP (RFC1717) connections.

The command is a toggle that alternately enables and disables the debug display.

Usage: Enter mpcmtoggle at the command prompt.

Example:

MPentry

Description: Displays information for a specified, active, MP or MP+ connection, including the options negotiated the connection. This command can be extremely helpful when researching MP or MP+ compatibility issues.


Note: The MpID number that must be entered is an internally generated number. To get a list of all currently assigned MpID numbers on your MAX TNT, enter the IFmgr -d command and specify a interface name or number.

Usage: Enter mpentry at the command prompt.

Example: The following example shows an MP+ call (noted as MPP). The End Point Discriminator (used to bundle the channels together) is shown under bundle id. In this case, it is the hardware MAC address of the calling device.

MPPCM

Description: Displays MP+ call-management information. The command is a toggle that alternately enables and disables the debug display. You can use it in conjunction with the MPtoggle command, since each command logs debug from a different place in code, but both display information based on multichannel connections.

Usage: Enter mppcm at the command prompt.

Example:

admin> mppcm
MPPCM debug is now ON
The following 8 messages indicate that a second channel is added to a 1-channel MP+ connection:

The following 12 messages indicate that a remote management session is brought up for the MP+ user with MpID 28. You can open a remote session to an MP+ user from the terminal server.

MPtoggle

Description: Displays information about MP and MP+ connections. You can use this command in conjunction with the MPPCM command, since each command logs debug from a different place in code, but both display information based on multichannel connections. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter mptoggle at the command prompt.

Example:

MSstat

Description: The MSstat command displays information about communications with other shelves over the TAXI bus. On the master shelf, the command displays statistics for the slave shelves. On a slave shelf, it displays statistics for the master and other slaves.

Usage: msstat

Example: From a master shelf:

admin> msstat
SH State TxQs TxSeq RxSeq Resend Timer LinkUp
2 4 0 13312 13116 3 0 2
3 4 0 12405 11822 0 0 2
4 2 0 0 0 0 1 0
5 2 0 0 0 0 1 0
6 2 0 0 0 0 1 0
7 2 0 0 0 0 1 0
8 2 0 0 0 0 1 0
9 2 0 0 0 0 1 0
Note that there are entries for all shelves (2-9), even though this system has only three shelves.

The MSstat command's output includes the following fields:

Field

Description

SH

Shelf number

State

Indicates the state of the multishelf communications. Values can be:

  • 1-No communications.

  • 2-Communications are initializing.

  • 3-Communications are initializing.

  • 4-Operational.

TxQs

Number of mssages in queue but not yet sent.

TxSeq

Number of messages sent.

RxSeq

Number of messages received.

Resend:

Number of retransmitted messages.

Timer

Number of seconds the shelf has been in the current state.

LinkUp

Number of times communications between the shelves have been established.

Example: From a slave shelf:

shelf-router-3/17> msstat
SH  State   TxQs  TxSeq  RxSeq Resend  Timer LinkUp
1      4      0  13693  13991      0      0      1
Note that on a slave shelf, only the master shelf is shown.

NetIF

Description: Displays the MAX TNT network interface mappings.

Usage: netif -m -q -t -v -?

Syntax element

Description

-m

Display mappings for the specified map type.

-q

Display the queue for a map.

-t

Toggle debug display.

-v

Display valid mapping tables.

-?

Display this summary.

Example:

Networki

Description: Displays information about calls as they are first presented to the MAX TNT. The MAX TNT assigns a numeric tag to each call in order to monitor the connection. (After a call passes through this section of code, it typically moves to a call-route manager, and is monitored with the RoutMgr diagnostic command.)

The Networki command is a toggle that alternately enables and disables the debug display.

Usage: Enter networki at the command prompt.

Example:

admin> networki
NETWORKI debug is now ON
The following messages indicate a new call coming into the MAX TNT. This is a normal string of messages for most calls:

** CALL 30  RINGING      globDsl  0, channel 23, session 999
The call is assigned a callID of 23 and a routeID of 123:

NETWORKI: cached callID 30, routeID 123
Resources have been allocated for the call. The MAX TNT then begins the process of answering the call:

NETWORKI: answering incoming call for route 123
The MAX TNT checks its call-route table to verify that it has an entry for the new call:

NETWORKI: found callID 30 for route
NETWORKI: found session for route 123
NETWORKI: clearSessionData
NETWORKI: answerCallRequest( 30, 123 )
With the next message, the call has been answered. The MAX TNT then determines where to route the call.

** CALL 30  CONNECTED    globDsl  0, channel 23, session  26
NETWORKI: call state connected, callid: 30
networki::pending call, checking for session completeness
NETWORKI: completeTransaction, route 123
NETWORKI: First call completed. Got base profile, service 1, type 0
NETWORKI: activateChannelList for route 123
clear enter NETWORKI: clearSessionData
clear exit clear done
At this point, the call is passed to another function, and Networki no longer applies to this call.

Following is a normal string of messages showing a call being cleared.

NETWORKI: clearSession
NETWORKI: Aborting transaction, route 102
NETWORKI: clearing retries
NETWORKI: callid 6 added to pending clear list
** CALL 6 INACTIVE globDsl 0, channel 23, session 999

OSPFAVLtree

Description: Displays the entire OSPF AVL tree.

Caution: With earlier software, this command caused the MAX TNT to reset. Do not use this command unless your MAX TNT is running 2.0 or later software.

Usage: Enter ospfavltree at the command prompt.

Example:

admin> ospfavltree
dest             mask            Lptr            Rptr            Myaddr  mrkedDl
0x 0 0x 0 0x 0 0x 0 0x1038dc00 0x0
0x 650a 0x ffff 0x 0 0x 0 0x104ef168 0x0
0x 200650a 0xffffffff 0x104ef168 0x 0 0x104ef0b8 0x0
0x 660a 0x ffff 0x104ef0b8 0x104ed66c 0x104ef0e4 0x0
0x 200660a 0xffffffff 0x 0 0x 0 0x104ef13c 0x0
0x 670a 0x ffff 0x104ef13c 0x104edb68 0x104ed66c 0x0
.
.
.

PBecho

Description: Tests the multishelf packet bus by using it to send traffic from one shelf controller to another.

The PBecho command is similar to Ping in that it sends a packet to a known destination and echoes the packet back. Because each cell contains a unique destination address to a shelf and slot within the system, you can test the packet bus by simply sending packets across it.

Usage: pbecho shelf slot count size

Syntax element

Description

shelf

Specifies the shelf to which to direct the echo packet.

slot

Specifies slot to which to direct to the echo packet.

count

Specifies the number of packets to send.

size

Specifies the size of the packets to send.

Example: In the following example, an administrator sends a thousand 1500-byte packets from the master shelf-controller to the slave shelf-controller in shelf 3:

The output of the command indicates that the slave controller received 1000 packets and echoed them back to the master shelf-controller. To further test the packet bus traffic across the multishelf system, the administrator could repeat the command a few times with different packet sizes, then, use the same command to send packets from the slave shelf-controller to the master.

PermConn-List

Description: Displays a list of all permanent connection profiles in the MAX TNT.

Usage: Enter permconn-list at the command prompt.

Pools

Description: Displays a snapshot of a large selection of memory pools, the size of each pool, and the status of each pool. At the end of the list is a summary of the total memory allocation in the MAX TNT.

Memory is dynamically allocated to support various tasks, and should be freed when a particular task has been completed. Taking pools snapshots over an extended period of time can help troubleshoot a problem with a memory leak, in which memory is allocated for a task but never freed.

Snapshots should never show the entire quantity of allocated memory (or even any single pool) increasing over an extended period of time.

Usage: Enter pools at the command prompt.

Example: The number of pools displayed is usually very large. The following example displays just a portion of the typical output.

admin> pools
Pool Name size limit inUse hiWat heapAdrs
Accounting Session Change Registrants 8 0 1 1 103CCAE0
AcctEvnt 14 0 127 127 103CCAE0
AfsHashEntry 191 0 0 0 103CCBE0
AfsTaskMsg 219 0 0 0 103CCBE0
AssignedChannelPool 32 0 127 139 103CCAE0
AuthData 116 0 0 0 103CCBE0
BrouterPool 80 0 2 14 103CCB60
.
.
.
volatile profile instance 16 0 171 184 103CCAE0
volatile profile type info 12 0 7 7 103CCAE0
The first portion of the Pools command output includes the following fields:

Field

Description

Pool name

Pool name.

Size

Size of the pool, in kilobytes.

Limit

Maximum number of buffers that can be allocated to a pool.

InUse

Number of pools in use.

HiWat

Highest number of pools allocated to a task since the MAX TNT was brought up.

HeapAdrs

Memory address of pool.

Following the list of pools, the Pools command displays a summary of memory usage:


total pools: 175
total buffers in use: 10593
total memalloc: 261685
total memfree: 258558
memalloc in use: 3129
memalloc failures: 0
memfree failures: 0
memalloc high water: 3146
Histogram of memalloc'd memory block sizes:
2659 buffers in range [64,127]
632 buffers in range [128,255]
2 buffers in range [256,511]
22 buffers in range [512,1023]
9 buffers in range [1024,2047]
21 buffers in range [2048,4095]
3 buffers in range [4096,8191]
7 buffers in range [8192,16383]
6 buffers in range [32768,65535]
2 buffers in range [131072,262143]
1 buffers in range [262144,524287]
Total memory in use: 1295104 bytes in 3364 buffers
Histogram of free memory block sizes:
12 buffers in range [128,255]
1 buffers in range [256,511]
2 buffers in range [1024,2047]
1 buffers in range [1048576,2097151]
Total free memory: 1503680 bytes in 16 buffers
Following are descriptions of some of the more important fields in this display:

Field

Description

total pools

Total number of pools in use.

total buffers in use

Number of buffers in use.

total memalloc

Total number of times the MAX TNT allocated a block of memory for use.

total memfree

Total number of times the MAX TNT freed a block of memory. This should be fairly close to total memalloc.

memalloc in use

Total number of memory pools in use. This is the difference between total allocated and total freed.

memalloc failures

Total number of times the MAX TNT failed to allocate a block of memory for use.

memfree failures

Total number of times the MAX TNT failed to free a block of memory.

memalloc high water

The highest number of memory pools in use at any one time.

PortInfo

Description: Displays information about the MAX TNT ports.

Usage: portinfo port-number

Example:

PPPdump

Description: Very similar to the WANdisplay diagnostic command. But the PPPdump command strips out escape characters that are present for asynchronous PPP users (who are dialing in with modems). The escape characters are necessary because of the asynchronous nature of the data stream. Stripping them out simply clarifies the presentation of the data.

If you enter the command while traffic through your MAX TNT is heavy, the resulting amount of output can make it tedious to find the information you're looking for. The screen might even display the message ----- data lost -----, which just means that not all the output can be displayed on the screen.

You might prefer to use the PPPdump command during a period of low throughput.

Usage: First open a session with a host card, then enter pppdump n

where n is the number of octets to display per frame. Specifying a value of 0 (zero) disables the logging of this data.

Example: Following are two examples of the display of an asynchronous call, one produced by WANdisplay and the other by PPPdump.

The following frames were logged by entering wandisplay 64:

To get the data stream without escape characters, the 0x7D bytes need to be stripped, and the byte following each 0x7D byte needs to be decremented by 0x20.

With PPP dump, the data is automatically converted and displayed:

See Also: WANdisplay, WANnext, WANopen

PPPFSM

Description: Displays changes to the PPP state machine as PPP users connect. The command is a toggle that alternately enables and disables the debug display.

Usage: First open a session with a host card, then enter pppfsm at the command prompt.

Example: The following display shows the complete establishment of a PPP session:

PPPinfo

Description: Displays information about established PPP sessions. The command has little practical use other than as a tool for developmental engineering.

Usage: pppinfo index [ all ]

Syntax element

Description

index

Selects a particular PPP information table.

all

Displays information about embedded structures.

Example:

PPPstate

Description: Displays the state of a PPP connection. Different PPP calls can be routed (call routing, as opposed to IP or IPX routing) through a MAX TNT differently. The command is a toggle that alternately enables and disables the debug display.

The command has little practical use other than as a tool for developmental engineering.

Usage: Enter pppstate at the command prompt.

Example: The following message indicates that data is moved directly from the WAN to the Ethernet segment. WAN data can be redirected to other resources (X.75 handler or V.120 handler) before it is ready to be sent to the Ethernet segment.

PPP-116: Redirect async wan direct 

PRIdisplay

Description: Display all ISDN PRI D-channel signaling packets that are either received or sent through the PRI interfaces.

Usage: To use this command, first open a session with a network card configured for PRI signaling (for example, a T1 or E1 card). Then enter the PRIdisplay command. The command uses the following syntax:

pridisplay number-of-octets-to-display line 

Syntax element

Description

number-of-octets-to-display

Specifies the number of octets in the PRI messages to display. Specify 0 (zero) to disable the display.

line

The PRI line to display. Specify 0 (zero) to display any line.

Example:

RADacct

Description: Displays RADIUS accounting information. The RADacct command displays very few messages if RADIUS Accounting is functioning correctly.(RADif displays more detailed information for troubleshooting RADIUS-related issues.) The RADacct command is a toggle that alternately enables and disables the debug display.

Usage: Enter radacct at the command prompt.

Example:

A user hangs up and a stop record is generated.

The following message indicates that there is some load on the network, and the sending of a stop record is delayed. This is not necessarily an indication of a problem.

RADif

Description: Displays RADIUS-related messages. RADif is a powerful diagnostic command, because it displays RADIUS messages the MAX TNT receives as well as messages that it sends. Output from RADif, in conjunction with running your RADIUS daemon in debug mode (using the -x option), gives you virtually all the information you need to clarify issues relating to user authentication.

You can also validate the IP port that you have configured (or think you have configured), and the user name that is being sent by the client.

The command is a toggle that alternately enables and disables the debug display.

Usage: Enter radif at the command prompt.

Example: Following are messages you might see for a successful RADIUS authentication:

The IP address and RADIUS Daemon Authentication port are displayed:

The response is sent back from RADIUS. In this case, the user my_name has passed authentication. Following is a list of the most common responses:

RADIF: _radCallback, authcode = 2
RADIF: Authentication Ack
After, authenticating a user, the RADIUS daemon sends the attributes from the user profile to the MAX TNT. The MAX TNT creates the user's Connection profile from these attributes, and RADif displays them. (See the MAX TNT RADIUS Configuration Guide for a complete list of attribute numbers.)

A RADIUS Accounting Start packet is sent to the RADIUS Accounting Server (using port 1646):

RADservdump

Description: Use this command to verify the configuration you have set in the External-Auth profile.

Usage: Enter radservdump at the command prompt.

This does not display any information related to the configuration of either your RADIUS Authentication server or your RADIUS Accounting server.

Example: For the following example, the MAX TNT has been configured with two RADIUS servers, 1.1.1.1 and 2.2.2.2. The port has not been changed from its default of 1700.

RADsessdump

Description: Displays the state of all RADIUS Accounting sessions.

Usage: Enter radsessdump at the command prompt.

Example:

The RADsessdump command displays the following information:

Column Name:

Description

State

The state of the RADIUS accounting parameters and any accounting requests that have been sent. Values can be:

  • init-Initializing. No RADIUS accounting parameters have been loaded.

  • loadd-RADIUS accounting parameters have been loaded, but an accounting request either hasn't been issued or has failed.

  • start-All RADIUS accounting parameters are loaded. An accounting request has been issued.

  • done- Session over. No accounting request was issued, or the request failed.

  • stop-Session over. An accounting stop request has been issued.

Route

Internal route ID.

SessID

Session ID. This depends on the route ID.

NASPort

Statistics about the call. The first two digits indicate the type of call: 1 indicates a digital call, 2 indicates an analog call. The next two digits indicate the line on which the call was received. The last two digits indicate the channel on which the call was received.

authM

Method of authentication.

evTime

Event time. This is a time stamp.

RADstats

Description: Displays a compilation of RADIUS Authentication and Accounting statistics.

Usage: Enter radstats at the command prompt.

Example:

admin> radstats
RADIUS authen stats:
In the following message, A denotes Authentication. O denotes Other. There were 612 Authentication requests sent and 612 Authentication responses received:

602 were authenticated successfully, and 18 were not:

In the next message, the IP address of the RADIUS server is 1.1.1.1, and the curServerFlag indicates whether or not this RADIUS server is the current authentication server. (You can have several configured RADIUS servers, but only one is current at any one time.) 0 indicates no. 1 indicates yes.

The next message indicates that the MAX TNT sent 1557 Accounting packets and received 1555 responses (ACKs from the Accounting server). Therefore, the unexp value is 2. This is not necessarily an indication of a problem, but might be the result of the MAX TNT timing out a particular session before receiving an ACK from the RADIUS server. Momentary traffic load might cause this condition. The value of bad is the number of packets that were formatted incorrectly by either the MAX TNT or the RADIUS server.

In the next message, note that the Accounting server is different from the Authentication server. The Accounting and Authentication servers do not need to be running on the same host, although they can be.

The next two messages can be used to look for traffic congestion problems or badly formatted Accounting packets. Under typical conditions, you might see a few packets whose acknowledgments fail.

The following message indicates whether any RADIUS requests have been dropped by the MAX TNT. With this particular message, no requests were dropped. 1557 were sent successfully.

The following message indicates whether any session timeouts resulted from failure to receive RADIUS responses. The message also indicates responses that are received by the MAX TNT but do not match any expected responses. The MAX TNT keeps a list of sent requests, and expects a response for each request. In the following message, one response was received from the RADIUS server that did not match any of the requests that the MAX TNT had sent out. This might be caused by a corrupted response packet, or by the MAX TNT timing out the session before the response was received.

The following messages display a summarized list of RADIUS server statistics.

Reset

Description: This command resets the MAX TNT. When you reset the unit, it restarts and all active connections are terminated. All users are logged out and the default security level is reactivated. In addition, any active WAN lines are temporarily shut down due to loss of signaling or framing information. After a reset, the MAX TNT runs POST (power-on self-tests).

Usage: reset

Example: To reset the unit:

See Also: NVRAM

Revision

Description: Displays the serial number of the box.

Usage: Enter revision at the command prompt.

Example: In the following message, 7172461 is the serial number of the MAX TNT.

RoutMgr

Description: Displays information about the routing of incoming calls to either the Ethernet or modem ports. RoutMgr, when used in conjunction with Networki, can show valuable call routing information. If you have problems with users not connecting, and the incoming calls disconnect within one or two seconds of being presented to the MAX TNT, use RoutMgr and Networki to look for possible clues.

The command is a toggle that alternately enables and disables the debug display.

Usage: Enter routmgr at the command prompt.

Example:

There are no port limitations configured in the T1 profile:

The next two messages show that the Bearer Capability in the ISDN setup message for the call indicates that it is a voice call, and that the call is routed to an available modem:

At this point, the call is passed to other MAX TNT functions to continue the connection setup.

Following is output from RoutMgr when a call is cleared.

SAR

Description: Shows packet bus statistics. Packet-bus traffic enters and exits a slot card (and shelf controller) by means of a chip called a SAR.

Usage: sar -option

Where -option is one of the following:

Option

Description

-s

Show SAR errors.

-s -a

Show all statistics.

-s -i shelf slot

Show SAR statistics for the indicated shelf and slot.

-s -m

Show SAR memory partition.

-c

Clear global statistics.

-c -a

Clear all statistics.

-c -i shelf slot

Clear statistics for indicated shelf and slot.

-v shelf slot

Display the SAR virtual circuit table for the specified shelf and slot.

-l

List open channels.

-y

Loop back cell statistics (shelf controller only).

-z

Send loopback cell (shelf controller only).

Example:

In the following example, an administrator checks for SAR errors and finds that there are none.

admin> sar -s
Ver  RxAlrt  RxStop RxRstrt NoRxBuf bsPrErr cmPrErr  busErr NoTxMBx NoRxMBx  s
8 0 0 0 0 0 0 0 0 0 6
In the next example, the administrator displays all the SAR statistics for the system:

admin> sar -s -a
SH/SL Tx TxDone TxNoBuf Rx RxErr RxUnFlow RxOvRun a
1/ 1 8 8 0 5816 0 0 0 0
1/11 736947 736947 0 736473 0 0 0 0
1/16 27637 27637 0 27494 0 0 0 0
1/17 160 160 0 160 0 0 0 0
1/19 174588 174588 0 174588 0 0 0 0
2/21 822669 822669 0 822653 4 0 0 0
3/21 1109332 1109332 0 1109301 5 0 0 0
4/21 145403 145403 0 0 0 0 0 0
5/21 145403 145403 0 0 0 0 0 0
6/21 145403 145403 0 0 0 0 0 0
7/21 145403 145403 0 0 0 0 0 0
8/21 145403 145403 0 0 0 0 0 0
9/21 145403 145403 0 0 0 0 0 0
In the following example, the administrator displays SAR statistics for shelf 1, slot 17 (the master shelf-controller).

admin> sar -s -i 1 17
SH/SL        Tx    TxDone   TxNoBuf        Rx     RxErr  RxUnFlow   
RxOvRun   a
1/17 160 160 0 160 0 0 0 0


SNTP

Description: Displays messages related to the Simple Network Time Protocol (SNTP) functionality of the MAX TNT. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter sntp at the command prompt.

Example: Following are three examples of messages displayed with SNTP enabled.

The MAX TNT accepts time from a configured NTP server. The following message appears if the MAX TNT does not accept a supplied time:

The following message indicates that the MAX TNT accepts the time from a specified NTP server:

Because the stored time is off by more than one second, it is adjusted:

StackLimit

Description: If any MAX TNT function uses all but 128 or fewer of the bytes available for the stack, this command enables a checking routing that logs a warning to the Fatal-History log. The command is a toggle that alternately enables and disables the debug display.

Description: This command will enable a checking routine that will log a warning to the Fatal-History log whenever any MAX TNT function usage gets within 128 bytes from the end of the stack. The command is a toggle that alternately enables and disables the debug display.

Usage: Enter stacklimit at the command prompt.

TDM

Description: Used to set up or query the TDM bus.

Usage: tdm [-option ] [ itemA itemB ] [ connectionId ]

where -option is one of the following:

Option

Description

-a

Allocate by first available. (Used when setting up a TDM connection to test).

-c

Connect channels.

-d

Disconnect a channel.

-f

Allocate a TDM channel by (f)ix-by-slot-item.

-r

Allocate a TDM channel by round robin.

-s

Display TDM manager statistics.

-l

List all connections.

-t

Toggle TDM manager debug output.

-u

Display TDM channel usage statistics.

-?

Display this summary.

The other syntax elements are:

Element

Description

-x number

Set the next TDM channel to check.

itemA

Logical address to connect from.

itemB

Logical address to connect to.

connectionID

ID of connection to disconnect.

Example: Following are some examples of output from the TDM command. (For more information about testing the TDM bus, see Testing packet and TDM traffic.)

admin> tdm -l
--id-- --cstate-- cnt tdm# ---src(A)--- ---dst(B)---
1 connected 8 32 01:02:04/001 01:11:01/001
33 01:02:04/002 01:11:01/002
34 01:02:04/003 01:11:01/003
35 01:02:04/004 01:11:01/004
36 01:02:04/005 01:11:01/005
37 01:02:04/006 01:11:01/006
38 01:02:04/007 01:11:01/007
39 01:02:04/008 01:11:01/008
2 connected 24 40 01:02:06/001 01:11:01/009
41 01:02:06/002 01:11:01/010
42 01:02:06/003 01:11:01/011
43 01:02:06/004 01:11:01/012
.
.
.
admin> tdm -s
Number of total connections: 9
Number of active connections: 9
Number of available channels: 839
Number of used channels: 185
Number of disconnection errors: 0
Number of bad received messages: 0
Number of invalid events: 0
Number of missing connections: 0
Number of bad events: 0
Number of bad states: 0
admin> tdm -u
(non-empty entries ONLY)
timslot nUsed --currSrc--- --currDst---
32 1 01:02:04/001 01:11:01/001
33 1 01:02:04/001 01:11:01/001
34 1 01:02:04/001 01:11:01/001
35 1 01:02:04/001 01:11:01/001
36 1 01:02:04/001 01:11:01/001
37 1 01:02:04/001 01:11:01/001
38 1 01:02:04/001 01:11:01/001
39 1 01:02:04/001 01:11:01/001
40 1 01:02:06/001 01:11:01/009
.
.
.

TDMtst

Description: TDMtst runs on the HDLC card and tests the TDM bus. You can use it to verify communication between HDLC cards. Because the command tests byte-stream communication on the TDM bus, which must use a known time slot, it requires some setup before it can verify TDM traffic. (for more information about testing the TDM bus, see Testing packet and TDM traffic.)

Usage: tdmtst -option

where -option is one of the following:

Option

Description

-o channel physical-address logical-address

Open a TDM channel between the physical address and the logical address.

-c channel

Close the TDM channel.

-e channel count size

Send packets across the TDM bus on the open channel.

-b channel count size

Send packets across the TDM bus on the open channel.

-x channel string

Send the specified string over the TDM channel.

-s

Display the TDM test statistics.

-t

Toggle debug level.

TelnetDebug

Description: Displays messages as Telnet connections are attempted or established. The Telnet protocol negotiates several options as sessions are established, and TelnetDebug displays the Telnet option negotiations.

The command is a toggle that alternately enables and disables the debug display.

Usage: Enter telnetdebug at the command prompt.

Example: The following session shows a successful Telnet connection from the MAX TNT terminal server to another UNIX host.

The far-end UNIX host has been contacted:

For this Telnet session, the MAX TNT will support options 24 and 1. The UNIX host should respond with either DO or WONT:

The UNIX host will support option 1:

The MAX TNT receives a request to support option 3:

The MAX TNT will support option 3:

The UNIX host will support option 3:

The UNIX host will not support option 24:

The MAX TNT will not support option 24:

The UNIX host will support options 1 and 3:

TNTCall

Description: Places or clears a call. This command does not work for Frame Relay connections.

Usage: tntcall [-t] [-c connection-profile] [-h route-ID] [?]

Option

Description

-t

Toggle debug level.

-c connection-profile

Place a call with the specified Connection profile.

-h route-ID

Clear the channel associated with the specified route ID.

-?

Display this summary.

Example: The following output shows the MAX TNT answering an incoming call.

A call comes into the MAX TNT:

The call is assigned to a device (in this case the HDLC channel in shelf 1, slot 16, Munich chip 4, channel 26), and is assigned a unique session ID:

The TDM connection is set up for the call:

The call is successfully established:

After the session is disconnected or timed out, the MAX TNT begins tearing down the call:

TNTMP

Description: Displays information about MP and MP+ bundles and their channels. You can execute the TNTMP command on the shelf controller or on an HDLC card. You must first execute the Open command to open a session with the card.

Usage: tntmp -i

Example: To display information about MP and MP+ bundles and their channels:

admin> tntmp -i
mpBundleID=13 masterSlot=1/15 masterMpID=2 ifCount=2 rtIf=1/17:6
routeID slot ifNum localIfNum localMpID
32 1/15 1 1 2
33 9/ 2 193 1 2
This command works on HDLC cards as well. First, open a session with HDLC card, and then execute the TNTMP command. For example:

admin> open 1 15
hdlc-1/15> tntmp -i
mpBundleID=13 masterSlot=1/15 masterMpID=2 ifCount=2 rtIf=1/17:6
routeID slot ifNum localIfNum localMpID
32 1/15 1 1 2
33 9/ 2 193 1 2
In this example, the output shows a two-channel MP or MP+ bundle with the first channel in slot 1/15 and the second (slave) channel in slot 9/2. The command displays the following information:

Field

Description

mpBundleID
The globally known bundle ID for the whole system. If the connection adds channels for additional bandwidth on demand, the call for those channels is compared to the current bundle and assigned the same bundle ID as the other channels of the call.

masterSlot
The channel that was established as the base channel of the connection. After the MAX TNT authenticates a call that is not part of an existing bundle, it establishes the base channel of the connection. That channel becomes the master of the multilink connection.

masterMpID 
The bundle ID at the master slot card. (The masterMpID is always the same as the localMpID for channels on the master slot card.)

ifCount
The number of channels in the bundle.

rtIf 
The shelf/slot:id for the Route Logical Interface.

routeID 
The globally known ID for each call.

slot
The shelf/slot numbers of the channels in the MP or MP+ bundle.

ifnum
Channel number on the master slot card.

localIfNum 
The channel number on the local slot card. For HDLC cards, the channels are numbered 1-192. In the output in the example, the master slot (1/15) shows channel number 1. The interface number for the slave slot (9/2) is also 1, meaning the first channel on that card. However, at the master slot card, the slave interface number is mapped to a pseudo-interface number greater than 192, so it is not confused with channels on the master slot.

localMpID
The bundle ID known locally to the slot card.

TSshow

Description: Displays uptime and revision information about the MAX TNT. The Uptime command and the Software-Version parameter display the same information.

Usage: tsshow [ ? ] [ uptime ] [ revision ]

Syntax element:

Description:

?

List all options.

uptime

Display system uptime.

revision

Display software and version currently running.

Example: Following are some samples of TSshow output:

admin> tsshow
Show what? Type 'tsshow ?' for help.
admin> tsshow ?
tsshow ? Display help information
tsshow uptime Display system uptime.
tsshow revision Display system revision.
admin> tsshow uptime
system uptime: up 36 days, 9 hours, 59 minutes, 27 seconds
admin> tsshow revision
system revision: tntsr 2.0.0

TunnelDebug

Description: Displays messages related to setting up Generic Routing Encapsulation (GRE) tunnels on the MAX TNT. The command is a toggle that alternately enables and disables the debug display.You would normally use this command with the ATMPdebug command.

Usage: tunneldebug

Example: The following example shows an ATMP tunnel being set up:

TUNNELTNT.CB[1/7]: Event=Start-Tunnel SN=80
TUNNELTNT[1/7]: DUMP [Start-Tunnel] SN=80 MC=1/17/24/10052400
HN=[] priHA=[200.67.1.254] secHA=[] Udp=5150 pass=[ascend]
IP=141.111.40.55 Mask=255.255.255.255 IPX=00000000:000000000000
TUNNEL: createFAsession: priHA=[200.67.1.254] secHA=[] udpPort=5150
ifNum=1/17/24/10052400 MajDev=7 password=ascend
mcIpAddr=141.111.40.55/32
TUNNEL-411: Alloc 1019F660 Id=411 TN=411
TUNNEL-411: resolving 200.67.1.254, port=5150, SN=411
TUNNEL-START: In progress
TUNNELTNT[1/7]: DUMP [Start-Tunnel-Rsp] SN=411 MC=1/7/4/10059440
LocalSN=80 GlobalSN=411 Status=In progress
TUNNEL: _dnsCallback: name=[200.67.1.254], ip=200.67.1.254 DNS=411
TUNNEL-411: tunnelSetStatus: status=Good completion
TUNNELTNT[1/7]: DUMP [Update-Tunnel] SN=411
TunnelNumber=405 mcRtIf=1/7/4/10059440 HomeRtIf=0/0/0/0
HomeAgent=200.67.1.254:5150 HomeNetwork=[] Flags=10 AgentMode=2
IP=141.111.40.55 Mask=255.255.255.255 IPX=00000000:000000000000
TUNNELTNT[1/7]: DUMP [Set-Status] SN=411 ErrorCode=0
TUNNELTNT[1/7]: DUMP [Start-Tunnel-Rsp] SN=411 MC=1/7/4/10059440
LocalSN=80 GlobalSN=411 Status=In progress

TunnelSlot

Description: The command has little practical use other than as a tool for developmental engineering.

Update

Description: Modifies optional functionality of the MAX TNT. To enable some options, you must obtain a set of hash codes (supplied by an Ascend representative) that will enable the functionality in your MAX TNT. After each string is entered, the word complete appears, indicating that the MAX TNT accepted the hash code.

If you enter update without a text string modifier, the MAX TNT displays a list of current configuration information.

Usage: update [ text_string ]

Example:

admin> update 5 1023 12321312312312321
The following two messages indicate that the text strings were entered incorrectly:

The following message indicates that the MAX TNT accepted the update string:

WANdisplay

Description: Displays all packets received from, or sent to any of the WAN interfaces. Because WANdisplay output shows what the MAX TNT is receiving from and sending to the remote device, the information can be very helpful in resolving PPP negotiation problems.

If you enter the command while traffic through your MAX TNT is heavy, the resulting amount of output can make it tedious to find the information you're looking for. The screen might even display the message ----- data lost -----, which just means that not all the output can be displayed on the screen.

Depending on the types of information you need to gather, you might prefer to use the WANdisplay command during a period of low throughput, or to use WANdsess, WANopen or WANnext to focus the display and .

Usage: wandisplay number-of-octets-to-display

Enter wandisplay 0 to disable the logging of this information.

Example: Following are several examples of WANdisplay output. Note that the bytes are displayed in hexadecimal format.

WANdsess

Description: Shows WAN data as it is received and transmitted for a particular user. The WANdsess command is very similar to the WANdisplay command, but when you use WANdsess, the MAX TNT displays only incoming and outgoing packets for a specific user. WANdsess is particularly helpful on a MAX TNT with several simultaneous active connections. The command acts as a filter, allowing you to focus your troubleshooting.

Use the WANdsess command with host cards only. You must first execute the Open command to open a session with the modem or HDLC card.

Usage: wandsess session-name octets

Syntax element

Description

session-name 
Name of a local Connection profile or a RADIUS user profile.

octets 
Maximum number of octets to display per packet. If you specify 0 (zero), the MAX TNT does not display any data.

Example: To open a session with a modem card, and activate the display of WAN data for Tim's sessions:

admin> open 1 7
modem-1/7> wandsess tim
RECV-tim:300:: 1 octets @ 3E13403C
[0000]: 7E 21 45 00 00 3E 15 00 00 00 20 7D 31 C2 D2
RECV-tim:300:: 15 octets @ 3E133A24
[0000]: D0 7D B3 7D B1 B3 D0 7D B3 90 02 04 03 00 35
XMIT-tim:300:: 84 octets @ 3E12D28C
[0000]: 7E 21 45 00 00 4E C4 63 00 00 1C 7D 31 17 5F D0
[0010]: 93 90 02 D0 93 91 B3 00
Note that the bytes are displayed in hexadecimal format.

See Also: WANdisplay, WANopening

WanEventsStats

Description: Displays statistics about WAN events of interest on a host card.

Usage: First, open a session to a host card, then enter waneventstats at the command prompt.

Example:

In this output, the following counters should always be set to zero (a non-zero value indicates an error condition):

The rest of the counters can have non-zero values, although most of them indicate how busy the system is and should have small values. For example, the following counters record high-priority message caching events:

The next counters record send message requests. These are the only counters that record normal events rather than errors. The first _wanSendDataOk counter represents the count of all HDLC packets sent out, which may be quite a large number. The other two counters represent the two types of HDLC data, normal and high priority. Their sum should equal the value of _wanSendDataOk in the absence of errors. For example:

The next counter records dropped normal priority messages. A non-zero value indicates the number of normal messages dropped due to lack of a buffer. To some extent this indicates how busy the system is, but because sessions have a buffer quota, it is possible to drop a normal message and increment this counter even when the system is not overloaded and when it is not out of buffers.

The next counter reports requests to send a packet being processed after the session has been terminated. This is a normal occurrence when a call terminates during data transfer. (Its value should normally be relatively small but not necessarily non-zero.)

The following counters record the system's inability to obtain a DRAM or HDLC buffer for high priority message caching:

The following counter records high priority messages that have been dropped from the cache due to the arrival of another high priority message for the same session:

WANopening

Description: Shows WAN data as it is received and transmitted during connection establishment for all users. The WANopening command is particularly helpful for troubleshooting connection problems in which users make the initial connection, but are disconnected within a few seconds. The output of WANopening is very similar to the output of WANdisplay, but WANopening only shows packets until the connection has been completely negotiated.

Use the WANopening command with host cards only. You must first execute the Open command to open a session with the modem or HDLC card.

Usage: wanopening octets

The octets value specifies the maximum number of octets to display per packet. If you specify 0 (zero), the MAX TNT does not log WAN data

Example: To open a session with a modem card, and activate the display of WAN data received and transmitted during connection establishment:

admin> open 1 7
modem-1/7> wanopening
Display the first 24 bytes of WAN messages
RECV-272:: 1 octets @ 5E138F74
[0000]: 0D
RECV-272:: 13 octets @ 5E13958C
[0000]: 0A 41 63 63 65 70 74 3A 20 69 6D 61 67
XMIT-276:: 1011 octets @ 2E12D8A4
[0000]: 7E 21 45 00 03 EE 54 2B 40 00 37 06 BA 09 CF 2B
[0010]: 00 86 D0 93 91 90 1A 0A
Note that the bytes are displayed in hexadecimal format.

See Also: WANdisplay, WANdsess

WANtoggle

Description: Displays messages from the WAN drivers on the MAX TNT, including the states of calls that are passed from the MAX TNT call routing routines as the connection is prepared to be passed to the Ethernet drivers.

If you enter the command while traffic through your MAX TNT is heavy, the resulting amount of output can make it tedious to find the information you're looking for. The screen might even display the message ----- data lost -----, which just means that not all the output can be displayed on the screen. You might prefer to use this command during a period of low throughput.

The command is a toggle that alternately enables and disables the debug display.

Usage: Enter wantoggle at the command prompt.

Example: Following is a typical example of output produced by a modem call into the MAX TNT. After the incoming call is determined to be an analog call, a modem is directed to answer it.

The next two messages appear when the call is cleared.

The last message is not an indication of a problem. The modem clears the call a split second before the software releases its resources. The software does a check on the modem, which has already been released. This message is not an indication of a problem.



[Top][Contents][Prev][Next][Last]Search

techpubs@eng.ascend.com

Copyright © 1997, Ascend Communications, Inc. All rights reserved.