SQUISH FAQ -- http://www.ledge.co.za/software/squint/squish/

INSTALLATION

Q.  How do I install it?
A.  make install
    These are the prerequisites (failing which things will just die
    inexplicably):
	- squid
	- apache (for CGI part)
	- perl
	- perl-GD
	- gd
	- cron

Q.  http://localhost/squish/squish.cgi says "Can't locate GD.pm in @INC"
A.  Install perl-GD
    On SuSE 9.2, you need these packages:
    	perl-GD-2.16-3
	gd-2.0.28-2

    If you don't have it with your distribution, try
    	perl -MCPAN -e 'install GD'

Q.  How do I uninstall?
A.  rm -r /usr/local/squish /var/lib/squish  # be careful ...
    vi /etc/crontab           # remove squish entries
    vi /etc/squid/squid.conf  # remove SQUISH parts


ABOUT THIS SOFTWARE

Q.  How does this software help against malware/viruses/etc??
A.  If your computer runs a program which polls a web site for instructions,
    you will quickly exceed your daily allocation of time or bandwidth.  This
    does not solve the problem, but should make it easier to identify.

Q.  What's with the version number?
A.  You're going to tell me about the bugs, then I'll fix them, and we can have
    another version.

Q.  Why would I ever want to use the --notime option?
A.  To test squish with old data.  That's the only occasion.


PROBLEMS AND ARB QUESTIONS

Q.  I keep getting my browser madly reloading http://my.proxy.svr/squish/? 
    Aaargh!
A.  In /etc/hosts, you have multiple conflicting definitions of your fully
    qualified host name.  Remove all of them except one.
    	# /etc/hosts sample:
	10.0.0.1	my.proxy.svr           # REMOVE or RENAME THIS
	192.168.54.32	my.proxy.svr my

Q.  Help!  I've been squished!
A.  Sorry.

Q.  How long must I wait?
A.  You must wait until your data falls off the end of the graph.  This is
    usually until tomorrow (especially on Fridays).

Q.  Can I download a file bigger than my daily quota?
A.  Just do it.  You'll get squished when the download completes, but don't
    worry about that.  Being squished does not affect downloads currently in
    progress, unless the connection is interrupted.

Q.  What's with the wierdo indigo cyan colour of the headings?
A.  I spilled C0FFEE in the HTML.  I was tired.

Q.  I see this in /var/log/squid/cache.log (or on the terminal)
	Reloading WWW-proxy squid
	| aclParseAclLine: IGNORING: Proxy Auth ACL 'acl SQUISHED1 proxy_auth "/etc/squid/squished"' because no authentication schemes are fully configured.
	| aclParseAclLine: IGNORING invalid ACL: acl SQUISHED1 proxy_auth "/etc/squid/squished"
	| aclParseIpData: Bad host/IP: 'aardvarkscantsquishants'
	| squid.conf line 1842: http_access deny SQUISHED1
	| aclParseAccessLine: ACL name 'SQUISHED1' not found.
	| squid.conf line 1842: http_access deny SQUISHED1
	| aclParseAccessLine: Access line contains no ACL's, skipping
	| aclParseAclLine: IGNORING: Proxy Auth ACL 'acl SQUISHED1 proxy_auth "/etc/squid/squished"' because no authentication schemes are fully configured.
	| aclParseAclLine: IGNORING invalid ACL: acl SQUISHED1 proxy_auth "/etc/squid/squished"
	| aclParseIpData: Bad host/IP: 'aardvarkscantsquishants'
	| squid.conf line 1842: http_access deny SQUISHED1
	| aclParseAccessLine: ACL name 'SQUISHED1' not found.
	| squid.conf line 1842: http_access deny SQUISHED1
	| aclParseAccessLine: Access line contains no ACL's, skipping
    What's this about?
A.  To make my life simpler, squish makes one list, mixing up IP addresses
    and user names.  Squish's installer doesn't check if you are using
    ident, proxy_auth or no authentication -- it just installs for all three.
    However, squid finds this a little annoying.  Having two files -- one for
    IPs and the other for user names -- is just as bad, IMHO.  If it bothers
    you, you can remove	the SQUISHED1 lines -- or whichever ones squid
    complains about.

Q.  I've been squished, but now I just stay squished...
A.  You probably go through the proxy to see whether you're squished.  Don't
    check too often.  Remember- you're supposed to be working.


CAN'T YOU JUST ...

Q.  I want squish to do something it doesn't already do ...
A.  Tell me -- info at ledge.co.za is a good starting point.  Offer to pay a
    truly inspiring amount, and we may be able to do wonders for you.

