Difference between revisions of "Debian Known Issues"
(→Debian 10 (Buster) does not allow unprivileged access to MySQL root user) |
m (some typos and formatting corrected) |
||
Line 1: | Line 1: | ||
− | If you come across any unknown | + | 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 | + | * Edit your archives 10_core.pl and change its location - as EPrints user |
− | + | vi archives/archive_name/cfg/cfg.d/10_core.pl | |
− | change the host line to your new host | + | 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 | |
As root restart your apache | As root restart your apache | ||
− | # apache2ctl | + | # apache2ctl graceful |
− | |||
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 | + | 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 | + | 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> | + | <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. | + | # 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 | + | <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 | + | 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 | |
+ | |||
+ | 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 | + | 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]]. |
Revision as of 18:20, 17 December 2020
If you come across any unknown EPrints-specific issues please send a bug report to the eptech mailing list.
Contents
- 1 Known Issues
- 1.1 debian packages for version 3.3.13: Various problems related to subjects and divisions
- 1.2 debian packages for version 3.3.13: links to /id/eprint/<NUMBER> yield 500 Internal Server Error
- 1.3 No Tools Available on Login
- 1.4 Wrong XML::LibXML Version
- 1.5 DiskSpace.pm measuring disk usage (reiserFS)
- 1.6 Debian 10 (Buster) no longer uses MySQL
- 1.7 Debian 10 (Buster) does not install CGI.pm
- 1.8 Debian 10 (Buster) does not allow unprivileged access to MySQL root user
Known Issues
Issue #291 has been resolved only after building debian packages for version 3.3.13.
This leads to problems with all operations reading tree structures from flat text files:
- bin/import_subjects produces essentially empty trees
- after creating a new repository with default divisions and subjects the divisions and subjects remain empty and more importantly, due to empty values most operations within the webinterface involving divisions or subjects yield an error, rendering the whole repository useless.
Solution: Manual edit
debian packages for version 3.3.13: links to /id/eprint/<NUMBER> yield 500 Internal Server Error
Solution: Manual edit
No Tools Available on Login
This occurs if you are using certain Firefox 3 versions on debian/ubuntu and you have your repository at http://localhost.
This is due to the fact that Firefox 3 won't let you store cookies for domains which don't have a domain. localhost.localdomain may work (untested) however the fix below encourages the use of example.org.
Basically it will work under most other browsers or you can do the following fix.
- Think of a domain for your repository and add this to your hosts file in /etc/hosts (here example.org) by doing the following as root.
# vi /etc/hosts
Add the line
127.0.0.1 example.org
- Then either create a new archive with example.org as its location
or
- Edit your archives 10_core.pl and change its location - as EPrints user
vi archives/archive_name/cfg/cfg.d/10_core.pl
change the host line to your new host e.g.:
$c->{host} = 'example.org';
Regenerate your apache config:
bin/generate_apacheconf
As root restart your apache
# apache2ctl graceful
Now you should be able to log in from the new url by pointing firefox at http://example.org
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 perl_lib/EPrints/SystemSettings.pm
.
Installing 1.63 from cpan (as root):
# 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.
Note that you can build Debian packages from CPAN modules using 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:
dh-make-perl --install --notest --cpan XML::LibXML
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
1448756819 => "REISERFS_SUPER_MAGIC", # 0x565A4653
Many thanks to José Miguel Parrella Romero for pointing this out.
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.
- As the root user, change directory to
tmp
and download the MySQL configuration DEB package usingwget
- 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).
- Update APT to get new MySQL repository listings
# cd /tmp # wget https://dev.mysql.com/get/mysql-apt-config_0.8.16-1_all.deb
# dpkg -i mysql-apt-config*
# apt-get update
You should now be able to install EPrints through APT without any further issues.
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
This is also an issue with Ubuntu 20.04, thus see advice at Installing EPrints on Debian/Ubuntu.