DansGuardian Documentation Wiki

You are here: Main Index » where_to_get_it


|

Wiki Information

Differences

This shows you the differences between the selected revision and the current version of the page.

where_to_get_it 2009/06/27 21:50 where_to_get_it 2010/10/22 16:24 current
Line 1: Line 1:
-====== Introduction ======+====== Where To Get It ======
There are several places to obtain DansGuardian, usually from your distribution's official and unofficial repositories.  There are several places to obtain DansGuardian, usually from your distribution's official and unofficial repositories. 
:!:<color DarkRed>**Make sure you read and agree with the [[http://dansguardian.org/?page=copyright2| License and Copyright]] before you download the software.  If you are charging for software installation or using this software commercially, then you should pay for a license!**</color> :!:<color DarkRed>**Make sure you read and agree with the [[http://dansguardian.org/?page=copyright2| License and Copyright]] before you download the software.  If you are charging for software installation or using this software commercially, then you should pay for a license!**</color>
-===== Download Locations =====+==== Download Locations ====
-First check the usual repositories for your distribution for a pre-built package. If the usual package for your distribution doesn't meet your [[Which Version?|version requirements]], next look for "experimental" or "unofficial" repositories for your distribution.+First check the usual repositories for your distribution for a pre-built package. If the usual package for your distribution doesn't meet your [[Which Version?|version requirements]] (less common than in the past), next look for "alpha/beta/test/development/experimental" or "unofficial" repositories for your distribution.
-If you still can't find anything satisfactory, you may be able to download either the source or compiled packages for various operating systems at various places including the following page. (You may instead prefer to use the compiled packages available from the usual archive for your distribution.)+If you still can't find anything satisfactory, you may be able to download either the source or compiled packages for various operating systems at various places such as the Dag Wieers collection (or the following page). (You may instead prefer to use the compiled packages available from the usual archive for your distribution.)
  * [[http://dansguardian.org/?page=download| DansGuardian Web Site and Mirrors]]   * [[http://dansguardian.org/?page=download| DansGuardian Web Site and Mirrors]]
-  * [[http://mambo.lopata.net/content/view/13/30/| DG Complete for OS-X]] +  * [[http://mambo.lopata.net/content/view/13/30/| DG Complete for OS-X]] (no longer available as of March 2010???)
-<color saddlebrown>Note currently there are no Patches or Patched Versions for DansGuardian. Instructions for some earlier versions of DansGuardian included these words: </color> +<color saddlebrown>Note for the 2.10 series there are no Patches or Patched Versions for DansGuardian. Instructions for some earlier versions of DansGuardian said: </color>
For Patches and Patched versions go to [[Patches and Hacks]]. For Patches and Patched versions go to [[Patches and Hacks]].
-===== Special Distributions ===== +==== Special Distributions ==== 
-A derivative of DansGuardian is available as the Cop+ addition to the IPCop distribution. (It would be very difficult to install DansGuardian onto an IPCop system directly instead of using the Cop+ package.) That DansGuardian is very closely integrated into IPCop, so much so that configuration information about DansGuardian may be quite difficult to translate for use on an IPCop system. A better source of assistance for Cop+ on IPCop may be http://copfilter.endlich-mail.de/+A pre-configured version of DansGuardian is available as the Cop+ addition to the IPCop distribution. (It would be very difficult to install DansGuardian onto an IPCop system directly instead of using the Cop+ package.) That DansGuardian is very closely integrated into IPCop, so much so that making manual configuration changes to DansGuardian can break things without giving you clear error messages telling you what's wrong. People who aren't experienced linux system admins should stick with the functions provided by the Cop+ Web GUI. Cop+ is available here: http://home.earthlink.net/~copplus
An unsupported homebrew package derived from DansGuardian is available for SmoothWall Express. A good source for assistance with packages added to  SmoothWall Express is http://community.smoothwall.org/forum/ An unsupported homebrew package derived from DansGuardian is available for SmoothWall Express. A good source for assistance with packages added to  SmoothWall Express is http://community.smoothwall.org/forum/
Several of SmoothWall's commercial products inlude a web filter similar to DansGuardian. For assistance with these, contact the reseller you purchased the base product from. Or if you bought directly from SmoothWall, investigate https://support.smoothwall.net/ Several of SmoothWall's commercial products inlude a web filter similar to DansGuardian. For assistance with these, contact the reseller you purchased the base product from. Or if you bought directly from SmoothWall, investigate https://support.smoothwall.net/
-===== New To Linux ===== + 
-Become familiar with Linux before attempting to set up a DansGuardian web filter for a whole network:+==== New To Linux ==== 
 +Become familiar with Linux before attempting to set up a DansGuardian web filter for a whole network (or any other production use):
  - Choose the distribution that DansGuardian (and other servers) will ultimately use.   - Choose the distribution that DansGuardian (and other servers) will ultimately use.
  - Install the chosen Linux distribution on your own computer on your own desktop.   - Install the chosen Linux distribution on your own computer on your own desktop.
  - Use the Linux system routinely and constantly to become very familiar with both its maintenance tools and its administration procedures.   - Use the Linux system routinely and constantly to become very familiar with both its maintenance tools and its administration procedures.
-DansGuardian on Linux is not rocket science. But it's not incredibly user-friendly either, and it's not an excellent place to start. Perhaps installing and maintaining DansGuardian when you're not already familiar with Linux should be proscribed to nerd geniuses only.  +DansGuardian on Linux is not rocket science. But it's not incredibly user-friendly either, and it's not an excellent place to start out. Perhaps installing and maintaining DansGuardian even though you're not yet familiar with Linux should be restricted to nerd geniuses only. 
-===== Building From Source =====+==== Building From Source ====
Sometimes you won't be able to locate and use a package, and will instead need to build DansGuardian from source. (This situation is //not// common, but it does happen every so often.) Possible reasons for building from source include: Sometimes you won't be able to locate and use a package, and will instead need to build DansGuardian from source. (This situation is //not// common, but it does happen every so often.) Possible reasons for building from source include:
Line 44: Line 45:
The [[http://dansguardian.org/downloads/2/|complete source code]] is available as a tarball from the DansGuardian website.  Most systems already have almost everything necessary to build DansGuardian from source (glibc, autoconf, gcc, make, etc.). You may need to also obtain: i) the "zlib" build (runtime is probably already there) package and ii) the PCRE build (runtime is probably already there) package. The [[http://dansguardian.org/downloads/2/|complete source code]] is available as a tarball from the DansGuardian website.  Most systems already have almost everything necessary to build DansGuardian from source (glibc, autoconf, gcc, make, etc.). You may need to also obtain: i) the "zlib" build (runtime is probably already there) package and ii) the PCRE build (runtime is probably already there) package.
-If you are replacing an existing version (perhaps an earlier one from your distribution), it's important to //replicate the exact same build configuration//. __Do not rely on the "defaults"__. The "defaults" cannot encompass the wide variation from one distribution to the next. +If you are replacing an existing version (perhaps an earlier one from your distribution), it's important to //replicate the exact same build configuration//. <color #200>__Do not rely on the "defaults"__</color>. The "defaults" cannot encompass the wide variation from one distribution to the next.
To replicate an existing build configuration exactly: To replicate an existing build configuration exactly:
  - execute <color #351>dansguardian\ -v</color> using the //old// version, capture the exact output in a file, and print it.   - execute <color #351>dansguardian\ -v</color> using the //old// version, capture the exact output in a file, and print it.
  - in the ./configure step when building the new DansGuardian, enter all the options and values (especially the paths) exactly as they were output by the previous version   - in the ./configure step when building the new DansGuardian, enter all the options and values (especially the paths) exactly as they were output by the previous version