Jump to content
Wiki Home
EPrints Home
Bazaar
Files
Main menu
Main menu
move to sidebar
hide
Navigation
Front Page
EPrints 3 Manual
EPrints Training Course
EPrints Glossary
Installing EPrints
How-to Configure EPrints
EPrints 3.2+ API
EPrints 3 Reference
EPrints Plugins
Wiki
All categories
Recent changes
Main Page
Help
EPrints Documentation
Search
Search
Appearance
Log in
Request account
Personal tools
Log in
Request account
Pages for logged out editors
learn more
Contributions
Talk
Editing
Quickstart:Install EPrints
Page
Discussion
British English
Read
Edit
View history
Tools
Tools
move to sidebar
hide
Actions
Read
Edit
View history
General
What links here
Related changes
Special pages
Page information
Appearance
move to sidebar
hide
Warning:
You are not logged in. Your IP address will be publicly visible if you make any edits. If you
log in
or
create an account
, your edits will be attributed to your username, along with other benefits.
Anti-spam check. Do
not
fill this in!
[[Category:Quickstart]] NOTE: This page assumes you have completed the steps on the [[Quickstart:System Setup | 'System Setup']] page of this guide. == Installing EPrints 3.4.7 from Source == === Create initial directory with correct permissions === <p>As root:</p> <code>mkdir /opt/eprints3</code><br/> <code>chown eprints:eprints /opt/eprints3</code><br/> <code>chmod 2775 /opt/eprints3</code><br/> === Cloning from Git === Clone the Git repository from GitHub to <tt>/opt/</tt> and set the <tt>eprints</tt> user as the owner. It is probably best to specify and checkout the latest release rather than using HEAD, which may have known issues: <code>dnf install git</code><br/> <code>su eprints</code><br/> <code>git clone https://github.com/eprints/eprints3.4.git /opt/eprints3</code><br/> <code>cd /opt/eprints3/</code><br/> <code>git checkout tags/v3.4.7</code><br/> == Database == Before we can install the system we need to make sure that the database has a user the system can use. === Creating MySQL EPrints user === If you are running a modern version of Linux (e.g. Red Hat Enterprise Linux 9+ or Ubuntu 20.04+), the eprints user will not be able to connect to the MySQL database as the root user without a password. Therefore, before running "epadmin create" later in these instructions make sure you switch to the root user, open the MySQL client and run the following commands, (substituting the password (i.e. 'changeme') appropriately): CREATE USER 'eprints'@'localhost' IDENTIFIED by 'changeme'; GRANT ALL PRIVILEGES ON *.* TO 'eprints'@'localhost' WITH GRANT OPTION; When you are asked for the '''Database Superuser Username''' and '''Database Superuser Password''' be sure to use the username and password set above. If you are running older version of Linux where you have not needed to do the above steps. You can probably use the default options for these to steps. ==Creating the Archive== ==== Make sure the database is actually running ==== <p>MySQL:</p> <code>sudo systemctl status mysql</code> <p>MariaDB:</p> <code>sudo systemctl status mariadb</code> <br/> ==== Change to your "eprints" user ==== <code>su eprints</code> <br/> ==== Change directory to the eprints directory ==== <i>(<tt>/opt/eprints3</tt> by default)</i><br/> <code>cd /opt/eprints3</code> <br/> ==== Create a research publications archive ==== <p>(You will be prompted to answer various questions about the configuration of your archive):</p> <code>bin/epadmin create pub</code> ===== <i>Note on Archive Flavour</i> ===== <i>If you don't want a research publications archive, in the above command use <code>zero</code> instead of <code>pub</code>. This will create a very basic repository, which can either store very generic items or can be more greatly customised as it does not have some of the intentional restrictions that come with a Research Publications repository. Other flavours of repository may be available but these will have to have be added their <tt>FLAVOUR_lib</tt> to the <tt>EPRINTS_PATH/flavours/</tt> directory. If you run just <code>bin/epadmin create</code> without a further parameter or one that is not recognised, the command should suggest what types (flavours) of repository archive are available.</i> == Database Tables and Website == These have now been created when you created the archive. == Next Steps == You are now ready to configure the EPrints system! Go to the [[Quickstart:Configure EPrints | next page of this guide]] to find out how.
Summary:
Please note that all contributions to EPrints Documentation may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see
EPrints Documentation:Copyrights
for details).
Do not submit copyrighted work without permission!
Cancel
Editing help
(opens in new window)