Files/OAI Harvester for EPrints 3.2+ - Revision history

Kgoetz: bring in contents from Synchronize your repository via OAI-PMH

2018-10-03T00:17:43Z

bring in contents from Synchronize your repository via OAI-PMH

← Older revision		Revision as of 00:17, 3 October 2018
Line 2:		Line 2:
	[[Category: Eprints3.2]]		[[Category: Eprints3.2]]
	[[Category: Eprints3.3]]		[[Category: Eprints3.3]]
			[[Category:OpenAccess]]


			The [http://www.openarchives.org/pmh/ Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH)] is a low-barrier mechanism for repository interoperability. Data Providers are repositories that expose structured metadata via OAI-PMH. Service Providers then make OAI-PMH service requests to harvest that metadata. OAI-PMH is a set of six verbs or services that are invoked within HTTP.

			== About OAI Harvester plugin ==

	Keeps your repository in-sync with another repository via OAI-PMH.		Keeps your repository in-sync with another repository via OAI-PMH.

	Note that these modules contain only the abstract classes, you will need to write your own module which translate whatever XML format you're harvesting to EPrints data structure. An example is provided under <code>cfg/plugins/EPrints/Plugin/Import/OAIPMH/Stub.pm.stub</code>.		Note that these modules contain only the abstract classes, you will need to write your own module which translate whatever XML format you're harvesting to EPrints data structure. An example is provided under <code>cfg/plugins/EPrints/Plugin/Import/OAIPMH/Stub.pm.stub</code>.

			To be able to harvest another repository using OAIPMH you must [http://files.eprints.org/751/ install this plugin] and configure it per instructions below.

	=== Install ===		=== Install ===
Line 45:		Line 53:

	That's it!		That's it!

			== Export your repository via OAI-PMH ==

			Make sure you follow the instructions on [[OAI]] to configure your repository with the right OAI elements.

Kgoetz: adding categories

2018-09-12T01:30:57Z

adding categories

← Older revision		Revision as of 01:30, 12 September 2018
Line 1:		Line 1:
			[[Category: Howto]]
			[[Category: Eprints3.2]]
			[[Category: Eprints3.3]]

	Keeps your repository in-sync with another repository via OAI-PMH.		Keeps your repository in-sync with another repository via OAI-PMH.

Denics@free.fr: /* OAI Harvester for EPrints 3.2+ */

2011-07-06T09:38:21Z

OAI Harvester for EPrints 3.2+

← Older revision		Revision as of 09:38, 6 July 2011
Line 1:		Line 1:
	~~== OAI Harvester for EPrints 3.2+ ==~~
	Keeps your repository in-sync with another repository via OAI-PMH.		Keeps your repository in-sync with another repository via OAI-PMH.

Denics@free.fr: Created page with '== OAI Harvester for EPrints 3.2+ == Keeps your repository in-sync with another repository via OAI-PMH. Note that these modules contain only the abstract classes, you will need …'

2011-07-06T09:38:03Z

Created page with '== OAI Harvester for EPrints 3.2+ == Keeps your repository in-sync with another repository via OAI-PMH. Note that these modules contain only the abstract classes, you will need …'

New page

== OAI Harvester for EPrints 3.2+ ==
Keeps your repository in-sync with another repository via OAI-PMH.

Note that these modules contain only the abstract classes, you will need to write your own module which translate whatever XML format you're harvesting to EPrints data structure. An example is provided under <code>cfg/plugins/EPrints/Plugin/Import/OAIPMH/Stub.pm.stub</code>.

=== Install ===
* As ''root'' user:
<code>
cpan HTTP::OAI
</code>
* As ''eprints'' user:
<code>
cp -rf bin/ cfg/ ./archives/ARCHIVEID/
</code>

check the perl declaration in file ''./archives/ARCHIVEID/bin/oai/harvest'' and change it accordingly

<code>
./bin/epadmin update_database_structure ARCHIVEID
</code>
* As ''root'' user:

Restart Web Server.

=== Usage ===
* Create a module which transforms XML as explained in the intro of this file. Say you created a DC importer called OAIPMH::OAI_DC.
* Edit the configuration file ''cfg/cfg.d/oai_harvester.pl'' and create a new configuration for the service you want to harvest (an example is provided in that file) eg:
$c->{oai_harvester}->{service_name} = {
url => 'http://oaiserver.com/oai',
set => 'that_set'
default_values => sub {
my( $session, $epdata, $header ) = @_;
$epdata->{userid} = 1234; # user '1234' will own all imported publications
$epdata->{eprint_status} = 'archive'; # imported publications will go straight to the live archive
# etc...
},
};
* Run (or setup in cron) bin/oai/harvest periodically:
<code>
bin/oai/harvest ARCHIVEID --plugin=OAIPMH::OAI_DC --conf=service_name
</code>

That's it!