LOCKSS 2.0-alpha5 System Manual

Welcome to the LOCKSS 2.0-alpha5 System Manual.

Released: 2021-12-17
Last modified: 2022-04-15

Attention

Security advisories: CVE-2021-45105, CVE-2021-44832

LOCKSS 2.0-alpha5 (originally released 2021-12-17) and the custom Solr and OpenWayback containers it includes are affected. See CVE-2021-45105 and CVE-2021-44832.

What's New?

What's New in 2.0-alpha5d?

  • Bug fixes in the LOCKSS Installer.

What's New in 2.0-alpha5c?

  • Bug fixes in the LOCKSS Repository Service.

What's New in 2.0-alpha5b?

What's New Since 2.0-alpha4?

  • Numerous bug fixes and substantial performance improvements in the LOCKSS Repository Service, in support of reliability, scalability, and LOCKSS 1.x to 2.x migration.

  • Improved LOCKSS Installer distributed without requiring Git, rolling up most individual installation steps into a single script.

  • Upgrade from Solr 7.2.1 to 8.9.0.

  • Revamped HTTP error response handling, including new HTTP response/error categories and custom handling of categories in plugins.

  • Added support for communicating with APIs via POST requests during crawls.

  • All system components and the custom Solr and OpenWayback Docker containers included in the system now contain only the latest version of Log4j (2.16.0), which is not vulnerable to CVE-2021-44228 ("Log4Shell"), CVE-2021-45046 and CVE-2021-4104.

Installation

In order to install and test the LOCKSS 2.0-alpha5 system, you will need:

  • 64-bit Linux host (physical or virtual) with at least 4 CPU cores and 8 GB of memory, and adequate storage.

  • Commonplace Linux system utilities like curl/wget and tar to run the LOCKSS Downloader and the LOCKSS Installer.

  • K3s, a lightweight Kubernetes environment (installed via the LOCKSS Installer).

See System Prerequisites and Installing the LOCKSS System for more details.

Upgrade

If you were running LOCKSS 2.0-alpha4, Git is no longer required. See Upgrading From LOCKSS 2.0-alpha4 for upgrade instructions.

Attention

The LOCKSS 2.0-alpha4 system, and the Solr and OpenWayback containers it includes, are affected by CVE-2021-44228 ("Log4Shell"), CVE-2021-45046 and CVE-2021-4104. Please see the LOCKSS 2.0-alpha4 security advisory and upgrade to LOCKSS 2.0-alpha5.

Questions and Answers

Is LOCKSS 2.0-alpha5 vulnerable to CVE-2021-44228 ("Log4Shell")?

No, but it is affected by additional Log4j 2.x vulnerabilities discovered after the original 2021-12-17 release of LOCKSS 2.0-alpha5. See Security Advisories.

I have an existing classic LOCKSS system (version 1.x). Can I upgrade to LOCKSS 2.0-alpha5?

The LOCKSS 2.0-alpha5 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.75.8) to a LOCKSS 2.0 system for production purposes.

However, an upcoming version of the classic LOCKSS system will contain an experimental tool to test the migration of select archival units (AUs) from a production 1.x system to a test 2.x system.

To help us advance toward the final LOCKSS 2.0 release, please consider installing and running the LOCKSS 2.0-alpha5 release on a test machine and providing us with your feedback.

I have a LOCKSS system running 2.0-alpha4. Can I upgrade to LOCKSS 2.0-alpha5?

Yes. You are welcome to wipe your testing data from LOCKSS 2.0-alpha4 and start from scratch, but there is an upgrade path from LOCKSS 2.0-alpha4.

Can I use my own PostgreSQL database? Can I use my own Solr database?

Yes, you can configure the system to use your institution's Postgres database and/or Solr database -- or you can simply let system run included ones locally.

Can I replay Web content with my own Pywb instance? Can I replay Web content with my own OpenWayback instance?

Yes, you can configure your own Pywb instance and/or OpenWayback instance to connect directly to the LOCKSS Repository Service -- or you can let the system run included ones locally, or you can choose not to run any Web replay engine at all.

Contact Us

Please contact us for questions, feedback and bug reports. Open a ticket by sending e-mail to . Your contribution toward the final LOCKSS 2.0 release is very important to us and greatly appreciated by the community.