The University of Illinois Open Archives Initiative Metadata Harvesting Project


ASP OAI 2.0 Static Repository Gateway
ver. 1.11

Disclaimer: The following is 'quick and dirty' documentation to hopefully get you started. It assumes a fair amount of familiarity with configuring the Microsoft IIS web server and other minutia such as editing text files, etc. Hopefully, we will eventually have time for some better documentation. Thanks.

WHAT THIS IS:

This is an ASP OAI-PMH static repository gateway implementation as described in release 2.0 of the Open Archives Initiative Protocol for Metadata Harvesting and Specification of the OAI Static Repository and Gateway - alpha version .   It uses

This application can be downloaded onto an appropriately configured Microsoft Windows NT/2000 system and used with minimal configuration changes.

INSTALLATION:

ASSUMPTIONS & NOTES:

ARCHITECTURE:

Operating System / Platform
Microsoft Windows NT 4 Server SP 6
Microsoft Windows NT 4 Workstation SP 6
Microsoft 2000 Advanced Server
Microsoft 2000 Professional, SP 2
 
Microsoft Internet Information Server (IIS), version 4 or higher
 
Microsoft Active Server Pages (ASP)
ASP modules included use VBScript and JScript
 
Microsoft Windows Script, version 5.6 or higher
The script support object library is available free from the Microsoft Website at
http://msdn.microsoft.com/nhp/Default.asp?contentid=28001169
 
Microsoft XML Parser (MSXML) 4.0
This parser is available free from the Microsoft Website at
http://msdn.microsoft.com/xml
 
Windows HTTP Services (WinHTTP), version 5.0 or higher
The library is available on the Microsoft Website at
http://msdn.microsoft.com/library/en-us/winhttp/http/about_winhttp.asp
 
UIUC OAI Harvester Objects:
The library is available on SourceForge at
http://sourceforge.net/project/showfiles.php?group_id=47963

OAI PROTOCOL CONFORMANCE & XML Schema Definition Documents for Validation:

As installed locally, this system has been validated using version 1.45a of the OAI Repository Explorer (available at http://oai.dlib.vt.edu/~oai/cgi-bin/Explorer/2.0b2-1.44/testoai).   The OAI Repository Explorer tests for conformance to OAI Protocol release 2.0. When you have you have completed installing this tool and believe everything is set up properly, go to this site and enter the URL for your data to validate your system.

INCLUDED FILES:

PathInfoFilter.dll
An ISAPI filter for handling the extended path info passed from the harvester to the gateway.

PathInfoFilter.ini
The configuration file for PathInfoFilter.dll.

global.asa
The global.asa file retrieves parameters from GatewayDescription.xml to configure the gateway.

GatewayDescription.xml
The configuration file for the OAI Static Repository Gateway. It is XML-formatted and self-illustrative. Please refer to the file for repository settings.

StaticRepositoryDescription.xml
The configuration file for the supported static repositories. The filename can be specified in GatewayDescription.xml.

static-repository.xml
An sample OAI static repository adapted from Specification of the OAI Static Repository and Gateway - alpha version .

README.html
This HTML file.

license.html
The Open Source license for this code.

functions.inc
This contains various functions that are needed by other script files. This file is included in the scripts that need access to the functions. functions.inc provides functions and subroutines such as parsing OAI identifiers, generating UTC datestamps, creating and parsing resumption tokens, etc. These are mostly functions that should be reusable across many different OAI implementations and are not specific to this implementation.

oai.asp
The main Active Server Page script code. All OAI requests are dispatched by oai.asp. Most of this code is written in VBScript, a small amount of JScript is also used.

*.asp (other than oai.asp)
Each of these ASP files corresponds to a single OAI request and is called by oai.asp.

*.xsl
Each of these XSLT files corresponds to a single OAI request for generating the response by using the XSLT technology.

All code provided in this illustrative implementation is being made available under OpenSource license.

AUTHORS:

Thomas G. Habing
Research Programmer, Digital Library Initiative
University of Illinois at Urbana-Champaign
052 Grainger Engineering Library, MC-274
thabing@uiuc.edu
Timothy W. Cole
Mathematics Librarian
University of Illinois at Urbana-Champaign
214 Altgeld Hall, MC-382
t-cole3@uiuc.edu
Ying-ping Chen
Graduate Assistant
University of Illinois at Urbana-Champaign
052 Grainger Engineering Library, MC-274
ychen21@uiuc.edu
  University of Illinois at Urbana-Champaign University of Illinois at Urbana-Champaign
Library Gateway Homepage
Comments to: Tom Habing
Updated on: 10/06/03 Ychen21