Tools/epm

From EPrints Documentation
Revision as of 10:19, 14 July 2023 by Drn@ecs.soton.ac.uk (talk | contribs) (Added command explanations with examples)
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
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. E.g. tools/epm uninstall 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