Provided by: wulf2html_2.6.0-0ubuntu5_all 
NAME
wulfweb - A script to create an html table of cluster node statistics
SYNOPSIS
wulfweb [-d delay] [-f wulfhosts] [-i include] [-p path] [-t type] [-h] [-v level]
filename
WULFWEB OPTIONS
filename (required) is the name of the web page created (e.g. mycluster.html)
-d delay sets the delay used for both wulflogger and page updates
-f wulfhosts to specify a particular wulfhosts file
-i include file (which must contain html intended to go after <html> and before the
table in the created web page).
-t type to control wulflogger "type" of display.
-h displays help/usage
-v level controls verbosity and debugging output
DESCRIPTION
wulfweb is a script that creates a web page containing an optional inclusion (described in
detail below) followed by an html table formatted to contain automatically updated cluster
statistics collected from xmlsysd's running on the cluster nodes by wulflogger. Note that
wulflogger is therefore required by the wulfweb program.
A typical invocation might be:
$ wulfweb -f /usr/share/wulfweb/wulfhosts -d 60 -t 1 \
-i myheader.html mycluster.html &
to create a page with the header myheader.html in front of the "load averages" table that
auto-refreshes every 60 seconds. The cluster is described in the wulfhosts file (see
wulfstat(1) or wulflogger(1) for details). Run in the background, wulfweb will keep this
page current indefinitely.
INCLUDED FILE
The included file must contain valid html for material that you might wish to precede the
table. It can be empty (or no include file may be given on the command line) in which
case the raw table and the <meta> tag that causes automatic refresh are the sole contents
of the output file.
The included header file can be as fancy as you like, but I'd strongly urge that if you
want to embed the tables in a complex document you consider using php and including the
table in a php-generated page, as otherwise I think you'll find this simple inclusion
mechanism limiting.
Be warned! Check the resulting documents produced carefully for errors! The most that
wulfweb can do is produce the table (hopefully correctly). Obviously it cannot be blamed
for bad html in any inclusion.
The following is an example of a reasonable inclusion that should work:
<html>
<head>
<title>MyCluster Stats</title>
</head>
<body>
<h2>MyCluster Load Average</h2>
<hr>
DISPLAY TYPES
The following display types are supported by wulflogger:
0 - a "vmstat-like" display of stats from all cluster hosts. Probably
the most useful single display.
1 - load average only
2 - memory utilization (similar to running "free" on each host)
3 - network rates
4 - time displays system clocks, uptime, cpu type and clock
5 - pids interface for monitoring running distributed tasks.
6 - pids interface for monitoring running distributed tasks with
full command line displayed.
The pids interface (with or without the full command line displayed) is a bit quirky. It
will generally ignore root-owned tasks, for example, presuming that the tool is intended
to monitor userspace applications. There exist wulfhosts controls for these properties;
eventually they will likely be controllable at the command line of this tool as well.
SEE ALSO
xmlsysd(8), wulfstat(1), wulflogger(1)
WARNING WARNING WARNING
Trust No One. Your Mileage May Vary. Use With Caution. Void Where Prohibited. Use Your
Head. I am NOT RESPONSIBLE for losses you sustain based on the use of this software,
which comes with NO WARRANTY concerning suitability for any purpose and in fact may be
quite useless and misleading.
You Have Been Warned.
ACKNOWLEDGEMENT
Blessings on any and all who've ever contributed to the perl programming language, from
its inventors on down.