Skip to content

ezpaarse-project/bibliomap-harvester

Repository files navigation

bibliomap-harvester

Monitors and harvests ezproxy log files for bibliomap visualization.

Architecture

Prerequisites

  • Docker and docker-compose

Installation and running

As a standalone script, bibliomap-harvester is not very usefull. Please have a look to bibliomap docker-compose.yml to understand how it can be orchestrated with required modules: bibliomap-enricher and bibliomap-viewer

Configuration

Env variable can be used to customize it:

  • BBH_ENRICHER_HOST
  • BBH_ENRICHER_PORT
  • BBH_STREAMNAMES
  • BBH_STREAMPATHS

Look at config.json to see the default values.

To connect external log files, you have to mount docker volumes this way.

  • Supposing you have 2 ezproxy log file here on the hosting server:
    • /bibcnrs/inp/ezproxy/ezproxy.log
    • /bibcnrs/insb/ezproxy/ezproxy.log
  • Then you have to add these volumes when running bibliomap-harvester container:
    • -v /bibcnrs/inp/ezproxy/ezproxy.log:/app/tmp/inc.log
    • -v /bibcnrs/insb/ezproxy/ezproxy.log:/app/tmp/insb.log
  • Then when running bibliomap-harvester container, you have to setup theses variables:
    • BBH_STREAMNAMES="INC INSB"
    • BBH_STREAMPATHS="/app/tmp/inc.log /app/tmp/insb.log"

Developement

git clone git@github.com:ezpaarse-project/bibliomap-harvester.git
cd bibliomap-harvester
DEBUG=bibliomap* make run-debug