Operation (PDS4)
This document describes how to operate the Harvest Tool software for use with PDS4 data product registration. The following topics can be found in this document:
Overview
Harvest Tool is a highly configurable flexible tool for ingesting metadata from PDS4 labels and products. However, due to it's highly configurable nature it is also very complex and has a fairly significant learning curve. This section will provide an overview of what is needed in order to get started.
Tutorial
The PDS Engineering Node website has a procedure for Data Releases at Discipline Nodes, which contains an example set for walking through the ingestion of some data into the Registry get a sense of how it works. If you would like to dive right in, continue on through the more detailed configuration and execution of the tool.
Quick Start
Move onto the Quick Start Guide for a background on configuring the policy files and executing Harvest.
Add New Search Fields to 'data' collection
Harvest and the Registry can be configured to add additional fields to the searchable "data" collection. The process can be cumbersome, so feel free to reach out to Engineering Node for assistance:
- Add a new slot to the applicable policy candidate
- Add a new field to the applicable Search API Config File
- Add a new field to the data schema throug the Solr Schema API or
Quick Start
This section is intended to give a quick and easy way to set up the Harvest policy configuration file and run the tool. For a more detailed explanation on other ways to set up the policy configuration file as well as other ways of running the tool, go to the Harvest Policy File and Advanced Usage sections.
Setup
Included in the Harvest package is a master policy example configuration file for PDS4 product registration. Go to the examples/ folder, make a copy of the harvest-policy-master.xml file and modify it as necessary.
Next, you can continue on to the Walk-Through to learn about the various sections of the config and how to modify them.
Or you can head to the Minimal Config section to make some minor mods to the config to get started testing.