BRU SERVER PLUGIN FOR NAGIOS(r) COPYRIGHT AND LEGAL INFORMATION ------------------------------------------------------------------------------ Copyright (c) 2011, TOLIS Group, Inc. All rights reserved. TOLIS Group, BRU, BRU Server, the BRU graphic, and the TOLIS Group logo are servicemarks, trademarks, or registered trademarks owned by TOLIS Group, Inc. Nagios, the Nagios logo, and Nagios graphics are the servicemarks, trademarks, or registered trademarks owned by Nagios Enterprises. Note: While Nagios is an open-source application, BRU, BRU Server, and the components of BRU Server are not open-source applications, public-domain, or shareware. A license for BRU Server can be obtained by contacting TOLIS Group, Inc. at the information below. TOLIS Group, Inc. 8687 E Via de Ventura Suite 115 Scottsdale, AZ 85258 Tel: 480-505-0488 Fax: 480-505-0492 Web: http://www.tolisgroup.com | http://www.bru.com VERSION AND RELEASE NOTES ------------------------------------------------------------------------------ Version: 1.0 - Initial Release This is the initial release of the plugin. INSTALLATION ------------------------------------------------------------------------------ The installation of this plugin is faily straight forward since it's about the same as with any other Nagios plugin. 1. Copy the 'check_bruserver' file into your Nagios plugin directory. Some installations have this at /usr/lib/nagios/plugins and other installations use the default /usr/local/nagios/plugins. 2. Add the command definition, shown below, to the commands.cfg file. 3. Add the service definitions for the Agent systems. A sample service definition is shown below in the "Example Service Definitions" section. 4. Add the service definition for the Server system. A sample service definition is shown below in the "Example Command Definitions" section. 5. Check with Nagios to verify that the changes made are all valid. You can do this by running the following command: nagios -v Some installations have the config file located at /etc/nagios/nagios.cfg and others have it at the default /usr/local/nagios/etc/nagios.cfg. Use the appropriate path for your Nagios installation. If there are no errors, proceed to the next step. Otherwise, you'll need to correct any errors reported before restarting Nagios. 6. For Nagios installations that do not use xinitd, you'll need to manually restart the Nagios process for the changes to take affect. EXAMPLE SERVICE DEFINITIONS ------------------------------------------------------------------------------ Here are two sample service definitions for Nagios: # Define a service for the BRU Server Agent define service { use generic-service host_name client1,client2,client3 service_description BRU Server Agent Daemon check_command check_bruserver! agent } # Define a service for the BRU Server Server define service { use generic-service host_name serversys service_description BRU Server Server Daemon check_command check_bruserver! server } Change the above fields as needed for your Nagios configuration. EXAMPLE COMMAND DEFINITIONS ------------------------------------------------------------------------------ Here is the command definitions applied in the commands.cfg file. # 'check_bruserver' command definition define command { command_name check_bruserver command_line $USER1$/check_bruserver $HOSTADDRESS$ $ARG1$ } There really isn't much that needs to be changed above since doing so will require that you change the name of the 'check_bruserver' file and other system wide changes.