#    Copyright (c) 1999 University of Southern California.
#    All rights reserved.                                            
#                                                                   
#    Redistribution and use in source and binary forms are permitted
#    provided that the above copyright notice and this paragraph are
#    duplicated in all such forms and that any documentation, advertising
#    materials, and other materials related to such distribution and use
#    acknowledge that the software was developed by the University of
#    Southern California, Information Sciences Institute.  The name of the
#    University may not be used to endorse or promote products derived from
#    this software without specific prior written permission.
#    
#    THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
#    WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
#    MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

LPC-lite v1.0
=============
LSAM Authors: Amy S. Hughes, Joe Touch
More Information: http://www.isi.edu/lsam


Introduction
------------
LPC-lite is a stripped-down version of the LSAM Proxy Cache which provides
multicast push, but requires explicit channel management and file lists.  
LPC-lite is composed of CGI cripts, Perl scripts, C code, and web pages for
use with an unmodified Apache proxy cache and AFDP, on any Unix system.  It 
is a slightly simplified, re-documented, subset of the LPC system.

LPC-lite v1.0 has some augmented features, compared to LPC v1.1.  The LPC-lite
server push mechanism supports preloading of remote pages, i.e. via full URLs,
rather than local file paths.  Files, when pushed, now imply the push of
in-line images (<img> tag).  These features are available only in LPC-lite,
because they would unnecessarily complicate the automated features of LPC v1.1.

For more information about the LSAM project, and the LSAM Proxy Cache
current releases, see our web pages at:

	http://www.isi.edu/lsam/


Distribution Requirements
-------------------------
This distribution has been fully tested on FreeBSD2.2.6.  Because
the supporting packages are all available for other platforms, LPC-lite
v1.0 may work on other UNIX platforms.  Modifications are necessary for
use on non-UNIX filesystems.

The following must be installed on your machine and all target clients
to use LPC-lite v1.0:

	- The Apache web server (http://www.apache.org)
	- The AFDP multicast file transfer system 
	  (http://www.ecf.utoronto.ca/afdp/)
	- a Perl 5 interpreter
	- a C compiler

LPC-lite is available as a part of the full LSAM distribution and is
available separately.

You will download the file LPC-lite-1.0.tar.gz

Note:  Another multicast FTP system with a command-line interface may
be substituted for AFDP with few changes to the LPC-lite scripts.


Distribution Contents
---------------------

LPC-lite/
   LPC-lite-installscript -
	a shell script which configures and compiles the distribution
	scripts and executables

   README.LPC-lite - this file


Installation with LPC
---------------------

LPC-lite is compiled and installed with the complete LSAM proxy cache, 
	follow the directions included therein.


Independent Installation Instructions
-------------------------------------

Download and install AFDP and Apache as instructed.

Configure Apache to run CGI scripts and as a proxy cache.

Download LPC-lite-1.0.tar.gz to the apache/cgi-bin directory.

Decompress LPC-lite-1.0.tar.gz.  This will create the directory
	cgi-bin/LPC-lite

Run LPC-lite/LPC-lite-installscript.  This script will ask you for
	- the Perl5 executable
	- the location of your Apache server's cache directory
	  (by default: apache/proxy)
	- the location of your AFDP executables
	- your desired multicast TTL (please see XXXX for possible
	  values
	- the C compiler


Features
--------
LPC-lite will push all given URLs and their inline images to the given
	clients.

LPC-lite will push any given URL, provided that it can be cached by apache,
	including files that are local to the server and those that are 
	foreign.


Using LPC-lite
--------------
LPC-lite has two interfaces, CGI through a browser and command-line script.

The CGI interface can be accessed through:
http://yourapache[:port]/cgi-bin/LPC-lite-cgi.pl
The form will provide further instructions.

The command-line script is LPC-lite-script.pl
The script needs to be supplied with two files, one containing the list of 
clients that LPC-lite will push files to, another containing a list of URLs
that will be pushed.  The entries in each file must be on separate lines.


Known Problems
--------------
- LPC-lite will not push inline images that have any whitespace in their URLs.
- Due to the nature of AFDP's secretary selection, some files may not be 
	transferred.  

Changes
-------
V1.0 - 5/99:
	This is the initial release of LPC-lite