]> git.wincent.com - bansshee.git/blob - contrib/RHEL-5.3/README
contrib/RHEL-5.3: add sample configuration file
[bansshee.git] / contrib / RHEL-5.3 / README
1 This directory contains platform-specific Bansshee support files for Red Hat
2 Enterprise Linux 5.3.
3
4   - configuration file:
5     - etc/bansshee.conf
6   - logwatch filter files:
7     - etc/logwatch/conf/services/bansshee.conf
8     - etc/logwatch/conf/services/secure.conf
9     - etc/logwatch/scripts/services/bansshee
10   - startup script:
11     - etc/rc.d/init.d/bansshee
12
13
14 DIFFERENCES FROM THE DEFAULT SETTINGS
15
16 The default settings in the bansshee script were designed to work with Red Hat
17 Enterprise Linux ES 3. There are three main differences when moving to RHEL
18 5.3:
19
20   (1) Some of the status messages emitted by sshd have changed slightly:
21       - what was previously "illegal user" is now "invalid user"
22       - instead of just "Failed password", we might also see now "Failed none"
23         and "Failed publickey"
24   (2) The logwatch configuration files have moved from "/etc/log.d" to
25       "/etc/logwatch". In addition, a minor bug in the previous version of the
26       logwatch script has been corrected (previously it tried to match
27       "appended" when it should have matched "added").
28   (3) Appending the BANSSHEE chain to the default firewall rules will have no
29       effect because by the time the initial INPUT chain is finished all SSH
30       traffic will already have been accepted; we therefore have to insert the
31       chain rather than appended. (Obviously if you have a custom set of
32       firewall rules then you may want to tweak this even further, inserting
33       the BANSSHEE chain before a specific rule number.)
34
35
36 INSTALLATION
37
38 To use the configuration file, copy it into the /etc directory:
39
40   sudo cp etc/bansshee.conf /etc/bansshee.conf
41
42 To use the filter files, copy them to the appropriate directories:
43
44   sudo cp etc/logwatch/conf/services/* \
45           /etc/logwatch/conf/services/
46   sudo cp etc/logwatch/scripts/services/bansshee \
47           /etc/logwatch/scripts/services/
48
49 To use the startup script, copy it to the /etc/rc.d/init.d directory:
50
51   sudo cp etc/rc.d/init.d/bansshee /etc/rc.d/init.d/
52
53 Specify that the basshee service should be started at boot time:
54
55   sudo chkconfig bansshee on
56
57 Confirm that the service will be started at boot:
58
59   sudo chkconfig --list bansshee
60
61 Start the bansshee service if not already started:
62
63   sudo service bansshee start
64
65 AUTHOR
66
67 These RHEL 5.3 support files were prepared by Wincent Colaiuta
68 (win@wincent.com).