Share

GroundWork Monitor Architect

File Release Notes and Changelog

Release Name: monarch-2.0

Notes:
Monarch 2.0 Release Notes

This release is all about scalability. First and foremost is the 
latest in a series of tree navigations. This one was written from 
scratch (where as previous versions were adopted from other open 
source projects) and is fully Ajax driven. The second major innovation 
allows multiple checks on the same service definition. For example, a 
disk check can be defined for multiple partitions, or an snmp check on 
a network device can be defined for multiple interfaces. The third 
major enhancement introduces Groups that, among other things, allows 
centralized management of multiple nagios installations. Note also 
that the alternative EZ interface is now fully integrated.

# Bug fixes since 1.3

1.  Host Wizard: The template override values from a host profile are 
    not applied.
2.  EZ Import tool doesn't support tab delimiter in files.
3.  Control->Load can create multiple instances of a service check.
4.  Need to add "Circular" to Nagios CGI, under statusmap layout.

# Update 2.0.2

1. Debug flag in monarch_tree.cgi was set to 1 in the 2.0.1 release. Debug writes to /tmp/debug.txt when using tree nav, but the file does not grow.
2. monarch_ez.cgi missing argument for GroundWork Monitor integration. This did not affect the standalone version.
3. MonarchStorProc.pm added /usr/local/bin path for mysqldump.


# Enhancements

1.  Ajax tree navigation - much faster and scales well (tested with 
    2800 hosts). 
2.  Improved secure CGI session management includes Single Sign On 
    integration option.
3.  Clone service
4.  Multiple instance service checks - check all interfaces on a 
    router with a single service definition
5.  Groups
     - Multiple instance nagios support - 
     - File management replaced with groups 
       (e.g. <groupname_hosts.cfg, groupname_services.cfg>)
     - Group macros to extend the Nagios $ARGn$ macros. Service checks
       inherit values from the group a host is assigned. 
6.  EZ alternative interface 
     - Simplified interface hiding the complexity of Nagios relying on
       profiles
     - Delimited file import
     - Nmap discovery
7.  Misc. directives supported in nagios.cfg (to enable event brokers
    among other things)
8.  Host delete tool - mass delete hosts
9.  Service delete tool - mass delete services from hosts
10. Extended info forms have dropdowns to select image files (if the 
    Nagios share is correctly set).






























Changes: # MonArch - Groundwork Monitor Architect # changelog.txt # ############################################################################### # Release 0.94e # 3-June-2005 ############################################################################### # # Bug fixes since 0.94c 1. retain_state_information not written to nagios.cfg. 2. Some changes to Control -> Nagios configuration were not saved. 3. Control -> Nagios configuration -> command_check_interval was a check box (now it's a text box). 4. Service Escalation Template errored on save if a service description was selected. 5. Escalation tree 'Close' button fixed. 6. Improvements to Control -> Load. (A period wasn't escaped so some objects were named a string of hyphens). # Enhancements: 1. On Control -> Commit, the current Nagios config set is written to it's own folder in <monarch home>/backup. The folder name is yyyy-mm-dd_hh:MM:SS. Previously, backups were overwritten. 2. On a new installation, you can no longer do Control -> Commit if you haven't set Control -> Nagios configuration. Previously, you could commit an empty nagios.cfg # ############################################################################### # Release 0.95c # 27-June-2005 ############################################################################### # # Bug fixes since 0.94e 1. Most of the png images were somehow corrupted (notably the background image for the javascript help). 2. Page fault error on Manage -> Escalations -> Escalation templates -> Service when saving service description '*'. 3. Control -> Load: Fixed bugs loading escalations and service dependencies. 4. Manage -> Hosts -> Service Detail was not displaying the check command if defined at the service # Enhancements: 1. cgi.cfg is now integrated. 2. Added option in setup to switch between Nagios 1.x and 2.x (still some work left getting all 2.x directives implemented, but it will write files that 2.x will support. Be sure to edit Nagios Main Configuration). 3. New style sheets. 4. Increased size of service names name column to 250 charcaters (was truncating at 100). 5. Backup option on commit and load. Existing nagios files and a mysqldump of monarch are written to a separate backup folder: <monarch home>/backup/yyyy-mm-dd_hh:mm:ss # ############################################################################### # Release 0.95d # 11-July-2005 ############################################################################### # # Bug fixes since 0.95c 1. Host Templates 1.x users: some 2.0 directives weren't filtered, causing Nagios preflight and commit to fail. 2. Manage->Hosts->Services->Service Dependencies: failed when service description contained spaces. # Enhancement: 1. Improved Pre-flight and commit error reporting. # ############################################################################### # Release 0.96b # 29-Aug-2005 ############################################################################### # # Bug fixes since 0.95d 1. Host Templates: Max check attempts appeared twice in modify/design host templates. 2. Manage->Hosts->Profiles Profiles: Service profile dependency to host profile removed. (eliminates confusing behavior selecting service profiles). 3. Host wizard: Select service from 'Add to list' cleared the file name value. 4. Service templates: is_volatile property was missing. 5. Command line truncated: Command line was limited to 255 characters, and is now set to 65,535 characters. 6. Names truncated in various places: All names can now have up to 255 characters. 7. Escalation trees: Certain characters in name caused page load error (from a database insertion error). 8. Control->Load: Lost contact group properties from hosts (Nagios 2.0 directive). 9. Control->Load: Sometimes timed out. An unnecessary loop caused web server to timeout. 10. Paths hard coded in code (various places): /usr/local/groundwork/monarch /usr/sbin These values are now stored in the database, and set during setup and update. 11. Setup: Incorrectly set permissions on nagios cfg folder. At the user's discretion, group permissions on cfg files are set to read/write (g+rw), and only if group ownership is non root. No changes will be made to the folder itself. 12. Commit failed to update resource.cfg. 13. Export/Preflight/commit: contact_group directive on hosts contained parents (Nagios 2.0). # Enhancements: 1. Javascript tree navigation: New layout using javascript from www.Treeview.net. 2. Inheritance: Nagios directives inherited from templates (contacts, hosts and services) can now be overridden on the instantiated object. 3. Parser (load process) no longer forces properties onto new templates (contacts, hosts, services) but looks for best match, and unmatched properties remain with object. 4. Parser (load process): Support for two way flow from files to database. This wasn't really supported, though everyone seemed to be doing it. You now have the option to update or replace. 5. Clone a host: Enter a name, alias, address and select an existing host to replicate. 6. Passwords now encrypted in database. 7. Resource macros: Added informational label. 8. Escalation trees: Sort order of escalations is by first_ notify directive. 9. Host wizard: No longer pops up in a new browser (you can still exit and resume a wizard session). # ############################################################################### # Release 0.96d # 6-Sept-2005 ############################################################################### # # Bug fixes since 0.96b 1. 'threshold' misspellings various places. 2. Services->Manage links broken when there were fewer than 100 services. 3. Flaws in monarch_update.pl caused sql errors and/or override values were not saved: a. Hosts->Manage->Host Vitals->Save. b. Hosts->Manage->Services->Service Detail->Save. 4. Hosts->Manage->Services->Service Detail->Save would not override check_command or contact group. 5. cgi.cfg: default_statusmap_layout and default_statuswrl_layout written as discriptive text instead of numeric value. # ############################################################################### # Release 0.97a # 22-Sept-2005 ############################################################################### # # Bug fixes since monarch-096d SFREQID 1. 1309851 Contact groups lost from hostgroups when saving service templates (and visversa) 2. 1295890 Clone a host incorrectly set check_period, notification_period, check_command and event_handler (unless host template specified). 3. 1294964 Service->new after add NO SCREEN REFRESH (Also Service profiles->new) 4. 1293611 Manage Host screen rename does not work 5. 1292334 Load causes pre-flight to fail (missing check commands) 6. 1290314 nagios resource link missing 7. 1290058 Unable to import configuration file (missing param in MonarchLoad.pm) 8. 1287336 Contact template web interface (cannot save notification options) 9. 1287332 www group missing from monarch_setup script 10. 1283587 Version Number Mismatch # Enhancements 1. Service Groups (Nagios 2.0) # ############################################################################### # Release 1.0 # 14-Mar-2006 ############################################################################### # # Bug fixes since monarch-097a 1. 1326030 Unable to delete contactgroups. 2. 1327666 Service Paraeters Not Applied consistently (logic revised to capture properties). 3. 1337011 Auth reverts back to super_user group in Control menu (hard coded references remved). 4. 1341115 resource files doesn't get copied 5. 1341124 global service escalation requires wildcards (2.x) (wildcards and regular expressions supported for host_name, hostgroup_name on load). 6. 1341120 can't clear host/service escalation 7. 1341118 service escalation tree doesn't take (hosts) 8. 1341126 can't get to host unless ip defined (javascript issus resolved) 9. 1341141 import doesn't handle wildcards (wildcards and regular expressions supported for host_name, hostgroup_name, service_description on load). 10. 1395608 inherit checkbox odd behaviour (button added with documentation). 11. 1356859 Path to nagios binary cannot be changed (now prompted for during setup). 12. 1393298 service_name with a # is not editable (URI Escapes added to make javascript happy, though maybe not too happy). 13. 1341128 service unreachable in contacts 14. 1423405 Service Group Management: Host removed from select after only a single service was added. 15. 1338329 permissions cause errors: Should now correctly report system errors. 16. 1413603 wrong helptext in service dependency template new: Corrected 17. 1341135 contact group not necessary for hostgroup: no longer required to save form. # Enhancements 1. Ajax lookup of hosts by name or address, services by name. 2. One to many service profiles to hosts and host profiles. 3. Improved host profile interface: Assign hosts, host groups form the host profile. Selectively apply attributes to hosts. 4. Improved service profile interface: Assign host groups, hosts, host profiles from the service profile. 5. Improved service interface: Selectively apply attributes to hosts. 6. Improved service check interface: Includes test facility and command syntax. 7. Improved service dependency interface: Allows dependencies across multiple hosts to be applied. 8. Profile portability: Import/export profiles to/from XML formatted files. 9. Simplified escalation interface: Assign escalations to objects from the escalation tree. Hostgroup escalations eliminated (moved to hosts). 10. Escalations on service groups. 11. Improved tree navigation using frames. 12. Externals: Provides an interface to assign configuration information to hosts and services that is external to Nagios (See Control->Setup). # ############################################################################### # Release 1.2 # 6-Jul-2006 ############################################################################### # # Bug fixes since 1.0 1. Control->Load caused performance commands set to type 'check'. 2. Control->Load strips service template check command arguments. 3. Modify a service; then apply detail this service to a host failed to update host. 4. Dashes not accepted in contact properties pager field. 5. Delete service template not cleaning up contactgroup_assign table. 6. Hosts sometimes removed from hostgroup when contactgroup changes saved. 7. monarch_ez discover/import hosts: Fixed process_hosts to do case insensitive check before trying to import. 8. Control->Load Service groups added but not populated with services. 9. Entries in nagios.cfg that were commented out with a "##" and being ignored by nagios, so the default in Nagios was being executed. Now written as =0 where default is 1. 10. Host check command not showing when inherited from template. 11. Use Retained Scheduling Info not written to nagios.cfg. 12. Modify->Services when adding a service dependency to a service with the 'parent' host as the 'same host' not applied to all hosts. 13. Modify->Services apply to hosts didn't list hosts if the count was over 50. 14. Escalation trees GUI didn't show assigned escalations if two or more had the same first notification value. 15. Missing closing HTML comment tag in MonarchForms.pm - removed the comment. 16. Host dependencies invalid assumptions - incorporated patch from monachus (SourceForge 1473815). 17. Event Handler in Templates not showing notification host/svc - all commands now listed. 18. Service profile apply to hosts: service dependencies not applied properly 19. Service profile apply to hosts: externals not applied. 20. Clone host: externals not applied for host or services. 21. Many typos in documentation corrected. # Enhancements 1. Added MonarchCallOut.pm - can be used to perform some custom tasks when running commit. # ############################################################################### # Release 1.3 # 17-Oct-2006 ############################################################################### # # Bug fixes since 1.2 1. Service profiles->Apply to hosts: creates multiple service dependency entries causing prolonged Nagios restarts. 2. Services->Apply to hosts: applying service dependency to hosts from a service does not work. 3. Services->Apply to hosts: merge/replace not applying service detail properly or at all. 4. Profiles->Profile importer did not import service details. 5. Commands->Rename did not preserve arguments on service checks. 6. Delete hostgroup/host template not cleaning up contactgroup_assign table. 7. Hosts/Services->Search: searching for an object with a space in the name truncated the name. 8. New host wizard->Services->Service profile - service dependencies not applied. 9. Ajax functions Search hosts/Search services/Load were broken with newer versions of CGI::Ajax. 10. Hosts->Service Cannot remove service escalation tree once assigned. Can only change. 11. Escalation tree-> New: No error when adding a duplicate escalation tree. # ############################################################################### # Release 2.0 # 12-Dec-2006 ############################################################################### # # Bug fixes since 1.3 1. Host Wizard: The template override values from a host profile are not applied. 2. EZ Import tool doesn't support tab delimiter in files. 3. Control->Load can create multiple instances of a service check. 4. Need to add "Circular" to Nagios CGI, under statusmap layout. 5. Notes and action_url directives missing from extended info templates. # Enhancements 1. Ajax tree navigation - much faster and scales well (tested with 2800 hosts). 2. Improved secure CGI session management includes Single Sign On integration option. 3. Clone service 4. Multiple instance service checks - check all interfaces on a router with a single service definition 5. Groups - Multiple instance nagios support - - File management replaced with groups (e.g. <groupname_hosts.cfg, groupname_services.cfg>) - Group macros to extend the Nagios $ARGn$ macros. Service checks inherit values from the group a host is assigned. 6. EZ alternative interface - Simplified interface hiding the complexity of Nagios relying on profiles - Delimited file import - Nmap discovery 7. Misc. directives supported in nagios.cfg (to enable event brokers among other things) 8. Host delete tool - mass delete hosts 9. Service delete tool - mass delete services from hosts 10. Extended info forms have dropdowns to select image files (if the Nagios share is correctly set). # ############################################################################### # Update 2.0.2 # 26-Dec-2006 ############################################################################### # 1. Debug flag in monarch_tree.cgi set to 1. Debug writes to /tmp/debug.txt when using tree nav, but the file does not grow. 2. monarch_ez.cgi missing argument for GroundWork Monitor integration. This did not affect the standalone version. 3. MonarchStorProc.pm added /usr/local/bin path for mysqldump.