home *** CD-ROM | disk | FTP | other *** search
/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / Software / SURVEYOR / Readme.txt < prev    next >
Encoding:
Text File  |  1999-07-29  |  14.9 KB  |  352 lines
  1.  
  2.         Surveyor Lite Version 1.0      Build 1 04/19/99
  3.          ------------------------------------------------------
  4.     
  5. README.TXT            
  6. ==========
  7.     This README.TXT file contains important information about
  8.     Shomiti Systems' Surveyor Lite Version 1.0 software. 
  9.     
  10.     Please read this file in its entirety for the latest
  11.     information regarding this release of Surveyor.
  12.  
  13.     NEW FEATURES:
  14.  
  15.     -Application Response time is displayed in its own window.
  16.  
  17.     -Following Capture View Enhancements have been made:
  18.       o Set mark function - allows the user to select a packet and mark
  19.         it as time zero.
  20.       o High level address display - allows the user to view source and 
  21.         destination network address summary.
  22.       o Ability to select layer to display in summary
  23.       o Ability to save selected packets
  24.       o Ability to print selected packets with option to print summary,
  25.         detail or both to file.
  26.  
  27.     -Real Time Name learning has been added. In addition, the names 
  28.      learned on remote (Explorer/Surveyor) machines are also polled 
  29.      for local display. 
  30.  
  31.     -Function Keys definitions have been added to access the most common 
  32.     operations.
  33.  
  34.     -Surveyor Lite is intended for educational use only.  Functionalities such
  35.     as remote monitoring/analysis, expert analysis, and traffic generation have
  36.     been disabled.  Captured packets also have been limited to the last 100
  37.     packets.
  38.  
  39.         
  40. Table of Contents
  41. =================
  42.     1.0 Hardware Requirements & Software Compatibility
  43.     2.0 Software Installation
  44.         2.1 Overview
  45.         2.2 New Installation
  46.         2.3 Upgrade Installation
  47.           2.3.1 Upgrade over Century Lan Analyzer(CLA) software
  48.                 2.3.2 Upgrade over earlier version of Surveyor
  49.     3.0 NDIS Configuration Options
  50.     4.0 Example Files
  51.     5.0 Configuring the Startup Name Table
  52.     6.0 Problems Fixed in this Release  
  53.         7.0 Known Problems  
  54.         8.0 Helpful Hints
  55.         9.0 How to Contact Technical Support
  56.  
  57. 1.0 Hardware Requirements & Software Compatibility
  58. ==================================================
  59.     Minimum PC configuration:
  60.         Microsoft Windows95 or 
  61.         Microsoft WindowsNT 4.0/SP 3 (with Administrative privileges)
  62.                   Pentium 100Mhz processor or higher.
  63.     32MB RAM Windows 95 
  64.     32MB RAM Windows NT 4.0 
  65.     800 x 600 Video SVGA display (or higher) 
  66.     NDIS enhanced 16/32 bit driver for 10/100 Ethernet Adapter Card and or
  67.     NDIS 4/16 Token Ring adapter card
  68.     
  69.     Optional:
  70.     - Century Media Module (CMM) 10/100 Ethernet Analyzer/Capture/Filter
  71.           PC Module (ISA slot)
  72.     - Explorer 10/100 Ethernet portable integrated network analysis 
  73.       and monitoring system
  74.         - Century Tap and 12-Tap allow CMM Analyzers and Explorers 
  75.       to tap into 10/100 Ethernet full-duplex links
  76.     
  77.     Surveyor/Explorer Compatibility Matrix:
  78.     This release is compatible with previous releases of
  79.     Surveyor (2.1 and 2.2) and Explorer (1.1, 1.2, and 1.3).  
  80.         
  81. 2.0 Software Installation
  82. =========================
  83.         Note: Do not use the Add/Remove Software program found in the
  84.               Control Panel of Windows95 and WindowsNT 4.0 to install
  85.               Surveyor. Follow the installation instructions described 
  86.           below for proper installation.
  87.  
  88.         Note: If CMM hardware analyzer modules are installed in your 
  89.           system, record the address setting of each module by 
  90.           viewing their jumper settings.  After installation, 
  91.           Surveyor will need the Module addresses for proper 
  92.           startup.
  93.  
  94.         2.1  Overview of Installation Process
  95.              -Remove existing installations of Century LAN Analyzer
  96.          -Install the Surveyor 1.0 Base module
  97.         
  98.     2.2 New Surveyor 1.0 Installation:
  99.  
  100.     Insert Surveyor 1.0 CD-ROM into the CD-ROM drive. From 
  101.     Windows 95 or Windows NT 4.0, Click the Start button, choose Run, 
  102.     and type X:\setup <enter>, where X is your CD dirve. Default installation will 
  103.     install Surveyor files into the C:\Program Files\Shomiti\Surveyor directory. 
  104.     You can edit this destination directory during the installation 
  105.     process if you choose.
  106.             
  107.     2.3 Upgrade Installation: (When Century LAN Analyzer (CLA) Ver 1.x
  108.         OR earlier versions of Surveyor 2.x are already installed.)
  109.  
  110.         Note: UnInstallShield does not delete Surveyor's startup configuration
  111.               file, Surveyor.ini file found in the Windows or Winnt directory.
  112.               It is recommended that the Surveyor.ini file be renamed and
  113.               the newer version of Surveyor, upon start up, will create a
  114.               new default Surveyor.ini file.
  115.  
  116.         Note: Before Upgrade, move all USER created capture files (.cap), 
  117.               filter files (.cfg & .dfd), transmit files (.tsp), 
  118.           name files (.nam), and log files to a directory other than
  119.               the installation directory. These files will be deleted
  120.               during the Upgrade process if they reside in the target
  121.            installation directory
  122.  
  123.         2.3.1 Perform these operations if you are installing Surveyor
  124.               1.0 on a system which has a previous version of CLA (1.x)
  125.               already installed on it. Simultaneous installations of
  126.               Surveyor software and Century LAN Analyzer(CLA) software
  127.               are not supported.
  128.           - Run the "Century UnInstallShield" provided with the earlier 
  129.         version of installed CLA software.
  130.       - Remove the "Shomiti NDIS 3.1 PKTDRVR" from the network folder
  131.         of the control panel (No new Shomiti NDIS driver needs to be 
  132.         installed).
  133.       - Delete Pktdrvr.vxd from the \Windows\System directory.
  134.       - Install Surveyor 1.0 software as described above (section 2.2).
  135.  
  136.         2.3.2 Perform these operations if you are installing Surveyor 1.0  
  137.               on a system which has a previous version of Surveyor:
  138.           - Run the "Surveyor UnInstallShield" provided with the earlier 
  139.         version of Surveyor software. (see UnInstallShield notes)
  140.       - Install Surveyor 1.0 software as described above.
  141.  
  142.     UninstallShiled Notes:
  143.      The uninstallation program removes files that it had originally
  144.         installed and were not modified.  If any files are left over after the
  145.         uninstallation process, you may still proceed with the upgrade process
  146.         as described above.
  147.  
  148. 3.0 NDIS Configuration Options
  149. ==============================
  150.     Surveyor 1.0 supports up to four (4) Ethernet and/or Token Ring 
  151.     adapters. However, the default setting for Surveyor is for one (1)
  152.         adapter. If you are using any other number of adapters you MUST 
  153.         manually edit the system file: c:\windows\surveyor.ini*. The file
  154.         can be edited with a text editor such as Notepad.  You     will need
  155.         to insert the following line into the c:\windows\surveyor.ini* file,
  156.         just above the line that defines your Name Table default pathway.
  157.  
  158.     NoOfNdisModule=X
  159.  
  160.     Where the value X is the number of NDIS cards installed in your 
  161.     machine. You must set the value to Zero if you remove all of the 
  162.     adapters. If you had two NDIS cards installed it would look like 
  163.     this:
  164.  
  165.     NoOfNdisModule=2
  166.     Name Table=c:\shomiti\surveyor\Surveyor.nam   
  167.  
  168.     If you experience problems, delete any Dial Up adapters.
  169.     Then, after you have successfully installed both NICs, you can     
  170.     add the Dial Up adapters. 
  171.  
  172.     * the default directory on WindowsNT is c:\winnt  
  173.               
  174. 4.0 Example Files
  175. =================
  176.     An example directory, Program Files\Shomiti\Surveyor\Examples, contains sample 
  177.     Capture Filter Definition (.cfd) files, Display Filter 
  178.     Definition (.dfd) files, Capture (.cap) files, 
  179.     Transmit Specification (.tsp) files, and Template (.cap) files.
  180.     
  181.     Note: (.tsp) files created with Surveyor are not backwards 
  182.           compatible with older versions of CLA software because
  183.           of format changes. 
  184.     
  185. 5.0 Configuring the Startup Name Table
  186. ======================================
  187.     The Name Table is a file that contains a list of discovered MAC
  188.     and Network addresses found by Surveyor in real-time and/or
  189.     during the capture and decode process. The default Name Table 
  190.     file is Surveyor.nam and is located in the Shomiti\Surveyor 
  191.     directory (if default installation paths were chosen). 
  192.     This file updates itself during monitoring but is not 
  193.     automatically saved.
  194.  
  195.         To save, click the NAM button found in both the Surveyor Main 
  196.         and Detail views, click Save, and choose the directory to save 
  197.         in and type a name for your new Name Table file...example,
  198.         MyNetwork.nam. 
  199.  
  200.         To make the above file, MyNetwork.nam, the default startup Name 
  201.     Table file, you will need to edit the Surveyor.ini file found 
  202.     in the Windows directory by following these instructions:
  203.  
  204.       1. Locate the Surveyor.ini file in your Windows95 or WindowsNT 
  205.         directory
  206.      2. Double Click  on  the Surveyor.ini file to open
  207.      3. Search for this line "NameTable=C:\Program Files\Shomiti\Surveyor\Surveyor.nam"
  208.      4. Delete the "Surveyor.nam" text on that line
  209.      5. Replace text with the default name table file, for example 
  210.             MyNetwork.nam. 
  211.      6. Save the Surveyor.ini file, exit your editor and start the 
  212.         Surveyor application.
  213.         
  214.     Note: Switching between Name Table files with Surveyor running 
  215.           can be accomplished by clicking on the "NAM" tool bar 
  216.           button and click "Open". Find the name table file you want 
  217.           and Click  "OK".  Surveyor will always start up with the 
  218.           Name Table file specified in the Surveyor.ini file.
  219.  
  220. 6.0 Problems fixed in this release
  221. ===================================
  222.  
  223. 1.    NTP packets:
  224.     A crash occurs when decoding bad NTP packets.
  225.     Ref# 1760
  226.  
  227. 2.    Login Window:
  228.     Incorrect tab sequence in login window.
  229.     Ref# 1761
  230.  
  231. 3.      Export to *.CSV file:
  232.         A crash may occur when trying to export any capture view to *.csv file 
  233.     format.
  234.     Ref# 1624
  235.  
  236.                       
  237. 7.0 Known Problems 
  238. ==================
  239.     
  240. 1.    Packet edit:
  241.     Inserting multiple frames before the first frame which has a long delta 
  242.     time may produce a negative delta time stamp for those frames.    
  243.     Ref# 1478
  244.  
  245.  
  246. 8.0 Helpful Hints
  247. ===============
  248.               
  249. 1.      Adapter Cards\Token Ring:
  250.         Madge PCMCIA adapter does not install properly with OSR2 
  251.     (OEM release 2) of Windows95. Specifically it does not work with 
  252.     NDIS.VXD driver, date 8/24/1996, size 16,301. It does however 
  253.     install properly with previous NDIS.VXD driver. If you have 
  254.     installed the OSR2 version of Windows95, locate and copy the 
  255.     older NDIS.VXD driver to windows\system directory.
  256.  
  257. 2.      Remote\Dial-Up Networking:
  258.         Before Remote Dial-Up, remove all IP address bindings to all NDIS 
  259.         adapters except the IP address binding to the Dial-Up Adapter on 
  260.     local PC. IP address bindings are done through Windows95 & NT's 
  261.     Network folder found in the Control Panel.
  262.  
  263. 3.      Remote\Dial-Up Networking:
  264.         After Remote Dial-Up, remove the IP address binding to the Dial- 
  265.         Up Network adapter on local PC.  This is done through the Network 
  266.     folder of the Control Panel in both Windows95 and WindowsNT. 
  267.     A reboot is necessary.    
  268.  
  269. 4.      Startup Crash:
  270.         At least one protocol must be assigned to a NDIS module that Surveyor 
  271.         may access as a Resource.  Failure to assign a protocol to the NDIS 
  272.     module will cause a "Blue screen" crash during  startup. Check the 
  273.     Network folder in the Control panel and verify that each NDIS adapter 
  274.     under "Bindings" has a protocol assigned before starting Surveyor.
  275.      
  276.  
  277. 5.    Viewing Capture files and applying filters:
  278.     Caution must be taken when saving filtered versions of capture files. 
  279.     If you create and apply a display filter to a capture that does not 
  280.     match anything, you will end up with an empty capture.  Do NOT save 
  281.     the empty capture file. To return to the original valid capture file
  282.     (to which the failed display filter was applied), bring up the filter 
  283.     by clicking on the "Create/Modify Display Filter" button in the Detail 
  284.     View toolbar. Turn off the filter by clicking on the "OFF" button in
  285.     the toolbar. Reactivate the Surveyor Capture View window by clicking 
  286.     on top of its window. Now from the Detail View toolbar use the pulldown 
  287.     menu for File, and click on Refresh.  This will cause the Surveyor 
  288.     Capture View window to Refresh and display the original capture file 
  289.      (unfiltered).
  290.  
  291. 6.    NDIS buffer sizing:
  292.     NDIS buffer size changes should only occur on the LOCAL system.  Do not 
  293.     change the buffer size of a REMOTE NDIS interface.
  294.  
  295. 7.     Packet Slicing:
  296.     Changing the Packet Slicing while a module is armed will affect the 
  297.     Elapsed Time in the Packet Statistics view.  Stop the module before
  298.     changing the Packet Slicing value.
  299.  
  300. 8.    CMM 1&2 Monitoring & Mode configuration:
  301.     The Century Media Module 1&2 cannot be set to Monitoring mode only. 
  302.     The mode choices for HDX are Capture, CAP+MON, or Transmit.
  303.     The mode choices for FDX (CMM2 only) are CAP+TX. 
  304.     The user must manually set the CMM2 module to CAP+TX for proper
  305.     FDX operation.  At the end of FDX the user must manually unset CAP+TX
  306.     mode.  There are no performance degradation when setting modules to 
  307.     CAP+MON mode.
  308.      
  309. 9.     NDIS Module:
  310.         Shomiti's NDIS module will be attached to the interface card's driver 
  311.     (NDIS.VXD). However, other services, such as TCP/IP, IPX, NetBIOS, etc., 
  312.     might also be attached to this driver. These other services will capture 
  313.     frames directed to the interface cards MAC address and to the Broadcast 
  314.     address. The NDIS module will be able to capture all addresses when the
  315.     module is armed for receive. Under heavy BROADCAST traffic the PC can
  316.     lock up because these other services are present. It is recommended that 
  317.     these services are removed from the interface card if the user is 
  318.     experimenting with a traffic generator generating streams of BROADCAST 
  319.     on the same segment as this given PC.
  320.  
  321. 10.    Module lock:
  322.     Use module\lock to lock out access to a local or remote module in use.
  323.     If you disconnect from a remote module you have locked, that module will
  324.     automatically be unlocked.
  325.  
  326. 11.    Sniffer Conversion:
  327.     Surveyor does not convert compressed (.enc) sniffer files to Shomiti's
  328.     (.cap) files.
  329.  
  330. 12.     Operation:
  331.         If packets are edited in the Capture View, use only the Save Icon button
  332.     "within" the Capture View window to save the changes.  Using the Save 
  333.     Icon button in the Detail View window in which the Capture View resides
  334.     will result in a loss of those changes.  Use the Save button in the 
  335.     window with which you are working.
  336.  
  337.     
  338.     
  339. 9.0 How to Contact Technical Support
  340. ====================================
  341.     Shomiti Systems Inc.
  342.     1800 Bering Drive
  343.     San Jose, CA 95112
  344.  
  345.     888-SHOMITI  (888) 746-6484 (Continental U.S. and Canada)
  346.  
  347.     Direct Phone Number to Tech Support.....408 437-4059
  348.     Main Phone Number.......................408 437-3940
  349.     Fax Number..............................408 437-4041
  350.         Support Email...........................support@shomiti.com 
  351.     Web Site................................http://www.shomiti.com
  352.