LOCKSS Installation and Kickstart Kyle Fenton Johnny Healey Brian - - PowerPoint PPT Presentation

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

LOCKSS Installation and Kickstart

Kyle Fenton Johnny Healey Brian Pitts

MetaArchive Project Emory University Atlanta, Georgia

June 5, 2007

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Session Learning Objectives

Installing LOCKSS on RPM-based Linux distributions. Develop a kickstart for easy deployment of LOCKSS nodes. Allocate storage space and configure LOCKSS. Create a secure plugin repository for LOCKSS.

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Installing LOCKSS

Prerequisite is JRE 1.5 from Sun. LOCKSS is available in RPM format from the LOCKSS team Install on Red Hat with rpm -ivh filename.rpm

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Kickstart for LOCKSS

Kickstart automates installation and configuration of Red Hat Linux Plain text file that can be edited by hand or with the Kickstart Configurator Documented at redhat.com and in our sample file

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Invoking Kickstart

Kickstart file can be placed on the network or a diskette Boot from your installation media and invoke kickstart appropriately linux ks=floppy linux ks=nfs:example.com:/path/ks.cfg linux ks=http://example.com/path/ks.cfg Use ksdevice=¡device¿ if you need to specify a network interface eg eth1

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Sample Kickstart

Emory has a sample kickstart that may help you design your own

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

LOCKSS and Linux Kickstarts

When adapting a kickstart for a Private LOCKSS Network, there are a few additional things that will need to be considered. Allocating storage space for LOCKSS Configuring LOCKSS Creating a plugin repository (optional)

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Allocating Storage Space

Before you can configure and run LOCKSS, you’ll need to allocate storage space. A repository, at its most fundamental level, is little more than a directory on a UNIX filesystem. Depending on the uniformity of your hardware, you may wish to incorporate this process into your kickstart.

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Allocating Storage Space The Easy Way

If Linux is installed on the same disk partition that LOCKSS is going to use as a repository, then allocating the storage space is a simple as making a directory for LOCKSS to store the content. mkdir /locksscache

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Allocating Storage Space The Slightly Less Easy Way

It’s entirely likely you’ll wish to use a separate partition (or even physical disk) as your LOCKSS repository. This can be as simple as formatting the disk and mounting it. mkdir /locksscache mke2fs -j /dev/sdXY echo "/dev/sdXY /locksscache ext3 defaults 0 0" >> /etc/fstab mount /locksscache

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Allocating Storage Space Other Options to Consider

If you’re creating a collaborative repository with multiple providers, it can be advantageous to create several repositories. Whichever method you choose, it can be easily adapted. mkdir /locksscache mkdir /locksscache/site1 mkdir /locksscache/site2 mkdir /locksscache/site3

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Allocating Storage Space Other Options to Consider

For an even more flexible solution, Logical Volume Management(LVM) can be used. This allows you to create and extend logical partitions as they are needed.

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Configuring LOCKSS

LOCKSS is configured by the /etc/lockss/hostconfig script. It will require you to enter the following information: Domain Name: locksscache.example.org IP Address: www.xxx.yyy.zzz Administrative Subnet: www.xxx.yyy.* LCAP V3 Port: 9729 Mail Relay: mail.example.org

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Configuring LOCKSS

Administrator’s E-mail address: admin@example.org Path to Java: /usr/java/jre1.5.0 11/bin/java Java Switches: You can leave this blank Configuration URL: The URL of the title database Preservation Group: Group ID in title database Cache Storage Directories: /locksscache;/locksscache/site1;/locksscache/site2

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Starting LOCKSS

Once it’s configured, LOCKSS can be started with the command: /etc/init.d/lockss start When you’ve started it and confirmed that the configuration is correct, this line can be added to /etc/rc.local

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Creating a Plugin Repository

A plugin repository is simply a web-accessible directory that contains a manifest page and list of the plugins stored. For simplicity, the MetaArchive project stores our plugin repositories on

• ur LOCKSS nodes.

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Plugin Repository Configuration

<VirtualHost *:80> <Directory "/var/www/html/plugins"> AllowOverride all ReadmeName README.html Order deny,allow Deny from all Allow from 127.0.0.1 www.xxx.yyy.zzz </Directory> </VirtualHost>

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart

Kickstart Allocating Storage Space Configuring LOCKSS Plugin Repositories

Questions?

Kyle Fenton, Johnny Healey, Brian Pitts LOCKSS Installation and Kickstart