iRODS Microservices

Miscellaneous iRODS microservices originally developed by Utrecht University.

Included microservices

• 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

Installation

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

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

Navigate to the branch of the repository for your iRODS version:

• master (irods4.2.8)
• irods-4.2.7

To get the patches for irods 4.2.10 do:

git clone <this repository> # you are on master after this
git merge origin/irods-4.2.10

Building from source

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

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

Ubuntu18:

apt-get install g++ irods-dev 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 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.