mirror of
https://github.com/rsyslog/rsyslog.git
synced 2025-12-17 07:00:42 +01:00
54 lines
1.8 KiB
Plaintext
54 lines
1.8 KiB
Plaintext
This directory contains the rsyslog testbench. It is slowly
|
|
evolving. New tests are always welcome. So far, most tests check
|
|
out the functionality of a single module. More complex tests are
|
|
welcome.
|
|
|
|
For a simple sample, see rtinit.c, which does a simple
|
|
init/deinit check of the runtime system.
|
|
|
|
Test Naming
|
|
===========
|
|
|
|
Test that use valgrind shall end in "-vg.sh".
|
|
Test that use valgrind's helgrind thread debugger shall end in "-vgthread.sh".
|
|
|
|
Setting up Test Environments
|
|
============================
|
|
|
|
Setting up MariaDB/MySQL
|
|
------------------------
|
|
to create the necessary user:
|
|
|
|
echo "create user 'rsyslog'@'localhost' identified by 'testbench';" | mysql -u root
|
|
mysql -u root < ../plugins/ommysql/createDB.sql
|
|
echo "grant all on Syslog.* to 'rsyslog'@'localhost';" | mysql -u root
|
|
|
|
openSUSE
|
|
--------
|
|
To configure system properties like hostname and firewall, use the
|
|
graphical "yast2" administration tool. Note the ssh-access by default
|
|
is disable in the firewall!
|
|
|
|
Core Dump Analysis
|
|
==================
|
|
The testbench contains some limited (yet useful) support for automatically
|
|
anaylzing core dumps. In order for this to work, obviously core files need
|
|
to be generated. This often doesn't work as intended. If you hit this problem,
|
|
check
|
|
|
|
1. ulimit -c unlimited (or a reasonable limit)
|
|
Note that root may need to increase a system-wide limit, which is
|
|
usually recorded in /etc/security/limits.conf
|
|
You need:
|
|
* soft core unlimited
|
|
|
|
2. cat /proc/sys/kernel/core_pattern"
|
|
On systemd systems (and some others), the pattern is changed to save
|
|
core files so that systemd can import them -- with the result that the
|
|
testbench doesn't see them any longer. We require classic format, which
|
|
can be set via
|
|
$ sudo bash -c "echo \"core\" > /proc/sys/kernel/core_pattern"
|
|
|
|
Note that you probably want to do neither of these changes to a production
|
|
system.
|