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 formats
VList
<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 (No
Koha 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]\">Koha
Record</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