Setup Koha Server

Enable Koha OAI Server

Access Koha via a web browser http://[IPofKohaVM]:8080/ Log in with the “kohaadmin” account Enter the system preference page More > Administration > Global system preferences Under OAIPMH, set the OAIPMH parameter to ON

(Note :Points to be considered when using KOHA-GSDL Integration )

1. The collection name of GSDL collection should be the same as "LibraryName" of KOHA whereas OAI-PMH-archiveID can be anything and will be used during collection building on GSDL.

To test the OAI server is set up correctly, you need to make sure there are some records in the system. If there aren't any, add some new records via the "Cataloging" panel.

To show a list of OAI records

http://[IPofKohaVM]/cgibin/koha/oai.pl?verb=ListIdentifiers&metadataPrefix=oai_dc

In here, you will be able to find a list of OAI identifiers.

By default, the identifier is constructed as "KOHAOAITEST:" followed by the Koha internal ID. For example, "KOHAOAITEST:1" is the OAI identifier for the first Koha record.

To retrieve OAI metadata for the specified OAI Identifier

http://[IPofKohaVM]/cgibin/koha/oai.pl?verb=GetRecord&identifier=[OAI-Identifier]&metadataPrefix=oai_dc

Set up Greenstone2.83

IMPORTANT: The MetadataXMLPlugin.pm has been modified to allow the custom OAIMetadataXMLPlugin.pm to work properly. However, the fix is not in any current tagged version. Please use the attached MetadataXMLPlugin.pm to replace the one in [Greenstone Installation]/perllib/plugins/MetadataXMLPlugin.pm

Set up Koha OAI collection with GLI (Linux)

Starting up the GLI server by running. /gli.sh and create a new collection under File > New... In this example we use "test" as our collection name.

Gather Panel

Use the Gather panel and put the source files into the test collection.

Enrich Panel

Add Dublin Core Metadata to the source documents. IMPORTANT: Add the “Koha OAI identifier” for the source document to the "dc.Resource Identifier" field (for example, KOHAOAITEST:1) This is how we link between Greenstone and Koha.In above case it will be like : test:1

Manual process for installing OAIMetadataXMLPlugin Quit out GLI Enter your Greenstone test collection from a terminal [Greenstone Installation]/collect/kohaoai Create perllib/plugins and copy the OAIMetadataXMLPlugin.pm into there from the folder.

Design Panel Reenter GLI and move on to the Design Panel Enter Document Plugins, choose the plugins that processes your source documents. IMPORTANT: You should see the OAIMetadataXMLPlugin as an option in the "Select plugin to add" list. Add the plugin and set "oai_server" to http://[IP of the Koha VM]:8080/cgi bin/koha/oai.pl.

Under the Librarian mode (the default mode), move the OAIMetadataXMLPlugin to the end of your plugin list. Under the Expert mode, move the OAIMetadataXMLPlugin to the front of MetadataXMLPlugin.

Create Panel IMPORTANT: Under Librarian mode (the default mode), enable the OIDtype and set it to“assigned”.

– Build the collection

Format Panel Enter Format Features and configure the page to have the following formatsVList<td valign=top>[link][icon][/link]</td><td valign=top>[highlight][link]{Or}{[classifyTitle],[Title]}[/link]<br/>{If}{[numleafdocs],,{If}{[Title],<small> Extracted Title: [Title]</small>}}[highlight]{If}{[Date],<br><small><i>_textdate_[Date]</i></small>}{If}{[NumPages],<br><small><i>_textnumpages_[NumPages]</i></small>}{If}{[Source],<br><small><i>_textsource_[Source]</i></small>}</td>

DocumentText<h3>[classifyTitle]</h3><b>Greenstone Metadata</b><hr width=\"100%\"/><b>dls.Title:</b> [dls.Title]<br/><b>dls.Subject:</b> [dls.Subject]<br/><b>dc.Identifier:</b> [dc.Identifier]<br/><br/><b>{If}{[oaiextracted.title],Koha Metadata, <span style=\"color: #B0B0B0\">Koha Metadata (NoKoha Metadata Extracted)</span>}</b><hr width=\"100%\"/>{If}{[oaiextracted.title], <b>dc.Title:</b> [oaiextracted.title]<br/>}{If}{[oaiextracted.type], <b>dc.Type:</b> [oaiextracted.type]<br/>}

{If}{[oaiextracted.date], <b>dc.Date:</b> [oaiextracted.date]<br/>}{If}{[oaiextracted.koharecordlink], <a href=\"[oaiextracted.koharecordlink]\">KohaRecord</a><br/>}<br/>

<b>Extracted Metadata</b><hr width=\"100%\"/>{If}{[Title], <b>Title:</b> [Title]<br/>}{If}{[Date], <b>Publication Date:</b> [Date]<br/>}{If}{[NumPages], <b>No. of Pages:</b> [NumPages]<br/>}{If}{[FileFormat], <b>File Format:</b> [FileFormat]<br/>}{If}{[ImageWidth], <b>Image Width:</b> [ImageWidth]<br/>}{If}{[ImageHeight], <b>Image Height:</b> [ImageHeight]<br/>}<br/><b>Source</b><hr width=\"100%\"/>

{Or}{[screenicon],[Text]} DocumentImages true

NOTE: Koha OAI metadata is extracted and stored as "oaiextracted.metadata_name". These metadata can be used in the format statement as [oaiextracted.type]

Screenshots for Integration of KOHA and GSDL

1. OPAC Search Results

2. OPAC Details Page

3. Staff Client Configuration for controlling FullText Link

4. Final Integration result and URL