LOCKSS System Manual Logo
2.0-alpha5

LOCKSS 2.0-alpha5 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
    • 1.3. Next Steps
  • 2. Upgrading From LOCKSS 2.0-alpha4
    • 2.1. Stop LOCKSS 2.0-alpha4
    • 2.2. Update the LOCKSS Installer
    • 2.3. Run the Upgrade Script
    • 2.4. Re-run the Configure Script
    • 2.5. Next Steps
  • 3. Installing the LOCKSS System
    • 3.1. Creating the lockss User
    • 3.2. Downloading the LOCKSS Installer
    • 3.3. Running the LOCKSS Installer
      • 3.3.1. Overview of the LOCKSS Installer
      • 3.3.2. Invoking the LOCKSS Installer
      • 3.3.3. Checking the System User and Group
      • 3.3.4. Configuring iptables for K3s
      • 3.3.5. Configuring firewalld for K3s
      • 3.3.6. Configuring ufw for K3s
      • 3.3.7. Configuring CoreDNS for K3s
      • 3.3.8. Installing K3s
      • 3.3.9. Testing the K3s Node
      • 3.3.10. Completion of the LOCKSS Installation Process
      • 3.3.11. Checking the K3s Configuration
  • 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.2.1. Switch iptables to legacy mode via Alternatives
      • 7.2.2. Post-Installation Changes to iptables
    • 7.3. Troubleshooting firewalld
      • 7.3.1. Add 10.42.0.0/16 and 10.43.0.0/16 to firewalld's trusted zone
      • 7.3.2. Post-Installation Changes to firewalld
    • 7.4. Troubleshooting ufw
      • 7.4.1. Allow traffic from 10.42.0.0/16 and 10.43.0.0/16 via ufw
      • 7.4.2. Post-Installation Changes to ufw
    • 7.5. Troubleshooting CoreDNS
      • 7.5.1. CoreDNS does not allow a loopback address to be given to Kubernetes pods as an upstream DNS server
      • 7.5.2. Post-Installation Changes to DNS
    • 7.6. Troubleshooting the K3s Installer
      • 7.6.1. Failed to apply container_runtime_exec_t to /usr/local/bin/k3s
      • 7.6.2. k3s-selinux requires container-selinux
    • 7.7. Troubleshooting the K3s Configuration Checker
      • 7.7.1. iptables should be older than v1.8.0, newer than v1.8.3, or in legacy mode
      • 7.7.2. User namespaces disabled
      • 7.7.3. apparmor enabled but apparmor_parser missing
      • 7.7.4. cgroup hierarchy nonexistent
      • 7.7.5. links: aux/iptables should link to iptables-detect.sh
      • 7.7.6. swap should be disabled
      • 7.7.7. CONFIG_INET_XFRM_MODE_TRANSPORT missing
  • 8. System Administration Tasks
    • 8.1. Running Commands as root
      • 8.1.1. Running Commands as root With sudo
      • 8.1.2. Running Commands Directly as root
    • 8.2. Running Commands as a Privileged User
    • 8.3. Running Commands as the lockss User
      • 8.3.1. Running Commands as lockss With sudo
      • 8.3.2. Running Commands as lockss With su
    • 8.4. Operating System Updates
    • 8.5. Installing curl
    • 8.6. Installing wget
  • 9. Appendix
    • 9.1. Security Advisories
      • 9.1.1. CVE-2021-45105 and CVE-2021-44832
    • 9.2. Release Notes
      • 9.2.1. LOCKSS 2.0.55-alpha5
      • 9.2.2. LOCKSS 2.0.54-alpha5
      • 9.2.3. LOCKSS 2.0.53-alpha5
      • 9.2.4. LOCKSS 2.0.52-alpha5
      • 9.2.5. LOCKSS 2.0.51-alpha5
    • 9.3. Past Versions
    • 9.4. Software License
    • 9.5. Network Ports
    • 9.6. Downloading the LOCKSS Installer using git
    • 9.7. Working with PostgreSQL
      • 9.7.1. Changing the PostgreSQL Database Password
    • 9.8. LCAP Over SSL
      • 9.8.1. Generating Keystores
        • 9.8.1.1. Command Line Tool
        • 9.8.1.2. Interactive Tool
      • 9.8.2. Installing the Keystores
    • 9.9. Migrating From LOCKSS 1.x

Navigation

  • « LOCKSS Documentation Portal
  • « LOCKSS Web Site
LOCKSS System Manual
  • Search

© Copyright 2000-2022, LOCKSS Program. Revision c5129691.

Built with Sphinx using a theme provided by Read the Docs.