LOCKSS 2.0-alpha3 System Manual
Welcome to the LOCKSS 2.0-alpha3 System Manual.
Docker containers managed by MicroK8s (a lightweight Kubernetes environment by Ubuntu makers Canonical), support for multiple disk storage volumes, the runcluster development environment, infrastructure for building LOCKSS plugins in the LAAWS environment, Pywb 2.4.2, and more.
For more details, see our Release Notes.
In order to install and test the LOCKSS 2.0-alpha3 system, you will need:
64-bit Linux host (physical or virtual) with 4 cores and 8 GB of memory.
MicroK8s (a lightweight Kubernetes environment), which requires Snap (an application package manager).
Git to download the lockss-installer project from GitHub.
See System Prerequisites for more details.
If you were running LOCKSS 2.0-alpha2, you no longer need Docker 1 nor Java 8 installed on the host machine.
See Upgrading From LOCKSS 2.0-alpha2 for more details.
Please contact us for questions, feedback and bug reports. Open a ticket by sending e-mail to
lockss-support (at) lockss (dot) org. Your contribution toward the final LOCKSS 2.0 release is very important to us and greatly appreciated by the community.
Frequently Asked Questions
- I have an existing classic LOCKSS system (version 1.x). Can I upgrade to LOCKSS 2.0-alpha3?
The LOCKSS 2.0-alpha3 release is a technology preview which we are excited to share with the community for testing purposes. It is not yet possible to convert from a classic LOCKSS system (e.g. version 1.74.10) to a LOCKSS 2.0 system. To help us advance toward the final LOCKSS 2.0 release, please consider installing and running the LOCKSS 2.0-alpha3 release on a test machine and :ref:`providing us with your feedback <Contact Us>`_.
- I have a LOCKSS system running 2.0-alpha2. Can I upgrade to LOCKSS 2.0-alpha3?
Yes. You are welcome to wipe your testing data from LOCKSS 2.0-alpha2 and start from scratch, but there is an :ref:`upgrade path <Upgrade>`_ from LOCKSS 2.0-alpha2.
- Can I use my own PostgreSQL database?
Yes, you can run the included PostgreSQL database, or configure it to use your local or institutional PostgreSQL database.
- Can I use my own Solr database?
Yes, likewise, you can run an included Solr database, but you can can also configure it to use your local or institutional Solr database.
- Can I replay Web content with my own Pywb instance?
Yes, you can configure your own Pywb instance to connect directly to the LOCKSS Repository Service, or you can use the included Pywb instance, or you might choose not to run Pywb at all.
- Can I replay Web content with my own OpenWayback instance?
Yes, you can configure your own OpenWayback instance to connect directly to the LOCKSS Repository Service, or you can use the included OpenWayback instance, or you might choose not to run OpenWayback at all.
The system’s containers are generated by Docker in development, which produces containers that run on
containerdat runtime. In previous releases, they were also orchestrated by Docker Swarm at runtime, so Docker was required on host machines. Starting with this release, the containers are orchestrated by Kubernetes at runtime instead, so Docker is not required on host machines.