6.2 Basic setup

To set up the Cache server cached:

1. Verify your installation. $HARVEST_HOME/bin should contain the cached program. $HARVEST_HOME/lib should contain the ftpget.pl program and the Perl library files: chat2.pl, ftp.pl, and socket.ph. $HARVEST_HOME/lib/cache should contain the client and dnsserver programs.

                

2. Modify $HARVEST_HOME/lib/cache/cached.conf for your site; you may use the -f flag to cached to specify the location of your cached.conf). In cached.conf, any line beginning with a ``#'' character is ignored. If a variable itself is commented out (or not included in the configuration file), it is given a default value, as specified below.

   At a minimum, you should edit the settings of cache_dir, cache_log, cache_access_log, and cache_mgr. You can also set the cache_ftp_program and cache_dns_program variables to point to where your ftpget and dnsserver programs are located (respectively), if they aren't in directories that are in your path. You can also change other variables, such as per-object timeouts. (Each of the variables is documented in comments in the cached.conf file supplied in the Harvest distribution.) In particular, you can specify the topology of neighbor and parent caches, using one or more cache_host variables (see Section 6.7.). Note that cached uses two port numbers for the ASCII and UDP protocol interfaces. Example values are shown in the provided cached.conf file. Also, note that cached will always append to the log files (e.g., they're never truncated).

    

3. Run cached (or use the (preferred) RunCache program included in the Harvest distribution). cached does not need to be run as root. The command line arguments for cached are detailed in Appendix A.2.