Classic LOCKSS Daemon

This is the source tree for the classic LOCKSS daemon (version 1.x). See https://www.lockss.org/ for information about the LOCKSS Program.

Source

A one-time copy can be obtained with Wget or Curl:

# With Wget
wget https://github.com/lockss/lockss-daemon/archive/master.zip

# With Curl
curl -L -o master.zip https://github.com/lockss/lockss-daemon/archive/master.zip

A buildable snapshot can be obtained by cloning the master branch:

# GitHub account with SSH key
git clone --depth 1 --branch master git@github.com:lockss/lockss-daemon.git

# Anonymous
git clone --depth 1 --branch master https://github.com/lockss/lockss-daemon.git

To obtain a local copy of the LOCKSS daemon Git repository, you can use the git clone command to establish the repository:

# GitHub account with SSH key
git clone git@github.com:lockss/lockss-daemon.git

# Anonymous
git clone https://github.com/lockss/lockss-daemon.git

You can subsquently use git pull to update.

Prerequisites

For development purposes, you will need:

Oracle JDK 8 or OpenJDK 8.
Apache Ant 1.7.1 or later.
Some tools require Python 2.7 (invoked as python2).
Some tools require Python 3.2 (invoked as python3) or greater.

Additional Prerequisites

In order to process split Zip files at runtime, the command-line zip program must be installed. (Most Linux systems have zip and unzip installed by default, or they can be installed easily from the software package manager.)

Other Prerequisites

JUnit 3.8.1 is included in the LOCKSS source distribution, but the Ant targets that invoke JUnit (test-xxx) require the JUnit JAR to be on Ant's CLASSPATH. The easiest way to do this is to copy lib/junit.jar into Ant's lib/ directory (/path/to/ant/lib).
For some of the tools, the JAVA_HOME environment variable must be set to the directory in which the JDK is installed, i.e.it is expected that tools.jar can be found in ${JAVA_HOME}/lib.
Some of the tests also require the command line zip program to be installed.

Build

ant test-all
    Builds the system and runs all unit tests

ant test-one -Dclass=org.lockss.foo.TestBar
    Builds the system and runs the given JUnit test class

ant -projecthelp
ant -p
    Lists other build options