OpenSMART User Guide

Ulrich Herbst

Holger Schultheiss


Table of Contents

1. Introduction
1.1. About This Book
1.1.1. Faces used in this book
1.1.2. Names used in this book
2. OpenSMART for New Users
3. The OpenSMART server
3.1. Configuration Server
3.1.1. Description
3.1.2. Configuration
3.1.3. Test the configuration server
3.2. Notify Server
3.2.1. Description
3.2.2. Configuration
3.2.3. Test the notify server
3.2.4. Troubleshoot the notify server
3.3. Collector Server
3.3.1. Description
3.3.2. Configuration
3.3.3. Test the collector server
3.3.4. Troubleshoot the collector server
3.4. Deployment Server
3.4.1. Description
3.4.2. Configuration
3.4.3. Test the deployment server
3.4.4. Troubleshoot the deployment server
3.5. osmart-updater
3.5.1. Description
3.5.2. Configuration
3.5.3. Test osmart-updater
3.5.4. Troubleshoot osmart-updater
3.6. archiver
3.6.1. Description
3.6.2. What to archive ?
3.6.3. Configuration
3.7. archive_errors
3.8. capacity-manager
3.8.1. Description
3.9. Configure Reporting
3.9.1. Templates for Online Reporting
3.9.2. Manual distinction between checkpoint/non-checkpoint reporting
3.10. OpenSMART's SLA-Reporting
3.11. The OpenSMART GUIs
3.11.1. Monitor GUI
3.11.2. Config GUI
3.11.3. ServDoc GUI
3.11.4. Report GUI
3.11.5. Deployment GUI
3.11.6. RSS Feeds
3.12. Logging with Log4perl
3.12.1. Logging without Log::Log4perl
3.12.2. What is Log::Log4perl and why does OpenSMART use it ?
3.12.3. Configure Log4perl
4. The OpenSMART agent
4.1. osagent
4.1.1. Description
4.1.2. Configuration
4.1.3. Test osagent
4.2. osreporter
4.2.1. Description
4.2.2. Configuration
4.2.3. Test osreporter
4.3. osagent.conf.xml
4.3.1. Description
4.3.2. Configuration
4.4. Logging with Log4perl
5. Install OpenSMART
5.1. Names used in this chapter
5.2. Installation for the OpenSMART server parts
5.2.1. Overview of OpenSMART installation (server parts)
5.2.2. Prerequisites for OpenSMART server
5.2.3. Create an OpenSMART User
5.2.4. Directory Structure
5.2.5. Copy OpenSMART-Server-Files to directory tree
5.2.6. Web server configuration
5.2.7. Database configuration
5.2.8. Installation of the OpenSMART deployment server
5.2.9. Other Configuration on the server side
5.2.10. Tune some OpenSMART settings
5.2.11. Install the documentation
5.3. Installation for the OpenSMART client (agent-) parts
5.3.1. Overview of OpenSMART installation (agent parts)
5.3.2. Prerequisites for OpenSMART agent
5.3.3. Create an OpenSMART User
5.3.4. Directory Structure
5.3.5. Copy OpenSMART-Agent-Files to directory tree
5.3.6. Installing OpenSMART Agent on Windows
5.3.7. Other Configuration on the client/agent side
5.3.8. Test osagent
5.3.9. Cronjobs
5.3.10. Logging
6. OpenSMART - Configuration
6.1. Configuration for the OpenSMART - Server
6.2. Configuration for the OpenSMART - Agent
7. Test the OpenSMART Installation
8. Start OpenSMART
8.1. Start the OpenSMART collector server
8.2. Start the OpenSMART frontend
8.3. Start the OpenSMART agent
9. Configure the OpenSMART agents
9.1. Where is the configuration ?
9.2. What checks are available ?
9.3. Some examples for osagent.conf.xml
9.4. Using XML include files for osagent.conf.xml
9.5. Things common to all XML tags in OpenSMART
9.6. Tags to configure osagent
9.7. Tags to configure osreporter
9.8. Tags Common to All Checks and/or Checkpoints
9.8.1. Tags Common to All Checks
9.8.2. Tags Common to All Checkpoints
9.9. Tags used in more than one Checkpoint
9.9.1. Credentials / Userids / Passwords
9.10. Configuration for the aixswraid check.
9.11. Configuration for the db2ts check.
9.12. Configuration for the db2lck check
9.13. Configuration for the db2applications check
9.14. Configuration for the db2connect check
9.15. Configuration for the disk check.
9.16. Configuration for the dns check
9.17. Configuration for the errpt check
9.18. Configuration for the eventlog check
9.19. Configuration for the hparray check.
9.20. Configuration for the ftp check
9.21. Configuration for the hylafax check
9.22. Configuration for the load check.
9.23. Configuration for the logs check.
9.24. Configuration for the lpd check.
9.25. Configuration for the lvmfreespace check.
9.26. Configuration for the lxswraid check.
9.27. Configuration for the mailq check.
9.28. Configuration for the mqs check
9.29. Configuration for the mqclearing check.
9.30. Configuration for the mqconnect check
9.31. Configuration for the mysql check
9.32. Configuration for the mysqlconnect check
9.33. Configuration for the ntp check.
9.34. Configuration for the ntp-remote check
9.35. Configuration for the nbu check.
9.36. Configuration for the oraasmfreespace check.
9.37. Configuration for the oraax check.
9.38. Configuration for the orainvobj check.
9.39. Configuration for the orasessions check
9.40. Configuration for the oratnsping check
9.41. Configuration for the orats check.
9.42. Configuration for the oralck check
9.43. Configuration for the ping check
9.44. Configuration for the proc check.
9.45. Configuration for the raid3ware check.
9.46. Configuration for the readfile check.
9.47. Configuration for the simple check
9.48. Configuration for the smtp check
9.49. Configuration for the soap check.
9.50. Configuration for the sockets check.
9.51. Configuration for the sunswraid check.
9.52. Configuration for the swap check.
9.53. Configuration for the services check.
9.54. Configuration for the webapp check.
9.55. Configuration for the websphere check
9.56. Configuration for the xen check.
9.57. Configuration for the template check.
10. How can I monitor Application XXX ?
10.1. Monitoring apache.
10.1.1. Checks for monitoring apache
10.1.2. Example configuration for monitoring apache
10.2. Monitoring Oracle Databases.
10.2.1. Checks for monitoring Oracle Databases
10.2.2. Example configuration for monitoring Oracle Databases
10.3. Monitoring MySQL Databases.
10.3.1. Checks for monitoring MySQL Databases
10.3.2. Example configuration for monitoring MySQL Databases
10.4. Monitoring hylafax.
10.4.1. Checks for monitoring hylafax
10.4.2. Example configuration for monitoring hylafax
10.5. Monitoring DB2 Databases.
10.5.1. Checks for monitoring DB2 Databases
10.5.2. Example configuration for monitoring DB2 Databases
10.6. Monitoring sendmail.
10.6.1. Checks for monitoring sendmail
10.6.2. Example configuration for monitoring sendmail
10.7. Monitoring WebSphere Application Server.
10.7.1. Checks for monitoring WebSphere application server
10.7.2. Example configuration for monitoring WebSphere
10.8. Monitoring your Xen domain (especially Dom0)
10.8.1. Checks for monitoring a Xen Dom0
10.8.2. Example configuration for monitoring a Xen Dom0 domain
11. Upgrade OpenSMART
11.1. Upgrade from OpenSMART 1.2
11.1.1. Upgrade OpenSMART server from OpenSMART 1.2
11.1.2. Upgrade OpenSMART agent from OpenSMART 1.2/1.1 via Deployment-Server
11.2. Upgrade from OpenSMART 1.1
11.2.1. Upgrade OpenSMART server from OpenSMART 1.1
11.2.2. Upgrade OpenSMART agent from OpenSMART 1.1/1.0.1 via Deployment-Server
11.3. Upgrade from OpenSMART 1.0
11.3.1. Upgrade OpenSMART server from OpenSMART 1.0
11.3.2. Upgrade OpenSMART agent from OpenSMART 1.0 via Deployment-Server
12. Appendix
12.1. Database configuration for OpenSMART
12.1.1. PostgreSQL and OpenSMART
12.1.2. MySQL and OpenSMART
12.1.3. Oracle and OpenSMART
12.1.4. DB2 and OpenSMART
12.2. How to create a tiny OpenSMART agent installation
12.3. How to monitor IBM's Virtual-IO-Server (VIO) with OpenSMART
Glossary
Index

List of Examples

3.1. A very easy example
3.2. A more advanced example with named SQL statements