Provides a way for a Xymon server to monitor a DokuWiki installation
Compatible with DokuWiki
2014-09-29a 2014-09-29 2014-05-05 2013-12-08 2013-05-10 2010-11-07 2011-05-25 2011-11-10 angua 2012-10-13
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
This plugin is currently being tested, so use it at your own risks.
This plugin will allow a Xymon server to periodically fetch special pages from a Dokuwiki installation to report information and warn about potential updates or security holes.
More information about Xymon can be found at http://xymon.sourceforge.net/.
The plugin will test the following things:
This test will check if a new version of Dokuwiki is available. The information is the same as the information reported at the top of the pages.
The colors are:
Install the plugin manually by copying the directory dokuwiki-plugin/xymon into lib/plugins.
host# ll lib/plugins/xymon/ total 4 -r--r----- 1 wwwdokuwiki wwwdokuwiki 2453 Jan 4 11:58 action.php -r--r----- 1 wwwdokuwiki wwwdokuwiki 224 Jan 3 11:49 plugin.info.txt
The plugin will generate pages under the namespace xymon.
So you should:
Example:
The xymon script will fetch the pages using XMLRPC, so you must activate it and allow the corresponding user to use it.
Example:
Copy the xymon script to $XYMONHOME/ext. Check the file permissions and make sure it is executable.
In $XYMONHOME/etc/tasks.cfg, add:
[dokuwikicheck] ENVFILE /usr/local/www/xymon/server/etc/xymonserver.cfg NEEDS xymond GROUP nettests CMD /usr/local/www/xymon/server/ext/dokuwiki.rb INTERVAL 24h
In $XYMONHOME/etc/hosts.cfg:
0.0.0.0 wikiname:dokuwiki #noconn NOCOLUMNS:info,trends dokuwikicheck DOKUWIKIURL:http://example.com/path/to/dokuwiki/ DOKUWIKIUSER:xymon DOKUWIKIPASSWORD:password
If you need the xymon server to connect using a ssl client certificate, you can add the corresponding fields:
0.0.0.0 wikiname:dokuwiki #noconn NOCOLUMNS:info,trends dokuwikicheck DOKUWIKIURL:https://example.com/path/to/dokuwiki/ DOKUWIKIUSER:xymon DOKUWIKIPASSWORD:password DOKUWIKISSLCERT:/path/to/certs/client-cert-crt.pem DOKUWIKISSLKEY:/path/to/certs/client-cert-key.pem DOKUWIKISSLCACERT:/path/to/certs/server-ca-crtchain.pem
Make sure that the certificate files are readable by the xymon server.
Also make sure that the server certificate chain is correct, because the script will refuse to connect if the webserver can't be authenticated. If you really don't want to verify the server's identity, you can edit the ruby script yourself to allow openssl to connect anyway (but you don't want to do this because you care about your security).
When the plugin and the script are installed, the status of the installation appears in the xymon interface:
It's time to update this installation:
To be written
See the bug tracker at GitHub: https://github.com/ZeWaren/dokuwiki-plugin-xymon/issues
hostname was not match with the server certificate