# OAI Server Configuration # This is the main configuration file for configuring your Greenstone oai server. # The server is a cgi program called oaiserver (oaiserver.exe on Windows). # Some basic commands that you can send it are: # ....cgi-bin/oaiserver.cgi?verb=Identify # ....cgi-bin/oaiserver.cgi?verb=ListSets # ....cgi-bin/oaiserver.cgi?verb=ListMetadataFormats # ....cgi-bin/oaiserver.cgi?verb=ListIdentifiers&set=xxx (1.1 only) # ....cgi-bin/oaiserver.cgi?verb=ListIdentifiers&set=xxx&metadataPrefix=oai_dc (2.0 only) # ....cgi-bin/oaiserver.cgi?verb=ListRecords&set=xxx&metadataPrefix=oai_dc # ....cgi-bin/oaiserver.cgi?verb=GetRecord&identifier=xxx&metadataPrefix=oai_dc #The List verbs (ListSets, ListIdentifiers, ListRecords) all return a #sequence of items. The 'resumeafter' paramter below indicates how many #records to return - if this number is less than the number matching the #request, then a resumption token is returned. To use this to get the #next set of documents, you need to issue the same request again, with #an additional parameter: resumptionToken=xxx #For example, # ....cgi-bin/oaiserver.cgi?verb=ListRecords&set=demo&metadataPrefix=oai_dc&resumptionToken=gsdloai:demo,,11- # For more information about the OAI-PMH protocol, see # http://www.openarchives.org/ # Strings containing spaces should be enclosed in double quotes "" #the baseURL used by the oaiserver #Example: baseURL "http://your-domain-name/cgi-bin/oaiserver.cgi" baseURL "your-own-baseURL-goes-here" # the base address of gsdl directory #Example: baseDocRoot "http://your-domain-name/gsdl" baseDocRoot "your-own-base-document-root-goes-here" # The OAI repository name - human readable repositoryName "" # The central administrative email address for the repository. maintainer "" # Which version of OAI the repository supports, 1.1 or 2.0 # (The server supports both) oaiversion "2.0" # How many records to output before needing a resumption token # A value of -1 will return all records for a request resumeafter 250 # Other free text items describing the repository. There is no restriction # on the number of items, or item names # The format is like the following: # oaiinfo "item name" "item value" # Examples may include sponsor, purpose, size... # A list of collections that should be made available to OAI clients. By # default, collections are not available. # There can be more than one line: each line must start with oaicollection, # and this is followed by one or more collection names. The collection name # is the name of the collection's folder in the collect directory. oaicollection demo oai-e # Optional, set name and description for each collection # collname is the same collection name as in the above oaicollection line # The format is like the following: # oaisetname collname "Name of Collection" # oaisetdescription collname "Collection description" # Metadata mapping information. At present, Greenstone's OAI server # supports the following metadata formats. # oai_dc (OAI standard for Dublin Core) # gsdl_qdc (Greenstone format for Qualified Dublin Core) # rfc1807 (OAI standard for RFC 1807 format) # the list of metadata formats this server should support (Choose from the # above list) oaimetadata oai_dc gsdl_qdc # Metadata in other formats must be mapped to these formats. This can be done # in this file, or for a particular collection, in its collect.cfg file. # The format is like # oaimapping # The Greenstone field names can be unqualified (Title, Subject) or # qualified by a namespace (dc.Title, dls.Subject). These mapping rules # will apply to the entire repository. Collection specific rules can also # be specified in this file using a collection name qualifier. This is # the collection name followed by a colon (demo:Title, demo:dls.Title). # Mappings specified in a collect.cfg file do not need the collection # qualifier. # Details about the Dublin Core metadata format can be found at # http://dublincore.org/ # Elements include Title, Creator, Subject, Description, Publisher, # Contributor, Date, Type, Format, Identifier, Source, Language, # Relation, Coverage, Rights # mappings for the dls metadata set # for dublin core (oai_dc metadata prefix) oaimapping dls.Title oai_dc.title oaimapping dls.Subject oai_dc.subject oaimapping dls.Language oai_dc.language oaimapping dls.Organization oai_dc.publisher # for qualified dublin core (gsdl_qdc metadata prefix) oaimapping dls.Title gsdl_qdc.title oaimapping dls.Subject gsdl_qdc.subject oaimapping dls.Language gsdl_qdc.language oaimapping dls.Organization gsdl_qdc.publisher