Added page for icmpmonitor to website.
authorAaron Taylor <ataylor@subgeniuskitty.com>
Sun, 8 Nov 2020 14:16:39 +0000 (06:16 -0800)
committerAaron Taylor <ataylor@subgeniuskitty.com>
Sun, 8 Nov 2020 14:16:39 +0000 (06:16 -0800)
data/production/icmpmonitor/index.md [new file with mode: 0644]
data/production/icmpmonitor/index.metadata [new file with mode: 0644]

diff --git a/data/production/icmpmonitor/index.md b/data/production/icmpmonitor/index.md
new file mode 100644 (file)
index 0000000..b484e29
--- /dev/null
@@ -0,0 +1,39 @@
+# ICMPmonitor #
+
+ICMPmonitor pings a set of hosts, executing per-host, user-defined commands
+whenever a host begins or ceases to respond. It has been tested on OpenBSD,
+FreeBSD and Debian Linux.
+
+Configuration is simple. Each host to monitor should have a corresponding entry
+in the configuration file. Details of each entry may be found in `README.md`.
+The example below monitors the host `zardoz.subgeniuskitty.com` with a ping
+every 30 seconds, printing `A terrible silence echoes...` whenever 180 seconds
+elapse without receiving a ping response.
+
+    [zardoz.SGK]
+    host = zardoz.subgeniuskitty.com
+    interval = 30
+    max_delay = 180
+    up_cmd = "echo Zardoz returns..."
+    down_cmd = "echo A terrible silence echoes..."
+    start_condition = up
+
+Assuming your build environment is suitable, build and execute the example
+configuration with the following commands.
+
+    % make clean && make
+    % sudo ./icmpmonitor -f ./icmpmonitor.ini
+    ICMPmonitor: localhost up
+
+ICMPmonitor will execute any command you specify. This requires caution but
+allows access to the full power of the command line. Potential uses include
+power cycling ports on a PDC, triggering DNS changes, executing remote commands
+via SSH, writing to syslog, sending an email, or any other command you can
+imagine.
+
+For longer monitoring sessions, consider using `tmux` or `screen` to wrap
+ICMPmonitor.
+
+Obtain ICMPmonitor at <https://git.subgeniuskitty.com/icmpmonitor/.git>.
+
+See `README.md` for more information.
diff --git a/data/production/icmpmonitor/index.metadata b/data/production/icmpmonitor/index.metadata
new file mode 100644 (file)
index 0000000..64d3f56
--- /dev/null
@@ -0,0 +1,6 @@
+[DEFAULT]
+page_title = ICMPmonitor Homepage
+meta_keywords = 
+meta_description = 
+menu_text = ICMPmonitor
+menu_priority = 1000