http://docs.opsview.org/ 2010-03-21T17:43:57+00:00 http://docs.opsview.org/ http://docs.opsview.org/lib/images/favicon.ico text/html 2010-03-19T17:27:18+00:00 Ton Voon http://docs.opsview.org/doku.php?id=developer:nagiosbrokermodules&rev=1269019638&do=diff This is a way of extending functionality in Nagios without having to alter core code. This is similar to how apache have different modules for other functionality. Name This should be of the format opsview_{description}. Template Use an existing broker module as a template. You will have to change which functions it needs to register for. text/html 2010-03-19T15:23:24+00:00 Ton Voon http://docs.opsview.org/doku.php?id=developer&rev=1269012204&do=diff This section holds information for developers of Opsview. Development * Contributing * Code repository * Setting up a development server * Style Guide * Branches Opsview Configuration * Updating Initial Configuration Web UI * Using Scriptaculous JS * Using Javascript Graphs * Viewports * Events view * Web Security * Access Control * Web screens * Internationalisation * Translators * Web Exceptions * Validation * Catalyst Views * Menus * Popup menus … text/html 2010-03-19T09:54:26+00:00 James Peel http://docs.opsview.org/doku.php?id=opsview-community:ports&rev=1268992466&do=diff TCP Ports used by Opsview: * 80 (apache) - required for access to Opsview * 3000 (opsview-web) - Opsview web application. By default, listens on all interfaces * 5667 (nsca) - Required for distributed monitoring. Listens on 127.0.0.1 * 5666 (nrpe / opsview-agent) - By default, listens on all interfaces * 3306 (mysql) - mysql database connection. Default depends on distribution * 2345 (NMIS) - For NMIS. Only in distributed environments. Binds to 127.0.0.1 text/html 2010-03-19T09:49:49+00:00 Ton Voon http://docs.opsview.org/doku.php?id=opsview-community:solaris-installation&rev=1268992189&do=diff Before you start * For supported Sun Solaris releases please refer to platforms. Planning Planning your system should take into account how many hosts you plan on monitoring - large numbers of hosts being monitored may best be served by using a distributed system - see our design notes for further information. text/html 2010-03-19T09:49:33+00:00 Ton Voon http://docs.opsview.org/doku.php?id=opsview-community:centos-installation&rev=1268992173&do=diff Before you start * For supported CentOS Linux releases please refer to platforms. * Please ensure perl 5.8.8-15.el5_2.1 or newer is installed to resolve a performance problem. Planning Planning your system should take into account how many hosts you plan on monitoring - large numbers of hosts being monitored may best be served by using a distributed system - see our design notes for further information. text/html 2010-03-19T09:49:15+00:00 Ton Voon http://docs.opsview.org/doku.php?id=opsview-community:rhel-installation&rev=1268992155&do=diff Before you start * For supported Red Hat Enterprise Linux releases please refer to platforms. * Please ensure perl 5.8.8-15.el5_2.1 or newer is installed to resolve a performance problem. Planning Planning your system should take into account how many hosts you plan on monitoring - large numbers of hosts being monitored may best be served by using a distributed system - see our design notes for further information. text/html 2010-03-19T09:48:58+00:00 Ton Voon http://docs.opsview.org/doku.php?id=opsview-community:ubuntu-installation&rev=1268992138&do=diff Before you start * For supported Ubuntu releases please refer to platforms. Known issues Note: On Ubuntu Hardy, an issue has been raised where Opsview Web will not start up with these errors: ERROR - Errors encountered: Caught exception in Opsview::Web::Controller::Status::Service->default "DBD::mysql::st execute failed: Lost connection to MySQL server during query ERROR - Caught exception in Opsview::Web::Controller::Root->end "Can't insert new Opsview::Auditlog: DBI connect('database=o… text/html 2010-03-19T09:38:26+00:00 Ton Voon http://docs.opsview.org/doku.php?id=opsview-community:debian-installation&rev=1268991506&do=diff Before you start * For supported Debian releases please refer to platforms. Planning Planning your system should take into account how many hosts you plan on monitoring - large numbers of hosts being monitored may best be served by using a distributed system - see our design notes for further information. text/html 2010-03-19T09:08:33+00:00 Ton Voon http://docs.opsview.org/doku.php?id=opsview-community:opsviewconfigfiles&rev=1268989713&do=diff Most configuration is performed via Web User Interface. However some less common system options are located in configuration files. opsview.conf This is the main configuration file for Opsview, it can be found in /usr/local/nagios/etc. Make your local changes to this file. text/html 2010-03-18T15:00:29+00:00 Ton Voon http://docs.opsview.org/doku.php?id=developer:notificationmethods&rev=1268924429&do=diff These are scripts that are invoked by Nagios when a notification needs to be sent. Within Opsview, the notificationmethods table lists all the notification types available. There are two types of configuration for notifications: * global. This needs to be set for the notification method itself (eg, a mailserver) * per-contact. These are set for each contact (eg, an email address) text/html 2010-03-17T16:10:21+00:00 Ton Voon http://docs.opsview.org/doku.php?id=developer:webscreens&rev=1268842221&do=diff To add a new class of screen: * Add model (link to model stuff) * Copy an existing lib/Opsview/Web/Controller/Admin/*.pm to new name * Copy an existing root/admin/*/list_functions and root/admin/*/edit_functions into a new dir * Update list text/html 2010-03-16T13:57:41+00:00 Ton Voon http://docs.opsview.org/doku.php?id=developer:model&rev=1268747861&do=diff The model is changed at the controller specification: __PACKAGE__->config( model_name => 'OpsviewSchema::Contact', ); OpsviewSchema refers to the DBIx::Class model, whereas OpsviewDB refers to the Class::DBI model. Switching over is a case of changing this variable. Reads should just work. More effort required for saves. text/html 2010-03-16T13:39:38+00:00 Ton Voon http://docs.opsview.org/doku.php?id=developer:databasemodel&rev=1268746778&do=diff Upgrades Update the upgradedb_{db}.pl script with the required changes for an existing database. Use the next schema version number, based on the branch (or instance, if changing BRAN-3.3, use a schema version of “3.3”). For the sub version number, start from 1. text/html 2010-03-16T09:55:28+00:00 Ton Voon http://docs.opsview.org/doku.php?id=rancid-latest:troubleshooting&rev=1268733328&do=diff I've added a new host, but there isn't a SVN entry created When a reload occurs, Opsview will generate a list of all the hosts that have RANCID enabled. However, if the websvn repository doesn't show the host, then maybe the message has not been passed through. Check the timestamp of the following directory: text/html 2010-03-16T09:51:54+00:00 James Peel http://docs.opsview.org/doku.php?id=rancid&rev=1268733114&do=diff Overview The Opsview RANCID Module provide Opsview Enterprise edition integration with the RANCID network infrastructure managment tool. From the RANCID homepage: RANCID monitors a router's (or more generally a device's) configuration, including software and hardware (cards, serial numbers, etc) and uses CVS (Concurrent Version System) or Subversion to maintain history of changes. RANCID has been integrated into Opsview via add-on modules (please see the commercial information page for de… text/html 2010-03-15T16:47:49+00:00 Ton Voon http://docs.opsview.org/doku.php?id=developer:addingtabs&rev=1268671669&do=diff This describes changes required to convert an existing admin configuration page into a tabbed layout. Set tabs in controller In auto: my $tabs = ["Contact", "Notification Details"]; $c->stash( tabs => $tabs ); Create templates Take existing edit_form_fields and convert to tab: