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:59] – demiankatz | indexing:dspace [2020/09/21 15:38] – [2. Import records into VuFind using OAI-PMH harvest] 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 and properly indexed |
- | :!: ** These instructions were written for VuFind 2.x or newer; See [[legacy:indexing:dspace|this page]] for VuFind 1.x ** | + | To retrieve records from DSpace, you will need to use the [[indexing:oai-pmh|OAI-PMH]] protocol. |
- | ===== 1. Turn on OAI-PMH in DSpace | + | In newer versions of DSpace, |
- | OAI must be enabled | + | You can check whether the service is enabled |
- | - Modify the DSpace server config in **nginx.conf** on the DSpace server:<code>Location /oai/ { | + | |
- | 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; | + | Before harvesting data from DSpace to VuFind, you should check that DSpace' |
- | | + | |
- | | + | {{ : |
- | } | + | |
- | </ | + | In the above image, |
- | - Modify the **server.xml** for the appropriate DSpace Tomcat instance in the **HOST** block:< | + | |
- | Reloadable=" | + | ==== Fixing Missing Indexing ==== |
- | | + | |
- | - Modify | + | If metadata does not display correctly through the server (for example, if you receive an "Error No matches for the query" |
- | harvest.includerestricted.oai = true | + | |
- | harvester.autoStart = true | + | < |
- | ...</ | + | ./ |
+ | </ | ||
+ | |||
+ | The meaning of parameters –o and –c is as follows: | ||
+ | |||
+ | * -o Optimize index after indexing | ||
+ | * -c Clears the Solr index before indexing (it will import all items again) | ||
===== 2. Import records into VuFind using OAI-PMH harvest ===== | ===== 2. Import records into VuFind using OAI-PMH harvest ===== | ||
- | These steps use VuFind' | + | These steps use VuFind' |
- Modify **$VUFIND_LOCAL_DIR/ | - Modify **$VUFIND_LOCAL_DIR/ | ||
Line 50: | Line 48: | ||
php harvest_oai.php | 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) ===== | ===== 3. Customize Import Rules (optional) ===== | ||
- | If you wish to customize the way your records are ingested, see the [[indexing: | + | 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/ | :!: 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