Plugins

mattpascoe edited this page Nov 3, 2015 · 6 revisions

Plugins

The release v10.05.24 is the first release of ONA the provides the plugin framework. This framework is an initial start so it will likely go through quite a bit of change as it develops along. By default the NMAP plugin will come with ONA.

Manage Plugins

Install

To install a plugin, simply clone/untar/unzip it into the /opt/ona/www/local/plugins directory. It is recommended you clone the project as you can more easily upgrade this way.

cd /opt/ona/www/local/plugins;git clone https://github.com/opennetadmin/<plugin_name>.git

Once you have placed the plugin into this directory, it should be visible in the "Plugins -> Manage Plugins" menu option. Simply find it in the list and click the Install icon and follow any instructions.

  • err - Install dialog, click this to complete plugin installation
  • help - Help icon, takes you to the plugins online documentation (if one exists)
  • plugin - Activate or deactivate a plugin. If the icon is green the plugin is active, if it is grey it is inactive. Click to toggle.

Available Plugins

The following is a list of plugins that I currently have in development. Most are functional, others are not quite ready for prime time. I'll try and release them as they become useful for general consumption.

Name Description
plugins/ona_nmap_scans Perform nmap based network audits and compare the results to data in ONA
rack_maint Track device location in physical racks
plugins/puppet_facts Gather puppet facts from puppetmaster servers and store those facts with the hosts in ONA
plugins/puppet_external_nodes define external node attributes for hosts in ONA. Allows puppet to use ONA as an external nodes source instead of using nodes.pp
build_isc_dhcp Build ISC DHCP server configuration from data in ONA
build_bind Build BIND DNS server configuration from data in ONA
build_tinydns Build Tinydns (djbdns) server configuration from data in ONA
plugins/cisco_cfg_audit Using Cisco configuration archives stored in ONA by the cfg_archive plugin, audit NAT and IP interface data against data stored in ONA
plugins/ona_recent_additions Shows a quick box on the dashboard with the last 5 subnets, hosts, DNS names that were added.
plugins/rpt_check_last_response Provides a quick query report to show hosts that have not responded since the specified date. Requires last_response data from sources such as the ona_nmap_scans plugin
plugins/cfg_archive A process similar to Rancid that connects to network devices and gets their configuration to archive in ONA. Currently supports Cisco and Juniper devices.
plugins/cisco_ucs_stats Will provide a Dashboard box showing the status of all your Cisco UCS chassis and the blades inside. You can easily get info on hardware status, memory, serial numbers etc
plugins/livestatus_stats Provides a dashboard box that displays warning and critical alerts for your hosts in Nagios/Icinga. Provides other details about he alerts as well. Provides a box on the display host as well showing all services and their status
plugins/openvmps Provide VQP responses to the openvmps server based on data in ONA. Using openVMPS external program methods you can have the VMPS server ask ONA directly for responses
plugins/vmware_stats Gather information from a VMware system and display it for each host. Things such as Memory, CPU, Disks, Tools and power status are available.
plugins/whois Provide a dashboard box for searching whois databases and a report based on your DNS domains and when they will expire.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.