lr_run_tests - Run several tests on a Lire installation lr_run_tests testdir lr_run_tests exercises several aspect of a Lire system. The testdir argument should be a directory which has the following directory structure
testdir/logs/output/mail/tmp/
The logs and mail subdirectories contain the input that will be used to test Lire.
TEST INPUT The logs/ subdirectory should contain log files named service.log or service-number.log. Example: ipchains.log, combined.log or combined-1.log. The mail/ subdirectory should contain email messages that represent requests to the online responder. The message should be named service.mail or service-number.mail. Example: xferlog.mail or xferlog-1.mail.
LR_LOG2REPORT TESTS lr_run_tests will create an XML report for each log file contained in the logs subdirectory. The XML reports will be saved under output/xml/basename.xml. An ASCII report will then be generated in output/txt/basename.txt. After that, if the requirements needed to generate HTML, XHTML or PDF reports are installed, a report in that format will be created in output/format/basename.format. If the requirements needed to generate images are available, a report with images will also be created under output/format-i/basename. This will be a directory in the case of the HTML or XHTML output format.
LR_PROCESSMAIL TESTS All emails in the mail/ subdirectory will be processed. Make sure that the input emails have a reachable email address in the From: or Reply-To: header so that you can receive the result of the test. Each email should contain one log file, either as a (possibly gzipped) attachment or as plain text in the email body.
LOGGING The tests are run with DEBUG, KEEP and ARCHIVE set to off. (See the Configuration Parameters section in the Lire User Manual for details about these variables.) All messages with a level of notice or higher will be saved in the appropriate output subdirectory under the name basename.log, where basename matches the input file. All those messages will also be output on STDERR. Additionally, if an error file was generated while the XML report was computed, you will find this file under output/xml/basename.error. Additionally, lr_run_tests will output info level messages specifying input files that generated warnings or higher level messages or that had other problems.
USING LR_RUN_TESTS You should check all generated reports intended for users (all except the XML one) for sanity. Also, you should make sure that all error messages are legitimate (they represent bogus input, really invalid log lines or missing installed components.) The idea of this script is to make it possible to run systematically a bunch of tests and analyze the input later rather then the iterative approach where it is easy to forget something. lr_log2report(1), lr_processmail(1), documentation in the Lire User Manual This manpage: $Id: lr_run_tests.pod,v 1.3 2002/02/12 18:47:04 flacoste Exp $ Copyright (C) 2001 Stichting LogReport Foundation [email protected] This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html or write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. Francis J. Lacoste <[email protected]>