This is the "READ_ME.TXT" file distributed with MG-SOFT Trap Ringer Professional Edition with MIB Compiler for Linux. Copyright (C) 1995-2008 MG-SOFT Corporation. All rights reserved. ======================================================================== Table of Contents ----------------- 1. About the Software 2. What's New in this Version 3. Different Editions of Trap Ringer Pro. 4. Installing the Software 5. Starting Trap Ringer and MIB Compiler for Linux 6. Uninstalling the Software 7. MG-SOFT Corporation on the Internet 8. Ordering the Software 9. Licensing Agreement 10. Contacting MG-SOFT Corporation ======================================================================== 1. About the Software --------------------- MG-SOFT Trap Ringer Professional Edition is a program for monitoring SNMPv1, SNMPv2c and SNMPv3 Trap notification messages and SNMPv2c and SNMPv3 Inform notification messages. It lets you manage received notifications in various ways and includes mechanisms for informing users about the received notifications. Trap Ringer lets you monitor received SNMP notifications in the main window by viewing the Console log (used for real-time monitoring) or any other log file created by this application (e.g., a daily log file). Information about received SNMP notifications can also be sent in e-mail or SMS messages to any number of recipients and logged to the system log file. Furthermore, Trap Ringer can invoke external programs upon receiving SNMP notifications in order to start any number of specific actions by providing command line parameters for each of them, as well as generate and periodically update any number of HTML report files that let you monitor SNMP notifications by using a Web browser. In addition, Trap Ringer can also act as an SNMP notification proxy forwarder application, meaning that it can forward received SNMP notifications to other SNMP management stations on the network. SNMP notifications can be forwarded either unchanged or translated to the selected SNMP version and notification type. These diverse features can all be used simultaneously. The software offers advanced filtering capabilities and implements a user-friendly filter creation wizard that helps you configure filters for capturing only those SNMP notifications that match the specified criteria. Trap Ringer also lets you assign different severity levels and colors to SNMP notifications in order to emphasize their importance and provide a better overview of received notification messages. Trap Ringer displays all the details about received notification messages and included variable bindings by retrieving the relevant data from MIB modules that provide this information. The enclosed MG-SOFT MIB Compiler lets you compile any vendor specific MIB file for use with Trap Ringer. The information about received SNMP Trap and Inform notifications can also be exported from Trap Ringer to CSV (comma separated value) ASCII files for the purpose of external viewing or post-processing. Besides supporting the standard IPv4/UDP transport protocol for SNMP notifications messages, Trap Ringer supports also IPv6/UDP transport and can receive SNMP notifications on any IPv4/UDP and IPv6/UDP port. Trap Ringer employs the client/server architecture, where the server module runs as a daemon application, receiving SNMP notifications from the network and processing them according to applied configuration, while the client (running on the same computer as server) provides a graphical user interface for viewing received SNMP notifications and for configuring both Trap Ringer server and client. MG-SOFT Trap Ringer Pro. is available for Linux operating systems running on Intel x86 architecture (Red Hat, Mandriva, SuSE,...), for Microsoft Windows operating systems (Windows ME, Windows 2000, Windows XP, Windows Server 2003, Windows Vista), as well as for Apple Mac OS X (universal binaries for both, Intel x86 and PPC). ======================================================================== 2. What's New in this Version ----------------------------- The following is a brief list of the major new functions and features in MG-SOFT Trap Ringer Professional Edition package for Linux. Trap Ringer Professional Edition for Linux, Version 5.x ------------------------------------------------------- * Sending SMS messages. Trap Ringer can send SMS (Short Message Service) messages to mobile phones to notify users about received SNMP notifications. SMS messages are sent through the connected mobile phone with a built-in modem. The contents of SMS messages can be configured to include desired information about received SNMP notifications. This new feature makes sure you are always alarmed of important network events on time, regardless of your current location. * SNMP notification proxy forwarder. In addition to performing diverse user notifying and logging operations, Trap Ringer can also act as the SNMP notification proxy forwarder, meaning that it can forward received SNMP notification messages to other SNMP managers on the network. Moreover, it can also translate received SNMP notification messages and forward them as SNMPv1 or SNMPv2c or SNMPv3 Trap messages, or as SNMPv2c or SNMPv3 Inform messages. * Create filter from notification wizard. Trap Ringer now lets you select a received SNMP notification and run the filter wizard to create the filter for receiving or blocking the same type of SNMP notifications in no time. The wizard automatically creates the filter conditions that match the attributes of the selected notification. To complete the wizard, simply choose the output unit (e.g., Mail, SMS, Log, etc.) to which you want to attach the filter. * Checking for updates. MIB Browser can automatically check for program updates in regular intervals and offer you the option to download the new version of the software when it is available. This way, you can always stay up to date with the latest release of the software. * Significantly updated and enhanced User Manual with numerous hints and usage examples will help you get the most from MG-SOFT's Trap Ringer Pro. MIB Compiler for Linux, Version 7.0 ----------------------------------- * Modern visual theme and enhanced visual appearance. By default, MIB Compiler graphical user interface now displays the Modern visual theme (a set of bitmaps for GUI components such as toolbar buttons, MIB tree icons, menus, etc., that affect the appearance of the application). Compared to Classic theme, Modern visual theme uses a higher number of colors (potentially up to 16,7 million colors). * Updated and enhanced User Manual with numerous hints and usage examples will help you get the most from MG-SOFT's MIB Compiler. Besides, a number of minor improvements has been implemented in these applications, and all known problems occurring in older versions have been fixed for this release. ======================================================================== 3. Different Editions of Trap Ringer Pro. ----------------------------------------- MG-SOFT Trap Ringer Pro. package for Linux is available in five different editions. All editions support receiving SNMPv1, SNMPv2c and SNMPv3 Trap notification messages, as well as SNMPv2c and SNMPv3 Inform notification messages. All editions also offer the same notification processing options. Editions are different regarding the number of supported SNMP agents from which Trap Ringer will receive SNMP notifications and regarding the support for the IPv6 protocol. The following editions of MG-SOFT Trap Ringer Pro. for Linux are available: * Trap Ringer Professional TR0016 Edition This edition supports receiving SNMP notifications from up to 16 different SNMP notification sources. * Trap Ringer Professional TR0064 Edition This edition supports receiving SNMP notifications from up to 64 different SNMP notification sources. Besides, this edition supports IPv6 protocol. * Trap Ringer Professional TR0256 Edition This edition supports receiving SNMP notifications from up to 256 different SNMP notification sources. Besides, this edition supports IPv6 protocol. * Trap Ringer Professional TR1024 Edition This edition supports receiving SNMP notifications from up to 1024 different SNMP notification sources. Besides, this edition supports IPv6 protocol. * Trap Ringer Professional TRXXXX Edition This edition supports receiving SNMP notifications from any number of SNMP notification sources. Besides, this edition supports IPv6 protocol. ======================================================================== 4. Installing the Software -------------------------- To install the software on Linux, you need to have the root user privileges. Otherwise, the installation software cannot install the system files in the system directories. Before installing the software, please close all running MG-SOFT's applications and uninstall any previous version of MG-SOFT Trap Ringer Pro. with MIB Compiler for Linux from the system. For uninstalling instructions, check the 'Uninstalling the software' section below. The installation requires approximately 80MB of disk space. To install the software, insert the CD containing MG-SOFT Trap Ringer Professional Edition for Linux software package, mount the CD drive, and use a package manager to install the software (e.g., RPM package manager on Red Hat, Mandrake, SuSe distributions, DPKG package manager on Debian distributions, etc.). 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 -i trapringer-XXX.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 trapringer-XXX.deb If you are using the Slackware Linux distribution, install the TGZ package by using the following command in the command prompt: # ./tgz-install.sh trapringer-XXX.tgz In case you have KDE or GNOME Environments installed on your computer, the installation will add an entry to the K Menu or Gnome Menu, respectively. IMPORTANT: ---------- When the software is installed on the hard drive, you need to copy the license.key file to /usr/local/mg-soft/trapringer/bin folder and start MG-SOFT Trap daemon (mgtrapd) and Trap Ringer daemon (mgtringerd). Without a valid license.key file, the software will run in a restricted evaluation mode. To copy the license.key file from a floppy disk to the folder whereto you installed Trap Ringer, use the following commands: mount /dev/fd0 /mnt/floppy -t msdos cp /mnt/floppy/license.key /usr/local/mg-soft/trapringer/bin/ umount /mnt/floppy Note that the "license.key" file name must contain only lower case letters (i.e., "LICENSE.KEY" file will *not* be accepted). Then, restart the computer. Instead of restarting the computer, you can start MG-SOFT Trap daemon (mgtrapd) and Trap Ringer daemon (mgtringerd) manualy by using the following commands: # /etc/init.d/mgtrapd start # /etc/init.d/mgtringerd start If the path to MG-SOFT Trap daemon and Trap Ringer daemon start/stop script in your distribution is different, change it accordingly. Supported Distributions ----------------------- The software has been successfully installed and tested by MG-SOFT on the following Linux distributions: 1.) Red Hat Linux 9.0 2.) Red Hat Enterprise Linux 3, 4, 5 3.) Fedora Core 1, 2, 3, 4, 5, 6, 7, 8 4.) Mandrake/Mandriva 9.2 - 10.2, 2005 - 2008 5.) SUSE Linux Enterprise Server and Desktop 9 and 10 6.) SUSE Linux/openSUSE 9.0 - 10.3 7.) Debian 3.1, 4.0 8.) Ubuntu 6.06, 7.10, 8.04 9.) Slackware 9.1 - 12.0 The software may also work on distributions not tested by MG-SOFT. In case of any problems, check the TROUBLE_SHOOTING.TXT document installed in the doc/ directory. Additional installation notes on Fedora Core 4-8, Red Hat Enterprise Linux 4-5, Mandriva 2005-2008, Debian 3.1-4, Ubuntu 6.06-8.04 -------------------------------------------------------------------- Because Fedora Core 4+, Red Hat Enterprise Linux 4+, Mandriva 2005+, Debian 3.1+ and Ubuntu 6.06+ distributions do not install the required standard C++ compatibility library from GCC 3.3 by default, this library needs to be installed manually before installing MIB Browser. Fedora Core 4, 5, 6, 7, 8 ------------------------- On Fedora Core 5, 6, 7 and 8, you need to install the compatibility standard C++ libraries from GCC 3.3 (compat-libstdc++-33). To download these libraries from FC repositories and install them, use the following command: yum install compat-libstdc++-33 Red Hat Enterprise Linux 4 -------------------------- On the Red Hat Enterprise Linux 4 CD2, is a file called compat-libstdc++-33-3.2.3-47.3.i386.rpm. This library (file) has to be installed before installing MIB Browser. To install this library, use the following command: # rpm -i /mnt/cdrom/RedHat/RPMS/compat-libstdc++-33-3.2.3-47.3.i386.rpm /mnt/cdrom is the directory where your CDROM is mounted. Red Hat Enterprise Linux 5 -------------------------- On the Red Hat Enterprise Linux 5 CD2, is a file called compat-libstdc++-33-3.2.3-61.i386.rpm. This library (file) has to be installed before installing MIB Browser. To install this library, use the following command: # rpm -i /mnt/cdrom/Server/compat-libstdc++-33-3.2.3-61.i386.rpm /mnt/cdrom is the directory where your CDROM is mounted. Mandriva 2005 ------------- On the Mandriva 2005 CD2, is a file called libstdc++5-3.3.4-4mdk.i586.rpm. This library (file) has to be installed before installing MIB Browser. To install this library, use the following command: # rpm -i /mnt/cdrom/media/main2/libstdc++5-3.3.4-4mdk.i586.rpm /mnt/cdrom is the directory where your CD drive is mounted. Mandriva 2006 ------------- On the Mandriva 2006 DVD, is a file called libstdc++5-3.3.6-1mdk.i586.rpm. This library (file) has to be installed before installing MIB Browser. To install this library, use the following command: # rpm -i /mnt/cdrom/media/main/libstdc++5-3.3.6-1mdk.i586.rpm /mnt/cdrom is the directory where your DVD drive is mounted. Mandriva 2007 ------------- On the Mandriva 2007 DVD, is a file called libstdc++5-3.3.6-3mdk.i586.rpm. This library (file) has to be installed before installing MIB Browser. To install this library, use the following command: # rpm -i /mnt/cdrom/i586/media/main/libstdc++5-3.3.6-3mdk.i586.rpm /mnt/cdrom is the directory where your DVD drive is mounted. Mandriva 2008 ------------- Mandrake 2008 distribution media do not include the compatibility standard C++ libraries from GCC 3.3. You need to download these libraries from an Internet repository, e.g., by using the following command: # urpmi libstdc++5 To add an official repository to the Mandriva Media Manager, use the following commands: Gnome menu -> Install & Remove Software -> Options -> Media Manager -> Add -> Distribution Sources -> Yes ->