Enable Debug Logging for NOVEAP.DLL (802.1x Wireless)

  • 7005241
  • 27-Jan-2010
  • 26-Apr-2012

Environment

Novell Client 2 SP1 for Windows
Windows 7 (x86 or x64) (Ultimate Edition, Enterprise Edition, or Professional Edition)
Windows Vista (x86 or x64) (Ultimate Edition, Enterprise Edition, or Business Edition)
Windows Server 2008 R2 (x64) (Enterprise Edition, or Standard Edition)
Windows Server 2008 (x86 or x64) (Enterprise Edition, or Standard Edition)

Situation

Novell Technical Services may request a debug log to examine activity relating to the 802.1x authentication functionality included in the Novell Client 2 SP1 for Windows. This document specifies the registry settings controlling the creation of such a debug log file.

Resolution

The consolidated logging mechanism is activated by creating the following Windows registry key and value:

[HKEY_LOCAL_MACHINE\Software\Novell\NOVEAP]
"DebugLogDebugLevel"=dword:00000001

Any value for DebugLogDebugLevel other than zero will cause logging to occur.


The size of the debug log file is controlled by the following registry key and value:

[HKEY_LOCAL_MACHINE\Software\Novell\NOVEAP]
"DebugLogMaxFileSize"=dword:00000000

The DebugLogMaxFileSize value specifies in KB how large the debug log file will be allowed to grow.  If the debug log file reaches the size specified in KB in DebugLogMaxFileSize, the file will be deleted and logging will continue but with all prior log content deleted.  Not having a DebugLogMaxFileSize value defined or having the value set to 0 allows the log file to grow indefinitely (the default setting).

For example, to allow for a log file up to 100MB, set DebugLogMaxFileSize to 102400. To allow for a log file up to 10MB, set DebugLogMaxFileSize to 10240.

Location of debug files:
Windows 7/Vista/2008: The log files will be named "NOVEAP-<session>-<processname>-DEBUG.LOG" or NOVEAP-<servicename>-DEBUG.LOG", and will be located in the "%ProgramData%\Novell\Client\Log\" directory. By default, this directory is hidden.
Windows XP: The log files will be named "NOVEAP-<session>-<processname>-DEBUG.LOG" or NOVEAP-<servicename>-DEBUG.LOG", and will be located in the "%SystemRoot%\Debug\UserMode\" directory.

Additional Information

This configuration applies to the Novell Client 2 SP1 for Windows and later. Earlier versions used different registry settings to enable debugging.

For the Novell Client for Windows XP/2003 4.91 SP4/SP5:

For builds of NOVEAP.DLL dated 08Feb2010 or later (first released in 491PSP5_NOVEAP.ZIP, for use on Windows XP SP3 only), use the above configuration.

For builds of NOVEAP.DLL dated earlier than 08Feb2010, enable NOVEAP tracing by creating the following registry key and value:

[HKEY_LOCAL_MACHINE\Software\Microsoft\Tracing\NOVEAP]
"EnableFileTracing"=dword:00000001

Disable logging by setting the "EnableFileTracing" value to 00000000, or by removing the "EnableFileTracing" value entirely.

The log file will be created as C:\Windows\Tracing\NOVEAP.LOG.