Difference between revisions of "Installing an EPM"

From EPrints Documentation
Jump to: navigation, search
(Created page with "== 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 r...")
 
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
[[Category:Howto]]
 
== Important ==
 
== Important ==
 
Broadly EPMs have been superseded by Ingredients and should be avoided. If you find you must install one, this guide aims to help.
 
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 ==
 
== 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.  (If you are installing a different version to what they have already installed you will need to take great care when '''Integration with the Archive''').
+
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/
 
  cd /opt/eprints3/lib/epm/
 
  git clone https://github.com/eprints/reports.git
 
  git clone https://github.com/eprints/reports.git
Line 11: Line 12:
 
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/
 
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+
 
  /opt/eprints3/ingredients/bazaar/tools/epm link_lib reports # EPrints 3.4.6+
−
  /opt/eprints3/site_lib/tools/epm link_lib reports # EPrints 3.4.5-
+
 
 +
== Integration with the Archive ==
 +
1. Enable the plugin using tools/epm
 +
  /opt/eprints3/ingredients/bazaar/tools/epm enable <ARCHIVE_ID> <PLUGIN_ID>
 +
<i>Note: <code>PLUGIN_ID</code> in our example is <code>reports</code></i>
 +
 
 +
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.

Latest revision as of 13:50, 13 October 2026

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.