This is the "READ_ME.TXT" file distributed with MG-SOFT MIB Browser 2010 Professional Edition with MIB Compiler for Linux. Copyright (C) 1995-2010 MG-SOFT Corporation. All rights reserved. ============================================================================ Table of Contents ----------------- 1. About the Software 2. Important Licensing Information 3. What's New in this Version 4. Installing the Software 5. Uninstalling the Software 6. MG-SOFT Corporation on the Internet 7. Ordering the Software 8. Licensing Agreement 9. Contacting MG-SOFT Corporation ============================================================================ 1. About the Software --------------------- MG-SOFT MIB Browser Professional Edition with MIB Compiler is an SNMP MIB Browser available for Microsoft's 32-bit and 64-bit Windows operating systems (Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008, Windows 7), for Linux operating systems running on Intel x86 architecture (Red Hat, SuSE, Ubuntu,...), for Apple Mac OS X (universal binaries for both, Intel x86 and PPC), as well as for Sun Solaris 10 (for both, Intel x86 and SPARC platforms). MIB Browser lets you monitor and manage any SNMP device on the network (i.e., file or database servers, modems, printers, routers, switches,...) by using the standard SNMPv1, SNMPv2c and SNMPv3 protocols over IPv4, and IPv6 networks. Along the standard SNMPv3 USM model, MIB Browser supports also Diffie-Hellman key exchange model, so that DOCSIS-based SNMPv3 agents (e.g., cable modems, cable modem termination systems, set-top boxes etc.) can be seamlessly contacted and managed. MIB Browser allows you to perform the SNMP Get, SNMP GetNext, SNMP GetBulk and SNMP Set operations. Besides, the software lets you capture and display SNMP Trap and SNMP Inform packets that are sent from arbitrary SNMP devices or applications on the network (requires installation of MG-SOFT SNMP Trap daemon). MIB Browser can monitor several SNMP devices simultaneously and contains features like SNMP Table viewer, SNMP Table 'editor', logging capabilities, real-time graphical presentation of queried numerical values, scan for implemented MIBs in agents, comparison of SNMP agent snapshots, management of SNMPv3 USM users on remote SNMP agents, etc. Generic SNMP Trace window displays SNMP messages exchanged between MIB Browser and SNMP agents. SNMP messages are displayed in raw hexadecimal dump format as well as in the decoded, human-readable format. Therefore, the Generic SNMP Trace window is particularly useful for debugging when developing an SNMP agent and for resolving problems when agents do not properly respond to MIB Browser's queries. MIB Browser lets you take a snapshot of an SNMP agent on the network and then simulate this agent on the computer where MIB Browser runs. Simulating means that MIB Browser runs a separate process, which listens for SNMP queries on a selected network interface and port and responds to SNMP queries, returning exactly the same OIDs and values as the "real" SNMP agent did at the time of taking its snapshot. The enclosed MIB Compiler lets you compile any standard or vendor specific MIB file. The compiled MIB file can then be loaded and utilized by MIB Browser. Generally, MIB files are supplied by vendors of SNMP manageable devices, and contain description of the manageable object hierarchy and object attributes in the SNMP device. In other words, MIB files serve as roadmaps for managing SNMP devices. This product includes Apache Xerces XML Parser for C++ software. For full licensing information refer to the "THIRD-PARTY-LICENSES.TXT" file located in the mibbrowser/doc folder. ============================================================================ 2. Important Licensing Information ---------------------------------- This software package installs the following MG-SOFT's applications: * MIB Browser Professional Edition, * MIB Compiler and * MIB Update Utility MIB Browser Pro. for Linux is available in four different editions: * MIB Browser Professional SNMPv3 Edition (supporting SNMPv1, SNMPv2c and SNMPv3 protocols). * MIB Browser Professional DOCSIS/DH Edition (supporting SNMPv1, SNMPv2c and SNMPv3 protocols as well as the Diffie-Hellman key exchange model for managing DOCSIS-based SNMPv3 agents. Besides, this edition supports IPv6 protocol). * MIB Browser Professional Developer's Edition (supporting SNMPv1, SNMPv2c and SNMPv3 protocols, Diffie-Hellman key exchange model and the Generic SNMP Trace debugging option. Besides, this edition supports IPv6 protocol). * MIB Browser Professional Simulator Edition (supporting SNMPv1, SNMPv2c and SNMPv3 protocols, Diffie-Hellman key exchange model, the Generic SNMP Trace feature, and IPv6 protocol. Furthermore, this edition incorporates the SNMP Agent Simulator). Which of these features will be available in the installed software depends on the purchased license. In addition, to enable reception of SNMP Trap and Inform notification messages in MIB Browser, MG-SOFT SNMP Trap daemon application must be installed from a separate installation package that is bundled with MIB Browser installation package for Linux. ======================================================================== 3. What's New in this Version ----------------------------- Here is a brief summary of major new functions and features in MG-SOFT MIB Browser 2010 Professional Edition release: * SNMP agent simulator. MIB Browser Professional Simulator Edition lets you take a snapshot of an SNMP agent on the network and then simulate this agent on the computer where MIB Browser runs. Simulating means that MIB Browser runs a separate process, which listens for SNMP queries on a selected network interface and port and responds to SNMP queries, returning exactly the same OIDs and values as the "real" SNMP agent did at the time of taking its snapshot. Furthermore, the OIDs, their syntaxes and values in agent snapshot files can be edited. This way, SNMP agent developers can effectively simulate an SNMP agent even before developing one. * Performing multiple operations. The new Multiple Operations window mimics scripting in a sense that you can add any number of SNMP operations to it (Get, GetNext, Set, Trap, etc.), each containing one or more variable bindings, and then start executing these operations against a specified SNMP agent with a single click of a button. The entire list of SNMP operations and variable bindings can be saved to an XML file for later use. This feature can significantly speed up repetitive tasks, like configuring or testing SNMP agents, etc. * Displaying SNMP statistics. The software now automatically collects its SNMP traffic and performance statistics, i.e., the number of SNMP packets received and sent by MIB Browsers since its startup, the number of requested and returned OIDs, the number of received and sent octets in SNMP PDUs, the number of sent SNMP Get, GetNext, GetBulk and Set requests and the number of received SNMP Response messages, etc. For each statistical variable, the SNMP Statistics window displays the total, delta and average values as well as the peak values. * Saving SNMP Traps and Informs to a file. The received SNMP Trap and Inform notification messages displayed in the SNMP Trap Ringer Console can now be saved to a file (either all or only selected notifications). Saved notifications can later be loaded into a separate tab in the SNMP Trap Ringer Console for review or into the Multiple Variable Bindings or the Multiple Operations window in order to send captured SNMP notifications to the network. * Using XML files. All files produced by MIB Browser (e.g., agent profiles file, agent snapshot file, generic trace file, etc), are now in XML file format. To ensure backward compatibility, previous file formats can still be loaded and used in the latest version of MIB Browser. * Updated and enhanced user manuals and help files with numerous hints and usage examples will help you get the most from MG-SOFT's MIB Browser Pro. and other MG-SOFT applications. Besides, a number of minor improvements have been implemented in all included applications, and all known problems occurring in older versions have been fixed for this release. ============================================================================ 4. Installing the Software -------------------------- To install the software on Linux, you need to have the root user privileges. Before the installation, please close all running MG-SOFT's applications and uninstall any previous version of MG-SOFT MIB Browser Professional Edition with MIB Compiler from the system. For uninstalling instructions, check the 'Uninstalling the software' section. For uninstalling the previous versions of MIB Browser, please check the 'Uninstalling MG-SOFT MIB Browser Versions 2.0-11.0' section. The installation requires approximately 70MB of disk space. To install the software, insert the CD containing MG-SOFT MIB Browser Professional Edition software packages, mount the CD, and use a package manager to install the software (e.g., RPM package manager on Red Hat, Mandrake, SuSe distributions and DPKG package manager on Debian-based distributions). The complete installation process involves installing MG-SOFT SNMP Trap daemon package and MG-SOFT MIB Browser package. If you are using a Linux distribution with the RPM package manager, install the RPM package of the software by using the following command in the command prompt: # rpm -ivh mgtrapd-XXX.i386.rpm # rpm -ivh mgmibbrowser_XXX.i386.rpm If you are using a Linux distribution with the DPKG package manager, install the DEB package by using the following command in the command prompt: # dpkg -i mgtrapd_XXX.i386.deb # dpkg -i mgmibbrowser_XXX.i386.deb If you are using the Slackware Linux distribution, install the TGZ package by using the following command in the command prompt: # installpkg mgtrapd-XXX.i386.tgz # installpkg mgmibbrowser_XXX.i386.tgz In case you have KDE or GNOME Environments installed on your machine, the installation will add an entry to the K Menu or Gnome Menu respectively. IMPORTANT: Applying the License =============================== It is necessary to apply a valid license before starting the software (in order to use the software without limitations). To do so, copy your "license.key" file to the following directories: /usr/local/mg-soft/mgtrapd/bin (unlocks SNMP Trap daemon) /usr/local/mg-soft/mgmibbrowser/bin (unlocks MIB Browser, Compiler) Then, start MG-SOFT SNMP Trap daemon by using the following command: # /etc/init.d/mgtrapd start The software has been successfully installed and tested by MG-SOFT on the following Linux distributions: 1) Red Hat Enterprise Linux 4, 5 2) Fedora Core/Fedora 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 3) Mandriva 2007, 2008, 2009, 2010 4) SUSE Linux Enterprise Server/Desktop 10, 11 5) SUSE Linux/openSUSE 10, 10.1, 10.3, 11.2 6) Debian 4.0, 5.0 7) Ubuntu 5.10, 6.06, 7.10, 8.04, 9.10 8) Slackware 12, 13 The software may also work on distributions not tested by MG-SOFT, provided that they meet the following minimum system requirements: - kernel 2.6+ - glib2/libc6 2.3.4-2+ - libstdc++6 3.4.6-11+ In case of any problems, check the TROUBLE_SHOOTING.TXT document installed in the doc/ directory. Starting MIB Browser Professional Edition or MIB Compiler --------------------------------------------------------- There are two ways of starting the installed software. The first and the easiest way is to run the application from the K menu|MG-SOFT MIB Browser|MIB Browser or MIB Compiler (KDE environment), or Gnome menu|MG-SOFT MIB Browser|MIB Browser or MIB Compiler (GNOME environment). The second way is to start the application from the command prompt (xterm or compatible). To start MIB Browser Professional Edition from the command prompt use the following command: # /usr/local/mg-soft/mgmibbrowser/bin/mgmibbrowser.sh To start MIB Compiler from the command prompt use the following command: # /usr/local/mg-soft/mgmibbrowser/bin/mibcgui.sh ============================================================================ 5. Uninstalling the Software ---------------------------- To uninstall the software, you need the root user privileges. Uninstalling MG-SOFT MIB Browser 2010 (Version 12.0) ---------------------------------------------------- If the software has been installed by the RPM package manager, the following command in the command prompt will uninstall MIB Browser Professional Edition with MIB Compiler from your computer: # rpm -e mgmibbrowser_2010 # rpm -e mgtrapd If the software has been installed by the DPKG package manager, use the following command in the command prompt to uninstall MIB Browser Professional Edition with MIB Compiler from your computer: # dpkg -r mgmibbrowser-2010 # dpkg -r mgtrapd On Slackware Linux distribution use the following commands to uninstall MIB Browser Professional Edition with MIB Compiler from your computer: # removepkg mgmibbrowser_2010 # removepkg mgtrapd Uninstalling MG-SOFT MIB Browser Versions 2.0-11.0 -------------------------------------------------- The name of the installation package for MIB Browser versions 2.0-11.0 was different than for the version 2010, hence the commands for uninstalling it are slightly different. The easiest way to uninstall the software is to use the Uninstall menu command in the K menu|MG-SOFT MIB Browser (KDE environment) or Gnome menu|MG-SOFT MIB Browser (Gnome environment). The uninstall procedure can also be invoked by the following command in the command prompt: # mg-mibbrowser-start.sh uninst If the software has been installed by the RPM package manager, the following command in the command prompt will uninstall MIB Browser Professional Edition with MIB Compiler from your computer: # rpm -e mibbrowser If the software has been installed by the DPKG package manager, use the following command in the command prompt to uninstall MIB Browser Professional Edition with MIB Compiler from your computer: # dpkg -r mibbrowser Uninstalling MG-SOFT MIB Browser Version 1.0 -------------------------------------------- The Version 1.0 of MIB Browser for Linux has been packaged differently than Versions 2.0, 9.0, 10.0 and 11.0. Therefore, Version 1.0 might require different unistallation than other versions of the software. For automatic uninstallation of the Version 1.0 of MIB Browser, use the following command in the command prompt: # mg-mibbrowser-start.sh uninst If the uninstallation fails, use the distribution package manager to uninstall the software. For RPM based distributions use the following command: # rpm -e mgmibbpe For DEB based distributions use the following command: # dpkg -r mgmibbpe Note: In versions of the software prior to 2010 (V12), MG-SOFT SNMP Trap daemon is automatically uninstalled with the MIB Browser package. ============================================================================ 6. MG-SOFT Corporation on the Internet -------------------------------------- * MG-SOFT Web Site http://www.mg-soft.com/ * MG-SOFT Products http://www.mg-soft.com/products.html * MG-SOFT Sales Page http://www.mg-soft.com/sales.html * MG-SOFT Support Page http://www.mg-soft.com/support.html * MG-SOFT Corp. Profile http://www.mg-soft.com/profile.html * MIB Browser Professional http://www.mg-soft.com/mgMibBrowserPE.html * Trap Ringer Professional http://www.mg-soft.com/tringer.html * Net Inspector http://www.mg-soft.com/netinsp.html * Performance Manager http://www.mg-soft.com/mgPerformanceManager.html * Visual MIB Builder http://www.mg-soft.com/builder.html * MIB Explorer http://www.mg-soft.com/mgMibExplorer.html * MG-SOFT MIB Compiler http://www.mg-soft.com/mgmibc.html * SNMP Master Agent http://www.mg-soft.com/agent.html * MG-SOFT SNMPv3 engine http://www.mg-soft.com/snmpv3.html Announcing new releases ----------------------- Visit http://www.mg-soft.com/news_announce.html for the latest information about the scheduled software releases and updates. Evaluation software ------------------- Evaluation software is available for downloading from MG-SOFT's web site at http://www.mg-soft.com/download.html To apply for a 30-day evaluation license key, fill in and submit the on-line order form at http://www.mg-soft.com/evalKeyReq.html For immediate software release notifications, subscribe to our mailing list at http://www.mg-soft.com/maillist.html ============================================================================ 7. Ordering the Software ------------------------ To obtain the latest ordering and licensing information, visit http://www.mg-soft.com/sales.html or contact . For details on licensing arrangements for licensing MG-SOFT's software products visit http://www.mg-soft.com/licenseTypes.html ============================================================================ 8. Licensing Agreement ---------------------- Check the LICENSE_AGREEMENT.TXT file that was installed with the software. Also, check the LICENSE_TYPES.TXT file or visit http://www.mg-soft.com/licenseTypes.html for details on various licensing arrangements for licensing MG-SOFT's software products. Contact for additional information. ============================================================================ 9. Contacting MG-SOFT Corporation ---------------------------------- For the latest information about our products, check our WEB site at http://www.mg-soft.com/ or contact us directly. You can subscribe to our mailing lists on-line by submitting the application form at http://www.mg-soft.com/maillist.html If you don't have access to the Internet, let us know by e-mail that you wish to subscribe and we will add you to the list of recipients. For additional information about MG-SOFT Corporation, please contact the following address: MG-SOFT Corporation Phone: +386 2 2506565 Strma ulica 8 Fax: +386 2 2506566 2000 Maribor E-mail: info@mg-soft.com Slovenia Internet: http://www.mg-soft.com/ ============================================================================