home *** CD-ROM | disk | FTP | other *** search
/ The Best of Windows 95.com 1996 September / WIN95_09962.iso / webmisc / mib1_2a.zip / ReadMe.txt < prev    next >
Text File  |  1996-08-11  |  12KB  |  285 lines
  1.                          Welcome to MIB Master!
  2.                         =======================
  3.  
  4.                        Version 1.2 Release 11 August
  5.                       ------------------------------
  6.  
  7.                            Table of Contents
  8.                            =================
  9.  
  10.    1....Description
  11.    2....New in version 1.2!
  12.    3....MIB Master Installation
  13.    4.1...Prerequisites
  14.    4.2...Windows/NT and Windows 95 Procedure
  15.    4.3...Linux Procedure
  16.    5....Disclaimer
  17.  
  18. -------------------------------------------------------------------------------
  19.  
  20.                                 1. Description
  21.                                 ==============
  22.  
  23. Intended for use in the small to medium LAN environment, MIB Master allows you
  24. to view and modify your SNMP agents using any World Wide Web browser such as
  25. Netscape Navigator or Microsoft Explorer. This gives a simple access that does
  26. not have lots of features that you will never use and a price tag to match.
  27.  
  28. MIB Master fully supports SNMP version 1, including:
  29.  
  30.      *      Get and Set Requests,
  31.      *      Tables entries,
  32.      *      All standard variable types,
  33.      *      Agregates multiple Gets to minimise network traffic,
  34.      *      Many standard RFC MIB files provided,
  35.      *      Customisable HTML templates,
  36.      *      Full trap support,
  37.      *      Host discovery ,
  38.      *      Security features including admin and user passwords,
  39.      *      ASN to HTML conversion script for AWK,
  40.      *      Automatic vendor detection using sysObjectId
  41.  
  42. All Equivalence products, including MIB Master, can be downloaded free of
  43. charge from our Web site, whose address is given below. This site contains
  44. information on configuring and installing MIB Master, as well as the rest of
  45. our products.
  46.  
  47. For a up to 7 Get Requests, MIB Master can be used without registration. For
  48. more than 7 Get Requests and Set Request capability, a special registration
  49. key can be purchased from Equivalence. The price for registration key is US$50.
  50.  
  51. MIB Master currently runs on the following operating systems:
  52.  
  53.     - Windows/NT version 3.5, 3.51, and 4.0
  54.     - Windows 95
  55.     - Linux
  56.     - SunOS
  57.  
  58. For more information, or to get the latest version, check out our Web site at:
  59.  
  60.                        http://www.ozemail.com.au/~equival
  61.  
  62. -------------------------------------------------------------------------------
  63.  
  64.                             2. New in Version 1.2
  65.                             =====================
  66.  
  67. For those who are familiar with MibMaster version 1.0, here is a summary of
  68. the new features in version 1.1:
  69.  
  70.   .  We have included lots more MIB files. They are available in a separate
  71.      archive from our Web site. See
  72.      http://www.ozemail.com.au/~equival/mibmaster/faq.html for more info
  73.  
  74.   .  A problem with the Host Discover screen which caused it to display
  75.      text in a font too large for the screen has been fixed.
  76.  
  77.   .  A problem with the Host Discover screen displaying large negative
  78.      ping times has been fixed.
  79.  
  80.   .  A problem with Discover MIB page which caused it to fail has been fixed.
  81.  
  82.   .  A problem which caused long MIB displays to be occasionally truncated
  83.      has been fixed.
  84.  
  85.   .  The AWK script "mib_to_html" has been replaced with an improved script
  86.      called "mib2html.awk". This is a fully fledged ASN parser and was used for
  87.      all of the MIB files provided with MibMaster. See the FAQ for more
  88.      information on where to get AWK.
  89.  
  90.   .  The View MIBs page will display the name of the MIB vendor as identified
  91.      by the sysObjectId entry. The enterprise number in this object will be
  92.      used to extract the name of the vendor as contained in the text file
  93.      "enterprise-numbers". If a subdirectory with the enterprise number exists
  94.      in the "mibs/vendors" directory, then this string will be a hyperlink to
  95.      a HTML target in the file "mibs/vendors.html". See the existing file
  96.      for an example of how to do this.
  97.  
  98. -------------------------------------------------------------------------------
  99.  
  100.                             3. Installation Procedure
  101.                             =========================
  102.  
  103. Until we get a proper install program going, you should follow the step
  104. outlined here. At present we are assuming a reasonable knowledge of the target
  105. operating system (Windows/NT or Linux) and its concepts and management. If you
  106. are a rank beginner then this is a good time to start learning!
  107.  
  108. 3.1 Prerequisites:
  109. ------------------
  110.  
  111. It is assumed that the following have already been installed:
  112.  
  113.   * TCP/IP.
  114.   * Remote Access Service (optional).
  115.   * A web browser, e.g. Netscape Navigator.
  116.  
  117.  
  118. 3.2 Windows/NT & Windows 95 Procedure
  119. -------------------------------------
  120.  
  121. BEFORE STARTING: Make sure you have an UnZip program which correctly
  122.                  handles long filenames. Using a program which does not
  123.                  do long filenames correctly will cause all of the help files
  124.                  and MIB files to be inaccessible!
  125.  
  126.   1.    If this is the first time you have installed a copy of MIB Master, then
  127.         go to step 4. If you have previously installed a version of MIB Master,
  128.         continue on to step 2.
  129.  
  130.   2.    Open a command shell and use the CD command to change to the  directory
  131.         in which the previous version of MIB Master is installed. Enter the
  132.         following commands:
  133.  
  134.                             MIBMaster STOP
  135.                             MIBMaster REMOVE
  136.  
  137.         A note for experts: as a rule it is not necessary to remove the service
  138.         as stopping it is sufficient to replace the executable file. Of course
  139.         it then does not need to be installed later either. This is put in here
  140.         as a fail safe only.
  141.  
  142.   3.    You may then delete all of the files in the current directory or copy
  143.         them to another directory as a backup. All configuration information
  144.         is stored elsewhere, so the new version will automatically use the
  145.         old settings.
  146.  
  147.   4.    Use your favorite UnZIP program to unpack the .ZIP file you have
  148.         received. You should do this in the directory in which you want to
  149.         install MIB Master. We recommend using the directory:
  150.  
  151.                         C:\WIN32APP\MIBMASTR
  152.  
  153.         If you are installing MIB Master into the same directory as a previous 
  154.         version, make sure you delete all of the old files before continuing.
  155.  
  156.         MAKE SURE THE UNZIP PROCESS CREATES THE DIRECTORIES IN THE ZIP FILE!
  157.         IF YOU DO NOT CREATE TYHESE DIRECTORIES, YOUR MIB FILES WILL NOT WORK!
  158.  
  159.   5.    The directory should contain a file named MIBMaster.EXE, two .GIF files,
  160.         and a set of .HTML files. If you have .HTM files instead of .HTML,
  161.         then your UnZIP programs doesn't understand long filenames. To rename
  162.         these files to the correct extension, enter the following command from
  163.         an command shell:
  164.  
  165.                               REN *.HTM *.HTML
  166.  
  167.   6.    From a command shell, execute the command:
  168.  
  169.                               MIBMaster INSTALL
  170.  
  171.         This will install the MIB Master service into the system registry.
  172.  
  173.   7.    From a command shell, execute the command:
  174.  
  175.                                MIBMaster START
  176.  
  177.         This will start the MIB Master service automatically. Alternatively, you
  178.         may use the Services applet in the Control Panel to start the MIB Master
  179.         service manually. This applet can also be used to make MIB Master
  180.         automatically start on reboot.
  181.  
  182.   8.    Start your Web browser and enter the URL:
  183.  
  184.                               http://localhost:1090
  185.  
  186.         This should bring up the MIB Master Home Page with the logo and
  187.         hyperlinks to online help and configuration pages.
  188.  
  189.   9.    The first time you attempt to access any MIB Master configuration page,
  190.         you will be asked for a username and password to authorise access.
  191.         MIB Master is delivered with two username/password pairs which can
  192.         be configured from the Global Parameters configuration page. The
  193.         default entries for administrator access are username "admin" and
  194.         password "secret". The default values for user access are "user" and
  195.         "password". We recommend you change these settings to other values to
  196.         preserve the security of your system. 
  197.  
  198.   10.   Follow the steps in the "Getting Started" section of the online help.
  199.         This section is also available from a hyperlink on the MIB Master Home
  200.         page.
  201.  
  202.   11.   Once you are connected to the 'Web, be sure to check out the release
  203.         notes for late breaking information on your version of MIB Master. There
  204.         is a hyperlink to this document near the bottom of the MIB Master Home
  205.         Page.
  206.  
  207.   12.   Most importantly - PLEASE REGISTER YOUR COPY OF MIB Master! Not only will
  208.         it allow you to use MIB Master with more 7 Get Requests, but the money will
  209.         help us improve the product even further. We will keep you informed
  210.         of new versions of MIB Master via email, and please check our 'Web
  211.         Home Page at "http://www.ozemail.com.au/~equival" for information on
  212.         other Equivalence products.
  213.  
  214.  
  215. 3.3 Linux Procedure
  216. -------------------
  217.  
  218.   1.    If this is the first time you have installed a copy of MIB Master, then
  219.         go to step 4. If you have previously installed a version of MIB Master,
  220.         continue on to step 2.
  221.  
  222.   2.    You must stop the running version of MIB Master. To do this use the
  223.         following:
  224.  
  225.                             ps -aux | grep mibmaster
  226.                             kill -9 <pid>
  227.  
  228.         Where <pid> is the process ID displayed by the ps command.
  229.  
  230.   3.    You may then delete all of the files in the directory in which the
  231.         previous version of MIB Master is installed or copy them to another
  232.         directory as a backup. All configuration information is stored
  233.         in the directory $(HOME)/.pwlib_config, where $(HOME) is the home
  234.         directory of the user who installed and registered MIB Master. Be
  235.         carefull not to modify or delete this information or you will lose
  236.         your registration status.
  237.  
  238.   4.    If MIB master is going to be used by one person only, then we
  239.         recommend using an installation in that user's home directory. For
  240.         example, the following commands can be used to install MIB Master
  241.         in the directory ~/mibmaster:
  242.  
  243.                cd ~
  244.                mkdir mibmaster
  245.                cd mibmaster
  246.                gunzip -c mibmaster-v1.0beta1-linux-486.tgz | tar xf -
  247.  
  248.         If MIB master is going to be used by more than person, we recommend
  249.         creating a userid specifically for MIB Master, and then installing
  250.         the program in /usr/local/mibmaster as shown above.
  251.  
  252.         As MIB Master stores configuration and registration information in the
  253.         home directory of the user which invokes the executable, the filesystem
  254.         containing this directory must be writable.
  255.  
  256.         MIB Master will run correctly setuid, so a suitable configured
  257.         executable may be invoked from the rc.local at startup file without
  258.         littering the root directory with configuration files.
  259.  
  260.   5.    From a command shell, execute the command:
  261.  
  262.                                mibmaster -x &
  263.  
  264.         To have MIB Master automatically start on reboot, include the above
  265.         line in your /etc/rc.local file.
  266.  
  267.   6.    Proceed from step 8 of the Windows/NT installation isntructions.
  268.  
  269.  
  270. -------------------------------------------------------------------------------
  271.  
  272.                                 4. Disclaimer
  273.                                 =============
  274.  
  275. The information and code herein is provided "as is" without warranty of any
  276. kind, either expressed or implied, including but not limited to the implied
  277. warrenties of merchantability and fitness for a particular purpose. In no event
  278. shall EQUIVALENCE be liable for any damages whatsoever including direct,
  279. indirect, incidental, consequential, loss of business profits or special
  280. damages, even if EQUIVALENCE has been advised of the possibility of such
  281. damages.
  282.  
  283.  
  284.                         Copyright (C) 1996 Equivalence
  285.