Subversion Repositories oidplus

Rev

Rev 635 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

  1. <!-- TODO: Translte to German (tutorial$dede$.html) -->
  2.  
  3. <p>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.
  4. <a href="https://www.viathinksoft.com/projects/vnag">More information about VNag</a></p>
  5.  
  6. <h2>Variant A: OIDplus is hosted on a different system as the Icinga2/Nagios server</h2>
  7.  
  8. <p>Example setup using Linux and Icinga2</p>
  9.  
  10. <p><img src="%%REL_WEB_PATH%%/img/variant_a.png"></p>
  11.  
  12. <ol>
  13.         <li>Download VNag here: <a href="https://www.viathinksoft.com/projects/vnag">www.viathinksoft.com/projects/vnag</a><br><br></li>
  14.  
  15.         <li>Install Icinga2, in case it isn't installed yet. Follow the documentation of Icinga2 in order to setup everything correctly.<br><br></li>
  16.  
  17.         <li>Extract VNag to e.g. <b>/daten/vnag/</b><br>
  18.         <i>Please change the paths so that these fit your environment.</i></li>
  19.  
  20.         <li>Create a symlink, e.g.:<br>
  21.         <code>ln -s /var/www/vnag/plugins/webreader/icinga2.conf /etc/icinga2/conf.d/vnag_webreader.conf</code><br>
  22.         In this file, adjust the path /daten/vnag<br><br></li>
  23.  
  24.         <li>Create a new file <b>/etc/icinga2/conf.d/oidplus_version.conf</b> with the following contents:<pre>
  25. apply Service "example_oidplus_version_check" {
  26.         import "generic-service"
  27.         check_command = "vnag_webreader"
  28.         vars = {
  29.                 // 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
  30.                 vnag_webreader_url = "<a href="%%ABS_WEB_PATH%%vnag.php" target="_blank">%%ABS_WEB_PATH%%vnag.php</a>"
  31.                 vnag_webreader_password = "%%WEBREADER_PASSWORD%%"
  32.                 vnag_webreader_signPubKey = "%%WEBREADER_PUBKEY%%"
  33.         }
  34.         assign where host.name == NodeName
  35. }</pre></li>
  36.  
  37.         <li>Restart Icinga2<br><br></li>
  38.  
  39.         <li>You can use various apps for Android and iPhone, or even your web browser to monitor the OIDplus version using Icinga2</li>
  40. </ol>
  41.  
  42.  
  43.  
  44. <h2>Variant B: OIDplus is hosted on the same system as the Icinga2/Nagios server</h2>
  45.  
  46. <p>Example setup using Linux and Icinga2</p>
  47.  
  48. <p><img src="%%REL_WEB_PATH%%/img/variant_b.png"></p>
  49.  
  50. <ol>
  51.         <li>Install Icinga2, in case it isn't installed yet. Follow the documentation of Icinga2 in order to setup everything correctly.<br>
  52.         You don't need to install VNag.<br><br></li>
  53.  
  54.         <li>Create a new file <b>/etc/icinga2/conf.d/oidplus_version.conf</b> with the following contents:<pre>
  55. object CheckCommand "cmd_oidplus" {
  56.         command = [ "$cmd_oidplus_dir$/%%REL_LOC_PATH%%vnag.sh" ]
  57.         arguments = {
  58.         }
  59. }
  60. apply Service "example_oidplus_version_check" {
  61.         import "generic-service"
  62.         check_command = "cmd_oidplus"
  63.         vars = {
  64.                 cmd_oidplus_dir = "%%SYSTEM_URL%%"
  65.         }
  66.         assign where host.name == NodeName
  67. }</pre></li>
  68.  
  69.         <li>Restart Icinga2<br><br></li>
  70.  
  71.         <li>You can use various apps for Android and iPhone, or even your web browser to monitor the OIDplus version using Icinga2</li>
  72. </ol>
  73.