Metacat Administrator’s Guide¶
Metacat is a repository for data and metadata (documentation about data) that helps scientists find, understand and effectively use data sets they manage or that have been created by others. Thousands of data sets are currently documented in a standardized way and stored in Metacat systems, providing the scientific community with a broad range of science data that–because the data are well and consistently described–can be easily searched, compared, merged, or used in other ways.
Note:
Your Metacat instance MUST be either 2.19.0 or 2.19.1 before you can upgrade it to 3.0.0 or above.
An external Solr HTTP server is required as of Metacat version 2.13.0. You should add the tomcat
user to the solr group and the solr user to the tomcat group in order to avoid the file
permission issues. The details can be found on the Solr Server part of the installation page.
If this is the first time you have installed an external Solr server, you need to re-index all existing objects in the Metacat instance. The instruction can be found on the Regenerating The Index part of the Metacat indexing page.
Download Metacat
- Binary Distribution (A war file installation)
GZIP File: metacat-bin-3.1.0.tar.gz
ZIP File: metacat-bin-3.1.0.zip
- Source Distribution (Full source, requiring build)
GZIP File: metacat-src-3.1.0.tar.gz
ZIP File: metacat-src-3.1.0.zip
For Developers: Metacat API documentation
Contents¶
- 1. Introduction
- 2. Contributors
- 3. License
- 4. Downloading and Installing Metacat
- 5. Configuring Metacat
- 5.1. Initial Configuration & Backup Properties
- 5.2. Authentication Configuration
- 5.3. Changing Authentication Configuration without Authentication
- 5.4. Logging in to Metacat
- 5.5. Required Configuration
- 5.6. Global Properties
- 5.7. Database Configuration
- 5.8. Solr Server Configuration
- 5.9. DataONE Configuration
- 5.10. DOI Service Configuration
- 5.11. Additional Configuration
- 5.12. Read-only Mode
- 5.13. MetacatUI Themes
- 6. Kubernetes
- 7. Admin API
- 8. DataONE Member Node Support
- 8.1. What is DataONE?
- 8.2. The DataONE Service Interface
- 8.3. Member Nodes
- 8.4. Coordinating Nodes
- 8.5. Investigator Toolkit
- 8.6. Configuring Metacat as a Member Node
- 8.7. Access Control Policies
- 8.8. Configuration as a replication target
- 8.9. Object Replication Policies
- 8.10. Apache configuration details
- 8.11. Configure Tomcat to allow DataONE identifiers
- 9. Accessing and Submitting Metadata and Data
- 10. Metacat Indexing
- 11. Modifying and Creating Themes
- 12. Metacat Authentication Mechanism
- 13. OAI Protocol for Metadata Harvesting
- 14. Event Logging
- 15. Enabling Web Searches: Sitemaps
- 16. Appendix: Metacat Properties
- 17. Appendix: Development Issues