Debian Known Issues - Revision history

Drn@ecs.soton.ac.uk: Added advice regarding imagemagick preview/thumbnail generation.

2024-03-12T11:22:12Z

Added advice regarding imagemagick preview/thumbnail generation.

← Older revision		Revision as of 11:22, 12 March 2024
Line 76:		Line 76:
	Note that this was tested in a Debian GNU/Linux virtual private server running under Virtuozzo hypervision. Other filesystems, such as simfs, don't usually give any problems with DiskSpace.pm.		Note that this was tested in a Debian GNU/Linux virtual private server running under Virtuozzo hypervision. Other filesystems, such as simfs, don't usually give any problems with DiskSpace.pm.

	===Debian 10+ (Buster, Bullseye, etc.) does not allow unprivileged access to MySQL root user===		===Debian 10+ (Buster, Bullseye, Bookworm etc.) does not allow unprivileged access to MySQL root user===
	This is also an issue with Ubuntu 20.04+, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].		This is also an issue with Ubuntu 20.04+, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].

			===ImageMagick policy settings prevent PDF preview/thumbnail generation===
			This was identified as an issue with Debian 12 (Bookworm) but may also be an issue with earlier Debian version. ImageMagick has a policy which means it will not read PDF documents, which EPrints requires to generate preview and thumbnails of these PDFs. To fix this edit <tt>/etc/ImageMagick-6/policy.xml</tt> and change the line:
			<policy domain="coder" rights="none" pattern="PDF" />
			To:
			<policy domain="coder" rights="<b>read</b>" pattern="PDF" />

Drn@ecs.soton.ac.uk: /* Debian 10+ (Buster, Bullseye, etc.) does not allow unprivileged access to MySQL root user */

2022-11-10T11:09:38Z

Debian 10+ (Buster, Bullseye, etc.) does not allow unprivileged access to MySQL root user

← Older revision		Revision as of 11:09, 10 November 2022
Line 77:		Line 77:

	===Debian 10+ (Buster, Bullseye, etc.) does not allow unprivileged access to MySQL root user===		===Debian 10+ (Buster, Bullseye, etc.) does not allow unprivileged access to MySQL root user===
	This is also an issue with Ubuntu 20.04, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].		This is also an issue with Ubuntu 20.04+, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].

Drn@ecs.soton.ac.uk: /* Debian 10 (Buster) does not allow unprivileged access to MySQL root user */

2022-05-30T14:04:39Z

Debian 10 (Buster) does not allow unprivileged access to MySQL root user

← Older revision		Revision as of 14:04, 30 May 2022
Line 76:		Line 76:
	Note that this was tested in a Debian GNU/Linux virtual private server running under Virtuozzo hypervision. Other filesystems, such as simfs, don't usually give any problems with DiskSpace.pm.		Note that this was tested in a Debian GNU/Linux virtual private server running under Virtuozzo hypervision. Other filesystems, such as simfs, don't usually give any problems with DiskSpace.pm.

	===Debian 10 (Buster) does not allow unprivileged access to MySQL root user===		===Debian 10+ (Buster, Bullseye, etc.) does not allow unprivileged access to MySQL root user===
	This is also an issue with Ubuntu 20.04, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].		This is also an issue with Ubuntu 20.04, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].

Drn@ecs.soton.ac.uk: No longer needed unless installing old copy of pre-3.4.3 deb package.

2022-05-30T14:04:11Z

No longer needed unless installing old copy of pre-3.4.3 deb package.

← Older revision		Revision as of 14:04, 30 May 2022
Line 75:		Line 75:

	Note that this was tested in a Debian GNU/Linux virtual private server running under Virtuozzo hypervision. Other filesystems, such as simfs, don't usually give any problems with DiskSpace.pm.		Note that this was tested in a Debian GNU/Linux virtual private server running under Virtuozzo hypervision. Other filesystems, such as simfs, don't usually give any problems with DiskSpace.pm.

	~~===Debian 10 (Buster) does not install CGI.pm===~~
	Debian 10's (Buster) dependency tree seems to be different to older versions and as a result does not install CGI.pm. To install this on pre-EPrints 3.4.3 versions, install the following additional dependency (as the root user) before trying to run ''epadmin''.
	~~# apt-get install libcgi-pm-perl~~

	~~Also recommendable is to keep your perl modules by saving an autobundle with~~
	~~# cpan -a~~

	~~Where- and whenever you like the snapshot can be (re-)installed with~~
	~~# perl -MCPAN -e 'install Bundle::Snapshot_yyyy_mm_dd_00'~~

	===Debian 10 (Buster) does not allow unprivileged access to MySQL root user===		===Debian 10 (Buster) does not allow unprivileged access to MySQL root user===
	This is also an issue with Ubuntu 20.04, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].		This is also an issue with Ubuntu 20.04, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].

Drn@ecs.soton.ac.uk: Removed issue with MySQL v.s MariaDB installation

2022-05-30T14:00:59Z

Removed issue with MySQL v.s MariaDB installation

← Older revision		Revision as of 14:00, 30 May 2022
Line 75:		Line 75:

	Note that this was tested in a Debian GNU/Linux virtual private server running under Virtuozzo hypervision. Other filesystems, such as simfs, don't usually give any problems with DiskSpace.pm.		Note that this was tested in a Debian GNU/Linux virtual private server running under Virtuozzo hypervision. Other filesystems, such as simfs, don't usually give any problems with DiskSpace.pm.

	~~===Debian 10 (Buster) no longer uses MySQL===~~
	~~Debian 10 has switched from using MySQL to MariaDB, so when trying to install from APT you will likley see an error like:~~
	~~The following information may help to resolve the situation:~~

	~~The following packages have unmet dependencies:~~
	~~eprints : Depends: mysql-server but it is not installable~~
	~~Depends: mysql-client but it is not installable~~
	~~E: Unable to correct problems, you have held broken packages.~~
	To solve this problem for pre-3.4.3 version of EPrints you will need to add the MySQL APT repository. EPrints 3.4.3+ should allow either MySQL or MariaDB to be installed. To add the MySQL APT repository for Debian 10 (Buster) follow the instructions below.
	~~<ol>~~
	~~<li>As the root user, change directory to <code>tmp</code> and download the MySQL configuration DEB package using <code>wget</code></li>~~
	~~# cd /tmp~~
	~~# wget <nowiki>https://dev.mysql.com/get/mysql-apt-config_0.8.16-1_all.deb</nowiki>~~
	<li>Install the DEB package using dpkg. When prompted you should not need to change any settings (i.e. stick with MySQL 8.0) so you can select OK. (If you are upgrading from Debian 9 it might be best to choose 5.7 to stay on the same version).</li>
	# dpkg -i mysql-apt-config*
	~~<li>Update APT to get new MySQL repository listings</li>~~
	~~# apt-get update~~
	~~</ol>~~
	~~You should now be able to install EPrints through APT without any further issues.~~

	===Debian 10 (Buster) does not install CGI.pm===		===Debian 10 (Buster) does not install CGI.pm===

Drn@ecs.soton.ac.uk: /* Wrong XML::LibXML Version */

2022-05-29T22:30:51Z

Wrong XML::LibXML Version

← Older revision		Revision as of 22:30, 29 May 2022
Line 60:		Line 60:
	# cpan XML::LibXML		# cpan XML::LibXML

	~~Alternatively you could follow the instructions at [[Installing_GDOME_on_Debian]] to install the GDOME XML library.~~		Without either XML::LibXML or XML::GDOME, EPrints uses a bundled XML::DOM implementation that has much lower performance and poorer Unicode support. In future versions of EPrints only XML::LibXML will be supported. As this is widely available across the most commonly used Linux operating systems.

	Without either XML::LibXML or XML::GDOME ~~Eprints~~ uses a bundled XML::DOM implementation that has much lower performance and poorer Unicode support.

	Note that you can build Debian packages from CPAN modules using [http://packages.debian.org/dh-make-perl dh-make-perl] in order to keep track of those modules you've been building by yourself. Provided you've already configured your CPAN environment (that is, at least your proxies and servers), you can survive with:		Note that you can build Debian packages from CPAN modules using [http://packages.debian.org/dh-make-perl dh-make-perl] in order to keep track of those modules you've been building by yourself. Provided you've already configured your CPAN environment (that is, at least your proxies and servers), you can survive with:

Drn@ecs.soton.ac.uk at 00:30, 6 March 2022

2022-03-06T00:30:54Z

← Older revision		Revision as of 00:30, 6 March 2022
Line 36:		Line 36:
	* Edit your archives 10_core.pl and change its location - as EPrints user		* Edit your archives 10_core.pl and change its location - as EPrints user

	vi archives/~~archive_name~~/cfg/cfg.d/10_core.pl		vi archives/ARCHIVEID/cfg/cfg.d/10_core.pl

	change the host line to your new host e.g.:		change the host line to your new host e.g.:

Th.lauke@arcor.de: some typos and formatting corrected

2020-12-17T18:20:06Z

some typos and formatting corrected

← Older revision		Revision as of 18:20, 17 December 2020
Line 1:		Line 1:
	If you come across any unknown ~~Eprints~~-specific issues please send a bug report to the eptech mailing list.		If you come across any unknown EPrints-specific issues please send a bug report to the eptech mailing list.
	[[Category:Debian and Ubuntu]]		[[Category:Debian and Ubuntu]]
	==Known Issues==		==Known Issues==
Line 34:		Line 34:
	or		or

	* Edit your archives 10_core.pl and change its location - as ~~eprints~~ user		* Edit your archives 10_core.pl and change its location - as EPrints user

	# vi archives/archive_name/cfg/cfg.d/10_core.pl		vi archives/archive_name/cfg/cfg.d/10_core.pl

	change the host line to your new host eg:		change the host line to your new host e.g.:

	$c->{host} = 'example.org';		$c->{host} = 'example.org';
Line 44:		Line 44:
	Regenerate your apache config:		Regenerate your apache config:

	# bin/generate_apacheconf		bin/generate_apacheconf

	As root restart your apache		As root restart your apache

	# apache2ctl ~~stop~~		# apache2ctl graceful
	~~# apache2ctl start~~

	Now you should be able to log in from the new url by pointing firefox at http://example.org		Now you should be able to log in from the new url by pointing firefox at http://example.org
Line 55:		Line 54:
	===Wrong XML::LibXML Version===		===Wrong XML::LibXML Version===

	This affects mainly Ubuntu and older Debian distributions where the libxml package is too old. The package installer doesn't check the XML::LibXML version. Either install XML::LibXML 1.63 from cpan or disable it by setting enable_libxml to 0 in ~~/usr/share/eprints3/~~perl_lib/EPrints/SystemSettings.pm.		This affects mainly Ubuntu and older Debian distributions where the libxml package is too old. The package installer doesn't check the XML::LibXML version. Either install XML::LibXML 1.63 from cpan or disable it by setting enable_libxml to 0 in <code>perl_lib/EPrints/SystemSettings.pm</code>.

	Installing 1.63 from cpan (as root):		Installing 1.63 from cpan (as root):

	cpan XML::LibXML		# cpan XML::LibXML

	Alternatively you could follow the instructions at [[Installing_GDOME_on_Debian]] to install the GDOME XML library.		Alternatively you could follow the instructions at [[Installing_GDOME_on_Debian]] to install the GDOME XML library.
Line 71:		Line 70:
	===DiskSpace.pm measuring disk usage (reiserFS)===		===DiskSpace.pm measuring disk usage (reiserFS)===

	Not supported in the default package install, to add support add the following to the array defined in $EPRINTS_HOME/perl_lib/Filesys/DiskSpace.pm		Not supported in the default package install, to add support add the following to the array defined in <code>$EPRINTS_HOME/perl_lib/Filesys/DiskSpace.pm</code>

	1448756819 => "REISERFS_SUPER_MAGIC", # 0x565A4653		1448756819 => "REISERFS_SUPER_MAGIC", # 0x565A4653
Line 80:		Line 79:

	===Debian 10 (Buster) no longer uses MySQL===		===Debian 10 (Buster) no longer uses MySQL===
	Debian 10 has ~~swicthed~~ from using MySQL to MariaDB, so when trying to install from APT you will likley see an error like:		Debian 10 has switched from using MySQL to MariaDB, so when trying to install from APT you will likley see an error like:
	The following information may help to resolve the situation:		The following information may help to resolve the situation:

Line 89:		Line 88:
	To solve this problem for pre-3.4.3 version of EPrints you will need to add the MySQL APT repository. EPrints 3.4.3+ should allow either MySQL or MariaDB to be installed. To add the MySQL APT repository for Debian 10 (Buster) follow the instructions below.		To solve this problem for pre-3.4.3 version of EPrints you will need to add the MySQL APT repository. EPrints 3.4.3+ should allow either MySQL or MariaDB to be installed. To add the MySQL APT repository for Debian 10 (Buster) follow the instructions below.
	<ol>		<ol>
	<li>1. As the root user, change directory to ''/~~tmp''~~ and download the MySQL configuration DEB package using ''wget''</li>		<li>As the root user, change directory to <code>tmp</code> and download the MySQL configuration DEB package using <code>wget</code></li>
	cd /tmp		# cd /tmp
	wget https://dev.mysql.com/get/mysql-apt-config_0.8.13-1_all.deb		# wget <nowiki>https://dev.mysql.com/get/mysql-apt-config_0.8.16-1_all.deb</nowiki>
	<li>Install the DEB package using dpkg. When prompted you ~~shoudl~~ not need to change any settings (i.e. stick ~~witj~~ MySQL 8.0) so you can select OK. (If you are upgrading from Debian 9 it might be best to choose 5.7 to stay on the same version).</li>		<li>Install the DEB package using dpkg. When prompted you should not need to change any settings (i.e. stick with MySQL 8.0) so you can select OK. (If you are upgrading from Debian 9 it might be best to choose 5.7 to stay on the same version).</li>
	dpkg -i mysql-apt-config*		# dpkg -i mysql-apt-config*
	<li>Update APT to get new MySQL repository listings		<li>Update APT to get new MySQL repository listings</li>
	apt-get update		# apt-get update
	</ol>		</ol>
	You should now be able to install ~~eprints~~ through APT without any further issues.		You should now be able to install EPrints through APT without any further issues.

	===Debian 10 (Buster) does not install CGI.pm===		===Debian 10 (Buster) does not install CGI.pm===
	Debian 10's (Buster) dependency tree seems to be different to older versions and as a result does not install CGI.pm. To install this on pre-EPrints 3.4.3 versions, install the following additional dependency (as the root user) before trying to run ''epadmin''.		Debian 10's (Buster) dependency tree seems to be different to older versions and as a result does not install CGI.pm. To install this on pre-EPrints 3.4.3 versions, install the following additional dependency (as the root user) before trying to run ''epadmin''.
	apt-get install libcgi-pm-perl		# apt-get install libcgi-pm-perl

			Also recommendable is to keep your perl modules by saving an autobundle with
			# cpan -a

			Where- and whenever you like the snapshot can be (re-)installed with
			# perl -MCPAN -e 'install Bundle::Snapshot_yyyy_mm_dd_00'

	===Debian 10 (Buster) does not allow unprivileged access to MySQL root user===		===Debian 10 (Buster) does not allow unprivileged access to MySQL root user===
	This is also an issue with Ubuntu 20.04~~. See~~ advice at ~~https://wiki.eprints.org/w/~~Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2		This is also an issue with Ubuntu 20.04, thus see advice at [[Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2\|Installing EPrints on Debian/Ubuntu]].

Drn@ecs.soton.ac.uk: /* Debian 10 (Buster) does not allow unprivileged access to MySQL root user */

2020-12-17T16:17:50Z

Debian 10 (Buster) does not allow unprivileged access to MySQL root user

← Older revision		Revision as of 16:17, 17 December 2020
Line 104:		Line 104:

	===Debian 10 (Buster) does not allow unprivileged access to MySQL root user===		===Debian 10 (Buster) does not allow unprivileged access to MySQL root user===
	This is also an issue with Ubuntu 20.04. See advice at https://wiki.eprints.org/w/Installing_EPrints_on_Debian/Ubuntu#~~Ubuntu_20.04_LTS~~		This is also an issue with Ubuntu 20.04. See advice at https://wiki.eprints.org/w/Installing_EPrints_on_Debian/Ubuntu#MySQL_root_user_cannot_be_used_2

Drn@ecs.soton.ac.uk: Added advice about MySQL root user issues with Debian 10 / Ubuntu 20.04

2020-12-17T16:17:13Z

Added advice about MySQL root user issues with Debian 10 / Ubuntu 20.04

← Older revision		Revision as of 16:17, 17 December 2020
Line 102:		Line 102:
	Debian 10's (Buster) dependency tree seems to be different to older versions and as a result does not install CGI.pm. To install this on pre-EPrints 3.4.3 versions, install the following additional dependency (as the root user) before trying to run ''epadmin''.		Debian 10's (Buster) dependency tree seems to be different to older versions and as a result does not install CGI.pm. To install this on pre-EPrints 3.4.3 versions, install the following additional dependency (as the root user) before trying to run ''epadmin''.
	apt-get install libcgi-pm-perl		apt-get install libcgi-pm-perl

			===Debian 10 (Buster) does not allow unprivileged access to MySQL root user===
			This is also an issue with Ubuntu 20.04. See advice at https://wiki.eprints.org/w/Installing_EPrints_on_Debian/Ubuntu#Ubuntu_20.04_LTS