Installing an EPM

From EPrints Documentation
Revision as of 12:59, 13 October 2026 by Ap1e26 (talk | contribs) (→‎Integration with the Archive)
Jump to: navigation, search

Important

Broadly EPMs have been superseded by Ingredients and should be avoided. If you find you must install one, this guide aims to help.

Installing from GitHub repository

1. Clone from Github the Bazaar plugin repository (e.g. https://github.com/eprints/reports.git) to /opt/eprints3/lib/epm/ and fetch the required version.

cd /opt/eprints3/lib/epm/
git clone https://github.com/eprints/reports.git
cd reports
git checkout v3.2.1

2. Run the /opt/eprints3/ingredients/bazaar/tools/epm command to link the library from /opt/eprints3/lib/epm/ in the appropriate locations under /opt/eprints3/lib/

/opt/eprints3/ingredients/bazaar/tools/epm link_lib reports # EPrints 3.4.6+

Integration with the Archive

1. Enable the plugin using tools/epm

/opt/eprints3/ingredients/bazaar/tools/epm enable <ARCHIVE_ID> <PLUGIN_ID>

Note: PLUGIN_ID in our example is reports

2. Where any warnings are produced compare the current and .epmnew version of a file and reconcile any differences. Removing the .epmnew file when you are done.