Richard G Baldwin (512) 223-4758, NRG Room 4238, Baldwin@DickBaldwin.com, http://www.austincc.edu/baldwin/

ITNW 1351 Fundamentals of Wireless LANs

Lab Project # 13

Network Log Files

Revised:  August 26, 2005
By Richard G. Baldwin

File:  FwlProj0zz.htm


Preface

This laboratory project was prepared specifically for the benefit of my students who are enrolled in ITNW 1351, Fundamentals of Wireless LANs.

The project was designed under the assumption that students enrolled in the course have successfully completed the prerequisite course, ITNW 1325, Fundamentals of Networking Technologies.

The project design also assumes that the students are actively studying the material in the prescribed textbook for this course, which explains such complex topics as the IEEE 802.11g wireless specification.

Another browser window

I recommend that you open another copy of this document in a separate browser window so that you can easily view the discussion and the figures at the same time.

Purpose of Project

The purpose of this project is fairly limited in scope.  The purpose is to show you how to capture log files containing information that can be used for troubleshooting wireless network problems.

However, the project does not show you how to interpret the contents of the log files to actually perform troubleshooting activities.

Equipment Requirements

The following equipment is required to complete this laboratory project:

Background Information

Getting help from Microsoft

This project is partially based on the Microsoft TechNet article entitled How to gather information to troubleshoot a wireless connectivity problem in Windows XP.

The text of the article begins as follows:

"This article describes how to collect information to troubleshoot a wireless connectivity problem on your Microsoft Windows XP-based computer. This information is required when you contact Microsoft Product Support Services (PSS) for help troubleshooting a wireless connectivity problem."

Required log files

The article describes a great deal of information that you will need to have available when you contact Microsoft for assistance.  Included in that information is the following set of log files:

Creating the log files

Those log files describe network activity.  This project will show you how to create those log files.

Interpreting the log files

These are plain text files, but their format is far from simple.  However, with some extra effort and research on your part, you could probably learn how to interpret the log files yourself and use them in your network troubleshooting efforts.

Discussion

Using Netsh

According to the Windows XP help system,

"Netsh is a command-line scripting utility that allows you to, either locally or remotely, display or modify the network configuration of a computer that is currently running."

The XP help system goes on further to say,

"To run a netsh command, you must start netsh from the Cmd.exe prompt and change to the context that contains the command you want to use. The contexts that are available to you depend on which networking components you have installed."

The RAS context and the set tracing command

In this case, we are interested in the remote access servers (RAS) context.  This context supports about two dozen commands, one of which is set tracing.  A description of the set tracing command, taken from the XP help system, is provided in Figure 1.

set tracing

Enables or disables tracing for the specified 
 component.

Syntax
set tracing Component {enabled | disabled}

Parameters
Component 
  Required. Specifies the component for which you
   want to enable or disable tracing. Use * to
   specify all components. 
{enabled | disabled} 
  Required. Specifies whether to enable or 
   disable tracing for the specified component. 

Remarks
  To see a list of all installed components, use
   the show tracing command without parameters. 

Examples
  To set tracing for the PPP component, type:
    set tracing ppp enabled

Figure 1

Components in the RAS context

Figure 2 shows a list of all installed components on my machine obtained by executing the command shown in the first line of Figure 2.

C:\jnk>netsh ras show tracing
XMLProvI                                 disabled
WZCTrace                                 disabled
WZCDLG                                   disabled
Wlpolicy                                 disabled
wavemsp                                  disabled
termmgr                                  disabled
tapisrv                                  disabled
tapi32                                   disabled
tapi3                                    disabled
RASTLS                                   disabled
RASTAPI                                  disabled
RASSPAP                                  disabled
RASPAP                                   disabled
RASMAN                                   disabled
RASIPHLP                                 disabled
RASIPCP                                  disabled
RASEAP                                   disabled
RASDLG                                   disabled
RASCHAP                                  disabled
RASCCP                                   disabled
RASBACP                                  disabled
RASAUTO                                  disabled
RASAPI32                                 disabled
PPP                                      disabled
NETSHELL                                 disabled
NETMAN                                   disabled
NDPTSP                                   disabled
KMDDSP                                   disabled
IPNATHLP                                 disabled
IASRECST                                 disabled
h323msp                                  disabled
FWCFG                                    disabled
EAPOL                                    disabled
conftsp                                  disabled
confmsp                                  disabled
BAP                                      disabled

Figure 2

The components highlighted in boldface in Figure 2 match the seven log files identified in the earlier list from Microsoft.

How to enable logging

There are two different ways to enable logging on those seven components.  One way is to execute the command shown in Figure 3 at a command prompt.

C:\jnk>netsh ras set tracing * enabled

Figure 3

Execution of this command will enable logging on all of the components listed in Figure 2, most of which are not needed for network troubleshooting.

A more selective approach

The second way is to execute the seven individual commands shown in Figure 4 at the command prompt.

C:\jnk>netsh ras set tracing wzctrace enabled
C:\jnk>netsh ras set tracing eapol enabled
C:\jnk>netsh ras set tracing rastls enabled
C:\jnk>netsh ras set tracing wzcdlg enabled
C:\jnk>netsh ras set tracing xmlprovi enabled
C:\jnk>netsh ras set tracing netman enabled
C:\jnk>netsh ras set tracing netshell enabled

Figure 4

Execution of those seven commands will enable logging on those seven components only.

Don't forget to disable logging and delete the log files

The log files that are created can become quite large and can consume quite a lot of disk space.  Therefore, you should always remember to disable logging when it is no longer necessary.

Regardless of which approach you use to enable logging, the easiest way to disable logging is to execute the command shown in Figure 5 at the command prompt.  This will disable logging on all components in the RAS context for which logging is currently enabled.

C:\jnk>netsh ras set tracing * disabled

Figure 5

Also, once you are finished with the log files, as far as I can tell, there is no harm in deleting them.

Where are the log files?

Microsoft describes the location of the log files as the %windir%\Tracing folder.  On my machine, that turns out to be the C:\WINDOWS\tracing folder.

What you will do

In this project, you will configure and start two Linksys routers running on different channels with different SSIDs.

Then you will enable logging on the wzctrace and wzcdlg components.

A series of network operations

After that, you will go through a series of operations that involve removing and applying power to the routers as well as switching your wireles connection back and forth between the two routers to generate network activity.

Disable logging, examine log files, and delete them

Then you will disable logging and examine the contents of the two log files to get a feel for the types of information that they contain.

Finally, you will delete the two log files.

Project Instructions

Configure two access points

Using what you learned in the project entitled Automatic Switching Among Access Points, set up a wireless network router with the following configuration:

Then, also using what you learned in the project entitled Automatic Switching Among Access Points, set up a second wireless network router with the following configuration:

Enable logging on two components

Obtain a command line window and execute the two commands shown in Figure 6.

C:\jnk>netsh ras set tracing wzctrace enabled
C:\jnk>netsh ras set tracing wzcdlg enabled

Figure 6

(Note, the commands in Figure 6 assume that your current directory is c:\jnk.)

Check on the log files

Go to the folder at C:\WINDOWS\tracing and confirm that the following two files have been created there:

Create network activity

Now plug and unplug the power to the routers a few times to create some network activity.

Using the Wireless Network Connection dialog, manually switch your connection back and forth between the two routers a few times to create a different kind of network activity.

Disable logging

Execute the command shown in Figure 5 at the command prompt to disable logging.

Examine the log files

Double click on each of the log files.  That will cause the log files to be opened in Notepad.  For example, Figure 7 shows a partial screen shot of the text contained in one of the log files.



Figure 7

Does it make any sense?

See if you can identify anything in either of the log files that correlates with the network activity caused by applying and removing power and by switching the connection back and forth between the two networks.  For example, it might be useful to search for SSID in the Notepad display.

Delete the log files

Delete the two log files to prevent them from wasting space on your hard drive.

Learn how to interpret the log files

Search the web in an attempt to find articles that explain how to interpret the information contained in the log files.


Copyright 2005, Richard G. Baldwin.  Reproduction in whole or in part in any form or medium without express written permission from Richard Baldwin is prohibited.

About the author

Richard Baldwin is a college professor (at Austin Community College in Austin, TX) and private consultant whose primary focus is a combination of Java, C#, and XML. In addition to the many platform and/or language independent benefits of Java and C# applications, he believes that a combination of Java, C#, and XML will become the primary driving force in the delivery of structured information on the Web.

Richard has participated in numerous consulting projects and he frequently provides onsite training at the high-tech companies located in and around Austin, Texas.  He is the author of Baldwin's Programming Tutorials, which have gained a worldwide following among experienced and aspiring programmers. He has also published articles in JavaPro magazine.

In addition to his programming expertise, Richard has many years of practical experience in Digital Signal Processing (DSP).  His first job after he earned his Bachelor's degree was doing DSP in the Seismic Research Department of Texas Instruments.  (TI is still a world leader in DSP.)  In the following years, he applied his programming and DSP expertise to other interesting areas including sonar and underwater acoustics.

Richard holds an MSEE degree from Southern Methodist University and has many years of experience in the application of computer technology to real-world problems.

Baldwin@DickBaldwin.com

-end-