Novell Home

NetMail 3.10 Logging Patch for Windows

Novell Cool Solutions: Feature

Digg This - Slashdot This

Posted: 26 Nov 2003
 

This patch provides the file and the instructions to help administrators setup logging when running NetMail 3.10 on the Windows platform. Please follow the instructions carefully before implementing this patch.

  13 Nov 2003 netmail310log.exe97K NetMail 3.10 Logging Patch for Windows

installation instructions


Place file in empty directory and extract. This should provide a readme file and the syslogd.dll file. Please read the remainder of the installation instructions below.

How to configure Syslog for NetMail 3.1 for Windows

*** Please read these instructions completely before attempting any configuration ***

It is strongly suggested you make a backup of your system, including the Windows registry.

Shutdown NetMail and WebAdmin. Open Services (Start/Settings/Control Pannel/Administrative Tools/Services) and stop NetMail Manager and NetMail Web Administration services.

Copy the 3.10e version of syslogd.dll to the proper location in the bin directory. For a default installation, this location is C:\Program Files\novell\netmail\bin. If you are currently running NetMail 3.10e, skip this step.

Create the syslog key in the Windows registry
Run regedit
Go to My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Novell\
If the syslog key doesn't exist, create it by right-clicking on Novell, then select New/Key and give it the name syslog.

Configure the registry for syslog. The following registry keys are supported:

priority The threshold at which log messages are written to the log file. The format is an integer between 0 and 7.

Each message generated by NetMail has a priority tag. If the message priority tag is less than or equal to value specified in this registry key, the message will be written to the log file.

The message priority tags are:
0 emergency
1 alert
2 critical
3 error
4 warning
5 notice
6 info
7 debug

If priority is not set, a default value of 2 is used.

event threshold The threshold at which messages are written to the Windows Event System. The format is an integer between 0 and 7. The values have the same meaning as described for priority.

If the message has a priority tag that is less than or equal to the value specified in this registry key, the message will be written to the Windows Event System. Messages will show under the Application Log section.

If event threshold is not set, a default value of 3 is used.

path The file system path where log files will be created. The format is a string. Log files are always named with a prefix of syslog.

If path is not set, a default path of c:\{Windows}\system32\drivers\etc will be used. NetMail determines the value for {Windows} by reading the string value SystemRoot from the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion.

max file size The maximum size of the log file in megabytes. When the log file reaches this size, a new log file will be created. The format is an integer greater than zero.

If max file size is not set, a default value of 1 is used.

max files The maximum number of log files allowed. When this limit is reached, NetMail will recycle previously used log files. The format is an integer greater than zero.

If max files is not set, a default value of 1 is used. NetMail supports a maximum of 256 log files.

example

The following example illustrates the behavior of a NetMail system using specific values of the above registry keys:

priority = 7
event threshold = 3
path = C:\netmail_logs
max file size = 4
max files = 10

In this example, NetMail will grow each log file to 4 megabytes in size, and will allow a maximum of 10 log files to be created. The log files will be stored in C:\netmail_logs, and the log files will be named with the prefix syslog. After the tenth log file reaches 4 megabytes in size, the first log file will be truncated and reused. Since priority was set to 7, all log messages generated by NetMail will be written to the log files. Since event threshold was set to 3, only error, critical, alert, and emergency messages will be written to the Windows Event System.

To create the above registry keys, use regedit:

priority
Right-click on the syslog folder icon, select New/String Value.
Enter priority for the string name.
Double click on priority (in right pane) and enter a value depending on the level you desire (0 -- 7 as described above)

event threshold
Right-click on the syslog folder icon, select New/String Value.
Enter event threshold for the string name.
Double click on event threshold (in right pane) and enter a value depending on the level you desire (0 -- 7 as described above)

path
Right-click on syslog folder icon, select New/String Value.
Enter path for the string name.
Double click on path (in right pane) and enter a path name where you want the log file to be stored. Example: C:\netmail_logs.

max file size
Right-click on syslog folder icon, select New/String Value.
Enter max file size for the string name.
Double click on max file size (in right pane) and enter a number representing the maximum file size in megabytes. Example: 10

max files
Right-click on syslog folder icon, select New/String Value.
Enter max files for the string name.
Double click on max files (in right pane) and enter a number for the maximum number of log files. Example: 4

Create the directory as specified by the path registry key, if it does not exist.
Restart NetMail.

NetMail will cache log file information in memory in one megabyte blocks before writing to the log file. After you restart your NetMail system, depending on the value you set for priority, you will see a few log entries written to the log file. No additional log entries will be written until the internal one megabyte cache is full. When NetMail is shut down, any log messages that were cached will be flushed to the log file.

Messages written to the Windows Event System are not cached, so it is possible to use the Windows Event viewer to get a real-time view of critical NetMail events.

TID2967455


Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions. www.webwiseone.com

© 2014 Novell