Difference between revisions of "Archives/ARCHIVEID/cfg/cfg.d/"
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/flavours/pub_lib/cfg.d/ | |
− | + | # 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). | |
− | + | # 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] | + | ** '''[[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:
- EPRINTS_PATH/lib/cfg.d/
- EPRINTS_PATH/flavours/pub_lib/cfg.d/
- 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).
- 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.