This is the source tree for the classic LOCKSS daemon (version 1.x). See https://www.lockss.org/ for information about the LOCKSS Program.
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.
For development purposes, you will need:
-
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.
- In order to process split Zip files at runtime, the command-line
zip
program must be installed. (Most Linux systems havezip
andunzip
installed by default, or they can be installed easily from the software package manager.)
-
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'sCLASSPATH
. The easiest way to do this is to copylib/junit.jar
into Ant'slib/
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 thattools.jar
can be found in${JAVA_HOME}/lib
. -
Some of the tests also require the command line
zip
program to be installed.
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
See the LOCKSS documentation portal at https://lockss.github.io/.