Jump to: navigation, search

This tutorial describes the procedure required to get some content in your machine. You will need to add the content yourself as described in the following sections, and please note that the content available to you will depend on which journals your institution has a subscription to.

Contents

[edit] Add titles to your Cache

Navigate to the cache administration interface available at http://your.hostname:8081/, which requires you enter your username (lockss) and password. This is the page from which all LOCKSS cache administration functions can be performed.1 Select Journal Configuration, which allows you manage the titles on your cache. From this page, select Add Titles, which will allow you to add one or more titles at once.

You will be presented with a screen listing the collections available to you. Select the collections you wish to add, then press Select Titles. The subsequent screen lists each title available within each collection selected. Each title constitutes an Archival Unit (AU), the smallest indivisible collection of content that a LOCKSS cache preserves. For electronic journals, an AU usually corresponds to a single volume of a single journal. For other types of content an AU may be an entire site, or any convenient, but well-defined, subset of the site.

Select the individual titles you wish to collect in your LOCKSS machine, and press Add Selected AUs. The LOCKSS daemon will shortly begin to collect the content and store it within your LOCKSS machine. You can check the progress of this by following the instructions outlined in the next section. Once the retrieval of content has completed, you can confirm that content has been correctly retrieved by viewing your content.

[edit] Can I monitor the progress of content retrieval?

You are able to monitor the retrieval of content by viewing Daemon Status -> Crawl Status. Look for entries in the Crawl Type column reading New Content. You can monitor the progress of this by checking the Status column. Once completed, this will read Successful. You can see in more detail the status of individual Archival Units by viewing the Status column in the Daemon Status -> Archival Units page.

[edit] What titles should be available?

The full list of titles currently available can be found at Publishers_and_Titles. Some content is available to Alliance members only. If the set available to you contains significantly less than you believe you are entitled to please email Image:EmailLockssSupportBold.gif; a low number of titles indicates there may be an error with the access control lists. Occasionally, a title may temporarily be unavailable for retrieval: if a publisher changes the structure of their site the plugin used by LOCKSS to retrieve the appropriate content may need to be updated. Fresh retrieval of this content will not be possible until the redevelopment work required to make this plugin conform to the new site has been completed.

[edit] The ‘Add Titles’ page includes a ‘Select All’ button. What happens if I “select all” titles, even those I don’t have access to?

You will not be able to retrieve content to which you are not permitted access. The LOCKSS system requires access to a manifest page hosted on the publishers server in order to know which files to retrieve. IP authentication is performed on requests before access is granted to this manifest page. If your institution does not have access, the system is unable to access the manifest page and in turn is unable to complete a crawl successfully. The LOCKSS team are looking at ways to immediately identify in the journal configuration page the journals an institution does have access to.

[edit] A recent issue of a title I subscribe to is available. Will back issues also be available?

The amount of content available depends on the agreement with the publisher. A publisher which agrees to make all back content available must put a manifest page online, permitting the LOCKSS system to retrieve all content. Although some publishers are putting manifest pages online for all back content, others are not. In the future, a publisher may make further back issues available. If the IP address used by your LOCKSS machine is registered for access to those back issues, and the publisher still has the manifest pages online you will be able to collect those issues. All new content, including back issues, will be announced as it becomes available.