$Id: README,v 1.6 2013/02/06 08:05:18 he Exp $   -*- Text -*-


	RITZ is "Remote Interface to ZINO"
	ZINO is "Zino is not OpenView"

OK, so I ran out of good ideas for a name...


Together these two make up a prototype of a simple network management
system, entirely written in Tcl.  Features:

 o Trap-driven polling; receives and interprets traps.
 o Periodic status polling (by default low frequency).
 o A simplistic event handling system.
 o A simple SMTP-like client/server protocol.
 o A TK-based user interface.

all in a little under 5000 lines of Tcl.

To install and use zino/ritz, you need:

 o Tcl and TK version >= 8.0 (we use 8.5.12)
 o A version of Tix compatible with the above (we use 8.4.3)
 o A version of Scotty compatible with the above (we use 2.1.11 with
   the patch in scotty.diff applied; the latter is essential for this
   version of scotty to have the straps program work as intended).
   Version 3 has deviated and is therefore more problematical.
 o Perl version 5, we use perl 5.14.2, but perl>=5.8 will also work
   fine.  Additionally, a number of perl modules are required:
     DateTime, GD, IPC::Shareable, TimeDate, YAML, 
 o Apache version 2.2 web server, including mod_perl (we use version 2.0.5)
 o rrdtool, including the RRDs perl module; we use either rrdtool
   version 1.2.x, 1.3.x or 1.4.x.
 o gnuplot (we use version 4.6.1)

Additionally, your package system will hopefully detect whith other
pieces of software these bits depend on, and install those too.


User authentication is implemented with a simple challenge/response
scheme which uses the Secure Hash Algorithm implemented by the program
in the sha/ subdirectory.  Compile and install it in a directory in
the users PATH to use it.

			 - oo -

Since the above was written, the NORDstat package has been integrated
into this package, and zino, the traffic statistics collector and the
software version monitor all share a common configuration file and
code to handle that.

This has caused some minor modification of the config file format; the
enclosed examples show the difference (the addition of "default" in
front of the default settings).

The traffic statistics collection software should now support 64-bit
counters as well, including computation of daily reports, and the
various plots.

Lastly, the daily textual reports have been extended with a
calculation of 90th percentile load values, and the weekly and monthly
reports also include the medians of the daily 90th percentile values.
These values are not yet reported via the web interface.


Comments to he@nordu.net
