[edit] Operating Your LOCKSS Box
- Please leave both the CD and floppy or USB flash disk in their drives at all times.
The LOCKSS software boots from the CD and reads configuration information from the floppy or USB flash disk. If either is removed, the LOCKSS box will not restart after a power failure. It will also not be able to download software updates from Stanford, as the keys used to verify updates are stored on the floppy or USB flash disk, and the programs used to verify the signatures using the keys are run directly from the CD. - The administrative user interface for your LOCKSS box is available at http://hostname:8081/. To access the UI you will need to supply the user name
lockssand the password you supplied during configuration. The major functions it provides are:- Journal Configuration - allows you to select the content your LOCKSS box will preserve. Please see Adding Content for further instructions.
- Admin Access Control - allows you to control the ranges of IP addresses from which the administrative user interface may be accessed.
- Proxy Access Control - allows you to control, the ranges of IP addresses that may access the preserved content by using the LOCKSS box as a web proxy.
- Daemon Status - provides a wide range of status information about the preserved content and the status of crawls, polls, and other internal daemon processes.
- Proxy Info - Generates proxy configuration files for browsers or other institutional proxies, to tell them what content is contained on the LOCKSS box.
Your LOCKSS box should run continuously. It will be gradually collecting the content you select, and comparing it with the same content at other LOCKSS boxes. Nevertheless, you may need to shut it down briefly, perhaps for maintenance, re-configuration or upgrade. You may do this at any time that is convenient for you and your users without worrying about what it is doing at the time. The LOCKSS system is designed to cope with random failures and interruptions. The state of all important activities is saved on disk; they will resume when the box restarts, or be retried later.
Your LOCKSS box checks every day for updates. About every six weeks it should find a new version of the daemon, download it, verify the signatures, and automatically replace the running daemon with the new one. It will send mail to the administrator address describing what happened. You should get this mail shortly after the LOCKSS team sends out an announcement of the new daemon release. The box will also send mail if it detects problems; if it isn't clear what to do about it forward the mail to
.
To shut the box down, login as root and type halt, or to reboot type reboot. The shutdown process takes a few seconds; wait until you see Press any key to reboot before powering off or resetting. Shutting the LOCKSS box down in this way allows the file systems to be marked clean. If the LOCKSS box was not shut down cleanly the file systems will be checked during the boot sequence; this can take hours. Rebooting the box restores all its software to a pristine state, it is generally the first thing to try if the box is behaving oddly.
If you restart the machine with the configuration medium (floppy, USB disk or configured CD) in the drive, the configuration it contains will be used. If you remove the configuration media and boot from the LOCKSS CD, it will re-enter the configuration dialog. This is how you re-configure your LOCKSS box if you ever need to. If you need to change your LOCKSS box's IP address, please mail
to warn us. We will need to update our information about your LOCKSS box.
If anything goes wrong -- please send e-mail to