LOCKSS System Manual
2.0-alpha4
LOCKSS 2.0-alpha4 System Manual
1. Introduction
1.1. System Prerequisites
1.1.1. Host
1.1.2. CPU
1.1.3. Memory
1.1.4. Storage
1.2. Operating System
2. Upgrading From LOCKSS 2.0-alpha3
2.1. Stopping LOCKSS 2.0-alpha3
2.2. Updating the LOCKSS Installer
2.3. Adjusting File Permissions
2.4. Uninstalling MicroK8s and Snap
2.5. Restoring Packet Filters
2.6. Revoking the Extra Privileges of the
lockss
User
2.7. Next Steps
3. Installing the LOCKSS System
3.1. Creating the
lockss
User
3.2. Installing Git
3.3. Downloading the LOCKSS Installer
3.4. Installing K3s
3.5. Checking the System
4. Configuring the LOCKSS System
4.1. Network Settings
4.1.1. Hostname
4.1.2. IP Address
4.1.3. Network Address Translation
4.1.4. Initial UI Subnet
4.1.5. Container Subnet
4.1.6. LCAP Port
4.2. Mail Settings
4.2.1. Mail Relay
4.2.2. Mail Relay Credentials
4.2.3. Administrator Email
4.3. Preservation Network Settings
4.3.1. Configuration URL
4.3.2. Configuration Proxy
4.3.3. Preservation Groups
4.4. Storage Areas
4.4.1. Content Data Storage Areas
4.4.2. Log Data Storage Area
4.4.3. Temporary Data Storage Area
4.5. Web User Interface Settings
4.6. Database Settings
4.6.1. PostgreSQL
4.6.1.1. Embedded PostgreSQL Database
4.6.1.2. External PostgreSQL Database
4.6.2. Solr
4.6.2.1. Embedded Solr Database
4.6.2.2. External Solr Database
4.7. LOCKSS Services
4.7.1. Metadata Query Service
4.7.2. Metadata Extraction Service
4.8. Web Replay Settings
4.8.1. Pywb
4.8.2. OpenWayback
4.9. Final Steps
5. Running the LOCKSS System
5.1. Starting the LOCKSS System
5.2. Shutting down the LOCKSS System
5.3. Restarting a Running LOCKSS System
5.4. Removing a Configured LOCKSS System
6. Using the LOCKSS System
6.1. Using the LOCKSS Configuration Service
6.1.1. Accessing the Web User Interface
6.1.2. Adding Archival Units
6.1.3. Configuring a Crawl Proxy
6.1.4. Managing Access to the Web User Interfaces
6.2. Using the LOCKSS Crawler Service
6.2.1. Accessing the Web User Interface
6.2.2. Monitoring Crawl Status in the System
6.2.3. Causing an Archival Unit to Crawl
6.2.4. Crawl Status Screen
6.2.4.1. Top-Level Crawl Information
6.2.4.2. Crawl Status Entry
6.3. Using the LOCKSS Poller Service
6.3.1. Accessing the Web User Interface
6.3.2. Requesting Polls
6.3.3. Monitoring Polling and Voting
6.4. Using the LOCKSS Metadata Extraction Service
6.4.1. Accessing the Web User Interface
6.4.2. Requesting Metadata Extraction
6.5. Using the LOCKSS Metadata Service
6.5.1. Accessing the Web User Interface
6.5.2. Requesting Metadata Information
6.6. Replaying Web Content with Pywb
6.6.1. Accessing the Pywb User Interface
6.6.2. Replaying a URL
6.6.3. Finding a URL From an AU to Replay
6.7. Replaying Web Content with OpenWayback
6.7.1. Accessing the OpenWayback User Interface
6.7.2. Replaying a URL
6.7.3. Finding a URL From an AU to Replay
6.8. Using the Kubernetes Dashboard
6.8.1. Installing the Kubernetes Dashboard
6.8.2. Accessing the Kubernetes Dashboard
6.8.3. Using the Kubernetes Dashboard UI
6.8.4. Updating the Kubernetes Dashboard
6.8.5. Removing the Kubernetes Dashboard
7. Troubleshooting the LOCKSS System
7.1. Known Issues
7.2. Troubleshooting
iptables
7.3. Troubleshooting
firewalld
7.4. Troubleshooting
ufw
7.5. Troubleshooting CoreDNS
7.6. Troubleshooting K3s
7.6.1. Troubleshooting the K3s Installer
7.6.1.1. Failed to apply container_runtime_exec_t
7.6.1.2. k3s-selinux requires container-selinux
7.6.2. Troubleshooting the K3s Configuration Checker
7.6.2.1. iptables should be older than v1.8.0 or in legacy mode
7.6.2.2. User namespaces disabled
7.6.2.3. swap should be disabled
7.6.2.4. CONFIG_INET_XFRM_MODE_TRANSPORT missing
8. Appendix
8.1. Security Advisories
8.1.1. CVE-2021-45105 and CVE-2021-44832
8.1.2. CVE-2021-44228, CVE-2021-45046 and CVE-2021-4104
8.2. Release Notes
8.2.1. LOCKSS 2.0.43-alpha4
8.2.2. LOCKSS 2.0.42-alpha4
8.2.3. LOCKSS 2.0.41-alpha4
8.3. Past Versions
8.4. Running Commands as
root
8.4.1. Running Commands as
root
With
sudo
8.4.2. Running Commands Directly as
root
8.5. Running Commands as a Privileged User
8.6. Running Commands as the
lockss
User
8.6.1. Running Commands as
lockss
With
sudo
8.6.2. Running Commands as
lockss
With
su
8.7. Working with PostgreSQL
8.7.1. Changing the PostgreSQL Database Password
8.8. LCAP Over SSL
8.8.1. Generating Keystores
8.8.1.1. Command Line Tool
8.8.1.2. Interactive Tool
8.8.2. Installing the Keystores
8.9. Network Ports
Navigation
« LOCKSS Documentation Portal
« LOCKSS Web Site
LOCKSS System Manual
Versions
Versions
This page has been renamed
Release Notes
.
Read the Docs
v: 2.0-alpha4
Versions
latest
2.0-alpha7
2.0-alpha6
2.0-alpha5
2.0-alpha4
2.0-alpha3
2.0-alpha2
2.0-alpha1
unstable
2.0-alpha-preview
Downloads
pdf
html
On Read the Docs
Project Home
Builds