NOTE: If you are upgrading there is a sql file in the root of plugins/npc called upgrade_schema.sql. Run this against your cacti database. It adds a handful of indexes to the npc tables. Skip this if doing a clean install.
Code: Select all
cd <cacti_home>/plugins/npc
mysql -u USERNAME -p DATABASE < upgrade_schema.sql2009-06-22 - 2.0.4 release notes:
Added few small features and fixed a couple bugs.
* Updated the graph paths to use the Cacti path defined on global.php. This should resolve the issues some people were having displaying or mapping graphs.
* Made the host and service status summaries clickable. When clicked the service or hosts grid will open filtered based on the clicked cell. For instance clicking the warnings cell will show all the services in a warning state. This feature will be expanded to all grids that show counts by state but currently is only available on the host and service status summary portlets (the ones at the top of NPC).
* Added the ability to acknowledge warnings.
* Added an 'Unhandled' toggle to the service problems (and portlet) grid. This button is on the bottom toolbar. Toggling it will filter the display to only show issues that have not been acknowledged.
2009-06-08 - 2.0.3 release notes:
This is a bug fix release.
* Added index to npc_objects to improve performance of perdata.php.
* Updated index on npc_configfilevariables which was preventing writes.
* Fixed host icon handling.
* Fixes comment handling which was breaking service and host detail screens.
* Added cli.php which will become a replacement for perfdata.php
2009-05-17 - 2.0.2 release notes:
NPC releases are no longer following beta/build release versioning. This release is skipping ahead to 2.0.2 and future releases will increment accordingly.
* Host and status summary portlets have been moved above the dashboard and navigation panels (see updated screenshot).
* Added A Nagios Status portlet which displays whether or not Nagios is running and if global checks and notifications are enabled.
* Made the portlet refresh rate a global property under NPC settings.
* Fixed bug where NPC was preventing other pages from auto refreshing by including and overriding top_graph_header.
* Added a realm (permission) for executing global commands like disabling all notifications or checks.
* Fixed bug that was causing double checkboxes on various forms.
* Added a cog icon to represent when host/services are in scheduled downtime.
* Added support to represent the icons defined in the Nagios host/service definitions (see dashboard screenshot). This feature must be enabled in NPC settings.
* Added support for hostgroup commands. These are accessed via right click on a hostgroup name from the hostgroup dashboard portlets.
* Updated most portlets and the comments grids to use live scrolling rather than paging.
* Fixed bug with searching comments.
* Added an Additional Information tab to service and host detail. This tab activates automatically if the notes_url parameter is defined in the Nagios host/service definition. See notes_url screenshot.
* Upates to support additional list methods using perfdata.php. This script is slowly become a Nagios/NPC general purpose CLI script.
2.0.0b Build 182 notes:
Big performance updates and a few new features including:
* Updated Doctrine ORM to 1.0.7 Stable
* Fixed some very inefficient queries.
* Updated the methods for getting host and service status summary. (Huge performanace gain)
* Added many new indexes
* Updated many of the grids to be buffered scrolling "live" grids rather than paging grids.
Live Grids: While scrolling up or down the grids will fetch the records relating to the scroll bar position plus some extra to give a buffer. See the attached screen shots that show a live hosts grid in action. The scrolling action should be preferable to paging through a large amount of data.
2.0.0b Build 166 notes:
* This beta release of NPC fixes a few minor bugs.
* Setting config_output_options=2 (or 3) in ndomod.cfg is now a requirement. This corrects some instances of no data or duplicate data.
* All grids were updated to fit the bottom bar to the bottom of the browser.
* All grids now have an option for configuring the number of rows displayed.
* All grids now have the option for configuring the refresh rate.
* Portlet rows/refresh is adjusted by clicking the configuration icon in top right corner of the portlet.
* Like all other aspects of the UI the rows and refresh configuration is saved server side on a per user basis.
2.0.0b Build 151 notes:
Besides a few bug fixes this release takes advantage of many of the plugin management features found in the plugin
architecture 2.x. including install/uninstall options as well as enable/disable option.
Uninstall removes all database traces of NPC.
NOTE: NPC now has to be installed via the plugin management section even if you are upgrading from a previous release. If you have an entry for NPC in global.php it can be removed.
----------------------------
I setup a community Trac site to host the NPC project. The NPC source as well as install guide, screen shots, etc. can be found there.
With the exception of some installation notes documentation is very slim. Here are a few tips to get you started:
- * Most lists including services or hosts can be double clicked to open additional detail screens.
* Most lists including services or hosts can be right clicked to popup a context menu used to issue service or host commands.
* If a graph is mapped to a service or host, a graph icon will be displayed in the hosts and services screens. A single left click of this icon will popup the graph.
* Most green check marks (started/enabled) or most red X (stopped/disabled) can be double clicked to toggle the option (requires that remote commands are enabled.)
* Most grid columns can be re-ordered via drag and drop.
* Most grid columns can be hidden and currently hidden columns can be viewed by clicking a down arrow to the right of the column heading.
* Dashboard portlets can be closed or minimized. Closed portlets can be made visible again by clicking the Portlets button on the far right of the toolbar on the Dashboard tab and then select which portlets you want displayed.
* All changes to the interface (portlets, column order, etc.) are saved server side on a per user basis. Customize the UI your way and it is available anywhere you login.
* Importing Nagios hosts is done from the N2C link on the left side tree menu. Before starting an import you need to click in the template field to the right of the hostgroup you are importing. Doing so will expose a select box for assigning a host template.
Bugs/support
The interface currently has some quirks that I am aware of. Dragging a portlet will sometimes move several portlets at once. When this happens just reload the NPC page and the portlet order should be correct.
Grids will sometimes fail to render or display fully. Closing and re-opening the problem tab usually resolves that. When viewing host/service detail screens, allow all the data to load before clicking through the tabs.
For all other issues post your problem here, or if you are inclined open a ticket on the NPC Trac site. This is an alpha release so I fully expect issues and I need your help to find them
Cheers,
Billy
