OAI FAQ

What is OAI?

See http://www.openarchives.org/

What version of OAI does EPrints support?

Version 1.1 and 2.0, although 1.1 is deprecated and we strongly recommend you do not use it.

What is the OAI URL for my archive?

It is the base URL of your archive plus /cgi/oai2 eg. http://eprints.soton.ac.uk/cgi/oai2

When verifying/registering my archive OAI interface I get "empty resumpotion token" error.

This is a known bug in 2.3 and should be fixed in the next release - see http://threader.ecs.soton.ac.uk/lists/eprints_tech/1926.html for a patch.

When verifying/registering my archive OAI interface I get a validation error because the "ListSets" response doesn\'t have any "Set" elements in it. Why is this? Probably a bug in the OAI configuration. In several releases we accidently left a "filter" on all the OAI output. If you have this in ArchiveOAIConfig?.pm:

$oai->{filters} = [
	{ meta_fields => [ "creators" ], value=>"harnad" }
# Example: don't export any OAI records from before 2003.
#	{ meta_fields => [ "date-effective" ], value=>"2003-" }
];

Then comment out (add a # at the start) the line with "harnad" in and restart the webserver.

I'm not sure this will resolve the problem. If not please email eprints support.

Problem validating OAI output from version 2.3.4 of eprints. There is a bug that strips all xmlns attributes from all XML output from eprints. This is good for XHTML but bad for everything else. It'll be fixed in the next release. If it's urgent search perl_lib/EPrints/XML.pm for the line which removes xmlns attributes and comment it out (add a # to the start of the line). It's a single line...

      next if( $name =~ m/^xmlns/ );