Perl Clients Guide

As already mentioned in the architecture guide, all Perl clients are written around Perl module Bionanny::Listener et al. Their API is a simplified Bionanny API (allowing to get data but not to log them - at least not at the moment).

Where are all these clients?

The sources are in the src/perl subdirectory (where else?) - but the Ant compile target moves them into build/run directory and some of them into build/cgi-bin directory. That's the place they should be used/called from.

Note, however, that the Ant compile target just moves them but it does not check if their first line (usually something like #!/usr/local/bin/perl -w) corresponds with the Perl executable location on your machine. Therefore, you may need to change it manually.

	bionanny.pl client

The bionanny.pl is a comprehensive command-line client. Invoke it by:

build/run/bionanny.pl [options]

For a detailed help with examples, call (assuming that the perldoc is on your path):

build/run/bionanny.pl -h

	cgi-bin client

There are several scripts that can be called as cgi-bin scripts and they show monitored data in a Web browser. As always with the cgi-bin scripts, the important is to put them where your HTTP server can find them. By default, the Ant will move them to the build/cgi-bin directory - so you can simply make a symbolic link pointing there.

Or, you can set an Ant property cgi.bin.dir pointing to a directory where Ant will copy them instead. For example:

./build-dev.sh -Dcgi.bin.dir=/my/cgi-bin/place compile

Remember, however, the example above will work only if you have a correct write permission to the destination directory.

Now, when your HTTP server knows about them, you can put in your browser something like:

http://localhost/cgi-bin/bionanny/monitor-index

and start to use it.