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. Running Commands as root
      • 8.2.1. Running Commands as root With sudo
      • 8.2.2. Running Commands Directly as root
    • 8.3. Running Commands as a Privileged User
    • 8.4. Running Commands as the lockss User
      • 8.4.1. Running Commands as lockss With sudo
      • 8.4.2. Running Commands as lockss With su
    • 8.5. Working with PostgreSQL
      • 8.5.1. Changing the PostgreSQL Database Password
    • 8.6. LCAP Over SSL
      • 8.6.1. Generating Keystores
        • 8.6.1.1. Command Line Tool
        • 8.6.1.2. Interactive Tool
      • 8.6.2. Installing the Keystores
    • 8.7. Network Ports
    • 8.8. Versions
    • 8.9. Past Versions

LOCKSS Documentation Portal

  • Home
  • LOCKSS System Manual
LOCKSS System Manual
  • »
  • 8. Appendix
Previous Next

8. Appendix

This appendix contains pages of additional information about the LOCKSS system.

Chapter Overview

  • 8.1. Security Advisories
  • 8.2. Running Commands as root
  • 8.3. Running Commands as a Privileged User
  • 8.4. Running Commands as the lockss User
  • 8.5. Working with PostgreSQL
  • 8.6. LCAP Over SSL
  • 8.7. Network Ports
  • 8.8. Versions
  • 8.9. Past Versions
Previous Next

© Copyright 2000-2021, LOCKSS Program. Revision e4af11e7.

Built with Sphinx using a theme provided by Read the Docs.
Read the Docs v: 2.0-alpha4
Versions
latest
2.0-alpha5
2.0-alpha4
2.0-alpha3
2.0-alpha2
2.0-alpha1
unstable
2.0-alpha-preview
Downloads
pdf
html
epub
On Read the Docs
Project Home
Builds