******************************************************************************* * W A N S T A T * * LAN/WAN Statistics Logger * * * * Version: 1.20b * * http://www.officenet.hu/utils/wanstat * ******************************************************************************* Member of Winners Circle at Novell Developers' Contest, 1st round: A strong and secure SMTP/POP3 implementation, a unique Pegasus Mail Gateway and a powerful list server: these are the key features of Niagara Mail Server. Consider also the easy management through NetWare Administrator and the built-in Anti-SPAM capability, making this smart mailer a perfect choice for your network. Detailed product description and a downloadable evaluation version can be found on our web page: http://www.officenet.hu/niagara ******************************************************************************* Contents -------- 1. Installation 2. Usage guidelines 3. Log file format 4. Copyright and licensing information 5. Registering your copy 6. Technical support 7. Contacting us 8. History 1. Installation --------------- Pkunzip the compressed original distribution archive file, and copy the WANSTAT.NLM into sys:system directory on your destination server. Server needs to be NetWare 4.11 or any newer version. Bindery emulation is not required nor used. 2. Usage guidelines ------------------- First, load WANSTAT in the board listing mode: LOAD WANSTAT WANSTAT will display a list of available LAN/WAN boards, with a board number at the beginning of every line in the list. Decide what boards you want to include in the log, and invoke WANSTAT in the logging mode: LOAD WANSTAT [UTC] [DBF] [TXT] [DISPLAY] [30M|60M|3H|6H|12H|24H] brdnums ... Parameters: - UTC forces the timestamp values in the log file to be expressed in UTC instead of local time. - DBF turns on logging in xBASE (*.dbf) file format - TXT turns on logging in plain text (*.txt) file format - DISPLAY turns on logging to the console screen - 30M causes logging to happen at every 30 minutes (default setting) - 60M causes logging to happen at every hour - 3H causes logging to happen at every 3 hours - 6H causes logging to happen at every 6 hours - 12H causes logging to happen at every 12 hours - 24H causes logging to happen at every day - brdnums ... are the board number values determined from the first step. LOAD WANSTAT HELP Will display the parameter list and explanation above, then unload itself. Example: LOAD WANSTAT DBF DISPLAY 3H 1 3 4 WANstat will be logging traffic for board numbers 1, 3 and 4 in DBF format at every 3 hours. Log files are stored in the sys:etc/wanstat directory, which will be created automatically if does not exists. Log file update will be occuring when: - loading WANSTAT in logging mode, the line will be ended with a "(starting)" remark; - unloading WANSTAT, loaded previously in logging mode, the line will be ended with a "(shutdown)" remark; - the specified interval elapses. --- Important note --- WANstat uses several new functions which may not be available in the original out-of-the box NetWare product. You have to apply the latest support pack on your server, or WANstat may refuse to load with undefined public symbol errors. Also, loading CLIBAUX.NLM prior to loading WANstat may be required, especially on NetWare 4.x versions. Novell does not recommend autoloading this NLM for 3rd party developers, that's why you are required to load it manually. You can do so from AUTOEXEC.NCF, as other applications may also require this NLM to be loaded. CLIBAUX.NLM is included with the latest support packs, or it is available as a separate download (CLIBAUX1.EXE) from Novell's ftp site. 3. Log file format ------------------ Here is a sample log file from our test server: NW411_EII: Tx 4429 kB, Rx 1378 kB at 13/09/1997 05:48:57 (starting) NW411_EII: Tx 4444 kB, Rx 1384 kB at 13/09/1997 06:00:01 NW411_EII: Tx 5579 kB, Rx 1832 kB at 13/09/1997 06:30:01 NW411_EII: Tx 18754 kB, Rx 2526 kB at 13/09/1997 07:00:00 NW411_EII: Tx 18867 kB, Rx 2560 kB at 13/09/1997 07:30:01 NW411_EII: Tx 18877 kB, Rx 2560 kB at 13/09/1997 08:00:00 NW411_EII: Tx 18898 kB, Rx 2572 kB at 13/09/1997 08:13:51 (shutdown) - NW411_EII is the name of the board, as shown in Monitor under LAN/WAN information; - the value following Tx means Total bytes sent; - the value following Rx means Total bytes received; - the time is expressed in local time (UTC was not specified), or in UTC (UTC was specified). If you load WANstat with the DBF parameter, the log files will be created as xBASE (*.DBF) files using the following structure: Field Type Length Decimals Remarks ___________________________________________________________________ INTERFACE Char 18 DATE Date TIME Char 8 hh:mm:ss EVENT Char 1 L=load, T=timer, S=shutdown RECEIVED Num 18 0 SENT Num 18 0 4. Copyright and licensing information -------------------------------------- This version of WanStat is freeware. You can use the software on any number of servers. You can also give the software to other people in it's original distribution form, with every component in the original compressed archive. 5. Registering your copy ------------------------ If you have downloaded WANstat from our web site, you are already registered. Otherwise, we kindly ask you to write an e-mail to "WANSTAT Registration" . Please include the following informations: Name: ................................................ Company: ................................................ Country: ................................................ Email address: ................................................ Product: LAN/WAN Statistics Logger v1.20b Comments: ................................................ ................................................ Note: your data will be held protected, and will not be given out to anyone. We also hate spam, like you. 6. Technical support -------------------- Limited support is available only for registered users, via e-mail. We always try to offer excellent technical support for our products. Reported issues are being investigated and discovered bugs are corrected as necessary. However, in case of freeware utilities like WANstat, we can't even guarantee that you will receive a response from us. See the following section on how to contact us. 7. Contacting us ---------------- Company: Office-Net Kkt. Address: Futar u. 17. H-1131 Budapest Hungary Phone: +36-30-951-2479 Fax: +36-30-980-2479 Email: support@officenet.hu Web: http://www.officenet.hu Please use the email address shown above for your technical support questions. 8. History ---------- 9th Mar 2000 v1.20b Minor bugs fixed Clarified CLIBAUX requirement in this readme.txt 27th Dec 1999 v1.20 NetWare 5.1 Ready Login name no longer required Bindery emulation no longer required xBase and TXT log file formats made optional logging interval can be selected from 30 mins to 24 hours 24th Nov 1998 v1.10 Added optional xBASE (*.DBF) log file format Displaying on the server console made optional No longer works on NetWare 3.x 21st Jan 1998 v1.01 Split into 3.x/4.x versions because of Clib differences 27th Nov 1997 v1.0 Initial release ------------------------------------------------------------------------------ Last updated on 9th March 2000 Copyright (c) CamaSoftware 1997-2000 Portions Copyright (c) Office-Net Kkt. 1997-2000 All Rights Reserved