source: trunk/scripts/README

Last change on this file was 481, checked in by katerina, 6 years ago

Enhancements and fixes for tickets #374, #375, #376, #377, #378, and #379.

File size: 2.9 KB
Line 
1
2
3This directory contains miscellaneous useful scripts, some of them contributed
4by various users. Additions and/or improvements are welcome.
5
6chroot.sh: prepare chroot environment for the log server
7---------
8
9   Usage: chroot.sh <chroot_directory>
10
11   Tested on Debian Linux. Your mileage may vary.
12   After running the script, review <chroot_directory>/etc/passwd
13   to replace passwords with a *, and to fix the
14   path to the home directory of the yule user.
15   If using a signed configuration file, you need
16   a working copy of GnuPG inside the chroot jail.
17
18   This script will probably fail on systems other than Linux,
19   mainly because of the mknod commands to create devices
20   in the chroot jail.
21
22   NO WARRANTY !!!
23
24samhainadmin.pl
25---------------
26
27   Perform various tasks useful if you are using signed configuration
28   and database files.
29
30   Run 'samhainadmin.pl -h' for usage instructions.
31
32yuleadmin.pl
33------------
34
35   Perl script (by Riccardo Murri) to list, add, and remove clients
36   from the yulerc file.
37
38   Run 'yuleadmin.pl -h' for usage instructions.
39
40check_samhain.pl
41----------------
42
43   Nagios plugin for samhain. Will execute samhain and report results
44   in the way expected by nagios. Drop this into your nagios/libexec/
45   directory.
46
47samhain.logrotator: logrotate script
48------------------
49
50   This is a logrotate script (contributed by Simon Bailey)
51
52concat.pl
53---------
54
55   Concatenate samhain file signature databases and write the resulting
56   database file to stdout. Does not work on signed or otherwise modified
57   file signature databases.
58
59samhain.{cgi|dtd|xsl}: display XML logfile in XML capable browser
60---------------------  (works with Mozilla 1.2, possibly Mozilla 1.0, IE 6)
61
62   Usage: 1. review samhain.cgi (see remarks in file)
63          2. drop samhain.cgi, samhain.dtd, samhain.xsl in some
64             directory on your webserver
65          3. use .htaccess to protect access to that directory
66          4. point your browser at samhain.cgi
67
68   You may need to rename samhain.cgi to samhain.php if you use
69   mod_php. Also, you will certainly need to edit the path to the
70   logfile in samhain.cgi.
71
72   CAVEAT: There is no built-in access restriction (use .htaccess to
73           password-protect the directory).
74
75   The XSL stylesheet is based on a contribution by Olivier Salaun.
76
77
78samhain.spec: RPM spec file for building a vanilla single-host RPM
79------------
80
81   Contributed by Andre Oliveira da Costa <brblueser@uol.com.br>
82
83   This is a spec file to produce a vanilla single-host samhain RPM
84   (no fancy options, standard directory layout :).
85
86   Accepted parameters for 'rpmbuild':
87
88   --with gpg           - enables gpg support
89   --with tests         - make tests before building
90
91redhat_i386.client.spec: RPM spec file for building a RedHat client RPM
92------------
93
94   Contributed by Philipp Stadler <philipp@stadler.priv.at>
95
96   Does not install documentation or local config file.
97
98
99                   
Note: See TracBrowser for help on using the repository browser.