#    Copyright (c) 1998 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.

LSAM RELOCATION
===============
LSAM Authors: Ted Faber, Lars Eggert
$Revision: 1.7 $ ($Date: 1998-07-06 10:19:44-07 $)
More information: http://www.isi.edu/lsam/mobility


Introduction
------------
This system allows you to move the contents of one proxy cache to another.
The recepient cache must have registered as being willing to accept the
additional data.

This system also provides a geographical data base that finds proxies in a
given geographical area that are willing to accept another proxy's cache
contents.

The system is best manipulated by the GUI accessed from the LSAM configuration
and status web pages (http://proxy_name/cgi-bin/lsam/configuration.pl).

To demonstrate the query, use the status page to send a query to our demo
goegraphy daemon at cos.isi.edu. Note that we cannot keep this server running
at all times.

Alternatively, compile the geography daemon in src/geod and run it using the
configuration file included there (./start_geod -f conf). The start_geod
script should be run as root. It sets the shell's resource limits high enough
to run a very large geod process. You'll want to load the geod with test data,
which can be done by executing

	% zcat machines.gz | perl ./geod_load.pl 

in the geod source directory after the geod is running. The test data is
large, so be sure that you're running on an acount that can support a lot of
memory use. Loading the geod may take 5 minutes or so.

A query consists of the name of a US city, a space and the two letter postal
abbreviation for its state. For example:

	Elmira, NY
	- or -
	Los Angeles, CA

Only US cities are currently included in the configuration file. If you can
file in the format of conf for another country, please forward it to
faber@isi.edu . You must also enter the radius around the city that you want
searched. 10000 usually yields a hit on our test database.

If you have gnuplot version 3.5 beta 340 or higher and the netpbm image
manipulation tools installed, the query will draw a map showing the region you
queried. Those tools can be obtained from http://www.FreeBSD.org as ports.


Demonstration
-------------
To demonstrate the content transfer:

1. Start two proxies
2. Establish one proxy as a destination
3. Send the other's content to it using the relocation_config.pl page
   under cgi-bin/lsam (you can reach it from the configuration URL
   above).
4. Lookups to locations in that were previously in the source proxy's
   cache will now be as fast using the destination proxy.

Questions or comments to faber@isi.edu .

CHANGES
=======

Relocation is new to 0.8.