Miscellaneous iRODS microservices originally developed by Utrecht University.

• msiCreateEpicPID: API call to register an Epic PID
• msiDeleteEpicPID: API call to delete an Epic PID
• msiGetEpicPID: API call to get an Epic PID
• msiUpdateEpicPID: API call to update metadata for an Epic PID
• msiArchiveCreate: Building data archives in iRODS (tar, zip, bzip, ...)
• msiArchiveExtract: Extracting data archives, full extract or partial extract
• msiArchiveIndex: Lists contents of a data archive

iRODS microservices can be installed using the packages provided on the releases page

You can also build the microservices yourself, see Building from source.

The microservices are built for iRODS version 4.2.11.

To build from source, the following build-time dependencies must be installed:

• make
• irods-dev-4.2.11
• irods-externals-cmake3.11.4
• irods-externals-clang6.0
• libcurl-openssl-dev
• libjansson-dev
• libarchive-dev
• g++

Ubuntu18:

apt-get install g++ irods-dev-4.2.11 irods-externals-cmake3.11.4 irods-externals-clang6.0 make libcurl4-openssl-dev libjansson-dev libarchive-dev

Centos7:

sudo yum install gcc-c++ irods-devel-4.2.11-1 irods-externals-cmake3.11.4-0 irods-externals-clang6.0-0 make jansson-devel libarchive-devel libcurl-devel openssl-devel rpmdevtools

Follow these instructions to build from source:

• First, browse to the directory where you have unpacked the source distribution.

• Check whether your umask is set to a sane value. If the output of umask is not 0022, run umask 0022 to fix it. This is important for avoiding conflicts in created packages later on.

• Access rights for iRODS group

  sudo chgrp irods /usr/lib/irods/plugins/microservices
  sudo chmod g+w /usr/lib/irods/plugins/microservices
  

• Add your admin account ot the iRODS group, e.g.:

  sudo vigr
  sudo vigr -s
  

  Logout and login, check with id if you are part of the iRODS group.

• Compile the project

export PATH=/opt/irods-externals/cmake3.11.4-0/bin:$PATH
cmake .
make

Now you can either build a DEB or install the project without a package manager.

To create a package:

make package

That's it, you should now have a DEB in your build directory which you can install using apt.

To install without creating a package

make install

This will install the .so files into the microservice plugin directory.