Smart Cache Manual

Abstract

This manual describes the configuration, installation and operation of the Smart Cache proxy caching HTTP server. Smart Cache homepage is located at http://home.worldonline.cz/~cz210552/. For latest changes go to What's new/History of Changes, Chapter 13

Copyright Notice

Copyright ©1998,1999,2000 Radim Kolar. Earlier versions of this manual were proofread by Juri Memmert and Luc Le Blanc.

Smart Cache and this manual are Open Source Software; you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details.

A copy of the GNU General Public License is available as /usr/doc/copyright/GPL in the Debian GNU/Linux distribution or on the World Wide Web at http://www.gnu.org/copyleft/gpl.html. You can also obtain it by writing to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Contents

• 1 Introduction
  • 1.1 About this manual
  • 1.2 When all things began
  • 1.3 Smart Cache born
  • 1.4 Other off line browsing solutions
  • 1.5 Smart Cache design goals
• 2 Basics informations
  • 2.1 What is Smart Cache
  • 2.2 Smart Cache summary
  • 2.3 Features List
• 3 Smart Cache Installation
  • 3.1 Smart Cache requires Java
  • 3.2 Choosing Java version
  • 3.3 Java downloading
  • 3.4 Checking the Java installation
  • 3.5 Installation for Debian GNU/Linux users
  • 3.6 Generic installation from .zip file
• 4 Smart Cache configuration
  • 4.1 Quick Smart Cache configuration
  • 4.2 Configuration of garbage collection
  • 4.3 Configuring a Web browser
• 5 Smart Cache operation
  • 5.1 Smart Cache on Debian GNU/Linux
  • 5.2 Running Smart Cache
  • 5.3 Stopping Smart Cache/Shutdown flag
  • 5.4 Running garbage collection
  • 5.5 Smart Cache maintenance
  • 5.6 URL blocking
• 6 Contacting author
  • 6.1 Sending source code patches
  • 6.2 Bug reporting
  • 6.3 User registration/feedback letters
  • 6.4 Addresses
• 7 Advanced topics
  • 7.1 Smart Cache memory usage
  • 7.2 Smart Cache Performance
  • 7.3 Web forwarding with Smart Cache
  • 7.4 Using Smart Cache as transparent proxy
  • 7.5 Cookies filtering
  • 7.6 Compiling Smart Cache sources
  • 7.7 Making Java 1.2+ .jar file
  • 7.8 Setting the bindaddress
  • 7.9 Structure of .cacheinfo control files
  • 7.10 Setting up logfiles
  • 7.11 Importing files to Smart Cache
  • 7.12 Using Smart Cache for non-HTTP protocols
  • 7.13 Using cache directory swaplevels
  • 7.14 Proxy access control
  • 7.15 Parent proxy authentification
  • 7.16 Exporting data from Smart Cache
  • 7.17 Data compression support
• 8 Smart Cache command line switches
• 9 Smart Cache repair utility
  • 9.1 Running repair
  • 9.2 Command line switches
  • 9.3 External MIME table file format for repair
• 10 Current bugs and limitations
  • 10.1 Java DNS caching bug/feature
  • 10.2 Known bugs list
  • 10.3 Smart Cache limitations
• 11 Troubleshooting
  • 11.1 Browsing problems
  • 11.2 Start up problems
  • 11.3 Memory usage problems
  • 11.4 Run time problems
• 12 FAQ
• 13 What's new/History of Changes
• 14 Future
• A Credits
• B Personal thanks
• C Interactive Bhagavad-gita