/* $Header: /usr/cvsroot/target/src/wrn/wm/demo/winagent/windemo.txt,v 1.1.1.1 2001/11/05 17:49:19 tneale Exp $ */

/****************************************************************************
 *     Copyright (c) 1988 - 1997  Epilogue Technology Corporation
 *     All rights reserved.
 *
 *     This is unpublished proprietary source code of Epilogue Technology
 *     Corporation.
 *
 *     The copyright notice above does not evidence any actual or intended
 *     publication of such source code.
 ****************************************************************************/

/* $Log: windemo.txt,v $
/* Revision 1.1.1.1  2001/11/05 17:49:19  tneale
/* Tornado shuffle
/*
/* Revision 1.3  2001/01/19 22:25:12  paul
/* Update copyright.
/*
 * Revision 1.2  1997/02/25 16:35:44  mrf
 * Added RCS log and copyright notice
 *
 */

WinDemo.txt -- Documentation for Win95 WinSock SNMP Demo Programs.
               These programs were built using Epilogue Technology
               Corporation's Envoy (portable SNMP source code
               product) version 7.0.  For more information about
               Envoy or other Epilogue products see the FOR FURTHER
               INFORMATION section below.


WINSOCK DEMO PROGRAMS:

The following programs are provided on this disk:

   WinAgent.exe --   SNMP Agent 
                     This is a 32-bit winapp providing SNMP agent
                     support for the Toaster MIB as well as the
                     System groups from MIB-II (RFC 1213).
                     It is a bi-lingual (SNMPv1/v2) agent which
                     uses winsock (version 1.1 or 1.0) for its
                     network access.

   SNMPTalk.exe --   SNMP MIB Browser
                     This is a 32-bit console app which provides
                     a simple command-line MIB browser.  Its
                     configuration is set in a file called
                     etc.ini (which must reside in the same
                     directory as SNMPTalk or be pointed to by
                     the ETC_INI environment variable).  SNMPTalk
                     determines the names and types of MIB
                     objects by reading a mib.rt file (which
                     is built using Epilogue's Emissary MIB
                     compiler).  An example mib.rt file has
                     been provided which supports the Toaster
                     MIB and the System group from MIB-II
                     (RFC 1213).  WinTalk uses a winsock DLL
                     (version 1.1 or 1.0) for network access.

WINSOCK DEMO SYSTEM REQUIREMENTS:

These demo programs were built to run on a Microsoft Windows95
system.  They also require a 32-bit Winsock DLL (version 1.1 or
1.0) such as that provided by the Microsoft TCP/IP support
included in Windows95.  Install the TCP/IP protocol and verify
its operation (using applications provided by your TCP/IP provider)
before attempting to run this demo.

WINSOCK DEMO INSTALLATION:

The following directions assume you will be installing both
demos on the same machine.  It is also possible (and more
exciting as a demo!) to use the two programs on two different
machines which can communicate over an IP network.  To run
the demo between two machines, follow the following installation
instructions on each machine.  Then, run the agent on one
machine and the MIB browser on the other (see USING THE
WINSOCK DEMOS section below).

   1. Copy all contents of the demo diskette into a directory
      on your target system (i.e. c:\EnvoyDemos).  If desired, 
      you can skip this step and run the demo programs directly
      from the demo diskette.

The following steps are optional and will create shortcut
icons for the two demo programs on your windows background.

   2. Right click on your Windows background.  Select "New"
      and "Shortcut".  Create a shortcut with the following
      properties:

         Command line:  <your directory>\WinAgent.exe
                        (i.e. c:\EnvoyDemos\WinAgent.exe)

         Name:          WinAgent

      This should cause a toaster icon with the label "WinAgent"
      to appear on your desktop.

   3. Right click on the Windows background and select "New"
      "Shortcut" again.  This time, create a shortcut with the
      following properties:

         Command line:  <your directory>\SNMPTalk.exe

         Name:          SNMPTalk

The following steps are also optional and will make the demos
look nicer:

   4.  Right click on the WinAgent shortcut and select "Properties".
       Switch to the shortcut tab and set "Run" to "Minimized".
       Then click "OK" to save the changes and exit.
       This will cause the agent to run minimized instead of 
       putting up a window (to see the window, you can then
       click on the WinAgent item on the task bar).

   5.  Right click on the SNMPTalk icon and select "Properties".
       Switch to the shortcut tab and click on "Change Icon".
       As you will now learn, SNMPTalk (being a console app) does
       not have an icon built-in.  Indicate to the dialog box
       that you want it to use the icon file balloon.ico in
       your demo directory (i.e. c:\EnvoyDemos\WSAgent.ico).
       Then click "OK" to save the changes and exit.
       This will give the MIB browser the same toaster icon as
       the agent.

RUNNING THE WINSOCK DEMOS

If you have installed shortcuts on your desktop, you can run a demo
program by double-clicking on its shortcut.  Otherwise, you can run 
a demo program by going to the "Start" menu, selecting "Run" and 
running the desired demo program from your demo installation 
directory (i.e. c:\EnvoyDemos\WinAgent.exe for the agent or 
c:\EnvoyDemos\SNMPTalk.exe for the MIB browser) or directly from
the demo diskette (a:\WinAgent.exe or a:\SNMPTalk.exe).

   One machine demo:

      1. Run the agent.

      2. Run the MIB browser.  
      
      3. At the mib browser command-line, enter the following commands 
         (text after '//' is a comment and should not be typed):

         snmptalk> dest 127.0.0.1   //sets destination to loopback address

         snmptalk@127.0.0.1> walk   //walks the MIB tree   
         
         snmptalk@127.0.0.1> help   //gives general help on program
         
         snmptalk@127.0.0.1> ?      //shows list of possible commands

      4. Type other commands (get, set, next, etc.) as desired.

      5. Quit the SNMPTalk program by typing "quit".

   Two machine demo:

      1. On the "agent" machine, run the agent.

      2. On the "manager" machine, run the MIB browser.

      3. At the mib browser command-line, enter the following commands 
         (text after '//' is a comment and should not be typed):

         snmptalk> dest <agent-ip>  //set destination to agent's ip address
                                    //or use hostname if dns is available

         snmptalk@127.0.0.1> walk   //walks the MIB tree   
         
         snmptalk@127.0.0.1> help   //gives general help on program
         
         snmptalk@127.0.0.1> ?      //shows list of possible commands

      4. Type other commands (get, set, next, etc.) as desired.

      5. Quit the SNMPTalk program by typing "quit".

TECHNICAL HELP

If you experience difficulties running this demo and would like
technical help, contact our engineering group (support@epilogue.com).

FURTHER INFORMATION

For further information about Epilogue's products, see our web page
(www.epilogue.com) or contact us by e-mail (info@epilogue.com)


Epilogue Technology Corporation

Sales/Marketing:                    Engineering/Technical Support:
11116 Desert Classic Lane, NE       268 Main Street, Suite 283
Albuquerque, NM  87111              North Reading, MA  01864
Phone:   (505) 271-9933             Phone:   (617)245-0804
FAX:     (505) 271-9798             FAX:     (617)245-8122
e-mail:  sales@epilogue.com         e-mail:  support@epilogue.com


