GROUNDWORK MONITOR OVERVIEW (Monarch 0.94b Beta)

Contents

A. Program Description

B. Monarch Overview

C. Monarch How To's

1. How Do I Import An Existing Nagios Configuration?
   
2. How Do I Create A New Host?
   
3. How Do I Create A New Service?
   
4. How Do I Add Services To A Host?
   
5. How Do I Create A Service Profile?
   
6. How Do I Create A Host Profile?
   
7. How Do I Setup Dependencies?
   
8. How Do I Setup Notifications
   
9. How Do I Setup Escalations?
   
10. How Do I Run Commit/Pre Flight?
    
    

A. PROGRAM DESCRIPTION

Prerequisites

Minimum Requirements

Product Objectives

Product Support

Notes

B. MONARCH OVERVIEW

Setup Procedures

1. Create the database.
2. Run monarch_setup.pl.
3. Make sure your web server User is a member of the Nagios Group.
4. Nagios cfgs need read/write permissions for Groups.
5. In your browser enter: http://<hostname|address>/cgi-bin/monarch.cgi
6. Login - User ID: super_user  Password: password
7. Go to Control>Setup to set the nagios.cfg folder.
8. Go to Control>Load to load an existing database.

Architectural View of Monarch

Structure of Monarch Concepts

Hosts and Services

Service Names

Service Profiles

Host Profiles

Application of Host Profiles

Monarch's User Interface

C. MONARCH HOW TO's

Monarch How To #1
HOW DO I IMPORT AN EXISTING NAGIOS CONFIGURATION?

1. Select Control
2. Select Setup
3. In the Setup Options screen, verify the nagios.cfg, resource file, and cgi.cfg directories.
   Note: The initial setup script should have entered the appropriate files here for you. You should not have to make changes.
4. Select Save to save any changes.

1. Select Control
2. Select Load
3. In the Confirm Drop Records screen, answer Yes to the prompted question: Are you sure you want to drop all Nagios records from Monarch and load etc/nagios/nagios.cfg?
4. The load status will display, select refresh from your browser to update the status. The import is finished when the load status indicates completed, any error messages will be displayed in red.
5. Select Continue to return to the main screen.

Monarch How To #2
HOW DO I CREATE A NEW HOST IN MONARCH?

1. Select Design
2. Select Host Templates
3. Select Copy from an existing Host Template or New Host Template
4. In the Host Template Properties screen, fill in the properties.
5. Select Add to add the new Host Template.

1. Select Design
2. Select Hosts
3. Select New Host Wizard
4. In the Host Vitals Screen enter a new Host Name
5. Enter an Alias
6. Enter an Address
7. Enter a Host Profile (optional)
8. Select Next to go to the Host Attributes 1 screen.

1. Select a required Host Template
2. Add to the Host one or more Parents (optional)
3. Select a Configuration File; This indicates the configuration file where the Host Definition will be stored after executing a Preflight Check or Commit. You might want to store Hosts of different types in different files, i.e. UNIX Hosts in hosts_unix.cfg, network Hosts in hosts_network.cfg, etc.
4. Select Next to go to the Host Attributes 2 screen.

1. Assign this Host one or more Host Groups; This directive is optional but recommended. Note: You will get a warning message during Commit or Preflight Check if a Host is not a member of any Host Group.
2. Select an Extended Host Info Template (optional)
   
3. Enter map coordinates for 2D and 3D Status Map Coordinates (optional)
   
4. Select a Host Escalation Tree; This directive is optional. Select if the escalation of Host notifications is required.
5. Select a Service Escalation Tree (optional)
   
6. Select a Service Profile for this Host (optional)
   
7. Select Next to go to the Select Host Services screen.

1. Select the Service Configuration file; This is the location where these Service Definitions will be stored. Note: If you selected a Service Profile in the previous page (Host Attributes 2), the Service Names in that Service Profile will show in the form.
2. Select Add to List to add Services to this Host; Select the Services to remove by selecting the Discard radio button. Select Services to modify by selecting the Modify radio button. If you selected Modify for any Services, a form with the check command and command line for each selected Service will be displayed for modifying. If you need to change any of these definitions, use Manage>Hosts to select and modify the settings.
3. Select Next to complete the Host Wizard.
4. In the Completed screen, select Save as Profile to save this new Host as a Host Profile or select Continue to complete the definition of this Host.

Monarch How To #3
HOW DO I CREATE A NEW SERVICE?

1. Select Design
2. Select Commands
3. Select Copy an Existing Command or New Command;
   Note: If the command you are creating has a format similar to an existing command, or if it will be calling a plugin program with different parameters, the copy option will be easiest to use.
   
4. In the Command Properties screen, enter the Name for the command.
5. Select a command Type.
   For a Host or Service command, select Check.
6. Enter the Command Line that will be used to execute the plugin program.
   Note: The command line should also match how it will be executed at a command prompt. You may use Nagios macros here. These are substituted by Nagios before the command is executed. Typical macros include: $HOSTADDRESS$ - the Host's IP Address; $USER1$ - the Nagios plugin directory. See the Nagios documentation for the complete list of macros.
7. Select Add to create the command.

1. Select Design
2. Select Service Templates
3. You have 3 options: Copy from an Existing Service Template and modify its settings; Create a New Service Template from scratch; Use an Existing Service Template which will be a child template of an existing template. The template will use the Nagios use directive for the existing template. These definitions will override the existing template.
4. In the Service Template Properties screen, enter the parameters.
5. Select to add the new Service Template.

1. Select Design
2. Select Profiles
3. Select Design/Manage Service Names
4. Select Add New Service Name
5. In the Service Name screen, enter the properties.
   Note: If you check the Use Template Command, the Service will use the command in the Service Template. If you change the Command in the Service Template, this will change the Command for Hosts using this Service Name Profile. If you do not check the Use Template Command, the Command Line defined in this Service Name Profile will be used.
6. Enter the Command Line that will be used to execute the plugin program.
   Note: Macros are used by the command definition. Here you enter $ARGx$ values separated by
   '!' Ex check_disk!75!90 for $ARG1$ $ARG2$
7. Select Add to add the new Service Name.

Monarch How To #4
HOW DO I ADD SERVICES TO A HOST?

1. Select Manage
2. Select Hosts
3. Select the option to find the Host:
   Find by IP address: Enter the full or partial IP address
   Find by Host Group: Select a Host Group then a Host Name
   Find by Host Name: Enter the full or partial Host name

1. Select Profile
2. You may either: Select a Host Profile in which the Service Profile associated with that Host Profile will be applied, or select a Service Profile to be applied.
3. Select Save
   Note: You will then have the option to select Apply Profile to Host which will apply the newly saved Profile to the Host.

1. Select Services
2. Choose a Service and select Add Service(s)
   Note: If you have assigned Service Profiles to Hosts, you can add a Service by updating the Service Profile, then applying it to all Hosts.
   

Monarch How To #5
HOW DO I CREATE A SERVICE PROFILE?

1. Select Design
2. Select Profiles
3. Select Design/Manage Service Profiles
4. Select Add New Profile
5. In the Service Profile screen, enter the following:
   Service Profile Name, Description of the Service Profile, and the Services to include using Add and Remove.
   
6. Select Add
   Note: To select multiple Services Names, use the CTRL key while selecting; or to select a range, click on the first item, press the SHIFT key and select the last item.
7. Select the File where these Service Definitions will be saved
8. Select Add to create the Service Profile

Monarch How To #6
HOW DO I CREATE A HOST PROFILE?

1. Select Design
2. Select Profiles
3. Select Design/Manage Host Profiles
4. Select Add New Profile
5. In the Host Profile screen, enter the name of the new Host Profile
6. Select Add to add the new Host Profile and continue on to the various Host Profile screens.

1. In the Host Profile screen you can define the following information under each of the displayed tabs:
   Profile: Enter the Extended Host Info Template and the Host file to store the configuration statements.
   Template: Select the Host Template to apply.
   Parents: Add the Parent Hosts.
   Host Groups: Add the Host Groups to this Host Profile.
   Escalations: Enter Host or Service Escalation Trees.
   Services: Enter Service Profile for this Host Profile.
   
2. Select Save to create the new Host Profile.

Monarch How To #7
HOW DO I SETUP DEPENDENCIES?

1. Select Host Dependencies
2. In the Host Dependency Properties screen, select the Host
3. Select the Parent for the Host
4. Select the Notification Failure Criteria
5. Select Add to create the dependency.

1. Select Service Dependency Templates
2. Select Copy from an existing Service Dependency Template or New Service Dependency Template
3. In the Service Dependency Properties screen, select the Service Name (the Service Dependency Template)
4. Select the Execution and Notification Criteria associated with a Service Name
5. Select Add to save the setup.

Monarch How To #8
HOW DO I SETUP NOTIFICATIONS?

1. Select Manage
2. Select Service Templates
3. Select the Service Template to modify
4. Enable the Notifications Enabled checkbox
5. Set the Notification Interval
6. Select the Notification Period from the defined Time Periods
7. Check the desired Notification Options (Unreachable, Critical, Warning and Recovery)
8. Select Contact Groups to be contacted

1. Select Manage
2. Select Host Templates
3. Select the Host Template to modify
4. Enable the Notifications Enabled checkbox
5. Set the Notification Interval
6. Select the Notification Period from the defined Time Periods
7. Check the desired Notification Options (Unreachable, Critical, Warning and Recovery)

1. Select Manage
2. Select Host Groups
3. Select Host Group that contains the Host for the Notification
4. In the Host Group Properties screen, select the Contact Groups to be used for Notifications
5. Select Save to save the Host Group Definitions

Monarch How To #9
HOW DO I SETUP ESCALATIONS?

1. Select Escalations
2. Select Escalation Template
3. Select the Escalation Type (Service)
4. Select Next to go to the Service Escalation Properties screen.
5. Enter a Name for the Escalation.
6. Select Contact Groups
7. Assign a First Notification (a number which identifies the first notification for which this escalation is effective).
8. Assign a Last Notification (a number which identifies the last notification for which this escalation is effective).
9. Assign a Notification Interval (indicates the interval in which notifications should be made while this escalation is valid).
10. Select Add to create the escalation.

1. Select Escalations
2. Select Escalation Template
3. Select the Escalation Type (Service)
4. Enter a Name for the Escalation.
5. Select Next to go to the Design Escalation Tree screen.
6. Add an Escalation Template to this Escalation Tree.
   Note: You can modify the list of Contact Groups associated with the Escalation by selecting the Modify Groups link.
7. Select Close

1. To a Service Name, then a Service Profile or Host Profile, then assign the Profile to Hosts using the Host Wizard or by modifying an existing Host Definition.
   or
2. To a Host Profile, then assign the Profile to the Hosts using the Host Wizard or by modifying an Existing Host Definition.
   or
3. To a Host Group.

1. Select Escalations
2. Select Escalation Template
3. Select the Escalation Type (Host)
4. Select Next to go to the Host Escalation Properties screen.
5. Enter a Name for the Escalation.
6. Select Contact Groups
7. Assign a First Notification (a number which identifies the first notification for which this escalation is effective).
8. Assign a Last Notification (a number which identifies the last notification for which this escalation is effective).
9. Assign a Notification Interval (indicates the interval in which notifications should be made while this escalation is valid).
10. Select Add to create the escalation.

1. Select Escalations
2. Select Escalation Template
3. Select the Escalation Type (Host)
4. Enter a Name for the Escalation.
5. Select Next to go to the Design Escalation Tree screen.
6. Add an Escalation Template to this Escalation Tree.
   Note: You can modify the list of Contact Groups associated with the Escalation by selecting the Modify Groups link.
7. Select Close.

1. Go to the Host Profile, then assign the Tree, then assign the Profile to Hosts using the Host Wizard or by modifying an existing Host Definition.

1. Select Escalations
2. Select Escalation Template
3. Select the Escalation Type (Host Group)
4. Select Next to go to the Host Group Escalation Properties screen.
5. Enter a Name for the Escalation.
6. Select Contact Groups
7. Assign a First Notification (a number which identifies the first notification for which this escalation is effective).
8. Assign a Last Notification (a number which identifies the last notification for which this escalation is effective).
9. Assign a Notification Interval (indicates the interval in which notifications should be made while this escalation is valid).
10. Select Add to create the escalation.

1. Select Escalations
2. Select Escalation Template
3. Select the Escalation Type (Host Group)
4. Enter a Name for the Escalation.
5. Select Next to go to the Design Escalation Tree screen.
6. Add an Escalation Template to this Escalation Tree.
   Note: You can modify the list of Contact Groups associated with the Escalation by selecting the Modify Groups link.
7. Select Close.

Monarch How To #10
HOW DO I COMMIT AND RUN A PRE FLIGHT TEST?

1. Select Control
2. Select Commit
   Nagios commit results and success notes will be displayed.