Tools/epm

From EPrints Documentation
Revision as of 09:42, 15 July 2023 by Drn@ecs.soton.ac.uk (talk | contribs) (Added unlink_lib)
Jump to: navigation, search

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects

epm is a command line to to manage EPMs with the following usage:

Usage:
   epm *command* [options]

   Where *command* is one of:

           build
           disable
           enable
           install
           link_lib
           list
           rebuild
           uninstall
           unpack

Options:
   --verbose
   --force
   --help
   --man
   --epm package_path
       Read metadata from the epm at package_path when building.

   --version
       Set the version when building.

Commands

build 
Builds a new <PACKAGE>.epm file. Uses metadata provided by PACKAGE.epmi if provided by --epm flag. Uses first argument after the command as the .epm filename and remaining arguments as files that should be packaged in the EPM. E.g. tools/epm build my_epm cfd.d/my_epm.pl plugins/EPrints/Screen/MyEPM.pm --epm /home/eprints/my_epm.epmi
disable 
Disables an EPM in a particular repository archive. First argument is the archive ID and the second argument is the EPM to be disable. E.g. tools/epm disable my_archive my_epm.
enable 
Enables an EPM in a particular repository archive. First argument is the archive ID and the second argument is the EPM to be enable. E.g. tools/epm enable my_archive my_epm
install 
Instalsl EPM specified within a .epm file to the repository under lib/epm/ as well as appropriate locations within lib/. E.g. tools/epm install /home/eprints/MyEPM.epm
link_lib 
Take a source directory of an EPM in lib/epm/PACKAGE and symlink to it from the correct locations in lib/. Using --force flag replaces any files currently in those locations in lib/. E.g. tools/epm link_lib my_epm
list 
List the current EPM packages installed and their versions. E.g. tools/epm list
rebuild 
Rebuilds the .epm and .epmi files in lib/epm/PACKAGE based on the existing files non-epm files in that directory. E.g. tools/epm rebuild my_epm
uninstall 
Uninstalls specified EPM from repository including removing from lib/epm/, appropriate locations in lib/ and disabling configuration files within any archives using the EPM. Using --force flag ignores EPM being enabled in an archive and any checksum mismatches. E.g. tools/epm uninstall my_epm
unlink_lib 
Unlink files linked into lib/ from a source directory of an EPM in lib/epm/PACKAGE. I.e. reverses link_lib. Not available until EPrints 3.4.6+. Cannot be run even with --force if EPM is enabled in an archive. E.g. tools/epm unlink_lib my_epm
unpack 
Unpacks the files in a .epm file and writes them to the current directory. E.g. tools/epm unpack /home/eprints/MyEPM.epm