Jump to: navigation, search

The LOCKSS team recommends installing the LOCKSS software using the bootable platform CD as described at Installing LOCKSS. If this is not possible, the software can be installed on an RPM-based Linux system such as RedHat and Fedora Core.

There are a few caveats:

  • Security may be impacted. See Security.
  • New versions of the LOCKSS daemon are released approximately every six weeks. If you run LOCKSS on Linux you are responsible for installing these upgrades. The platform CD installs upgrades automatically.
  • The LOCKSS daemon is extremely CPU- and disk-intensive. It spends most of its time auditing content, which involves repeatedly reading and hashing files. Its internal scheduler assumes it has the full use of a CPU. If it shares a machine with other CPU-intensive tasks this assumption may not be true (depending on the number of processors and I/O capacity, of course), and it may have trouble completing polls, with the result that it will be less able to audit its own content, and it may not be able to obtain repairs from other LOCKSS boxes when needed, because it's less able to help audit their content. If it has a CPU to itself, and the I/O capacity is sufficient there shouldn't be a problem.

[edit] Installation

While individual RPMs may be downloaded and installed, the easiest way to install LOCKSS on Linux is to use our Yum repository. (These instructions are for RedHat or Fedora; you may need to adapt them for other RPM-based Linux distributions. We don't currently provide Debian packages for distributions such as Ubuntu.)

[edit] First-time set up

  1. Add the following line to the file /etc/sysconfig/rhn/sources (creating the file if it doesn't already exist): 
    yum LOCKSS-Daemon-Repository http://www.lockss.org/repo
  2. Import the LOCKSS signing key into the RPM database:
    cd /tmp
wget http://keys.lockss.org/keys/LOCKSS-GPG-RPM-KEY
rpm --import LOCKSS-GPG-RPM-KEY
  3. Install the daemon:
    up2date install lockss-daemon
  4. Configure the daemon:
    /etc/lockss/hostconfig
    The configuration questions are a subset of those asked during installation of the platform CD. See Installation Instructions for details.
  5. Start the daemon running:
    /etc/init.d/lockss start
  6. To have the daemon start automatically at boot time:
    /sbin/chkconfig -add lockss

To further administer the daemon, access http://<hostname>:8081/ from a browser.

[edit] Upgrade

Each time a new LOCKSS daemon is released, perform these steps:
/etc/init.d/lockss stop
up2date install lockss-daemon
/etc/lockss/hostconfig
/etc/init.d/lockss start

hostconfig must be rerun after an upgrade only when new configuration options have been added. This doesn't happen frequently, but running it when it's not necessary is harmless.

Retrieved from "http://www.lockss.org/lockss/Installing_LOCKSS_on_Linux"