Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP Auto Port Aggregation Administrator's Guide: HP-UX 11.0, 11i v1, 11i v2 > Chapter 6 Troubleshooting HP APA

nettl Tracing and Logging Tool

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

The nettl command captures network events and packets. The logging portion captures state changes, errors, and connection establishment. The tracing portion capture inbound and outbound packets going through the network and loopback and header information. Log messages are written to the /var/adm/nettl.LOG000 file. To format and view the contents of this file, enter the following command:

# netfmt -v -f /var/adm/nettl.LOG000 | more

Look for Error and Disaster messages.

APA also supports the logging of status messages to the syslog.log file. See “Logging Messages to the syslog.log File” for information on enabling this feature.

You can access the logging and tracing utility using either the graphical user interface (GUI) version or the command line interface. The GUI version does the following:

  • Guides you through logging and tracing tasks.

  • Enables you to create and format reports.

  • Collects logging and tracing information specific to a subsystem.

  • Displays report screens that are updated instantaneously with current logging and tracing information by the subsystem.

  • Provides context-sensitive on-line help.

To access the GUI version of the logging and tracing utility, enter the following command:

nettladm

There are three levels of logging:

  • At link aggregate level

  • At Cisco's FEC level

  • At IEEE 802.3ad LACP level

The following examples show how to perform different tasks from the command line:

  • To turn on all logging at link aggregate level, enter:

    nettl -log 0xf -e HP_APA

  • To turn on all logging at Cisco's FEC level, enter:

    nettl -log 0xf -e HP_APAPORT

  • To turn on all logging at IEEE 802.3ad level, enter:

    nettl -log 0xf -e HP_APALACP

  • To examine the log file with cause and action descriptions, enter:

    netfmt -v -f /var/adm/nettl.LOG00 | more

  • To examine just the log messages in the log file, enter:

    netfmt -f /var/adm/nettl.LOG00

  • To check network logging and tracing status, enter:

    nettl -status

  • To start Cisco's FEC tracing to the file /tmp/tracefile.TRC0, enter:

    nettl -traceon all -entity HP_APAPORT -file /tmp/tracefile

  • To stop Cisco's FEC tracing, enter:

    nettl -traceoff all -entity HP_APAPORT

  • To start LACP tracing to the file /tmp/tracefile.TRC0, enter:

    nettl -traceon all -entity HP_APALACP -file /tmp/tracefile

  • To stop LACP tracing, enter:

    nettl -traceoff all -entity HP_APALACP

  • To format the tracefile into the file /tmp/traceout, enter:

    nettl -f /tmp/tracefile.TRC0 > /tmp/traceout

Whenever the TSO status of a link aggregate or failover group changes, a warning message is logged in the nettl.LOG000 file. For example, when the TSO capability is disabled on an aggregate, a WARNING message similar to the following is logged:

----------------------Auto-Port Aggregation/9000 Networking--------------@#%
  Timestamp            : Wed Aug 18 PDT 2004 09:37:56.600031
  Process ID           : [ICS]              Subsystem        : HP_APA
  User ID ( UID )      : -1                 Log Class        : WARNING
  Device ID            : 903                Path ID          : 0
  Connection ID        : 0                  Log Instance     : 0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<3014> HP Auto-Port Aggregation product disabled TCP Segmentation Offload
    capability for link aggregation 903.

When the TSO capability is enabled on an aggregate, an INFORMATIVE message similar to the following is logged:

----------------------Auto-Port Aggregation/9000 Networking--------------@#%
  Timestamp            : Wed Aug 18 PDT 2004 09:37:53.020072
  Process ID           : [ICS]              Subsystem        : HP_APA
  User ID ( UID )      : -1                 Log Class        : INFORMATIVE
  Device ID            : 903                Path ID          : 0
  Connection ID        : 0                  Log Instance     : 0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<4015> HP Auto-Port Aggregation product enabled TCP Segmentation Offload
          capability for link aggregation 903. VMTU = 32160.

For more information on using the command line interface and the GUI version, see nettl(1M) and nettladm(1M), respectively. See netfmt(1M) for information on creating a filter for trace formatting.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2007 Hewlett-Packard Development Company, L.P.