DansGuardian Brief Installation Guide

Tue 9th October 2001 - version 2.x.x

Installing from RPM

  1. Download the correct RPM for DansGuardian 2.
  2. If upgrading from an older version of DansGuardian, make a backup of your /etc/dansguardian directory. Also stop running any old version.
  3. rpm -Uvh DansGuardian-2....rpm (fill in the blank) (--nodeps might be needed)
  4. Now edit the dansguardian.conf file to your liking paying special attention to the accessdeniedaddress option.

Installing from source

  1. Download the source for DansGuardian 2.
  2. If upgrading from an older version of DansGuardian, make a backup of your /etc/dansguardian directory. Also stop running any old version.
  3. Untar with a 'tar -zxpf DansGuardian-2.....tar.gz' (fill in the blanks).
  4. cd into the new directory.
  5. Run the configure (./configure --help) script with the help option to see the user selectable settings. Default settings are shown in []'s.
  6. Run the configure (./configure) script with your options, if any. (RedHat 6.2/7.0 users can leave the default settings. Other users see below.
  7. Edit the Makefile and verify that all the directory settings are correct. If not, re-run the configure script.
  8. "make" will now build DansGuardian.
  9. "make install" will create the directory structure and install all the files in the chosen paths.
  10. "make clean" will remove the now un-needed binaries etc.
  11. Now edit the dansguardian.conf file to your liking paying special attention to the accessdeniedaddress option.

Options

You may change with the configure options:
bindir (where the binary gets places)
sysconfdir (where the config and data files gets placed)
sysvdir (where the startup script gets placed)
cgidir (where the cgi-bin dir is located)
mandir (where the man docs get placed)
logdir (where the logs get placed)
runas_usr (the system user the daemon runs as)
runas_grp (the system group the daemon runs as)
piddir (where the pid file gets placed)

The INSTALL file included within the source tarball gives all this information as well as example options for FreeBSD, OpenBSD, Mandrake, SuSE, etc

Nearly finished

You need to make DansGuardian start up when the server reboots. For linux this means use your favourite SysV editor to stick DansGuardian in run level 5 and 3 at about 92, if chkconfig/rpm has not already done this for you.

Also you need to rotate the logs once a week. As root, crontab -e and set the log rotation script up as follows:
59 23 * * sun /etc/dansguardian/logrotation
I.e 23:59 every sunday. Or as pleases you. Note, the path may be different. You don't have to use my splendid script and could use any method you want so long as it stops DansGuardian first, rotates then starts it again.

Finally

The port it listens on by default is 8080. It uses port 3128 on Squid. To manually start it run /etc/rc.d/init.d/dansguardian start. Use stop to stop it. For all support issues, join the mailing list and post your question or comment there. Everyone would like to know of success or failure as this may help them. The messages also act as an archive of information that may get put into the FAQ.

If you feel your message is not suitable for public viewing and is private (for example asking for pricing or other commercial issues) then email me direct. My address is author at dansguardian dot org.