acdhch/aksearch-solr

AkSearchSolr 镜像文档

1. 镜像概述和主要用途

AkSearchSolr 是一个 Solr 实例的 Docker 镜像，专为作为 AkSearch 的 Solr 后端和 MARC 数据导入环境设计。

2. 核心功能和特性

• 基于 solr:7 镜像构建，Solr 安装路径为 /opt/solr/server/solr。
• AkSearch 仓库克隆至 /opt/aksearch 目录，包含完整的 MARC 数据导入工具链。
• /opt/aksearch/import/*properties 配置文件中已固定 Solr 端口（AkSearch 假设 Solr 运行在 8080 端口，而 Solr 默认端口为 8983）。

3. 使用场景和适用范围

适用于需要部署 AkSearch 系统并依赖 Solr 进行索引管理的场景，尤其适合学术机构、图书馆等需处理 MARC 格式元数据的用户，可作为 AkSearch 的 Solr 后端服务及 MARC 数据导入环境。

4. 使用方法和配置说明

4.1 基本部署

通过 docker run 命令启动容器，示例如下：

bash
docker run --name aksearch-solr -d -p 8983:8983 -v aksearch-solrdata:/opt/solr/server/solr/mycores docker.xuanyuan.run/acdhch/aksearch-solr

参数说明：

• --name aksearch-solr：指定容器名称。
• -d：后台运行容器。
• -p 8983:8983：映射容器内 Solr 端口（8983）到主机。
• -v aksearch-solrdata:/opt/solr/server/solr/mycores：挂载数据卷以持久化 Solr 核心数据。

4.2 导入MARC数据

需先通过 docker exec 进入运行中的容器：

bash
docker exec -ti aksearch-solr bash

4.2.1 导入单个MARC文件

进入容器后，执行以下命令：

bash
cd /opt/aksearch && ./import-marc.sh <pathToTheMarcFile>

其中 <pathToTheMarcFile> 为 MARC 文件在容器内的路径。

4.2.2 导入目录中的所有MARC文件

通过批量导入脚本处理目录下的所有文件：

bash
cd /opt/aksearch && harvest/batch-import-marc.sh -m -d <pathToTheMarcDir>

注意：

• 脚本默认将日志写入 <pathToTheMarcDir>/log 目录，若无法创建/写入该目录，可使用 -z 参数禁用文件日志（日志仍会输出到控制台，可手动重定向至文件）。

4.2.3 导入示例MARC数据

进入容器后，执行以下命令下载并导入示例数据：

bash
# 下载并解压示例数据
curl -L 'https://github.com/acdh-oeaw/AkSearchSolr/blob/main/.github/workflows/marc.xml.gz?raw=true' > /tmp/marc.xml.gz
gunzip /tmp/marc.xml.gz

# 导入数据
cd /opt/aksearch && ./import-marc.sh /tmp/marc.xml

# 清理临时文件
rm /tmp/marc.xml

4.3 使用自定义MARC import.properties

通过挂载自定义配置文件并设置环境变量 VUFIND_LOCAL_DIR，覆盖默认 import.properties：

bash
docker run --name aksearch-solr -d -p 8983:8983 -v aksearch-solrdata:/opt/solr/server/solr/mycores \
  -v <pathToMyLocalImport.properties>:/opt/localcfg/import/import.properties -e VUFIND_LOCAL_DIR=/opt/localcfg \
  docker.xuanyuan.run/acdhch/aksearch-solr

说明：

• <pathToMyLocalImport.properties> 为主机上自定义 import.properties 文件路径。
• VUFIND_LOCAL_DIR=/opt/localcfg 指定本地配置目录，容器将读取 /opt/localcfg/import/import.properties。

4.4 其他导入脚本

AkSearch 提供的其他导入脚本（如权威数据导入）位于 /opt/aksearch 目录下，可直接调用：

• import-marc-auth.sh：导入 MARC 权威数据。
• harvest/batch-import-marc-auth.sh：批量导入 MARC 权威数据。

5. 已知问题

5.1 Solr 端口配置冲突

镜像中 Solr 运行在 8983 端口，若使用自定义 import.properties，需确保文件中 solr.hosturl 配置与容器内 Solr 端口一致（默认 8983）。

5.2 batch-import-marc-auth.sh 脚本路径冲突

执行 batch-import-marc-auth.sh 时若出现以下错误：

FATAL [main] (Boot.java:215) - ERROR: Error while invoking main method in specified class: org.solrmarc.driver.IndexDriver
java.lang.LinkageError: loader org.solrmarc.driver.Boot @3fee733d attempted duplicate interface definition for org.ini4j.Persistable.

解决方法：从 import-marc.sh 所在目录（/opt/aksearch）执行脚本：

bash
cd /opt/aksearch && harvest/batch-import-marc-auth.sh <参数>

原因：脚本路径解析错误导致类文件重复加载，通过指定工作目录可避免冲突。