To get back to the Classic LOCKSS Homepage use this link


This document explains how to enable Subscription Management to simplify the process of adding Archival Units of serial publications.

Please note that the terms Subscription Management and Subscription Manager will be used interchangeably through out this document.

Why Subscription Management is Important

When New Archival Units become available for preservation, an administrator needs to manually add them to the list of Archival Units to be preserved by a LOCKSS system. This is accomplished by going to the “Add AUs” link in the “Journal Configuration” page of the LOCKSS Administration web interface. The Archival Unit for future volumes of a title must be added manually as well.

Subscription Manager allows for serial publications to be more efficiently added to a LOCKSS system in bulk by allowing administrators to specify a subscription period when the Library is subscribed to the publications and then the LOCKSS software configures the associated Archival Units automatically.

  • Please Note in the context of the LOCKSS software the term “subscription” does not directly refer to the agreement between the Library and the serial publication publisher regarding the purchase of content published in the serial publication. Instead, it refers to Archival Units in the LOCKSS system and addresses the question of whether Archival Units that become available for preservation should be configured in LOCKSS to get them preserved.

Enabling Subscription Manager

Subscription manager is disabled by default in all new LOCKSS systems. In order to enable it you must first navigate to “Expert Config” and add the following parameters:

  • org.lockss.subscription.enabled=true
  • org.lockss.subscription.totalSubscriptionEnabled=true

Click on the “Update” button to make the change take effect.

After entering the org.lockss.subscription.enabled=true parameter and clicking “update”, it is necessary that we restart the LOCKSS Daemon.

  • Redhat 6 variant service lockss restart
  • Redhat 7 variant systemctl restart lockss

Verify Subscription Management is Enabled

Now that we have restarted the LOCKSS Daemon, navigate to the “Journal Configuration” page. You should see three new options near the bottom of the page that are directly related to the Subscription Manager

  • Add Titles to Subscription Management
  • Update Existing Subscription Options
  • Synchronize Subscriptions

Using Subscription Management

For information on using the Subscription manager, please visit Configuring Subscription Management

On that page you will learn about:

  • Subscription Synchronization
  • Adding New Subscriptions
  • Updating Existing Subscriptions
  • Subscription Specification Details
  • Limitations of the System