folioci/mod-erm-usage

FOLIO - mod-erm-usage

镜像概述

mod-erm-usage是FOLIO项目的一个核心模块，主要功能是存储ERM（电子资源管理）使用统计数据，并提供对这些统计数据的访问接口。该模块由欧洲区域发展基金(EFRE)资助开发，旨在支持图书馆及学术机构对电子资源使用情况的有效管理与分析。

核心功能与特性

• 数据存储：提供ERM使用统计数据的持久化存储能力
• 数据访问：支持对存储的统计数据进行查询和访问
• 标准化接口：遵循FOLIO项目的接口规范，便于与其他FOLIO模块集成
• 资源优化：预设JVM内存配置，确保模块在容器环境中高效运行

使用场景与适用范围

适用于需要管理和分析电子资源使用情况的图书馆、学术机构及研究组织，作为FOLIO生态系统的一部分，可与其他FOLIO模块协同工作，实现电子资源全生命周期管理。

使用方法与配置说明

基本部署要求

• 需配置数据库连接（模块依赖数据库存储统计数据）
• 容器内存需满足2147483648字节（2GB）的要求
• JVM参数需设置为-XX:MaxRAMPercentage=66.0以优化内存使用

Docker部署示例

docker run命令

bash
docker run -d \
  --name mod-erm-usage \
  -p 8081:8081 \
  -e DB_HOST=your-db-host \
  -e DB_PORT=5432 \
  -e DB_NAME=folio_mod_erm_usage \
  -e DB_USER=dbuser \
  -e DB_PASSWORD=dbpass \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  --memory=2g \
  folioorg/mod-erm-usage

docker-compose配置示例

yaml
version: '3'
services:
  mod-erm-usage:
    image: folioorg/mod-erm-usage
    container_name: mod-erm-usage
    ports:
      - "8081:8081"
    environment:
      - DB_HOST=your-db-host
      - DB_PORT=5432
      - DB_NAME=folio_mod_erm_usage
      - DB_USER=dbuser
      - DB_PASSWORD=dbpass
      - JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0
    deploy:
      resources:
        limits:
          memory: 2G

关键配置参数

数据库配置说明

模块依赖外部数据库存储统计数据，需通过环境变量配置数据库连接信息，包括：

• DB_HOST：数据库主机地址
• DB_PORT：数据库端口（通常为5432，PostgreSQL默认端口）
• DB_NAME：数据库名称
• DB_USER：数据库用户名
• DB_PASSWORD：数据库密码

代码仓库

https://github.com/folio-org/mod-erm-usage