Step by step Fedora squidGuard Installation and Configuration 

   The example of Fedora squidGuard installation and configuration below tested and done using Fedora 17.. To use squidGuard as an squid proxy content filter and redirect proxy user from accessing banned website you must configure squid and then proceed with squidGuard installation and configuration.  The step by step below show the example of squidGuard configuration start from the intallation process....

squidGuard installation

1.  Login on your Fedora box.  Open x terminal by go to Activities -> Applications -> System Tools -> Terminal

2.  and then issue su - command and enter root password when ask as show on example below

[jason@fedora ~]$ su -

Password:   <-- Type in root password here and hit enter key

[root@fedora ~]#

3.  Check if squidGuard already installed on the system if not....

[root@fedora ~]# rpm -q squidGuard

package squidGuard is not installed

[root@fedora ~]#

4.  Then download and install squidGuard using yum command as show on example below.

[root@fedora ~]# yum -y install squidGuard

.... until ....

Complete!

[root@fedora ~]#

5.  Then go to /var/squidGuard/ directory, download and unpack the squidGuard blacklist files blacklists.tar.gz that locate in /var/squidGuard.

... Go to /var/squidGuard

[root@fedora ~]# cd /var/squidGuard/

... Download squidGuard blacklists files.

[root@fedora squidGuard]# wget ftp://ftp.univ-tlse1.fr/blacklist/blacklists.tar.gz

... Unpack tar.gz blacklists file

[root@fedora squidGuard]# tar -zxvf blacklists.tar.gz.1

6.  EDIT squidGuard configuration file, see the squidGuard,conf configuration example here...

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

7.  Add squidguard to squid proxy configuration file, to enable squid proxy filter unwanted websites base on your squidGuard configuration...

[root@fedora ~]# vi /etc/squid/squid.conf

# ==========to make squid proxy use squidGuard===================

# ==========redirect from squid.conf          ===================

url_rewrite_program /usr/bin/squidGuard -c /etc/squid/squidGuard.conf

url_rewrite_children 500

# =====================================================

8.  Create and change the owner of squidGuard directory permission.

[root@fedora squidGuard]# mkdir /var/log/squidGuard/old

[root@fedora squidGuard]# chown squid:squid /etc/squid/squidGuard.conf

[root@fedora squidGuard]# chown -R squid:squid /var/squidGuard/blacklists

[root@fedora squidGuard]# chown -R squid:squid /var/log/squidGuard
[root@fedora squidGuard]#

9.  Compile squidGuard blcklists database... inorder to make blacklist we need to make the blacklists file databese ... use one of the command example below

[root@fedora squidGuard]# su squid -s /bin/sh -c "/usr/bin/squidGuard -c /etc/squid/squidGuard.conf -C all"

... or use this command if above command not working well ( # squidGuard -C all )...

or you may get error that say:

2012-07-27 00:16:44 [3302] /usr/bin/squidGuard: can't write to logfile /var/log/squidGuard/squidGuard.log
and 2012-07-27 00:16:44 [3302] Error db_open: No such file or directory then 2012-07-27 00:16:44 [3302] Going into emergency mode

dont worry ..those error may related to file permission and log files location.. go back to step 8 to change file permission...

10.  Stop squid and....

[root@fedora squidGuard]# service squid stop

Redirecting to /bin/systemctl stop squid.service

[root@fedora squidGuard]#

or use...

[root@fedora squidGuard]# /usr/bin/killall -HUP squid

11.  ...and start squid to apply the new squidGuard configuration.

[root@fedora squidGuard]# service squid start

Redirecting to /bin/systemctl start squid.service

[root@fedora squidGuard]#

to make sure that your proxy server start up automatically during the boot up...

[root@fedora squidGuard]# systemctl enable squid.service

12.  to verify and check squid server is up and running or not execute command as show on example below

[root@fedora squidGuard]# service squid status

... execute command below to check the squid and squidGuard process.

[root@fedora squidGuard]# ps aux | grep squid

root     12762  0.0  0.0   4252   468 pts/0    S+   13:04   0:00 tail -f /var/log/squidGuard/squidGuard.log
root     12844  0.0  0.1  16132  2540 ?        Ss   13:09   0:00 /usr/sbin/squid -f /etc/squid/squid.conf
squid    12846  4.0  0.6  28056 13264 ?        S    13:09   0:00 (squid-1) -f /etc/squid/squid.conf
squid    12847  0.2  0.0   3812   976 ?        S    13:09   0:00 (logfile-daemon) /var/log/squid/access.log
squid    12848  0.0  0.0   3668   728 ?        S    13:09   0:00 (unlinkd)
squid    12849  2.0  0.2   8320  5788 ?        S    13:09   0:00 (squidGuard) -c /etc/squid/squidGuard.conf
root     12851  0.0  0.0   4744   784 pts/1    S+   13:09   0:00 grep --color=auto squid

==== squid and squidGuard log ====

[root@fedora squidGuard]# tail -f /var/log/squidGuard/squidGuard.log

[root@fedora squidGuard]# ll /var/log/squidGuard/

[root@fedora squidGuard]# tail -f /var/log/squid/access.log

Keywords:  squidGuard fedora, fedora squidguard, configure squidguard fedora, fedora configure squidguard, squidguard installation fedora