EPrints Documentation - Recent changes [en-gb]

EPrints 3.4.8

Drn@ecs.soton.ac.uk — Mon, 18 May 2026 13:04:44 GMT

‎Bug Fixes

YouTube Import

Wr1r25 — Mon, 18 May 2026 08:37:50 GMT

‎Python 3.11+

User talk:Wr1r25

Jb4@ecs.soton.ac.uk — Fri, 15 May 2026 14:43:47 GMT

Welcome!

New page

'''Welcome to ''EPrints Documentation''!'''
We hope you will contribute much and well.
You will probably want to read the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents help pages].
Again, welcome and have fun! [[User:Jb4@ecs.soton.ac.uk|Jb4@ecs.soton.ac.uk]] ([[User talk:Jb4@ecs.soton.ac.uk|talk]]) 14:43, 15 May 2026 (UTC)

User:Wr1r25

Jb4@ecs.soton.ac.uk — Fri, 15 May 2026 14:43:47 GMT

Creating user page for new user.

New page

A new member of the eprints services team, starting to learn the eprints ecosystem and how it works. Started September, 2025

User:Wr1r25

Jb4@ecs.soton.ac.uk — Fri, 15 May 2026 14:43:47 GMT

User account Wr1r25 was created by Jb4@ecs.soton.ac.uk and password was sent by email

Issues with Installing EPrints on Ubuntu 26.04

Drn@ecs.soton.ac.uk — Wed, 13 May 2026 11:06:35 GMT

Updated info as of 13th May 2026

EPScript/Examples

Drn@ecs.soton.ac.uk — Tue, 12 May 2026 16:05:23 GMT

‎Testing a boolean field: Added advice for unset boolean fields

EPScript/Data Types

Drn@ecs.soton.ac.uk — Tue, 12 May 2026 15:48:07 GMT

‎Booleans

Issues with Installing EPrints on Ubuntu 26.04

Drn@ecs.soton.ac.uk — Sun, 10 May 2026 12:10:49 GMT

‎Current Issues

YouTube Import

Drn@ecs.soton.ac.uk — Fri, 08 May 2026 10:42:40 GMT

Added page skeleton for YouTube Import Bazaar package

New page

[[Category:Plugins]]
[[Category:Bazaar_Package]]
[[Category:Eprints3.4]]
[[Category:Eprints3.3]]

== Overview ==

== Installing Dependencies ==
=== Python 3.11+ ===
=== Deno ===
=== yt-dlp-ejs ===
=== yt-dlp ===

== Useful Scripts ==

Issues with Installing EPrints on Ubuntu 26.04

Drn@ecs.soton.ac.uk — Fri, 01 May 2026 15:16:52 GMT

Added issue with db creation

Issues with Installing EPrints on Ubuntu 24.04

Drn@ecs.soton.ac.uk — Fri, 01 May 2026 15:06:08 GMT

‎Previous Issues

Issues with Installing EPrints on Ubuntu 22.04

Drn@ecs.soton.ac.uk — Fri, 01 May 2026 15:02:56 GMT

Added issue as Ubuntu 22.04 is now only LTS that needs libncurses5 rather than libncurses6

Installing EPrints on Debian/Ubuntu

Drn@ecs.soton.ac.uk — Fri, 01 May 2026 14:59:15 GMT

libncurses6 is now used by Ubuntu 24.04 and 26.04

Issues with Installing EPrints on Ubuntu 26.04

Drn@ecs.soton.ac.uk — Fri, 01 May 2026 14:41:11 GMT

Added placeholder

New page

As of 1st May 2026, Ubuntu 26.04 is under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.

Category:Installation

Drn@ecs.soton.ac.uk — Fri, 01 May 2026 14:39:37 GMT

‎Distribution Notes: Added Ubunty 26.04 (under testing)

Template:EPrints Metadata Fields Content

Drn@ecs.soton.ac.uk — Thu, 30 Apr 2026 13:05:23 GMT

‎Object Methods: Added render_name

EPrints 3.4.7

Drn@ecs.soton.ac.uk — Wed, 29 Apr 2026 17:11:33 GMT

‎Known Issues: Added issue about error when looking up cache table UUID.

Template:EPrints Metadata Fields Content

Drn@ecs.soton.ac.uk — Wed, 29 Apr 2026 15:08:22 GMT

Added some methods of main MetaField class

Transitioning from IRUS to OpenAIRE Usage Counts

LukeWallin — Mon, 27 Apr 2026 09:32:42 GMT

updated eprints repo link

Transitioning from IRUS to OpenAIRE Usage Counts

Libjlrs — Fri, 24 Apr 2026 06:22:39 GMT

@@ Line 18: / Line 18: @@
 * [https://github.com/eprints/eprints3.4/pull/512 Adds clear buttons to multiple <code>Compound</code> fields]
 * [https://github.com/eprints/eprints3.4/pull/525 Adds support for rendering time with a given timezone]
 ==== Security and Privacy Improvements ====
 * [https://github.com/eprints/eprints3.4/pull/511 Prevents 'javascript:' URLs from being saved in URL fields]
 * [https://github.com/eprints/eprints3.4/commit/c5884562ed72b31681d3f0308b5987b2564052ad Modifies fix for SetLang referrer misuse]
 ==== General Improvements ====
@@ Line 34: / Line 40: @@
 * [https://github.com/eprints/eprints3.4/issues/527 Improves CRUD API fault tolerance]
 * [https://github.com/eprints/eprints3.4/issues/536 Better specifies MetaField property defaults]
 ==== Bug Fixes ====
@@ Line 42: / Line 62: @@
 * [https://github.com/eprints/eprints3.4/pull/534 Don't add export link elements to deleted item page head]
 * [https://github.com/eprints/eprints3.4/issues/535 Specifies more appropriate <code>empty_value</code>s for <code>Int</code> and <code>Float</code> MetaFields]
-* [https://github.com/eprints/eprints3.4/issues/508 Fixes <code>eval</code> blocks calling user-defined <code>toform</code> or <code>fromform</code> functions to work as effective try/catch blocks.
+* [https://github.com/eprints/eprints3.4/issues/508 Fixes <code>eval</code> blocks calling user-defined <code>toform</code> or <code>fromform</code> functions to work as effective try/catch blocks]
 == Planned Features and Improvements ==

@@ Line 1: / Line 1: @@
-As of 10th May 2026, Ubuntu 26.04 is still under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.
+As of 13th May 2026, Ubuntu 26.04 is still under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.
 ==== Current Issues ====
-; XML library compatability problems : This will first occur at the point where you complete the credentials you want to use for your archive's database whilst you are running <code>bin/epadmin create pub</code>.  It will exhibit itself as either a segmentation fault or an error with the memory allocation (malloc) or free commands.  This is due to EPrints use of the <code>XML:LibXML</code> Perl library that ultimately uses the C library <tt>libxml2</tt>.  As of 10th May 2026, we have yet to defintively determine why this is happening.  [https://github.com/eprints/eprints3.4/issues/509 This GitHub issue] first raised for what appears to be the same issue with FreeBSD 14.3 provides some more detail about this problem.  It is likely this relates to [https://github.com/cpan-authors/XML-LibXML/issues/113 this XML::LibXML GitHub issue], so it may be a while before the libxml-libxml-perl package is updated but the XML::LibXML package on CPAN will likely be updated more promptly. Currently a possible workaround of disabling "expand_entities" and "load_ext_dtd" options in the calls to <code>XML::LibXML->new</code> in perl_lib/EPrints/XML/LibXML.pm on lines 69 and 73 is being evaluated,  However, further testing is still required to determine what impact this temporary mitigation may have on EPrints functionality.
+; XML library compatability problems : This will first occur at the point where you complete the credentials you want to use for your archive's database whilst you are running <code>bin/epadmin create pub</code>.  It will exhibit itself as either a segmentation fault or an error with the memory allocation (malloc) or free commands.  This is due to EPrints use of the <code>XML:LibXML</code> Perl library that ultimately uses the C library <tt>libxml2</tt>.   [https://github.com/eprints/eprints3.4/issues/509 This GitHub issue] first raised for what appears to be the same issue with FreeBSD 14.3 provides some more detail about this problem.  It is likely this relates to [https://github.com/cpan-authors/XML-LibXML/issues/81 this XML::LibXML GitHub issue], which says it has been resolved upstream, which we believe to mean in the libxml2 C library (possibly version 2.15.3).  Ubuntu 26.04 as of 13th May 2026 is still providing libxml2 version 2.15.2, so there will hopefully be an update soon.

@@ Line 18: / Line 18: @@
 == Testing a boolean field ==
-Boolean fields can be <tt>TRUE</tt>, <tt>FALSE</tt> or <tt>NULL</tt>. Just doing a <code>test="boolean_field"</code> isn't enough. Use this:
+Boolean fields can be <tt>TRUE</tt>, <tt>FALSE</tt> or an empty string, the last of which means neither the true or false option has been selected. Just doing a <code>test="boolean_field"</code> isn't enough. Use this:
 <source lang="xml">
   <if test="boolean_field = 'TRUE'">
     ...
   </if>
 </source>

@@ Line 21: / Line 21: @@
 === Booleans ===
-'''BOOLEAN''' is either true or false.
+'''BOOLEAN''' is either 1 (i.e. true) and 0 (i.e false).
 === Dates ===

@@ Line 1: / Line 1: @@
-As of 1st May 2026, Ubuntu 26.04 is under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.
+As of 10th May 2026, Ubuntu 26.04 is still under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.
 ==== Current Issues ====
-; Segfault when creating EPrints database : If you use <code>bin/epadmin create pub</code> to create a new archive, once you approve the creation of the archive's database rather than prompting you for an appropriate username and password for a superuser that can create new database you get a segfault error like below. A resolution to this issue is currently being investigated.
+; XML library compatability problems : This will first occur at the point where you complete the credentials you want to use for your archive's database whilst you are running <code>bin/epadmin create pub</code>.  It will exhibit itself as either a segmentation fault or an error with the memory allocation (malloc) or free commands.  This is due to EPrints use of the <code>XML:LibXML</code> Perl library that ultimately uses the C library <tt>libxml2</tt>.  As of 10th May 2026, we have yet to defintively determine why this is happening.  [https://github.com/eprints/eprints3.4/issues/509 This GitHub issue] first raised for what appears to be the same issue with FreeBSD 14.3 provides some more detail about this problem.  It is likely this relates to [https://github.com/cpan-authors/XML-LibXML/issues/113 this XML::LibXML GitHub issue], so it may be a while before the libxml-libxml-perl package is updated but the XML::LibXML package on CPAN will likely be updated more promptly. Currently a possible workaround of disabling "expand_entities" and "load_ext_dtd" options in the calls to <code>XML::LibXML->new</code> in perl_lib/EPrints/XML/LibXML.pm on lines 69 and 73 is being evaluated,  However, further testing is still required to determine what impact this temporary mitigation may have on EPrints functionality.

@@ Line 8: / Line 8: @@
 == Installing Dependencies ==
 === Python 3.11+ ===
 === Deno ===
 === yt-dlp-ejs ===
@@ Line 13: / Line 14: @@
 == Useful Scripts ==

← Older revision		Revision as of 15:16, 1 May 2026
Line 1:		Line 1:
	As of 1st May 2026, Ubuntu 26.04 is under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.		As of 1st May 2026, Ubuntu 26.04 is under testing to determine if EPrints can be successfully installed and if so if there are any issues with doing this, which require a different approach from the general approach for installing EPrints on Debian/Ubuntu Linux.
		+
		+	==== Current Issues ====
		+	; Segfault when creating EPrints database : If you use <code>bin/epadmin create pub</code> to create a new archive, once you approve the creation of the archive's database rather than prompting you for an appropriate username and password for a superuser that can create new database you get a segfault error like below. A resolution to this issue is currently being investigated.
		+	Segmentation fault (core dumped) bin/epadmin create pub

@@ Line 1: / Line 1: @@
 '''N.B. It is assumed that you are installing the [[:Category:Eprints3.4 | latest version of 3.4]]. Earlier versions may have issues not listed here.'''
 ==== Previous Issues ====
 ; MySQL root user cannot be used : This is now explained under EPrints' [[Getting Started]] instructions. As it is typical for most modern Linux operating systems.

← Older revision		Revision as of 15:02, 1 May 2026
Line 5:		Line 5:
	; ''libsepol1'' Deb package no longer exists : This has been removed as a dependency on 29th May 2022, as it is not specifically required by EPrints.		; ''libsepol1'' Deb package no longer exists : This has been removed as a dependency on 29th May 2022, as it is not specifically required by EPrints.
	; MySQL root user cannot be used : This is now explained under EPrints' [[Getting Started]] instructions. As it is typical for most modern Linux operating systems.		; MySQL root user cannot be used : This is now explained under EPrints' [[Getting Started]] instructions. As it is typical for most modern Linux operating systems.
		+	; ''libncurses6'' Deb package not available : In more recent versions of Ubuntu libncurses6 is the name for the ncurses package but as Ubuntu 22.04 is older you will need to install ''libncurses5'' instead.

@@ Line 14: / Line 14: @@
 First, as the root user install all the dependencies for EPrints ('''N.B.''' Some dependencies may not be able in certain versions of Debian/Ubuntu.  See [[#Operating System Version Specific Requirements|Operating System Version Specific Requirements]] towards the end of this page):
-  apt install perl libncurses5 libselinux1 apache2 libapache2-mod-perl2 libxml-libxml-perl \
+  apt install perl libncurses6 libselinux1 apache2 libapache2-mod-perl2 libxml-libxml-perl \
     libunicode-string-perl libterm-readkey-perl libmime-lite-perl libmime-types-perl libdigest-sha-perl \
     libdbd-mysql-perl libxml-parser-perl libxml2-dev libxml-twig-perl libarchive-any-perl libjson-perl \

@@ Line 47: / Line 47: @@
 | Supported
 | Some minor issues. See [[Issues with Installing EPrints on Ubuntu 24.04]].
 |-
 |}

@@ Line 322: / Line 322: @@
 || The <code>EPrints::DataSet</code> object to which this field belongs.
 || Get dataset to which this field belongs.
 |}
 === Utility Methods ===
 '''TO BE DONE'''

@@ Line 103: / Line 103: @@
 === Session Initialisation and Close Bespoke Configuration ===
 EPrints 3.4.7 replaces <code>$c->{session_init}</code> and <code>$c->{session_close}</code> configuration in '''lib/cfg.d/session.pl''' with <code>EP_TRIGGER_BEGIN</code> and <code>EP_TRIGGER_END</code> triggers.  Although uncommon, if you have modified <code>session_init</code> in a later configuration file than session.pl and your session_init function requires the <code>EPrints::Repository</code>'s <code>offline</code> parameter then will not be sent to the function.  Similarly, if you have modified the <code>session_close</code> function and this requires and <code>EPrints::Repository</code> object as a parameter, this will not be sent.  These can be fixed with '''[https://github.com/eprints/eprints3.4/commit/cff8a57e643c230215279f187764fa6ec8d00a99.patch this patch]'''.
 == Further Planned Features and Improvements ==

@@ Line 253: / Line 253: @@
 |-
 | '''sql_sorted''' || <tt>0</tt> || NO || Whether SQL should be sorted. || Deprecated.  Defined but no longer functional.
 |}

@@ Line 10: / Line 10: @@
 ## https://github.com/openaire/EPrints-OAPiwik (forked from the above)
 ## https://github.com/alex-ball/EPrints-OAPing
-## https://github.com/eprints/EPrints-OAPiwik ''I think this is where the official release will live?''
+## https://github.com/eprints/EPrints-Matomo ''I think this is where the official release will live?''
 # Check data is being received - OpenAIRE is only updated monthly
 # remove/disable IRUS tracker

@@ Line 1: / Line 1: @@
 # Register your repository in the [https://provide.openaire.eu/home OpenAIRE Provide service]
-# Install EPrintsOpenAIRE https://github.com/eprintsug/EprintsOpenAIRE<br>- A new version (v1.1.0) is being tested as both an [https://github.com/eprintsug/EPrintsOpenAIRE/tree/support_config_option ingredient] and a [https://github.com/eprintsug/EPrintsOpenAIRE/tree/support_config_option-epm Bazaar/EPM package].
+# Install [https://github.com/eprintsug/EPrintsOpenAIRE/ EPrintsOpenAIRE export extension] (v1.1.0+)
-# Make sure repository is getting harvested in OpenAIRE Provide
+## Bazaar: https://bazaar.eprints.org/1309/
 # Install tracker NB we need to consolidate these (which are in approx. chronological order):
 ## https://github.com/Rudjer-Boskovic-Institute/EPrints-OAPiwik