This is the "READ_ME.TXT" file distributed with MG-SOFT Trap Ringer Professional Edition with MIB Compiler for Mac. Copyright (C) 1995-2008 MG-SOFT Corporation. All rights reserved. ======================================================================== Table of Contents ----------------- 1. About the Software 2. Different Editions of Trap Ringer Pro. 3. Installing the Software 4. Starting Trap Ringer and MIB Compiler for Mac 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 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 Apple Mac OS X (universal binaries for both, Intel x86 and PPC), for Linux operating systems running on Intel x86 architecture (RedHat, Mandrake/Mandriva, SuSE,...), as well as for Microsoft's 32-bit and 64-bit Windows operating systems (Windows ME, Windows 2000, Windows XP, Windows Server 2003, Windows Vista). ======================================================================== 2. Different Editions of Trap Ringer Pro. ----------------------------------------- MG-SOFT Trap Ringer Pro. package for Mac 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 Mac 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. ======================================================================== 3. Installing the Software -------------------------- To install the software on Mac OS X, you need to have admin user privileges. Make sure you are installing the latest version of the software, available from http://www.mg-soft.com/download.html Before installing, please close all running MG-SOFT's applications and uninstall any previous version of MG-SOFT Trap Ringer Pro from the system. For uninstalling instructions, please see the 'Uninstalling the software' section of this file. To install the software double-click the relevant .dmg file and run the included setup.mpkg file (you need the admin user privileges). Follow the installer on-screen guidelines. You should reboot the computer if the installer prompts you to do so. The software has been successfully installed and tested by MG-SOFT on: - Mac OS X v10.4.x Tiger (Intel x86 and PPC) - Mac OS X v10.5.x Leopard (Intel x86 and PPC) In case of problems, please refer to the "TROUBLE_SHOOTING.TXT" document located in the doc/ directory. Manually applying license.key file ---------------------------------- When manually applying the license key (i.e., not through the installer), copy a valid "license.key" file to the following directories: "/Library/Application Support/mg-soft/License/trapringer/" "/Library/Application Support/mg-soft/License/trapdaemon/" Then, restart the computer. Instead of restarting the computer, you can also execute the start/stop scripts by using the following commands: To start MG-SOFT SNMP Trap daemon: # sudo launchctl load /Library/LaunchDaemond/mgtrapd.plist To start MG-SOFT Trap Ringer daemon: # sudo launchctl load /Library/LaunchDaemond/mgtringerd.plist ======================================================================== 4. Starting Trap Ringer and MIB Compiler for Mac ------------------------------------------------ Run the applications from the Finder in /Applications/MG-SOFT Trap Ringer Pro folder. IMPORTANT: ---------- In order for Trap Ringer to receive SNMP Trap and Inform messages, MG-SOFT's SNMP Trap daemon must be started before any other trap receiving daemons/processes. ======================================================================== 5. Uninstalling the Software ---------------------------- To uninstall the software, double-click the "Uninstall Trap Ringer Pro" entry in the Finder (/Applications/MG-SOFT Trap Ringer Pro). Manual Removal of the Software ------------------------------ In case you want to remove the software manually, the following directories and files should be removed from the system: # rm -Rf /usr/local/mg-soft/common/bin/mgtringerd # rm -Rf /usr/local/mg-soft/common/bin/mgtringerd.plist # rm -Rf /Applications/MG-SOFT Trap Ringer Pro/ # rm -Rf /Library/LaunchDaemons/mgtringerd.plist # rm -Rf /Library/Application Support/mg-soft/License/trapringer # rm -Rf /Library/Application Support/mg-soft/TrapRingerPro In case this is the only MG-SOFT product installed on your computer, you can also remove the following directories and files: # rm -Rf /usr/local/mg-soft # rm -Rf /etc/mg-soft # rm -Rf /Library/LaunchDaemons/mgtrapd.plist ======================================================================== 6. MG-SOFT Corporation on the Internet -------------------------------------- * MG-SOFT Web Site http://www.mg-soft.com/ * Secure On-line orders http://www.mg-soft.com/pricelst.html * MG-SOFT Products http://www.mg-soft.com/products.html * MG-SOFT Download Page http://www.mg-soft.com/download.html * MG-SOFT Support Page http://www.mg-soft.com/support.html * MG-SOFT Corp. Profile http://www.mg-soft.com/profile.html * Network Management ToolBox http://www.mg-soft.com/mgNetManToolBox.html * SNMP Agent Design Kit http://www.mg-soft.com/agentDesignKit.html * MIB Browser Professional http://www.mg-soft.com/mgMibBrowserPE.html * Visual MIB Builder http://www.mg-soft.com/builder.html * Net Inspector http://www.mg-soft.com/netinsp.html * SNMP MIB Query Manager http://www.mg-soft.com/mgQueryManager.html * Trap Ringer Professional http://www.mg-soft.com/tringer.html * MIB Explorer http://www.mg-soft.com/mgMibExplorer.html * MG-SOFT MIB Compiler http://www.mg-soft.com/mgWinMIB.html * SNMP Master Agent http://www.mg-soft.com/agent.html * EasyAgent Source Code Gen. http://www.mg-soft.com/mgSrcGen.html * MG-SOFT SNMPv3 engine http://www.mg-soft.com/snmpv3.html * MG-SOFT WinSNMP SDK http://www.mg-soft.com/mgWinSNMP.html * MG-SOFT WinMIB SDK http://www.mg-soft.com/mgmibc.html * SNMP EasyAgent toolkit http://www.mg-soft.com/easyagent.html * WPDECO32 protocol decoder http://www.mg-soft.com/dll-deco.html Announcing New Releases ----------------------- Visit http://www.mg-soft.com/announce.html for the latest information about the scheduled software releases and updates. For immediate software release notifications, subscribe to our mailing list at http://www.mg-soft.com/maillist.html ======================================================================== 7. Ordering the Software ------------------------ Visit http://www.mg-soft.com/sales.html or contact to obtain the latest ordering and licensing information. Prior to ordering the software, visit http://www.mg-soft.com/licenseTypes.html for details on various licensing arrangements for licensing MG-SOFT's software products. ======================================================================== 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 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/ ========================================================================