Bibliomap is a tool for real-time viewing in the browser localised usage events generated by ezPAARSE.

How could it be useful ?

• For real-time monitoring your ezproxy EC consultations
• For helping ezpaarse adoption in your institution.
• And just for fun !

Demonstration on the CNRS subscribed electronic ressources usage statistics

In expo mode, the description popup will automatically show and hide at determined intervals. To activate it, add expo or e in the querystring. By default, the popup will be shown for 1 minute, then hidden for 10 minutes. To define custom intervals, expo should take two numbers separated by a comma. The first one is the time shown, the second is the time hidden. Times are defined in seconds.

Examples:

• http://bibliomap.inist.fr?expo (activates default expo mode: 1min shown / 10 min hidden)
• http://bibliomap.inist.fr?e (the same but with a shortcut)
• http://bibliomap.inist.fr?expo=20,120 (activates customized expo mode: 20 sec shown / 120 sec hidden)

Bibliomap uses these softwares:

• bibliomap-harvester for real-time listening lines of log comming from ezproxys
• bibliomap-enricher listening for bibliomap-harvester data, sending it to ezpaarse and sending the result to you this bibliomap
• bibliomap-viewer for the front end web interface showing ezPAARSE EC's in real time thanks to websocket protocol
• Log.io protocol for all the communication between these scripts

• Docker and docker-compose

• Load the configuration file which define your project settings (setup_*.sh)

# Clone the repository
git clone https://github.com/ezpaarse-project/bibliomap.git
cd bibliomap

# Load one configuration file
source ./setup_cnrs.sh 
# Or
source ./setup_istex.sh

# Start the tool
npm start

Then browse to http://127.0.0.1:50197

# Clone all the required repositories
git clone https://github.com/ezpaarse-project/bibliomap.git
cd bibliomap
git clone https://github.com/ezpaarse-project/bibliomap-harvester.git
git clone https://github.com/ezpaarse-project/bibliomap-enricher.git
git clone https://github.com/ezpaarse-project/bibliomap-viewer.git

# Load one configuration file
source ./setup_cnrs.sh 
# Or
source ./setup_istex.sh

# Install dependencies & Start the tool
npm run install
npm run start-debug

Then browse to http://127.0.0.1:50197

Whenever you want you can git pull all the git repositories using one command:

npm run pull

To upgrade to the latest version of bibliomap-harvester, bibliomap-enricher, and bibliomap-viewer in the docker-compose.yml, just git clone all of these into your bibliomap/ folder (see just above) and run this command:

npm version patch