LOCKSS 1.x to 2.x Migration Guide

Last updated: 2025-02-13

Welcome, LOCKSS 1.x users!

This document will guide you as you upgrade from LOCKSS 1.78 to LOCKSS 2.0-beta1 by performing a migration of the data you preserve from LOCKSS 1.78.5 to LOCKSS 2.0.84-beta1.

Important

At this time, LOCKSS nodes in the Global LOCKSS Network (GLN) and CLOCKSS are advised to wait until LOCKSS 2.0-beta2 or later before migrating to LOCKSS 2.x, as development work for additional performance and scalability improvements is underway to support the migration of GLN-sized or CLOCKSS-sized nodes.

Table of Contents

• 1. Migration Overview
• 2. Upgrading to LOCKSS 1.78.5
• 3. Preparing Your LOCKSS 2.x Host
• 4. Installing LOCKSS 2.0.84-beta1
• 5. Configuring LOCKSS 2.x for Migration
• 6. Configuring LOCKSS 1.x for Migration
• 7. Running the Migrator
• 8. Reconfiguring LOCKSS 2.x for Normal Operation
• 9. Frequently Asked Questions about the Migration
• 10. Appendix: Differences Between LOCKSS 1.x and LOCKSS 2.x
• 11. Appendix: LCAP Over SSL Migration