From: hal9 <hal9@users.sourceforge.net> Date: Mon, 18 Mar 2002 03:53:53 +0000 (+0000) Subject: Some new additions. X-Git-Tag: v_2_9_12~21 X-Git-Url: http://www.privoxy.org/gitweb/%22https:/faq/@default-cgi@/user-manual/static/@default-cgi@send-stylesheet?a=commitdiff_plain;h=350bcfb6c54e53181733efe4eb092b61ab3a3351;p=privoxy.git Some new additions. --- diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml index b84c590f..ec97e00a 100644 --- a/doc/source/faq.sgml +++ b/doc/source/faq.sgml @@ -6,7 +6,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: faq.sgml,v 1.15 2002/03/17 07:25:59 hal9 Exp $ + $Id: faq.sgml,v 1.16 2002/03/17 21:32:56 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge IJBSWA team. http://ijbswa.sourceforge.net @@ -20,7 +20,7 @@ <artheader> <title>Junkbuster Frequently Asked Questions</title> -<pubdate>$Id: faq.sgml,v 1.15 2002/03/17 07:25:59 hal9 Exp $</pubdate> +<pubdate>$Id: faq.sgml,v 1.16 2002/03/17 21:32:56 hal9 Exp $</pubdate> <authorgroup> <author> @@ -280,6 +280,7 @@ warranty? Registration?</title> <!-- ~~~~~ New section ~~~~~ --> <sect2 id="installation"><title>Installation</title> + <sect3 id="newinstall"><title>Can I install the new <application>Junkbuster</application> over the old one?</title> <para> @@ -290,24 +291,25 @@ warranty? Registration?</title> </para> <para> See the user-manual for platform specific installation instructions. - [FIXME: This is meant for after the name change!] + [FIXME: This is meant for after the name change for 3.0!] </para> </sect3> <sect3> -<title id="nothing">I just installed Junkbuster, and nothing is happening. -All the ads are there. What's wrong?</title> +<title id="firststep">I just installed Junkbuster. Is there anything +special I have to do now?</title> <para> - Did you configure your browser to use <application>Junkbuster</application> - as a proxy? It does not sound like it. See below. You might also try flushing - the browser's caches to force a full re-reading of pages. + All browsers must be told to use <application>Junkbuster</application> + as a proxy by specifying the correct proxy address and port number + in the appropriate configuration area for the browser. See below. </para> </sect3> + <sect3 id="localhost"><title>What is the proxy address of Junkbuster?</title> <para> If you set up the <application>Junkbuster</application> to run on @@ -340,6 +342,26 @@ All the ads are there. What's wrong?</title> </para> </sect3> +<sect3> +<title id="nothing">I just installed Junkbuster, and nothing is happening. +All the ads are there. What's wrong?</title> + +<para> + Did you configure your browser to use <application>Junkbuster</application> + as a proxy? It does not sound like it. See above. You might also try flushing + the browser's caches to force a full re-reading of pages. You can verify + that <application>Junkbuster</application> is running, and your browser + is correctly configured by entering the special URL: + <ulink url="http://i.j.b/">http://i.j.b/</ulink>. This should give you + a banner that says <quote>This is the Internet JUNKBUSTER</quote> and + access to <application>Junkbuster's</application> internal configuration. + If you see this, then you are good to go. If not, the browser or + <application>Junkbuster</application> are not set up correctly. + +</para> + +</sect3> + </sect2> @@ -349,11 +371,65 @@ All the ads are there. What's wrong?</title> <sect3 id="newconfig"><title>Can I use my old config files?</title> <para> - No. These will not work. You will need to re-enter your old - data into the new configuration structure. + There are major changes to <application>Junkbuster</application> + configuration from version 2.0.x to 2.9.x and later. The older files will + not work at all. If this is the case, you will need to re-enter your old + data into the new configuration structure. This is probably also a good + recommendation even if upgrading from 2.9.x to 3.x since there were + many minor changes along the way. </para> </sect3> +<sect3> +<title id="actionsfile">What is an <quote>actions</quote> file?</title> + +<para> + <quote>actions</quote> files are where various actions that + <application>Junkbuster</application> might take, are configured. + Typically, you would define a set of default actions that apply + to all URLs, then add exceptions to these defaults. +</para> + +<para> + Actions can be defined on a per site basis, or for groups of sites. Actions + can also be grouped together and then applied to one or more sites. There + are many possible actions that might apply to any given site. As an example, + if we are blocking cookies as one of our default + <application>actions</application>, but need to accept cookies from a given + site, we would define this in our <quote>actions</quote> file. + +</para> + +<para> + <application>Junkbuster</application> comes with several default + <application>actions</application> files, with varying degrees + of filtering and blocking, as starting points for your own + configuration (see below). +</para> + +</sect3> + + +<sect3> +<title id="actconfig">How are actions files configured? What is the easiest +way to do this?</title> + +<para> + The easiest way to do this, is to access <application>Junkbuster</application> + with your web browser at <ulink url="http://i.j.b/">http://i.j.b/</ulink>, + and then select + "<ulink url="http://ijbswa.sourceforge.net/config/edit-actions">Edit the actions list</ulink>" + from the selection list. You can also do this by editing the appropriate + file with a text editor. +</para> + +<para> + Please see the user-manual for a detailed explanation of these and other + configuration files, and their various options and syntax. +</para> +</sect3> + + <!-- FIXME: Commenting these out until we have some data there. HB 03/17/02. @@ -547,6 +623,33 @@ Note that normally only local users can connect to JunkBuster, so this is not </para> </sect3> +<sect3> +<title id="lanconfig">How can I set up Junkbuster to act as a proxy for my + LAN?</title> +<para> + By default, <application>Junkbuster</application> only responds to requests + from localhost. To have it act as a server for a network, this needs to be + changed in the main config file where the <application>Junkbuster</application> + configuration is located. In that file is a <quote>listen-address</quote> + option. It may be commented out with a <quote>#</quote> symbol. Make sure + it is uncommented, and assign it the address of the LAN gateway interface, + and port number to use: +</para> + +<para> + <screen> + listen-address 192.168.1.1:8118 + </screen> +</para> + +<para> + Save the file, and restart <application>Junkbuster</application>. Configure + all browsers on the network then to use this address and port number. + +</para> + +</sect3> + </sect2> <!-- ~~~~~ New section ~~~~~ --> @@ -785,9 +888,9 @@ Why does Junkbuster leave these large gaps?</title> <para> It would be easy enough to just eliminate this space altogether, rather than fill it with blank space. But, this would create problems with many pages - that use the overall size of the ad to help organize the page layout and - hold the various components of the page where they were intended to be. It is - best left this way. + that use the overall size of the ad to help organize the page layout and + position the various components of the page where they were intended to be. + It is best left this way. </para> @@ -805,10 +908,12 @@ secure is it? Do I need to take any special precautions?</title> from <quote>localhost</quote>. It is not itself directly exposed to the Internet in this configuration. If you want to have <application>Junkbuster</application> serve as a LAN proxy, this will have to - be opened up to allow for external requests. In this case, we'd recommend - that the port used by <application>Junkbuster</application> (default is - 8118), be firewalled from outside (Internet) connections. Better safe than - sorry. + be opened up to allow for LAN requests. In this case, we'd recommend + you specify only the LAN gateway address, e.g. 192.168.1.1 in the main + <application>Junkbuster</application> config file. All LAN hosts can then use + this as their proxy address in the browser proxy configuration. In this way, + <application>Junkbuster</application> will not listen on any external ports. + Of course, a firewall is always good too. Better safe than sorry. </para> @@ -962,6 +1067,9 @@ What can I do?</title> Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: faq.sgml,v $ +Revision 1.16 2002/03/17 21:32:56 hal9 +A few more additions. + Revision 1.15 2002/03/17 07:25:59 hal9 Correcting some of my typos, and some additions.