Warning: This page has not been updated in over over a year and may be outdated or deprecated.
indexing:dspace
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
indexing:dspace [2017/04/21 11:49] – demiankatz | indexing:dspace [2020/09/21 13:53] – demiankatz | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== How to index DSpace with VuFind ====== | ====== How to index DSpace with VuFind ====== | ||
- | These are the instructions used by the Naval Postgraduate School | + | ===== 1. Make sure OAI-PMH is turned on in DSpace |
- | :!: ** These instructions were written for VuFind 2.x or newer; See [[legacy:indexing: | + | In newer versions of DSpace, OAI-PMH should be enabled by default; however, in DSpace 3.x and earlier, some [[indexing: |
- | ===== Steps ===== | + | ===== 2. Import records into VuFind using OAI-PMH harvest |
- | OAI must be enabled on the DSpace repository first: | + | These steps use VuFind' |
- | | + | |
- | Proxy_set_header X-Forwarded-Host $host; | + | |
- | Proxy_set_header X-Forwarded-Server $host; | + | |
- | Proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; | + | |
- | + | ||
- | Proxy_pass http:// | + | |
- | Proxy_redirect http:// | + | |
- | Proxy_buffering off; | + | |
- | Proxy_store off; | + | |
- | + | ||
- | Proxy_connect_timeout 120; | + | |
- | Proxy_send_timeout 120; | + | |
- | Proxy_read_timeout 120; | + | |
- | } | + | |
- | </ | + | |
- | - Modify the **server.xml** for the appropriate DSpace Tomcat instance in the **HOST** block:< | + | |
- | Reloadable=" | + | |
- | allowLinking=" | + | |
- | - Modify the **dspace.conf** config file for the appropriate DSpace instance:< | + | |
- | harvest.includerestricted.oai = true | + | |
- | harvester.autoStart = true | + | |
- | ...</ | + | |
- | + | ||
- | Then you may proceed to import the OAI feed into VuFind: | + | |
- | | + | |
- | - Run these commands: | + | |
- | + | ||
- | < | + | |
- | cd $VUFIND_HOME/ | + | |
- | php harvest_oai.php | + | |
- | ./ | + | |
- | </ | + | |
- | ===== Required Files ===== | + | |
- | + | ||
- | ==== oai.ini ==== | + | |
- | < | + | |
- | [DSpace] | + | |
url=http:// | url=http:// | ||
metadataPrefix=oai_dc | metadataPrefix=oai_dc | ||
Line 55: | Line 19: | ||
injectId=" | injectId=" | ||
dateGranularity=auto | dateGranularity=auto | ||
- | harvestedIdLog=harvest.log | + | harvestedIdLog=harvest.log</ |
+ | - Run these commands:< | ||
+ | php harvest_oai.php | ||
+ | ./ | ||
+ | |||
+ | ==== Troubleshooting ==== | ||
+ | |||
+ | If you receive an error message during harvesting, you may need to rebuild the OAI indexes on your DSpace server. Log into that system and run these commands: | ||
+ | |||
+ | < | ||
+ | <path to dspace directory>/ | ||
+ | <path to dspace directory>/ | ||
</ | </ | ||
+ | After that processing completes, retry the harvest process on the VuFind server as described above. | ||
+ | |||
+ | ===== 3. Customize Import Rules (optional) ===== | ||
+ | |||
+ | If you wish to customize the way your records are ingested, see the [[indexing: | ||
+ | |||
+ | :!: If you change import rules, note that you will need to remove your $VUFIND_LOCAL_DIR/ | ||
+ | |||
+ | ===== 4. Customize Record Display (optional) ===== | ||
+ | By default, VuFind does not include any DSpace-specific display logic; records indexed from DSpace are displayed using the standard " | ||
---- struct data ---- | ---- struct data ---- | ||
---- | ---- | ||
indexing/dspace.txt · Last modified: 2023/08/16 19:52 by demiankatz