====== 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.

{{  :docs:manage_plugins.png  }}


===== Install =====

To install a plugin, simply untar/unzip it into the /opt/ona/www/local/plugins directory.  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. 

|{{http://opennetadmin.com/demo/images/silk/plugin_error.png}}| Install dialog, click this to complete plugin installation |
|{{http://opennetadmin.com/demo/images/silk/help.png}}| Help icon, takes you to the plugins online documentation (if one exists) |
|{{http://opennetadmin.com/demo/images/silk/plugin.png}}| 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|
|[[plugins/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|
|[[plugins/build_isc_dhcp]]| Build ISC DHCP server configuration from data in ONA|
|[[plugins/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/dns_ip_toggle]]| If you constantly change DNS A records between two different IP addresses (say you are upgrading a service) this gives you a quick toggle button between two IP addresses for the specified A record|
|[[plugins/nessus_scan]]| Based on a flag in ONA, generate a list of subnets and/or IP addresses to perform a nessus scan on.  Then link to the nessus results within the ONA GUI. |
|[[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 [[plugins/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/nagios_stats]]| Provides a dashboard box that displays warning and critical alerts for your hosts.  Provides other details about he alerts as well.  Provides a box on the display host as well showing all services and their status|
|[[plugins/nikto_scan]]| Based on a flag in ONA, generate a list of subnets and/or IP addresses to perform a nikto scan on.  Then link to the nikto results within the ONA GUI.|
|[[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/whois]]| Provide a dashboard box for searching whois databases and a report based on your DNS domains and when they will expire.|