Skip to content

File provenance library

License

Notifications You must be signed in to change notification settings

oicr-gsi/cerberus

Repository files navigation

Cerberus

Cerberus is joining system that allows merging different kinds of records. We use it to join LIMS metadata from Pinery with workflow metadata from Víðarr.

To join data from one or more Vidarr servers with one or more Pinery servers, create a configuration file ending in .cerberus as follows:

 {
   "pinery": {
     "pinery-miso": {
       "url": "http://pinery.example.com/",
       "versions": [
         2,
         7,
         8
       ]
     }
   },
   "vidarr": {
     "prod": "http://vidarr-prod.example.com:8000"
   }
 }

The "pinery" section describes all Pinery instances that can be used LIMS data sources. The keys are the provider name used in Vidarr. For each Pinery instances, multiple versions of the same data can be used by specifying them in the "versions" list.

The "vidarr" section describes all the Vidarr instances that should be used as file sources. The keys are the internal name of that Vidarr instance and the value is the URL of that instance.

The Cerberus file provenance client can be used to produce a joined file provenance TSV in the traditional format using:

java -m ca.on.oicr.gsi.cerberus.cli/ca.on.oicr.gsi.cerberus.Main online \
  -c config.json -o output.json