EPrints Technical Mailing List Archive

See the EPrints wiki for instructions on how to join this mailing list and related information.

Message: #10014


< Previous (by date) | Next (by date) > | < Previous (in thread) | Next (in thread) > | Messages - Most Recent First | Threads - Most Recent First

Re: [EP-tech] OAI Policies


Hi Will,

With reference to [1], assuming you have created a publication repository (e.g. bin/epadmin create pub) then I would expect you archive's cfg/cfg.d/ directory to only initially include those files with either a 4 or 5 superscript tag on them.  Any other files will have either been created completely from scratch or copied from either lib/cfg.d/ or flavours/pub_lib/cfg.d/.

If you have the same filename in your archive's cfg/cfg.d/ as either lib/cfg.d/ or flavours/pub_lib/cfg.d/ this will be used instead of this version.  You should only have a minimal number of configuration files in your archive for things you have modified. Any more than you need will make future upgrades more difficult, as changes to configuration files in cfg/cfg.d/ as either lib/cfg.d/will not be applied as this are overridden by the file in your archive's cfg/cfg.d/.

Files in flavours/pub_lib/defaultcfg/cfg.d/  (or lib/defaultcfg_zero/cfg.d/ if you create a zero rather than pub(lications) archive) are initially copied on creation of your archive, as these are highly likely to need modifying.

My general advice is you always try you best to avoid copying a file from lib/cfg.d/ or flavours/pub_lib/cfg.d/to your archive. Take the actually piece of configuration you are changing and add it to a new file under you archive prefixed with 'z_'.  So if you are wanting to modify some configuration from flavours/pub_lib/cfg.d/log.pl.  You create under you archive cfg/cfg.d/z_log.pl.  Copy the configuration settings you want to change from log.pl and then edit them under z_log.pl. By using the 'z_' prefix you can be fairly confident that this configuration file in your archive will be applied in precedent to configuration files in other directories.

As a rule, (but with a few exceptions*) configuration files with different filenames don't usually modify the same settings, although some do use settings defined in earlier configuration files.  So if you have identified the configuration setting you are trying to modify if you either copy this configuration file to your archive's cfg/cfg.d/ directory or make sure individual configuration settings are added to a configuration file alphabetically later, then these modification should be applied. There are some exceptions and I have on occasions been caught out, similar to the oai.pl issue that caught you out before. However, generally if you follow the rules I described, issues with configuration changes are usually limited due to syntax/typo errors.

I have updated [1] to explain that you would not expect all these configuration files to appear in the archive's cfg/cfg.d/ directory and you should be conservative on adding them to this directory.

Regards

David New,am

[1] https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwiki.eprints.org%2Fw%2FArchives%2FARCHIVEID%2Fcfg%2Fcfg.d%2F&data=05%7C02%7Ceprints-tech%40ecs.soton.ac.uk%7C13aa719c4e4249bf48ad08dd5b387ad7%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C638767020369949484%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=0KF8mhNtZZrwMCFESiGXqiwTqgxdZXdkAefkMEh6nBU%3D&reserved=0

*One exception is that eprint_fields.pl adds extra fields to the eprint data object and eprint_fields_pub.pl adds further extra fields to eprint data object.

On 04/03/2025 12:56, Will Hughes wrote:
CAUTION: This e-mail originated outside the University of Southampton.

CAUTION: This e-mail originated outside the University of Southampton.

Thanks, Yuri

I also managed to remove the link to OAI policies on the landing page. It looks much better now.

One more daft question - I am checking that all the files are where they should be and finding lots of differences between my installation and the expectations in the online manual. One thing I cannot discern after combing through several pages of the manual: What are the footnotes 1-5 indicating in, for example, https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwiki.eprints.org%2Fw%2FArchives%2FARCHIVEID%2Fcfg%2Fcfg.d%2F&data=05%7C02%7Ceprints-tech%40ecs.soton.ac.uk%7C13aa719c4e4249bf48ad08dd5b387ad7%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C638767020369965812%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=eg7by7QgqEkdSMd5i3UN45C2dQNiCCTiJXADNe%2FWHmY%3D&reserved=0

Many of these files are not in the indicated directory but in other,  similar directories and I am trying to make sure that everything is where it should be. Out of the 90-odd files listed on this page, I have 27. I am working through this list and finding the missing ones in various other folders, which is probably OK. However, this makes it quite difficult to check things, and very difficult to predict whether the changes I make will actually bite. They frequently don't...

Best wishes

Will

-----Original Message-----
From: eprints-tech-request@ecs.soton.ac.uk <eprints-tech-request@ecs.soton.ac.uk> On Behalf Of Yuri
Sent: 04 March 2025 11:15
To: eprints-tech@ecs.soton.ac.uk
Subject: Re: [EP-tech] OAI Policies

CAUTION: This e-mail originated outside the University of Southampton.

CAUTION: This e-mail originated outside the University of Southampton.

Don't configure it and remove the cgi/oai2 script.

Il 04/03/25 12:01, Will Hughes ha scritto:
Is there a way I can just remove all mention of oai?

*** Options: https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwiki.eprints.org%2Fw%2FEprints-tech_Mailing_List&data=05%7C02%7Ceprints-tech%40ecs.soton.ac.uk%7C13aa719c4e4249bf48ad08dd5b387ad7%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C638767020369978621%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=l66YD9wECZ0t1VQeyPJQZTS%2BiqjQOquE2x1ylRNw02o%3D&reserved=0
*** Archive: https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.eprints.org%2Ftech.php%2F&data=05%7C02%7Ceprints-tech%40ecs.soton.ac.uk%7C13aa719c4e4249bf48ad08dd5b387ad7%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C638767020369990893%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=hlr4rB8x43rPCcIczVk7MUN5EdU2nglH8B6sW01ECR4%3D&reserved=0
*** EPrints community wiki: https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwiki.eprints.org%2F&data=05%7C02%7Ceprints-tech%40ecs.soton.ac.uk%7C13aa719c4e4249bf48ad08dd5b387ad7%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C638767020370005262%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=5ySyTeE%2FaMOxanHBrbRLnR8bZFKgqNHBDZK94WSgjNs%3D&reserved=0