$Id: INSTALL,v 1.19 2001/08/23 22:00:26 dawson Exp $ INSTALLATION MANUAL FOR ANETD 1.6 ================================= This is the installation manual for Anetd. Please read the User Guide, anetd-user-guide.ps.gz, before running Anetd. If you are building from source, the user guide will be built for you under ad/doc. COMPILING THE SOURCE AND INSTALLING ----------------------------------- 1. The makefiles (for both Anetd and RSAREF) require GNU make. GNU make is standard on Linux systems; it is available for FreeBSD as a port or package (see http://www.freebsd.org/ports/devel.html) and for Solaris. On Linux invoke "make"; on other platforms invoke "gmake". 2. Fetch the RSAREF 2.0 library and check it against the following MD5 checksum: MD5 (rsaref20.1996.tar.Z) = 6b8df27a1b0b0f7dfb81adac2c222395. To the best of our knowledge you can find it in the following places (suggested by www.freebsd.org): ftp://ftp.deva.net/pub/sources/crypto/rsaref20.1996.tar.Z ftp://ftp.kddlabs.co.jp/.7/inet/caida/bmwt/rsaref20.1996.tar.Z ftp://ftp.zedz.net/pub/crypto/crypto/LIBS/rsa/rsaref20.1996.tar.Z ftp://ftp.hacktic.nl/pub/crypto/crypto/LIBS/rsa/rsaref20.1996.tar.Z ftp://ftp.demon.net/pub/mirrors/crypto/replay/crypto/LIBS/rsa/rsaref20.1996.tar.Z ftp://ftp.jyu.fi/.3/ftp.zedz.net/pub/replay/crypto/LIBS/rsa/rsaref20.1996.tar.Z ftp://ftp.funet.fi/pub/mirrors/utopia.hacktic.nl/crypto/LIBS/rsa/rsaref20.1996.tar.Z ftp://ftp.fu-berlin.de/unix/security/replay-mirror/crypto/LIBS/rsa/rsaref20.1996.tar.Z 3. Install the RSAREF library: cd into the top-level anetd directory mkdir rsaref mv rsaref20.1996.tar.Z rsaref cd rsaref tar xzf rsaref20.1996.tar.Z 4. Build the RSAREF library. 4.1 read rsaref/doc/readme.txt 4.2 cd into rsaref and create a directory named -build, where is the supported platform type appropriate for your installation (one of "bsd44", "exos", "linux", "solaris"); e.g., cd rsaref mkdir -build 4.3 copy the makefile into the newly created directory, eg: cp install/unix/makefile -build 4.4 cd into that directory and compile: cd -build; make [if on Linux] cd -build; gmake [if not on Linux] (on Solaris you may need to invoke gmake like "gmake CC=gcc") 5. cd to the top-level Anetd directory and edit Makefile.pre to customize the variables: ANETD_SRC_DIR INSTALL_PREFIX JAVAC PERL 6. Build Anetd 6.1 JAVA VERSION The Java files under directory abocc require jdk 1.2 to be compiled. It is possible to build Anetd without Java support by invoking make with the target "nojava". Note, however, that Java support is required on all ABone nodes. 6.2 make 7. Install Anetd 7.1 make install CLIENT-ONLY INSTALLATION ------------------------ If you want just the client part, sc, then you are ready to go. Simply put the client directory in your $PATH. Before using sc for the first time you will need to use makekey to create a public and private key pair. SERVER INSTALLATION ------------------- Starting from release 1.4, Anetd is decoupled from Java; this means that, before running Anetd for the first time, you have to fetch and install a JDK separately. As a convenience we are providing different JDKs under ftp://ftp.csl.sri.com/pub/anetd/java/). The idea is that you install the JDK once, and then you can install new versions of Anetd reusing the same JDK. Steps: 0. Prerequisite: if you haven't already installed a JDK, untar it somewhere. (The JDK version depends on the platform you are using.) For example, if you are installing jdk1.1.8, the tarball will build a tree with top level directory jdk1.1.8. Let's assume that the path to that directory is /path/to/jdk1.1.8. NOTE: for Solaris, you should follow the installation instructions provided with the Java package you downloaded from Sun. 1. Unpack somewhere the Anetd tarball. If installing for an ABone node, unpack under ~abocc. It will build a tree with top level directory anetd. 2. Configure Anetd. If you are configuring an *ABone* node, please refer to the instructions at ISI's ABone Web site: http://www.isi.edu/abone/joining.html If you are configuring a *private* node, copy the file anetd/etc/anetd.conf.sample to anetd/etc/anetd.conf.local. This file documents the default configuration settings, which should be adequate for most installations. If any modifications are required, edit anetd.conf.local and uncomment and edit ONLY those settings that require modification from the default values. BEFORE RUNNING ANETD: SECURITY NOTE ----------------------------------- Anetd can run standalone or in ABone mode. The difference is in who will be able to access your node and execute commands. Note that all ABone nodes must be run in ABone mode, while private nodes may be run either standalone or in ABone mode. Please consult the Anetd User Guide for information on the distinctions between ABone and standalone mode. ADDITIONAL INFO --------------- Please refer to the README file for pointers to additional documentation.