VNag is a framework that makes it easy to develop plugins for Nagios compatible software. You can use VNag to automatically get notified when a new OIDplus version is released. More information about VNag

Variant A: OIDplus is hosted on a different system as the Icinga2/Nagios server

Example setup using Linux and Icinga2

  1. Download VNag here: www.viathinksoft.com/projects/vnag

  2. Install Icinga2, in case it isn't installed yet. Follow the documentation of Icinga2 in order to setup everything correctly.

  3. Extract VNag to e.g. /daten/vnag/
    Please change the paths so that these fit your environment.
  4. Create a symlink, e.g.:
    ln -s /var/www/vnag/plugins/webreader/icinga2.conf /etc/icinga2/conf.d/vnag_webreader.conf
    In this file, adjust the path /daten/vnag

  5. Create a new file /etc/icinga2/conf.d/oidplus_version.conf with the following contents:
    apply Service "example_oidplus_version_check" {
    	import "generic-service"
    	check_command = "vnag_webreader"
    	vars = {
    		// The following page contains a machine-readable "VNag tag" which the VNag "web reader" plugin can read and redirect the output to the Nagios compatible software
    		vnag_webreader_url = "%%ABS_WEB_PATH%%vnag.php"
    		vnag_webreader_password = "%%WEBREADER_PASSWORD%%"
    		vnag_webreader_signPubKey = "%%WEBREADER_PUBKEY%%"
    	}
    	assign where host.name == NodeName
    }

  6. Restart Icinga2

  7. You can use various apps for Android and iPhone, or even your web browser to monitor the OIDplus version using Icinga2

Variant B: OIDplus is hosted on the same system as the Icinga2/Nagios server

Example setup using Linux and Icinga2

  1. Install Icinga2, in case it isn't installed yet. Follow the documentation of Icinga2 in order to setup everything correctly.
    You don't need to install VNag.

  2. Create a new file /etc/icinga2/conf.d/oidplus_version.conf with the following contents:
    object CheckCommand "cmd_oidplus" {
    	command = [ "$cmd_oidplus_dir$/%%REL_LOC_PATH%%vnag.sh" ]
    	arguments = {
    	}
    }
    apply Service "example_oidplus_version_check" {
    	import "generic-service"
    	check_command = "cmd_oidplus"
    	vars = {
    		cmd_oidplus_dir = "%%SYSTEM_URL%%"
    	}
    	assign where host.name == NodeName
    }

  3. Restart Icinga2

  4. You can use various apps for Android and iPhone, or even your web browser to monitor the OIDplus version using Icinga2