1. © 2009 GroundWork Open Source, Inc. PROPRIETARY INFORMATION: Information contained herein is not for use or disclosure outside of GroundWork Open Source, Inc. © 2007 GroundWork Open Source, Inc. Getting Started with GroundWork Monitor GroundWork Monitor Enterprise Edition 6.2 Page 1

2. © 2009 GroundWork Open Source, Inc. Page 2 Configuration Nagios Configuration Schema Configuration Tool Overview Setting Up Hosts Course Objectives for this Module Getting Started with GroundWork Monitor

3. © 2009 GroundWork Open Source, Inc. Page 3 GroundWork Monitor Enterprise Edition 6.2 Module 3 : Configuration

4. © 2009 GroundWork Open Source, Inc. Page 4 Configuration Nagios Configuration Objects Nagios is configured from a set of configuration files The main configuration file (nagios.cfg) contains the global settings for the Nagios application Ancillary files called the object files contain the configuration objects which describe the monitoring configuration These object files are comprised of data structures called configuration objects: define host { host_name localhost alias Linux Server #1 address 127.0.0.1 use generic-host check_command check-host-alive max_check_attempts 10 notification_interval 480 } define host { name generic-host process_perf_data 1 retain_status_information 1 flap_detection_enabled 1 retain_nonstatus_information 1 active_checks_enabled 1 passive_checks_enabled 1 check_period 24x7 obsess_over_host 0 check_freshness 0 check_command check-host-alive max_check_attempts 3 check_interval 0 event_handler_enabled 1 notifications_enabled 1 notification_interval 60 notification_period 24x7 notification_options d,u,r contact_groups nagiosadmin register 0 }

5. © 2009 GroundWork Open Source, Inc. Page 5 Configuration Nagios is an extremely flexible framework that is controlled through its configuration objects Nagios configuration objects can be in one file or spread across multiple files They are comprised of directives (label=value pairs) They are structured objects and can inherit directives from other Nagios objects (i.e. templates) They are relational (i.e. hosts incorporate services and services incorporate commands) They can describe devices (hosts) They can define relationships (dependencies or groups) They can control procedures (escalations or event handlers) They can be used to control UI behavior (extended info) They define how devices will be checked (services, commands) Nagios Configuration Objects

6. © 2009 GroundWork Open Source, Inc. Page 6 Configuration Nagios Configuration Object Relationships Hosts Services Commands Contacts Contact Groups Host Dependencies Host Extended Info Service Extended Info Service Dependencies Host Groups Service Groups Host Escalations Service Escalations Timeperiods Hosts Services Contacts Host Escalations Service Escalations Templates Any Nagios Object

7. © 2009 GroundWork Open Source, Inc. Page 7 Rationale Behind the Monarch Design Host Deletion Example When a host is retired from the network it will cause Host Alarms in Nagios, so it must be removed from Nagios One could start by deleting the host object for that host in the hosts.cfg file Then the preflight check would fail because services.cfg contains service objects referencing the missing host If the service objects are then located and deleted, there will still broken service dependency objects So one would need to delete all service dependencies referencing services deleted because the host went away Then there would still be references to the host in hostgroups which would cause preflight failures There could also be residual extended_host_info objects referencing the host And extended_service_info objects referencing each of the deleted services What is needed is a tool that understands not only the configuration data and object syntax but the relationships Configuring Hosts and Services

8. © 2009 GroundWork Open Source, Inc. Page 8 Architectural View of Monarch Configuration Tool Overview Database Tables | Relationships services Nagios configuration objects Monarch DB hosts contacts hosts contacts escalations services Configuration UI Hosts, Services, Contacts, Escalations Etc. Configuration UI Hosts, Services, Contacts, Escalations Etc. Nagios Configuration files Nagios Configuration files

9. © 2009 GroundWork Open Source, Inc. Page 9 Monarch Operation Edit the data using the GUI Test configuration using Preflight Test Backup the data Create new config files using Commit Architectural View of Monarch Monarch DB Hosts, Services, Contacts… Configuration UI Services, Profiles, Hosts, Contacts, Escalations, Commands, Time Periods, Groups, Control, Tools Configuration UI Services, Profiles, Hosts, Contacts, Escalations, Commands, Time Periods, Groups, Control, Tools Workspace directory Workspace directory Pre Flight Test Commit Load Configuration Tool Overview

10. © 2009 GroundWork Open Source, Inc. Page 10 Host Definition Host Template Host Definition Service Template Service Definition Nagios Host and Service Objects Host and Service Templates Configuration Tool Overview

11. © 2009 GroundWork Open Source, Inc. Page 11 Service Template generic-service Service Template generic-service Host Template generic-host Host Template generic-host Host Definition domain_controller Host Definition domain_controller Service Template generic-service Service Template generic-service Service Definition Host Alive Service Definition Host Alive Service Definition DNS_Server Service Definition DNS_Server Implemented Host ServiceHost Nagios Host and Service Objects Fully Implemented Host Configuration Tool Overview

12. © 2009 GroundWork Open Source, Inc. Page 12 Service CPU Service CPU Service memory Service memory Service disk Service disk Service httpd Service httpd Service URL get Service URL get Service Profile web monitoring Service Profile web monitoring Monarch Services and Service Profiles Service Profiles Inside the Monarch database we can take liberties with how we store the configuration data. Inside the database preconfigured services are stored in the services table. The entries In this table, unlike the services objects in the Nagios configuration files, are NOT associated with hosts. That association happens in another table. This allows us to ship a library of pre-configured, pre-tested services in the GroundWork product. These unassigned services can also be grouped Into logical groups called Service Profiles. Each Service Profile contains a collection of Services that would be appropriate for monitoring a particular device architecture Configuration Tool Overview

13. © 2009 GroundWork Open Source, Inc. Page 13 Host Template generic-host Host Template generic-host Service Profile web monitoring Service Profile web monitoring Host Profile Monarch Host Profiles Host Profiles In the Monarch database Service Profiles can also be associated with host templates to make Host Profiles. A host profile contains everything you need to configure a device other than a hostname, IP Address and an alias. Configuration Tool Overview

14. © 2009 GroundWork Open Source, Inc. Page 14 Comparison of Nagios and Monarch Configuration Objects Monarch Configuration Objects Object NameNagiosGroundWork CommandsXX ServicesXX Pre-configured ServicesX Host/Service ProfilesX Host/Service dependenciesXX Host/Service EscalationsXX Host/Service Escalation TreesX Configuration GroupsX Contacts/ContactgroupsXX Hosts/HostgroupsXX Services/ServicegroupsXX Host/Service DependenciesXX TemplatesXX TimeperiodsXX Configuration Tool Overview

15. © 2009 GroundWork Open Source, Inc. Page 15 GroundWork Open Source, Inc. 139 Townsend Street, Suite 500 San Francisco, CA 94107 Phone: 415.992.4500 Website: www.gwos.comwww.gwos.com Email: info@gwos.cominfo@gwos.com GroundWork Subscription Support: support.gwos.comsupport.gwos.com Confidential - Do not distribute Thank you