1.3. Upgrading From LOCKSS 2.0-alpha2

1.3.2. Upgrade Path

If you intend to upgrade a LOCKSS 2.0-alpha2 system, please read this section. Updating the LOCKSS Installer

On the command line, in the lockss-installer directory, type:

git checkout master
git pull

to update to the latest version of lockss-installer from GitHub. Running the Upgrade Command

On the command line in the updated lockss-installer directory, type:

sudo scripts/upgrade-alpha2-to-alpha3

The script will purge your Docker environment of components, configuration files and images used by the LOCKSS system. Installing Snap and MicroK8s

The LOCKSS system’s containers are no longer orchestrated by Docker Swarm and no longer require Docker to run. The system now uses MicroK8s, a lightweight Kubernetes environment. To install the MicroK8s application package, you will need to install and use Snap. See Installing Snap and Installing MicroK8s. Modifying the Environment

In order for LOCKSS 2.0-alpha3 to work properly, you will need to disable frontends to iptables like firewalld or ufw, and configure MicroK8s to use DNS in a way that avoids loopback addresses. See Disabling Packet Filters and Configuring DNS for details. Reconfiguring the System

Upon successful completion, you will prompted to run scripts/configure-lockss. Be advised that the configuration process will prompt you for the PostgreSQL database password. Starting LOCKSS

Once configuration is complete you can run lockss as usual with scripts/start-lockss.