Skip to main content

This product is an OAI implementation for the Zope server.

Project description

======
README
======

Please read docs/OAIPaper.pdf to follow the initial goal of the project.

For system installation read docs/Debian-Ubuntu_Install.txt.

OAI Configuration
=================

Create an Exist connector
-------------------------

In the Plone root create an object 'eXist Database Adapter'.

- Id : exist_2
- Title : Exist v2 prod
- eXist Version Number : 2.1
- eXist Server Name : IP or domain name but not 127.0.0.1 nor localhost
- eXist Port : 8080
- Encoding : utf-8
- Username : guest
- Password : guest
- Path to XMLRPC Server : /exist/xmlrpc


Create an OAI Repository
------------------------

In the Plone root create an object 'Exist Open Archive Repository'.

- Id : oaiPlanetterre
- Title : OAI Repository Planete Terre
- ExistDA : exist_2
- Root collection : /db/planetterre/metadata

Now you have to check the Namespaces configuration: lom, oai_dc.

Here, we need to have a DublinCore output from LOM files. To configure that you go
in 'Namespaces/oai_dc' and add an XLST filter to transform lom in DublinCore.
Filters are match the remote IP (user IP) to a specific XSL transformation.
In our case we want that all incoming IP use the same transformation.
Go in the 'XSL filters' tab and add:

- IP Mask : *
- XSL Filter : xsl/lom2dc.xsl
- No XSL filter associatied : No
- Active Filer : Yes


Create a collection set
-----------------------

In the Repository root go in 'setsStorage' and create an object 'Exist Open Archive Set'.
After the creation you have to configure many fields:

- Set name : geologie
- Set spec : ensdgesco:planetterre
- Set description : your team signature
- Set XPath :
- generic filter : *
- generic filter on Thokavi : contains(*, 'Tho')
- specific on some tags filter on Thokavi : contains(*:classification/*:taxonPath/*:source/*:string, 'Tho')
- Set publication date : $md//*:contribute[contains(*:role/*:value,"publisher")]/*:date/*:dateTime


Tesing OAI
----------

The base root for testing is the OAI repository: http://your.servername.io/oaiPlanetterre'.

You can test following verbs:

- ?verb=ListSets
- ?verb=Identify
- ?verb=ListMetadataFormats
- ?verb=ListRecords&metadataPrefix=oai_dc
- ?verb=ListRecords&from=2010-01-01&metadataPrefix=lom&set=ensdgesco:planetterre
- ?verb=ListIdentifiers&metadataPrefix=lom&until=2009-01-01&set=ensdgesco:planetterre


Create an harvester
-------------------

In the Plone root create an object 'Exist Open Archive Aggregator'.

Check for parameters:

- Id : a free id in the Plone root
- Default update : daily, weekly or monthly
- ExistDA Identifier : exist_2
- Root OAI collection aggregator : an existing path in your exist database where to store harvested collections ('/db/harvest').


After creation you have already 'Namespaces', 'Tokens' and 'setsStorage' in the folder. You need
to edit the default namespaces to fix some values.

In 'Namespaces' you have 'lom' and 'oai_dc'. Check the configuration.

Click on the button 'Add Exist Open Archives Harvester':

- Id : unisciel
- Title : unisciel
- Site Host : trouver.unisciel.fr
- Site url : /oaiUnisciel
- OAI Set : ensdgesco:CSP

Other fields are optionnal, you can submit.

Go in your new harvest collection and choose the 'Update' tab. You should see a list of sets available on the server.
Click on the button 'Harvest now' to test your configuration.


Changelog
=========

1.7.1 2013-07-09
-------------------

- Improve documention for instanciation of OAI repository and OAI harvester.
[encolpe]

- Improve documention for installation on Debian Wheezy and Ubuntu Raring.
[encolpe]

- Fix default main namespace declaration.
[encolpe]

- Again some tab and indentation fixes.
[encolpe]

1.7.0 2013-07-08
-------------------

- Add a configuration option to get publication date in Sets.
[encolpe]

1.6.3 2013-05-14
-------------------

- Fix the manifest file
[encolpe]

1.6.2 2013-05-06
-------------------

- Add missing MANIFEST.in file
[encolpe]

1.6.1 2013-05-06
-------------------

- Fix author email
[encolpe]

1.6.0 2013-05-06
-------------------

- Add EXist 2.0 compatibility
[encolpe]


1.5.4dev (unreleased)
---------------------

- Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Products.ZOpenArchives-1.7.2.zip (613.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page