Difference between revisions of "Archives/ARCHIVEID/cfg/cfg.d/"

From EPrints Documentation
Jump to: navigation, search
m
(Added explanation about where config files might come from an number so each indiviudal provenance can be determined.)
Line 6: Line 6:
  
 
Although this listing is shown as for the archive's cfg.d directory, it is actually the combined listing of all configuration files under the following cfg.d directories:
 
Although this listing is shown as for the archive's cfg.d directory, it is actually the combined listing of all configuration files under the following cfg.d directories:
* EPRINTS_PATH/lib/cfg.d/
+
# EPRINTS_PATH/lib/cfg.d/
* EPRINTS_PATH/flavours/pub_lib/cfg.d/
+
# EPRINTS_PATH/flavours/pub_lib/cfg.d/
* EPRINTS_PATH/lib/defaultcfg/cfg.d/ (which are copied to the repository archive's cfg.d directory on its creation).
+
# EPRINTS_PATH/lib/defaultcfg_zero/cfg.d/ (which are copied to the repository archive's cfg.d directory on its creation, unless using a specific flavour).
* EPRINTS_PATH/flavours/pub_lib/defaultcfg/cfg.d/ (which are copied to the repository archive's cfg.d directory on its creation).
+
# EPRINTS_PATH/flavours/pub_lib/defaultcfg/cfg.d/ (which are copied to the repository archive's cfg.d directory on its creation).
 
+
# Generated through ''epadmin create''
  
 
*'''[[EPrints_Directory_Structure/eprints3|eprints3]]/[[EPrints_Directory_Structure/eprints3/archives|archives]]/[[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID|ARCHIVEID]]/[[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg|cfg]]/cfg.d'''
 
*'''[[EPrints_Directory_Structure/eprints3|eprints3]]/[[EPrints_Directory_Structure/eprints3/archives|archives]]/[[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID|ARCHIVEID]]/[[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg|cfg]]/cfg.d'''
** '''[[10_core.pl]]''' - Core configuration for repository archive, such as hostname and port (both for HTTP and HTTPS), host aliases and path it sits on.
+
** '''[[10_core.pl]] <sup>5</sup>''' - Core configuration for repository archive, such as hostname and port (both for HTTP and HTTPS), host aliases and path it sits on.
** '''[[20_baseurls.pl]]''' - Configuration for how base URLs used by the repository archive.
+
** '''[[20_baseurls.pl]] <sup>1,2</sup>''' - Configuration for how base URLs used by the repository archive.
** '''[[adminemail.pl]]''' - The admin email address for the repository archive.
+
** '''[[adminemail.pl]] <sup>5</sup>''' - The admin email address for the repository archive.
** '''[[branding.pl]]''' - Branding for the repository archive.
+
** '''[[branding.pl]] <sup>1</sup>''' - Branding for the repository archive.
** '''[[database.pl]]''' - Configuration for connecting to the database.
+
** '''[[database.pl]] <sup>5</sup>''' - Configuration for connecting to the database.
** '''[[datasets.pl]]''' - Configuration for bespoke datasets and data objects for the repository archive.
+
** '''[[datasets.pl]] <sup>1</sup>''' - Configuration for bespoke datasets and data objects for the repository archive.
** '''[[document_fields_automatic.pl]]''' - Configuration for automatically setting document fields based on the values of other fields.
+
** '''[[document_fields_automatic.pl]] <sup>1</sup>''' - Configuration for automatically setting document fields based on the values of other fields.
** '''[[document_fields_default.pl]]''' - Default initial values for document fields.
+
** '''[[document_fields_default.pl]] <sup>1</sup>''' - Default initial values for document fields.
** '''[[document_fields.pl]]''' - Non-core field definitions for the document data object.
+
** '''[[document_fields.pl]] <sup>1</sup>''' - Non-core field definitions for the document data object.
** '''[[document_upload.pl]]''' - Configuration relating to managing document uploads.
+
** '''[[document_upload.pl]] <sup>1</sup>''' - Configuration relating to managing document uploads.
** '''[[document_validate.pl]]''' - Validation of the eprint data object as a whole.
+
** '''[[document_validate.pl]] <sup>1</sup>''' - Validation of the eprint data object as a whole.
** '''[[dynamic_template.pl]]''' - Legacy configuration for dynamic template of repository archive.
+
** '''[[dynamic_template.pl]] <sup>1</sup>''' - Legacy configuration for dynamic template of repository archive.
** '''[[email.pl]]''' - Configuration for sending email from the repository archive.
+
** '''[[email.pl]] <sup>1</sup>''' - Configuration for sending email from the repository archive.
** '''[[eprint_fields_automatic.pl]]''' - Configuration for automatically setting eprint fields based on the values of other fields.
+
** '''[[eprint_fields_automatic.pl]] <sup>2,3</sup>''' - Configuration for automatically setting eprint fields based on the values of other fields.
** '''[[eprint_fields_common.pl]]''' - Common (across [[EPrints Flavours|flavours]]) non-core fields for the eprint data object.
+
** '''[[eprint_fields_common.pl]] <sup>2</sup>''' - Common (across [[EPrints Flavours|flavours]]) non-core fields for the eprint data object.
** '''[[eprint_fields_default.pl]]''' - Default initial values for eprint fields.
+
** '''[[eprint_fields_default.pl]] <sup>2,3</sup>''' - Default initial values for eprint fields.
** '''[[eprint_fields.pl]]''' - Non-core field definitions for the eprint data object.
+
** '''[[eprint_fields.pl]] <sup>2,3</sup>''' - Non-core field definitions for the eprint data object.
** '''[[eprint_fields_pub.pl]]''' - Publication [[EPrints Flavours|flavour]] fields for the eprint data object.
+
** '''[[eprint_fields_pub.pl]] <sup>2</sup>''' - Publication [[EPrints Flavours|flavour]] fields for the eprint data object.
** '''[[eprint_locking.pl]]''' - Configuration for locking eprint data objects so they can only be edited by one user at once.
+
** '''[[eprint_locking.pl] <sup>1</sup>''' - Configuration for locking eprint data objects so they can only be edited by one user at once.
** '''[[eprint_render.pl]]''' - Configuration for rendering eprint abstract/summary pages.
+
** '''[[eprint_render.pl]] <sup>2,3</sup>''' - Configuration for rendering eprint abstract/summary pages.
** '''[[eprint_search_advanced.pl]]''' - Configuration for advanced search of eprint data objects.
+
** '''[[eprint_search_advanced.pl]] <sup>2,3</sup>''' - Configuration for advanced search of eprint data objects.
** '''[[eprint_search_simple.pl]]''' - Configuration for simple search of eprint data objects.
+
** '''[[eprint_search_simple.pl]] <sup>2,3</sup>''' - Configuration for simple search of eprint data objects.
** '''[[eprint_search_staff.pl]]''' - Configuration for staff search of eprint data objects.
+
** '''[[eprint_search_staff.pl]] <sup>2,3</sup>''' - Configuration for staff search of eprint data objects.
** '''[[eprint_validate.pl]]''' - Validation of the eprint data object as a whole.
+
** '''[[eprint_validate.pl]] <sup>2,3</sup>''' - Validation of the eprint data object as a whole.
** '''[[eprint_warnings.pl]]''' - Warnings to advise the depositor on potential issues with the eprint (e.g. no uploaded documents).
+
** '''[[eprint_warnings.pl]] <sup>2,3</sup>''' - Warnings to advise the depositor on potential issues with the eprint (e.g. no uploaded documents).
** '''[[exports.pl]]''' - Configuration relating to generic aspects of export plugins.
+
** '''[[exports.pl]] <sup>2</sup>''' - Configuration relating to generic aspects of export plugins.
** '''[[field_property_defaults.pl]]''' - Defaults for various attributes for a field specification.
+
** '''[[field_property_defaults.pl]] <sup>1</sup>''' - Defaults for various attributes for a field specification.
** '''[[field_validate.pl]]''' - General validation of a metadata field.
+
** '''[[field_validate.pl]] <sup>1</sup>''' - General validation of a metadata field.
** '''[[flavour_info.pl]]''' - Information about the [[EPrints Flavours|flavour]] of the repository archive.
+
** '''[[flavour_info.pl]] <sup>2,3</sup>''' - Information about the [[EPrints Flavours|flavour]] of the repository archive.
** '''[[indexing.pl]]''' - Configuration for indexing of metadata and document content.
+
** '''[[indexing.pl]] <sup>1</sup>''' - Configuration for indexing of metadata and document content.
** '''[[issues_search.pl]]''' - Configuration for search of eprint issues.
+
** '''[[issues_search.pl]] <sup>2,3</sup>''' - Configuration for search of eprint issues.
** '''[[languages.pl]]''' - Configuration for languages used by the repository archive.
+
** '''[[languages.pl]] <sup>1</sup>''' - Configuration for languages used by the repository archive.
** '''[[latest_tool.pl]]''' - Configuration for generating listings and feeds of latest eprints in the repository archive.
+
** '''[[latest_tool.pl]] <sup>1</sup>''' - Configuration for generating listings and feeds of latest eprints in the repository archive.
** '''[[log.pl]]''' - Configuration for logging error/warnung messages for the repository archive.
+
** '''[[log.pl]] <sup>1</sup>''' - Configuration for logging error/warnung messages for the repository archive.
** '''[[misc.pl]]''' - Miscellaneous configuration settings.
+
** '''[[misc.pl]] <sup>1</sup>''' - Miscellaneous configuration settings.
** '''[[oai.pl]]''' - Configuration for [[OAI]].
+
** '''[[oai.pl]] <sup>2,3</sup>''' - Configuration for [[OAI]].
** '''[[paths.pl]]''' - Configuration for filesystem paths for particular parts of the repository archive.
+
** '''[[paths.pl]] <sup>1</sup>''' - Configuration for filesystem paths for particular parts of the repository archive.
** '''[[plugins.pl]]''' - Enabling and configuration of plugins for the repository archive.
+
** '''[[plugins.pl]] <sup>2,3</sup>''' - Enabling and configuration of plugins for the repository archive.
** '''[[rdf_license.pl]]''' - Configuration for adding licences to RDF data files.
+
** '''[[rdf_license.pl]] <sup>1</sup>''' - Configuration for adding licences to RDF data files.
** '''[[rdf.pl]]''' - Configuration for setting XML namespaces for RDF data files.
+
** '''[[rdf.pl]] <sup>1</sup>''' - Configuration for setting XML namespaces for RDF data files.
** '''[[rdf_triples_bibo.pl]]''' - Configuration for generating Bibo RDF triples for an eprint data object.
+
** '''[[rdf_triples_bibo.pl]] <sup>1</sup>''' - Configuration for generating Bibo RDF triples for an eprint data object.
** '''[[rdf_triples_eprints.pl]]''' - Configuration for generating EPrints RDF triples for an eprint data object.
+
** '''[[rdf_triples_eprints.pl]] <sup>1</sup>''' - Configuration for generating EPrints RDF triples for an eprint data object.
** '''[[rdf_triples_formats.pl]]''' - Configuration for generating format RDF triples for an eprint data object.
+
** '''[[rdf_triples_formats.pl]] <sup>1</sup>''' - Configuration for generating format RDF triples for an eprint data object.
** '''[[rdf_triples_general.pl]]''' - Configuration for generating general RDF triples.
+
** '''[[rdf_triples_general.pl]] <sup>1</sup>''' - Configuration for generating general RDF triples.
** '''[[rdf_triples_repository.pl]]''' - Configuration for generating repository RDF triples.
+
** '''[[rdf_triples_repository.pl]] <sup>1</sup>''' - Configuration for generating repository RDF triples.
** '''[[rdf_triples_skos.pl]]''' - Configuration for generating SKOS RDF triples for an eprint and subject data objects.
+
** '''[[rdf_triples_skos.pl]] <sup>1</sup>''' - Configuration for generating SKOS RDF triples for an eprint and subject data objects.
** '''[[rdf_uris.pl]]''' - Configuration for generating RDF URIs.
+
** '''[[rdf_uris.pl]] <sup>1</sup>''' - Configuration for generating RDF URIs.
** '''[[registration.pl]]''' - Configuration for enabling/managing user reegistration for the repository archive.
+
** '''[[registration.pl]] <sup>1</sup>''' - Configuration for enabling/managing user reegistration for the repository archive.
** '''[[render_paras.pl]]''' - Function for rendering paragraphs for free-text fields.
+
** '''[[render_paras.pl]] <sup>2</sup>''' - Function for rendering paragraphs for free-text fields.
** '''[[request_copy.pl]]''' - Configuration for "request a copy" of a restricted document.
+
** '''[[request_copy.pl]] <sup>2,3</sup>''' - Configuration for "request a copy" of a restricted document.
** '''[[search.pl]]''' - Miscelleanous search configuration not tied to a specific data object or type of search.
+
** '''[[search.pl]] <sup>1</sup>''' - Miscelleanous search configuration not tied to a specific data object or type of search.
** '''[[security.pl]]''' - Functions for securing appropriate access to uploaded documents.
+
** '''[[security.pl]] <sup>1</sup>''' - Functions for securing appropriate access to uploaded documents.
** '''[[session.pl]]''' - Functions for bespoke operations when initiating or closing a session.
+
** '''[[session.pl]] <sup>1</sup>''' - Functions for bespoke operations when initiating or closing a session.
** '''[[template_core.pl]]''' - Core trigger for generating dynamic template.
+
** '''[[template_core.pl]] <sup>1</sup>''' - Core trigger for generating dynamic template.
** '''[[template_edit_phrases.pl]]''' - Edit phrases trigger for generating dynamic template.
+
** '''[[template_edit_phrases.pl]] <sup>1</sup>''' - Edit phrases trigger for generating dynamic template.
** '''[[template_legacy.pl]]''' - Legacy trigger for generating dynamic template, as defined in [[dynamic_template.pl]].
+
** '''[[template_legacy.pl]] <sup>1</sup>''' - Legacy trigger for generating dynamic template, as defined in [[dynamic_template.pl]].
** '''[[template_links.pl]]''' - Links trogger for generating dynamic template.
+
** '''[[template_links.pl]] <sup>1</sup>''' - Links trogger for generating dynamic template.
** '''[[user_auth_limits.pl]]''' - Configuration for limiting aspects of user authentication to prevent brute force password cracking, denial-of-service, user spamming, etc.
+
** '''[[user_auth_limits.pl]] <sup>1</sup>''' - Configuration for limiting aspects of user authentication to prevent brute force password cracking, denial-of-service, user spamming, etc.
** '''[[user_fields_automatic.pl]]''' - Configuration for automatically setting user fields based on the values of other fields.
+
** '''[[user_fields_automatic.pl]] <sup>1</sup>''' - Configuration for automatically setting user fields based on the values of other fields.
** '''[[user_fields_default.pl]]''' - Default initial values for user fields.
+
** '''[[user_fields_default.pl]] <sup>1</sup>''' - Default initial values for user fields.
** '''[[user_fields.pl]]''' - Non-core field definitions for the user data object.
+
** '''[[user_fields.pl]] <sup>1</sup>''' - Non-core field definitions for the user data object.
** '''[[user_login.pl]]''' - Configuration for managing user login to the repository archive.
+
** '''[[user_login.pl]] <sup>1</sup>''' - Configuration for managing user login to the repository archive.
** '''[[user_render.pl]]''' - Configuration for rendering user pages.
+
** '''[[user_render.pl]] <sup>1</sup>''' - Configuration for rendering user pages.
** '''[[user_review_scope.pl]]''' - Configuration defining the options for the scope of eprint items an editor user can review.
+
** '''[[user_review_scope.pl]] <sup>2,3</sup>''' - Configuration defining the options for the scope of eprint items an editor user can review.
** '''[[user_roles.pl]]''' - The roles assigned to different types of user.
+
** '''[[user_roles.pl]] <sup>1</sup>''' - The roles assigned to different types of user.
** '''[[user_search.pl]]''' - Configuration for search of user data objects.
+
** '''[[user_search.pl]] <sup>1</sup>''' - Configuration for search of user data objects.
** '''[[user_validate.pl]]''' - Validation of the user data object as a whole.
+
** '''[[user_validate.pl]] <sup>1</sup>''' - Validation of the user data object as a whole.
** '''[[views.pl]]''' - Configuration for generating browse views.
+
** '''[[views.pl]] <sup>2,3</sup>''' - Configuration for generating browse views.
** '''[[vlit.pl]]''' - Configuration for [[VLit]].
+
** '''[[vlit.pl]] <sup>1</sup>''' - Configuration for [[VLit]].

Revision as of 14:02, 31 January 2022

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects

This is the main repository configuration directory. Each of these files is a valid perl script and are loaded in alphabetic order. The configuration is stored in a hash reference named $c. For example a simple file might look like this:

# the foo option modifies the number of badgers in the boojum
$c->{foo} = 23;

Although this listing is shown as for the archive's cfg.d directory, it is actually the combined listing of all configuration files under the following cfg.d directories:

  1. EPRINTS_PATH/lib/cfg.d/
  2. EPRINTS_PATH/flavours/pub_lib/cfg.d/
  3. EPRINTS_PATH/lib/defaultcfg_zero/cfg.d/ (which are copied to the repository archive's cfg.d directory on its creation, unless using a specific flavour).
  4. EPRINTS_PATH/flavours/pub_lib/defaultcfg/cfg.d/ (which are copied to the repository archive's cfg.d directory on its creation).
  5. Generated through epadmin create
  • eprints3/archives/ARCHIVEID/cfg/cfg.d
    • 10_core.pl 5 - Core configuration for repository archive, such as hostname and port (both for HTTP and HTTPS), host aliases and path it sits on.
    • 20_baseurls.pl 1,2 - Configuration for how base URLs used by the repository archive.
    • adminemail.pl 5 - The admin email address for the repository archive.
    • branding.pl 1 - Branding for the repository archive.
    • database.pl 5 - Configuration for connecting to the database.
    • datasets.pl 1 - Configuration for bespoke datasets and data objects for the repository archive.
    • document_fields_automatic.pl 1 - Configuration for automatically setting document fields based on the values of other fields.
    • document_fields_default.pl 1 - Default initial values for document fields.
    • document_fields.pl 1 - Non-core field definitions for the document data object.
    • document_upload.pl 1 - Configuration relating to managing document uploads.
    • document_validate.pl 1 - Validation of the eprint data object as a whole.
    • dynamic_template.pl 1 - Legacy configuration for dynamic template of repository archive.
    • email.pl 1 - Configuration for sending email from the repository archive.
    • eprint_fields_automatic.pl 2,3 - Configuration for automatically setting eprint fields based on the values of other fields.
    • eprint_fields_common.pl 2 - Common (across flavours) non-core fields for the eprint data object.
    • eprint_fields_default.pl 2,3 - Default initial values for eprint fields.
    • eprint_fields.pl 2,3 - Non-core field definitions for the eprint data object.
    • eprint_fields_pub.pl 2 - Publication flavour fields for the eprint data object.
    • [[eprint_locking.pl] 1 - Configuration for locking eprint data objects so they can only be edited by one user at once.
    • eprint_render.pl 2,3 - Configuration for rendering eprint abstract/summary pages.
    • eprint_search_advanced.pl 2,3 - Configuration for advanced search of eprint data objects.
    • eprint_search_simple.pl 2,3 - Configuration for simple search of eprint data objects.
    • eprint_search_staff.pl 2,3 - Configuration for staff search of eprint data objects.
    • eprint_validate.pl 2,3 - Validation of the eprint data object as a whole.
    • eprint_warnings.pl 2,3 - Warnings to advise the depositor on potential issues with the eprint (e.g. no uploaded documents).
    • exports.pl 2 - Configuration relating to generic aspects of export plugins.
    • field_property_defaults.pl 1 - Defaults for various attributes for a field specification.
    • field_validate.pl 1 - General validation of a metadata field.
    • flavour_info.pl 2,3 - Information about the flavour of the repository archive.
    • indexing.pl 1 - Configuration for indexing of metadata and document content.
    • issues_search.pl 2,3 - Configuration for search of eprint issues.
    • languages.pl 1 - Configuration for languages used by the repository archive.
    • latest_tool.pl 1 - Configuration for generating listings and feeds of latest eprints in the repository archive.
    • log.pl 1 - Configuration for logging error/warnung messages for the repository archive.
    • misc.pl 1 - Miscellaneous configuration settings.
    • oai.pl 2,3 - Configuration for OAI.
    • paths.pl 1 - Configuration for filesystem paths for particular parts of the repository archive.
    • plugins.pl 2,3 - Enabling and configuration of plugins for the repository archive.
    • rdf_license.pl 1 - Configuration for adding licences to RDF data files.
    • rdf.pl 1 - Configuration for setting XML namespaces for RDF data files.
    • rdf_triples_bibo.pl 1 - Configuration for generating Bibo RDF triples for an eprint data object.
    • rdf_triples_eprints.pl 1 - Configuration for generating EPrints RDF triples for an eprint data object.
    • rdf_triples_formats.pl 1 - Configuration for generating format RDF triples for an eprint data object.
    • rdf_triples_general.pl 1 - Configuration for generating general RDF triples.
    • rdf_triples_repository.pl 1 - Configuration for generating repository RDF triples.
    • rdf_triples_skos.pl 1 - Configuration for generating SKOS RDF triples for an eprint and subject data objects.
    • rdf_uris.pl 1 - Configuration for generating RDF URIs.
    • registration.pl 1 - Configuration for enabling/managing user reegistration for the repository archive.
    • render_paras.pl 2 - Function for rendering paragraphs for free-text fields.
    • request_copy.pl 2,3 - Configuration for "request a copy" of a restricted document.
    • search.pl 1 - Miscelleanous search configuration not tied to a specific data object or type of search.
    • security.pl 1 - Functions for securing appropriate access to uploaded documents.
    • session.pl 1 - Functions for bespoke operations when initiating or closing a session.
    • template_core.pl 1 - Core trigger for generating dynamic template.
    • template_edit_phrases.pl 1 - Edit phrases trigger for generating dynamic template.
    • template_legacy.pl 1 - Legacy trigger for generating dynamic template, as defined in dynamic_template.pl.
    • template_links.pl 1 - Links trogger for generating dynamic template.
    • user_auth_limits.pl 1 - Configuration for limiting aspects of user authentication to prevent brute force password cracking, denial-of-service, user spamming, etc.
    • user_fields_automatic.pl 1 - Configuration for automatically setting user fields based on the values of other fields.
    • user_fields_default.pl 1 - Default initial values for user fields.
    • user_fields.pl 1 - Non-core field definitions for the user data object.
    • user_login.pl 1 - Configuration for managing user login to the repository archive.
    • user_render.pl 1 - Configuration for rendering user pages.
    • user_review_scope.pl 2,3 - Configuration defining the options for the scope of eprint items an editor user can review.
    • user_roles.pl 1 - The roles assigned to different types of user.
    • user_search.pl 1 - Configuration for search of user data objects.
    • user_validate.pl 1 - Validation of the user data object as a whole.
    • views.pl 2,3 - Configuration for generating browse views.
    • vlit.pl 1 - Configuration for VLit.