Debian Known Issues
If you come across any unknown Eprints-specific issues please send a bug report to the eptech mailing list.
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.
Installing 1.63 from cpan (as root):
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.