How to Install CSF on a Cpanel Server

Installation

============

Installation is quite straightforward:

rm -fv csf.tgz

wget http://www.configserver.com/free/csf.tgz

tar -xzf csf.tgz

cd csf

sh install.sh

Next, test whether you have the required iptables modules:

perl /etc/csf/csftest.pl

Don't worry if you cannot run all the features, so long as the script doesn't

report any FATAL errors

You should not run any other iptables firewall configuration script. For

example, if you previously used APF+BFD you can remove the combination (which

you will need to do if you have them installed otherwise they will conflict

horribly):

sh /etc/csf/remove_apf_bfd.sh

That's it. You can then configure csf and lfd by edit the files

directly in /etc/csf/*, or on cPanel servers use the WHM UI

csf installation for cPanel is preconfigured to work on a cPanel server with all

the standard cPanel ports open.

csf installation for DirectAdmin is preconfigured to work on a DirectAdmin

server with all the standard DirectAdmin ports open.

csf auto-configures your SSH port on installation where it's running on a non-

standard port.

csf auto-whitelists your connected IP address where possible on installation.

You should ensure that kernel logging daemon (klogd) is enabled. Typically, VPS

servers have this disabled and you should check /etc/init.d/syslog and make

sure that any klogd lines are not commented out. If you change the file,

remember to restart syslog.

See the readme.txt file for more information.

Webmin Module Installation/Upgrade

==================================

To install or upgrade the csf webmin module:

Install csf as above

Install the csf webmin module in:

  Webmin > Webmin Configuration > Webmin Modules >

  From local file > /etc/csf/csfwebmin.tgz > Install Module

Uninstallation

==============

Removing csf and lfd is even more simple:

On cPanel servers:

cd /etc/csf

sh uninstall.sh

On DirectAdmin servers:

cd /etc/csf

sh uninstall.directadmin.sh

On generic linux servers:

cd /etc/csf

sh uninstall.generic.sh

GD::Graph

=========

This perl module is required for Statistical Graphs available from the csf UI.

It is dependent on garphical libraries being installed for your OS (e.g.

libgd, libpng, etc. which is beyond the scope of this document)

The perl module itself can be installed in a variety of ways, e.g.:

Debian v6:

# apt-get install libgd-graph-perl

Direct from cpan.org:

# perl -MCPAN -e shell

cpan> install GD::Graph