OpenNMS on Debian Woody HOWTO

1. About this Document

• 1.1 Revision History
• 1.2 Acknowledgements and Thanks
• 1.3 Copyright Information
• 1.4 How this document was created
• 1.5 Feedback and comments
• 1.6 Why Debian Linux and this Document template?
• 1.7 Using Debian Woody vs. Debian Sid or Debian Sarge

2. OpenNMS Package Sources

• 2.1 Apt sources for OpenNMS on Woody
• 2.2 Notes from the package maintainers

3. Staging a Debian Woody Server

• 3.1 Operating System Installation Goals
• 3.2 Download and burn the CD images
• 3.3 Booting the Debian Installation CD-ROMs
• 3.4 The GNU/Linux Installation Main Menu (10-20min)
• 3.5 Package Configuration

4. Installing and Configuring OpenNMS on Debian Woody

• 4.1 Add OpenNMS sources and upgrade
• 4.2 Install Sun J2SDK 1.4.0_02-1
• 4.3 Install OpenNMS 1.1.2-1woody
• 4.4 Post Installation Modifications for 1.1.2-1woody
• 4.5 OpenNMS Configuration HOWTOs

5. OpenNMS Administration

• 5.1 Server Startup and Shutdown
• 5.2 Enabling Maps
• 5.3 Database Maintenance
• 5.4 Backing Up and Restoring OpenNMS Configuration
• 5.5 OpenNMS Log Files

6. Further Configuration

• 6.1 Questions answered in the online FAQ
• 6.2 Custom Reports
• 6.3 Integration with a Jabber server
• 6.4 Configuring Thresholds
• 6.5 Modifying the Notification Email Source
• 6.6 Collecting SNMP Data on multiple Ports
• 6.7 How to add Sound to Events
• 6.8 Add Flashing lights and Text-to-Speech to OpenNMS
• 6.9 How to further re-parent OpenNMS nodes in the maps
• 6.10 How to add additional administrators
• 6.11 How to manually add a device OpenNMS while it is running
• 6.12 How to change Event Colors
• 6.13 How to modify console graphics
• 6.14 How to use an analog line and a modem for notifications
• 6.15 Configuring Notifications base on %parm[#1]%
• 6.16 Suppressing Traps from Specific Hosts
• 6.17 Mib2opennms Usage Notes
• 6.18 Specific Device Configurations
• 6.19 Using OpenNMS to monitor Scripts

7. Troubleshooting

• 7.1 Questions Answered in the Online FAQ
• 7.2 OpenNMS Console Display Problems
• 7.3 Problems running other daemons
• 7.4 Log File Messages
• 7.5 Customization Problems
• 7.6 Error in varbinds with Extreme and Cisco devices
• 7.7 Error detecting SNMP on some devices that support it
• 7.8 OpenNMS only partially resolving IPs
• 7.9 Error Trying to Rescan a Node from WebGUI

8. Tools and Packages that compliment OpenNMS

• 8.1 OpenNMS Document Server
• 8.2 Network connectivity tools
• 8.3 Network diagnostic tools
• 8.4 Network security tools
• 8.5 Database tools
• 8.6 System Resource Monitoring
• 8.7 Tools requiring an XServer
• 8.8 Other tools

9. Further Information

• 9.1 About the OpenNMS Project
• 9.2 Related Links
• 9.3 The following URLs are relevant to OpenNMS code or documentation:

10. Appendices

• 10.1 Appendix A - 1.1.2 Initial Package Listing
• 10.2 Appendix B - 1.1.1 Final Package Listing
• 10.3 Appendix C - 1.1.2-1 Final Package Listing
• 10.4 Appendix D - 1.1.2-1 installation transcript
• 10.5 Appendix E - 1.1.2-1 installation transcript with opennms-db