1 | # OAI Server Configuration
|
---|
2 |
|
---|
3 | # This is the main configuration file for configuring your Greenstone oai server.
|
---|
4 | # The server is a cgi program called oaiserver (oaiserver.exe on Windows).
|
---|
5 | # Some basic commands that you can send it are:
|
---|
6 | # ....cgi-bin/oaiserver.cgi?verb=Identify
|
---|
7 | # ....cgi-bin/oaiserver.cgi?verb=ListSets
|
---|
8 | # ....cgi-bin/oaiserver.cgi?verb=ListMetadataFormats
|
---|
9 | # ....cgi-bin/oaiserver.cgi?verb=ListIdentifiers&set=xxx (1.1 only)
|
---|
10 | # ....cgi-bin/oaiserver.cgi?verb=ListIdentifiers&set=xxx&metadataPrefix=oai_dc (2.0 only)
|
---|
11 | # ....cgi-bin/oaiserver.cgi?verb=ListRecords&set=xxx&metadataPrefix=oai_dc
|
---|
12 | # ....cgi-bin/oaiserver.cgi?verb=GetRecord&identifier=xxx&metadataPrefix=oai_dc
|
---|
13 |
|
---|
14 | #The List verbs (ListSets, ListIdentifiers, ListRecords) all return a
|
---|
15 | #sequence of items. The 'resumeafter' paramter below indicates how many
|
---|
16 | #records to return - if this number is less than the number matching the
|
---|
17 | #request, then a resumption token is returned. To use this to get the
|
---|
18 | #next set of documents, you need to issue the same request again, with
|
---|
19 | #an additional parameter: resumptionToken=xxx
|
---|
20 | #For example,
|
---|
21 | # ....cgi-bin/oaiserver.cgi?verb=ListRecords&set=demo&metadataPrefix=oai_dc&resumptionToken=gsdloai:demo,,11-
|
---|
22 |
|
---|
23 | # For more information about the OAI-PMH protocol, see
|
---|
24 | # http://www.openarchives.org/
|
---|
25 |
|
---|
26 | # Strings containing spaces should be enclosed in double quotes ""
|
---|
27 |
|
---|
28 | #the baseURL used by the oaiserver
|
---|
29 | #Example: baseURL "http://your-domain-name/cgi-bin/oaiserver.cgi"
|
---|
30 | baseURL "your-own-baseURL-goes-here"
|
---|
31 |
|
---|
32 | # the base address of gsdl directory
|
---|
33 | #Example: baseDocRoot "http://your-domain-name/gsdl"
|
---|
34 | baseDocRoot "your-own-base-document-root-goes-here"
|
---|
35 |
|
---|
36 | # The OAI repository name - human readable
|
---|
37 | repositoryName ""
|
---|
38 |
|
---|
39 | # The central administrative email address for the repository.
|
---|
40 | maintainer ""
|
---|
41 |
|
---|
42 | # Which version of OAI the repository supports, 1.1 or 2.0
|
---|
43 | # (The server supports both)
|
---|
44 | oaiversion "2.0"
|
---|
45 |
|
---|
46 | # How many records to output before needing a resumption token
|
---|
47 | # A value of -1 will return all records for a request
|
---|
48 | resumeafter 250
|
---|
49 |
|
---|
50 | # Other free text items describing the repository. There is no restriction
|
---|
51 | # on the number of items, or item names
|
---|
52 | # The format is like the following:
|
---|
53 | # oaiinfo "item name" "item value"
|
---|
54 | # Examples may include sponsor, purpose, size...
|
---|
55 |
|
---|
56 | # A list of collections that should be made available to OAI clients. By
|
---|
57 | # default, collections are not available.
|
---|
58 | # There can be more than one line: each line must start with oaicollection,
|
---|
59 | # and this is followed by one or more collection names. The collection name
|
---|
60 | # is the name of the collection's folder in the collect directory.
|
---|
61 | oaicollection demo documented-examples/oai-e
|
---|
62 |
|
---|
63 | # Optional, set name and description for each collection
|
---|
64 | # collname is the same collection name as in the above oaicollection line
|
---|
65 | # The format is like the following:
|
---|
66 | # oaisetname collname "Name of Collection"
|
---|
67 | # oaisetdescription collname "Collection description"
|
---|
68 |
|
---|
69 | # Metadata mapping information. At present, Greenstone's OAI server
|
---|
70 | # supports the following metadata formats.
|
---|
71 | # oai_dc (OAI standard for Dublin Core)
|
---|
72 | # gsdl_qdc (Greenstone format for Qualified Dublin Core)
|
---|
73 | # rfc1807 (OAI standard for RFC 1807 format)
|
---|
74 |
|
---|
75 | # the list of metadata formats this server should support (Choose from the
|
---|
76 | # above list)
|
---|
77 | oaimetadata oai_dc gsdl_qdc
|
---|
78 |
|
---|
79 | #### Metadata Mapping Rules ####
|
---|
80 | ################################
|
---|
81 |
|
---|
82 | # Metadata in other formats must be mapped to the formats specified above.
|
---|
83 | # This can be done in this file, or, for a particular collection, in its
|
---|
84 | # collect.cfg file.
|
---|
85 |
|
---|
86 | # The format is like
|
---|
87 | # oaimapping <greenstone fieldname> <metadataPrefix.fieldname>
|
---|
88 |
|
---|
89 | # The Greenstone field names can be unqualified (Title, Subject) or
|
---|
90 | # qualified by a namespace (dc.Title, dls.Subject). Capitalization must match
|
---|
91 | # that used by Greenstone.
|
---|
92 | # OAI field names must start with the metadataPrefix name (e.g. oai_dc.) and
|
---|
93 | # capitalization must match that used by the appropriate schema. Valid elements
|
---|
94 | # for each schema are listed below. Only valid elements will be included in
|
---|
95 | # the output
|
---|
96 |
|
---|
97 | # OAI Dublin Core metadata schema:
|
---|
98 | # http://www.openarchives.org/OAI/2.0/oai_dc.xsd
|
---|
99 | # metadataPrefix: oai_dc
|
---|
100 | # Valid elements:
|
---|
101 | # contributor coverage creator date description format identifier language
|
---|
102 | # publisher relation rights source subject title type
|
---|
103 |
|
---|
104 | # Greenstone's OAI Qualified Dublin Core metadata schema:
|
---|
105 | # http://www.greenstone.org/namespace/gsdl_qdc/1.0/gsdl_qdc.xsd
|
---|
106 | # metadataPrefix: gsdl_qdc
|
---|
107 | # Valid elements:
|
---|
108 | # title creator subject description publisher contributor date type format
|
---|
109 | # identifier source language relation coverage rights alternative
|
---|
110 | # tableOfContents abstract created valid available issued modified
|
---|
111 | # dateAccepted dateCopyrighted dateSubmitted extent medium isVersionOf
|
---|
112 | # hasVersion isReplacedBy replaces isRequiredBy requires isPartOf hasPart
|
---|
113 | # isReferencedBy references isFormatOf hasFormat conformsTo spatial
|
---|
114 | # temporal audience accrualMethod accrualPeriodicity accrualPolicy
|
---|
115 | # instructionalMethod provenance rightsHolder mediator educationLevel
|
---|
116 | # accessRights license bibliographicCitation
|
---|
117 |
|
---|
118 | # OAI RFC 1807 metadata schema
|
---|
119 | # http://www.openarchives.org/OAI/1.1/rfc1807.xsd
|
---|
120 | # metadataPrefix: rfc1807
|
---|
121 | # Valid elements:
|
---|
122 | # bib-version id entry organization title type revision withdraw author
|
---|
123 | # corp-author contact date pages copyright handle other_access retrieval
|
---|
124 | # keyword cr-category period series monitoring funding contract grant
|
---|
125 | # language notes abstract
|
---|
126 |
|
---|
127 | # mappings for the dls metadata set
|
---|
128 | # for dublin core (oai_dc metadata prefix)
|
---|
129 | oaimapping dls.Title oai_dc.title
|
---|
130 | oaimapping dls.Subject oai_dc.subject
|
---|
131 | oaimapping dls.Language oai_dc.language
|
---|
132 | oaimapping dls.Organization oai_dc.publisher
|
---|
133 | # for qualified dublin core (gsdl_qdc metadata prefix)
|
---|
134 | oaimapping dls.Title gsdl_qdc.title
|
---|
135 | oaimapping dls.Subject gsdl_qdc.subject
|
---|
136 | oaimapping dls.Language gsdl_qdc.language
|
---|
137 | oaimapping dls.Organization gsdl_qdc.publisher
|
---|
138 |
|
---|
139 |
|
---|
140 | # These mapping rules will apply to the entire repository.
|
---|
141 |
|
---|
142 | # Collection specific rules can also be specified in this file using a
|
---|
143 | # collection name qualifier with the greenstone field name. This is the
|
---|
144 | # collection name followed by a colon (demo:Title, demo:dls.Title).
|
---|
145 | # oaimapping demo:dls.Title oai_dc.title
|
---|
146 | # Mappings specified in a collect.cfg file do not need the collection
|
---|
147 | # qualifier.
|
---|
148 |
|
---|