Rev 635 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line |
|---|---|---|---|
| 635 | daniel-mar | 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 | |||
| 800 | daniel-mar | 10 | <p><img src="%%REL_WEB_PATH%%/img/variant_a.png"></p> |
| 635 | daniel-mar | 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 | |||
| 800 | daniel-mar | 48 | <p><img src="%%REL_WEB_PATH%%/img/variant_b.png"></p> |
| 635 | daniel-mar | 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> |