========================================================================== This is the "readme.txt" file for MONET LAN analyzer LITE V1.5 (dated: 04/Dec/1997). Copyright 1993, 1997 by ABIT Corporation and MG-SOFT Corporation. All rights reserved. Please note that this is the evaluation software product and thus you are eligible to use the software for 30 (thirty) days solely for the evaluation purposes. After that you must either (1) obtain the commercial version of the software or (2) stop using the software and destroy all copies of the software in any form in your possession or under your control. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !! + !! MONET LAN analyzer - for a closer look into your net !! + !! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ========================================================================== Table of contents ----------------- 1. About MONET LAN analyzer LITE 2. Installing MONET LAN analyzer LITE 3. About packet driver 4. Running MONET LAN analyzer LITE 5. Obtaining the Licensed version of MONET LAN analyzer LITE 6. About MONET LAN analyzer (full version) 7. Protocol decoder in DLL module 8. List of supported protocol decoders 9. Related products 10. More information ========================================================================== 1. About MONET LAN analyzer LITE -------------------------------- MONET LAN analyzer LITE has been designed as a powerful debugging utility for the IP networking software developers. You can use it for tracing and capturing the IP protocol network packets and examining their contents, thus you can effectively follow the conversation between client and server software modules that you are developing and are scattered across the network. MONET LAN analyzer LITE is a downsized version of the full version MONET LAN analyzer, tailored to suit the needs of a general TCP/IP software developer. MONET LAN analyzer LITE features -------------------------------- * Runs on PC computes under the DOS operating system. It uses the Packet driver V1.09 network interface. * Program can capture IP, ARP and RARP protocol packets. * Protocol decoder can decode the following protocols: - DLC encapsulation layer, - IP, ARP and RARP layers on top of DLC, - TCP, UDP and ICMP layers on top of IP and - DNS protocol layer on top of UDP. * Everything carried by UDP or TCP layers is decoded as data which permits easy following of the conversation between clients and servers that the user is developing. * Evaluation version of MONET LAN analyzer LITE can keep in memory only a limited number of captured packets while limitations in the registered version will be imposed only by the amount of available RAM. * Registered version can filter network packets, both while capturing as well as in analyzing mode (off-line, when the user analyzes the contents of captured packets). * Registered version can save captured packets to files. * Registered version can generate reports and send them to files or printers. The licensed version of the software is shipped on a floppy. Besides the floppy we ship also the printed manual (172 pages). Registered users are eligible for free support. ========================================================================== 2. Installing MONET LAN analyzer LITE ------------------------------------- To install MONET LAN analyzer LITE, please follow these steps: 1. create a directory for MONET on your HD (e.g. MD \MONET) 2. set \MONET as a current working directory (e.g. CD \MONET) 3. unzip the contents of MONETL15.ZIP file by typing PKUNZIP -d MONETL15.ZIP (please note the -d switch !) =========================== After that you should find the following files on your hard disk: FILE_ID.DIZ - Brief description of the package README.TXT - This file LICENSE.TXT - Licensing agreement ORDERFRM.TXT - Information on ordering MONET LAN analyzer products MONET.EXE - MONET LAN analyzer LITE Version 1.0 MONET.DIR - MONET sub-directory tree definition file SYSTEM\SYSTEM.BIN - Alias definition file SYSTEM\PROTOCOL.PTC - Protocol description file Before running the software, some additional setup is required. Windows 95, Windows 98 ---------------------- If you are going to use MONET LAN analyzer LITE in the DOS prompt of Windows 95, we strongly recommend you to download and install the ndis3pkt virtual packet driver, available from http://www.danlan.com/ If you decide to use the virtual packet driver, you can skip the rest of this section. DOS --- For running in the native DOS environment, please note that MONET LAN analyzer LITE uses XMS memory area for storing captured data from the network, thus HIMEM.SYS (or compatible software) has to be installed. Installation of the HIMEM.SYS driver is done in CONFIG.SYS file. For example: BUFFERS = 30 FILES = 40 DEVICE = C:\DOS\HIMEM.SYS DOS = HIGH Note: "DOS = HIGH" statement in CONFIG.SYS is valid only in DOS V5.00 or higher. If HIMEM.SYS is not installed, MONET LAN analyzer LITE is not going to start-up! For easier navigation through the program, we suggest installing the mouse driver... Please check your DOS handbook to learn more about DOS system configuration. Before executing MONET LAN analyzer LITE you MUST install the packet driver software! Otherwise MONET LAN analyzer LITE won't start-up! Please read the following section for details. ========================================================================== 3. About packet driver ---------------------- Virtual packet driver for Windows 95 and Windows 98 --------------------------------------------------- If you are going to use MONET LAN analyzer LITE in the DOS prompt of Windows 95, we strongly recommend you to download and install the ndis3pkt virtual packet driver (http://www.danlan.com/). If you decide to use the virtual packet driver, you can skip the rest of this section. Packet driver for DOS --------------------- The Packet driver is a TSR driver (Terminate and Stay Resident) and should be installed before running MONET LAN analyzer LITE. The packet driver software for certain type of LAN adapter is usually supplied by the LAN adapter vendor, together with all other supported network drivers (MLID/ODI, NDIS,...). If the packet driver is not supplied together with your LAN adapter, you may download the software from numerous BBS and anonymous FTP or WEB sites. You may also find the packet driver software on many shareware CD releases (Simtel, ...) For the successful installation of the packet driver please refer to the instructions enclosed to the packet driver itself. Anyhow, usually you should specify the software interrupt number (in the range from 0x60 to 0x7F) and the hardware interrupt and I/O port numbers according to your LAN adapter configuration. For example, If you are using the NE2000 compatible LAN adapter configured for the interrupt 12 (0xC) and I/O port 0x300, then the packet driver can be installed by typing: NE2000 0x60 0xC 0x300 on a DOS prompt. In case of successful installation the driver responds with something similar to: > Packet driver for NE2000, version :.4.1 > Packet driver skeleton copyright 1988-92, Crynwr Software. > This program is free software; see the file COPYING for details. > NO WARRANTY; see the file COPYING for details. > > Packet driver is at segment 1D4F > Using 80[123]86 I/O instructions. > Interrupt number 0xC (12) > I/O port 0x300 (768) Thus, if you have a LAN adapter supported by the packet driver, you should be able to run MONET LAN analyzer LITE. Please be aware that some packet drivers behave very well while others tend to crash... We have successfully tested MONET LAN analyzer LITE software on NE2000 compatible network adapters with NE2000 packet driver in the most critical conditions (heavy network traffic). ========================================================================== 4. Running MONET LAN analyzer LITE ---------------------------------- If you have followed installation instructions given in section 2. of this readme.txt file and if you have installed packet driver software as described in section 3 of this readme.txt file, you can execute MONET LAN analyzer LITE by simply typing MONET or MONET m on the DOS prompt. The latter will start monitoring immediately, without displaying the 'About' window. ========================================================================== 5. Obtaining the Licensed version of MONET LAN analyzer LITE ------------------------------------------------------------ Please check the ORDERFRM.TXT file for the ordering information. We offer 3 different licensed versions of MONET LAN analyzer LITE: * MONET SNMP analyzer (adds SNMP and SNMPTRAP protocol decoders). * MONET LAN analyzer LITE/LLC (adds 802.2 LLC and SNAP packet capturing and protocol decoding abilities). * MONET LAN analyzer LITE. Besides, they all offer the following benefits: * full-featured registered version of MONET LAN analyzer LITE on floppy. * printed manual (172 pages) * eligibility for free support * the number of captured packets is limited only by the amount of available RAM in your computer * you can use filters for focusing on certain group of network packets that you want to capture or analyze (filters are just as powerful and user-friendly as those in full commercial version of MONET LAN analyzer!) * you can assign names to the frequently used addresses (IP and DLC) so that reports are much easier to follow * you can save captured packets to files for latter off-line analysis * you can send reports to printer * ... ========================================================================== 6. About MONET LAN analyzer (full version) ------------------------------------------ MONET LAN analyzer is a high-performance PC-based set of powerful tools for monitoring traffic on the local area network. It contains a wide variety of functions which offers a comprehensive support to network administrators, managers and troubleshooters as well as to networking software developers in many aspects of their activities. MONET LAN analyzer helps to increase productivity, to optimize network performance and to decrease network downtime. MONET LAN analyzer features --------------------------- Real time monitoring: Volume of the network traffic is displayed in many different manners. A wide range of parameters indicating network condition are computed in real time and periodically updated (utilization and traffic volume, time-stamps and delay times, average values, peak times and values, various error indicators,...). Powerful graphical presentation of monitoring statistics with export to the BMP file format. Protocol decoding: Support for packets encapsulated into IEEE 802.2 (LLC and SNAP), IEEE 802.3 (Novell IPX) and Ethernet II frames. Multi-level protocol decoders for all major LAN protocol families: AppleTalk, DECnet, IPX/SPX, NBeui, NCP (NetWare), NetBios, OSI/TP4, SMB, TCP/IP, SNMP, XNS,.... (full list of supported protocols is given in the following section). Traffic generation: Transmitting user-defined packets to the network for network testing purposes (triggering network events or loading network with heavy traffic to examine its behavior in critical conditions). Multi-level filtering: Two levels of capture filters and triggers, display filters, classifying filter structures,.... Filters are completely user-definable and 'point-and-click' easy to build. Many sample filters provided. System requirements: IBM PC/AT or compatible computer using Intel 386 or higher microprocessor, DOS V3.30 or higher operating system, XMS RAM extension (recommended 4 MB or more), XMS memory manager himem.sys. A wide range of LAN adapters is supported, either by MGD interface (MONET Genuine Driver) or through standard Packet driver V1.09 drivers. Pricing info: The actual price ranges from 900 US$ to 1800 US$, depending on the configuration the user wants to purchase. Demo version: MONET LAN analyzer DEMO version is a full featured software that runs on virtual net (you can't touch the real network). You can download the latest DEMO version from our web site at URL http://www.mg-soft.si/ ========================================================================== 7. Protocol decoder in DLL module --------------------------------- The WPDECO32 Protocol Decoder in DLL Module lets you incorporate the protocol decoding abilities into your 32-bit MS-Windows applications. How to use the WPDECO32 Protocol Decoder ---------------------------------------- The idea is simple. You have a captured network packet. Along with some other parameters you supply the packet length and the pointer to that packet to the WPDECO32 protocol decoder. After the successful call you get a set of strings, each string representing a line of the decode. You can then display these strings in some output window of your application, send them to the printer etc. This means that adding a protocol decoding functionality to your applications is easier than ever before. The WPDECO32.DLL contains only one function which you have to call in order to produce the decoded network packet. Besides including a header file and calling the decodePacket() function with properly initialized parameters, there is no need for any initialization or cleanup of the decoder, everything is done automatically when the WPDECO32.DLL is loaded or unloaded by your application. The WPDECO32 SDK contains two sample applications in order to illustrate the usage: * DECODER GUI application written in Delphi 2.0 * DECODEMO console application written in C/C++ Both are coming with full source code so they can serve as a very good starting point for further software development. Anyhow, please note the information given in the WPDECO32.DLL Programmer's Reference (in help file supplied with the SDK)! Supported protocols ------------------- Currently WPDECO32.DLL supports the most popular LAN protocols (for the complete list please check the contents of the help file supplied with the SDK). Besides, MG-SOFT can produce a customized version of the protocol decoder according to your needs, including support for other protocols, packet encapsulations,... Please note that the evaluation version of the WPDECO32.DLL protocol decoder distributed in the evaluation version of WPDECO32 SDK supports the following protocol decoders: * DLC, LLC and SNAP Ethernet encapsulation layers, * IP, ARP and RARP layers on top of the encapsulation layer and * TCP, UDP and ICMP layers on top of IP. * Everything else carried by the encapsulation, UDP and TCP protocol layers is decoded as data. Licensing options ----------------- The WPDECO32 SDK is a try before you buy package. Everybody has a right to download it and use it for the evaluation purposes and everybody has a right to try to develop his/her own software which uses our wpdeco32.DLL library. But when the product is ready (either for using by the one who produced it or by the end user), a required number of licenses has to be purchased. Please contact MG-SOFT Corporation for more information about licensing options. Availability ------------ The latest information about WPDECO32.DLL is available at http://www.mg-soft.si/dll-deco.html. The latest version of the WPDECO32 SDK can be downloaded from http://www.mg-soft.si/download.html. ========================================================================== 8. List of supported protocol decoders ------------------------------------------ Please note that the LITE version of MONET LAN analyzer contains only a limited protocol decoding abilities: - DLC encapsulation layer, - IP, ARP and RARP layers on top of DLC, - TCP, UDP and ICMP layers on top of IP and - DNS protocol layer on top of UDP. We believe that this set of protocols is sufficient to support the TCP/IP software developer's need to perform the 'network' debugging while developing the networking software. The DNS protocol doesn't fit into that group (unless somebody is developing software that utilizes the DNS protocol). We have added the DNS protocol decoder only as an example of high level protocol decoder that is, along with other protocol decoders, available in MONET LAN analyzer (full version) and the WPDECO32 protocol decoder in the DLL module. Both products support the following protocol decoders: Encapsulation headers DLC Data Link Control Header LLC 802.2 Logical Link Control Header SNAP SNAP Protocol Header Internet Protocol family IP Internet Protocol ARP Address Resolution Protocol RARP Reverse Address Resolution Protocol TCP Transmission Control Protocol ICMP Internet Control Message Protocol UDP User Datagram Protocol OSPF Open Shortest Path First Protocol IGMP Internet Group Management Protocol BGP Border Gateway Protocol EGP Exterior Gateway Protocol GGP Gateway to Gateway Protocol TNET Telnet Protocol DNS Domain Name Service Protocol NTP Network Time Protocol RPC Remote Procedure Call Protocol SNMP Simple Network Management Protocol ROUTE Route Information Protocol BOOTP Bootstrap Protocol TIME Time Datagram TFTP Trivial File Transfer Protocol AppleTalk family AARP Address Resolution Protocol ADSP Data Stream Protocol DDP Datagram Delivery Protocol AEP Echo Protocol AFP Filing Protocol NBP Name Binding Protocol PAP Printer Access Protocol RTMP Routing Table Maintenance ASP Session Protocol ATP Transaction Protocol ZIP Zone Information Protocol Novell (IPX/SPX/NetWare) family IPX Internetwork Packet Exchange SPX Sequence Packet Exchange (incl. SPX type 2 standard) NCP NetWare Core Protocol NDS NetWare Directory Service DIAG IPX Diagnostic Support Protocol ECHO Echo Packet BCST NetWare Broadcast Packet RIP Routing Information Protocol SAP Service Advertising Protocol SER NetWare Serialization Packet WDOG NetWare Watchdog Packet DECnet family LAT Local Area Transport Protocol DRP DEC Routing Protocol MOP Maintenance Operation Protocol NSP Network Services Protocol SCP Session Control Protocol FND Foundation Layer CTT Command Terminal Layer NetBIOS/NBeui families MLM Microsoft LAN Manager NBeui Microsoft Windows NetBIOS NBios IBM NetBIOS Protocol NBios NetBIOS over IP - Datagram Service Protocol NBios NetBIOS over IP - Name Service Protocol NBios NetBIOS over IP - Session Service Protocol SMB IBM Server Message Block Other protocols AMUP ABIT Multicast Protocol BPDU Bridge Protocol Data Unit TP4 OSI Transport Layer XWin X Windows protocol ========================================================================== 9. Related products ------------------- Please visit http://www.mg-soft.si/ for the latest information about the following and other related products: * MIB Browser Professional Edition * Net Inspector * MG-WinSNMP SDK * MG-WinMIB SDK * MIB Compiler * SNMP EasyAgent SDK * Simple SNMP Service * SendTrap utility * SNMP Ping utility * ... ========================================================================== 10. More information -------------------- For the latest information about our products, please check our WEB sites at http://www.mg-soft.si/ and http://www.abit.co.jp/ or contact us directly. In order to be promptly informed about news from MG-SOFT and ABIT Corporations, you may wish to subscribe to our mailing lists by filling in the form at URL http://www.mg-soft.si/maillist.html If you don't have access to the Internet, please let us know by email that you wish to subscribe and we will add you to the list of recipients. Please send all questions, suggestions, request for technical support and bug reports to our addresses: ABIT Corporation MG-SOFT Corporation 29-11 Hiraoka-cho Strossmayerjeva 32a Hachioji-shi 2000 Maribor Tokyo 192, Japan Slovenia Phone +81 426 271900 Phone +386 62 2295050 Fax +81 426 275221 Fax +386 62 222725 Email monet@abit.co.jp Email monet@mg-soft.si http://www.abit.co.jp/ http://www.mg-soft.si/ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !! + !! MONET LAN analyzer - for a closer look into your net !! + !! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ==========================================================================