How to Install EPrints on Void Linux

EPrints is a free, open-source software designed to allow for easy creation of digital archives. This tutorial will guide you through how to install EPrints on Void Linux.

Prerequisites

Before you begin, you must have the following:

  • A computer running Void Linux
  • Root access or sudo permissions
  • An internet connection

Step 1: Install Required Dependencies

Open a terminal and run the following command to install the necessary dependencies:

sudo xbps-install -S perl perl-DBI perl-DBD-MySQL perl-Config-IniFiles perl-CGI-Ajax lighttpd

This command will install Perl, MySQL, and web server Lighttpd, which are required for running EPrints.

Step 2: Download EPrints

Download the latest version of EPrints from the official website: https://www.eprints.org/download/. Once downloaded, extract the archive to your preferred location.

Step 3: Install EPrints

Change to the extracted EPrints directory using the following command:

cd <eprints-directory>

Then, run the following command to install EPrints:

sudo ./configure

If any missing dependencies are detected, the configure script will print a message indicating which packages are required to be installed.

After the configuration process completes, run the following command to install EPrints:

sudo make install

Step 4: Configure EPrints

Create a new user for EPrints:

sudo useradd -d /opt/eprints3 -s /bin/bash eprints

Change ownership of the EPrints installation directory to the new user:

sudo chown -R eprints:eprints /opt/eprints3

Copy a sample configuration file to /opt/eprints3/archives/first:

sudo cp /opt/eprints3/cfg/cfg.d/archive/default.pl /opt/eprints3/archives/first/cfg/cfg.d/

Change the ownership of this directory to the EPrints user:

sudo chown -R eprints:eprints /opt/eprints3/archives/first

Configure Lighttpd to serve EPrints, edit the lighttpd.conf file with the following command:

sudo nano /etc/lighttpd/lighttpd.conf

Add the following lines to this file:

server.modules += ("mod_cgi")
$HTTP["url"] =~ "^/cgi-bin/" {
   cgi.assign = (".cgi" => "/opt/eprints3/bin/epcgi")
}
alias.url = (
   "/eprints/" => "/opt/eprints3/archives/first/cfg/static/",
   "/lib/" => "/opt/eprints3/lib/",
   "/archives/" => "/opt/eprints3/archives/first/"
)

Save and exit the file, then restart the Lighttpd server:

sudo service lighttpd restart

Step 5: Access EPrints

EPrints should now be accessible via your web browser by visiting http://localhost/eprints/.

Conclusion

Congratulations! You have successfully installed EPrints on Void Linux. EPrints is now ready to be used for creating digital archives.