Difference between revisions of "Issues with Installing EPrints on Ubuntu 20.04"

From EPrints Documentation
Jump to: navigation, search
(Adds libio-string-perl deb package for Ubuntu 20.04)
(Updated installation issues.)
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.'''
 
'''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.'''
 
==== xpdf package no longer exists ====
 
The Deb package xpdf is no longer available in Ubuntu 20.04.  xpdf is probably no longer needed so if installing from source use the following APT command line:
 
 
apt-get install perl libncurses5 libselinux1 libsepol1 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 \
 
  liblwp-protocol-https-perl libtext-unidecode-perl lynx wget ghostscript xpdf antiword elinks \
 
  texlive-base texlive-base-bin psutils imagemagick adduser tar gzip mysql-server mysql-client unzip \
 
  libsearch-xapian-perl libtex-encode-perl libio-string-perl
 
  
 
==== MySQL root user cannot be used ====
 
==== MySQL root user cannot be used ====
Line 16: Line 6:
 
  GRANT ALL PRIVILEGES ON *.* TO 'eprints'@'localhost' WITH GRANT OPTION;
 
  GRANT ALL PRIVILEGES ON *.* TO 'eprints'@'localhost' WITH GRANT OPTION;
  
==== MySQL deprecated syntax ====
+
==== Previous issues ====
MySQL no longer supports creating a user as part of the GRANT PRIVILEGES command, which causes problems with EPrints if below version 3.4.2. Therefore, perl_lib/EPrints/Database/mysql.pm needs to be patched.  This can be done by using the [https://raw.githubusercontent.com/eprints/eprints3.4/master/perl_lib/EPrints/Database/mysql.pm latest version of mysql.pm on GitHub] if the Eprints version being installed is under 3.4.2.
+
; ''xpdf'' Deb package no longer exists : This has been removed as a dependency since EPrints 3.4.3.
 +
; MySQL deprecated syntax : <code>GRANT PRIVILEGES</code> command in used by ''epadmin'' has been modified to avoid using deprecated syntax since EPrints 3.4.3.

Revision as of 00:00, 30 April 2021

N.B. It is assumed that you are installing the latest version of 3.4. Earlier versions may have issues not listed here.

MySQL root user cannot be used

On Ubuntu 18.04 LTS rather than prompting you to set a password for MySQL server when installing this as a dependency, it just installs it without. However, this means on the root user can login to MySQL to add a database. As "epadmin create" runs at the eprints user, this will not be able to create a database for EPrints. The get round this as the root user connect to MySQL (just type "mysql" at the command line) and type the following two commands. You will want to set your own password (i.e. not 'changeme') , you may also want to restrict which databases the eprints user has control over. If you know the "Archive ID" you are going to use.

CREATE USER 'eprints'@'localhost' IDENTIFIED by 'changeme';
GRANT ALL PRIVILEGES ON *.* TO 'eprints'@'localhost' WITH GRANT OPTION;

Previous issues

xpdf Deb package no longer exists 
This has been removed as a dependency since EPrints 3.4.3.
MySQL deprecated syntax 
GRANT PRIVILEGES command in used by epadmin has been modified to avoid using deprecated syntax since EPrints 3.4.3.