Logo
Project Icon

Evergreen

开源图书馆管理系统服务器安装指南

Evergreen安装服务器PostgreSQLOpenSRFGithub开源项目

本文全面介绍Evergreen开源图书馆系统服务器端的部署流程,包括环境准备、依赖安装、系统配置、Apache设置、OpenSRF配置等核心步骤。文章还涵盖了开发者指南和数据库创建说明,为图书馆技术人员提供了实用的Evergreen部署参考。

访问官网访问官网GithubGithub文档文档
介绍相关项目

= 安装 Evergreen 服务器 = :toc:

== 前言:引用的用户账户 ==

在后续章节中,我们会引用几个不同的账户,如下所示:

  • Linux 用户账户: ** user Linux 账户是您用来以普通用户身份登录 Linux 系统的账户。 ** root Linux 账户是具有系统管理员权限的账户。在 Debian 上,您可以通过执行 su - 命令并在提示时输入 root 账户的密码,从 user 账户切换到该账户。在 Ubuntu 上,您可以使用 sudo su - 命令并在提示时输入 user 账户的密码,从 user 账户切换到该账户。 ** opensrf Linux 账户是您在安装 OpenSRF 时创建的账户。您可以通过执行 su - opensrf 命令从 root 账户切换到该账户。 ** postgres Linux 账户在您安装 PostgreSQL 数据库服务器时自动创建。您可以通过执行 su - postgres 命令从 root 账户切换到该账户。
  • PostgreSQL 用户账户: ** evergreen PostgreSQL 账户是您将创建用于连接 PostgreSQL 数据库服务器的超级用户账户。
  • Evergreen 管理员账户: ** egadmin Evergreen 账户是您将用于测试连接和配置 Evergreen 实例的管理员账户。

== 前言:开发者说明 ==

[注意] 如果您使用从 http://evergreen-ils.org/egdownloads 下载的官方发布 tarball,请跳过本节

直接使用 Git 仓库中源代码而非官方发布 tarball 的开发者,在进行 ./configure 步骤之前必须执行一个步骤。

作为 user Linux 账户,在 Evergreen 源目录中执行以下命令以生成配置脚本和 Makefile:

[source, bash]

autoreconf -i

== 安装先决条件 ==

  • PostgreSQL: 最低支持版本为 10。
  • Linux: Evergreen 已在以下系统上测试过: Debian Bookworm (12), Debian Bullseye (11), Debian Buster (10), Ubuntu Noble Numbat (24.04), 和 Ubuntu Jammy Jellyfish (22.04)。 如果您运行的是这些发行版的旧版本,您可能需要在升级 Evergreen 之前先升级系统。有关升级这些发行版的说明,请访问 Debian 或 Ubuntu 网站。
  • OpenSRF: OpenSRF 的最低支持版本为 3.3.0。

Evergreen 有许多先决条件包,必须在成功配置、编译和安装 Evergreen 之前安装这些包。

  1. 首先安装最新版本的 OpenSRF (3.3.0 或更高版本)。 您可以从 http://evergreen-ils.org/opensrf-downloads/ 下载 OpenSRF 发布版
  1. 以 root Linux 账户身份执行以下命令,使用 Makefile.install 先决条件安装程序安装先决条件,将下面的 替换为 debian-bookworm、debian-bullseye、debian-buster、ubuntu-jammy 或 ubuntu-noble:

[source, bash]

make -f Open-ILS/src/extras/Makefile.install

[[optional_developer_additions]] 3. 可选:开发者附加内容 + 要从 Git 源代码检出执行某些开发者任务,需要额外的包。以 root Linux 账户身份: +

  • 要安装检索和管理 Web 依赖项所需的包,请使用 -developer Makefile.install 目标。目前,这仅用于构建和安装 Web 员工客户端。
  • 要选择性地运行 Angular 和 AngularJS 测试,您需要手动安装 Firefox 和 Chromium 或 Chrome。

[source, bash]

make -f Open-ILS/src/extras/Makefile.install -developer

  • 要安装构建 Evergreen 翻译所需的包,请使用 -translator Makefile.install 目标。

[source, bash]

make -f Open-ILS/src/extras/Makefile.install -translator

  • 要安装构建 Evergreen 发布包所需的包,请使用 -packager Makefile.install 目标。

[source, bash]

make -f Open-ILS/src/extras/Makefile.install -packager

== Web 员工客户端的额外步骤 ==

[注意] 如果您使用从 http://evergreen-ils.org/downloads 下载的官方发布 tarball,请跳过本节。否则,请确保您已安装xref:#optional_developer_additions[可选的开发者附加内容]后再继续。

[[install_files_for_web_staff_client]] === 为 Web 员工客户端安装 AngularJS 文件 ===

  1. 构建、测试、压缩:以下所有步骤都在员工 JS Web 根目录中进行:

[source,sh]

cd $EVERGREEN_ROOT/Open-ILS/web/js/ui/default/staff/

  1. 安装项目本地依赖项。npm 检查 'package.json' 文件中的依赖项,并从 Node 包网络获取它们。

[source,sh]

npm install # 获取 JS 依赖项

  1. 运行构建脚本。

[source,sh]

npm run build-prod

  1. 可选:如果安装了 -developer 包和必要的浏览器,则测试 Web 客户端代码。 CHROME_BIN 应设置为 chrome 或 chromium 的路径,例如 /usr/bin/chromium:

[source,sh]

CHROME_BIN=/path/to/chrome npm run test

[[install_files_for_angular_web_staff_client]] === 为 Web 员工客户端安装 Angular 文件 ===

  1. 构建、测试、压缩:以下所有步骤都在 Angular 员工根目录中进行:

[source,sh]

cd $EVERGREEN_ROOT/Open-ILS/src/eg2/

  1. 安装项目本地依赖项。npm 检查 'package.json' 文件中的依赖项,并从 Node 包网络获取它们。

[source,sh]

npm install # 获取 JS 依赖项

  1. 运行构建脚本。

[source,sh]

ng build --configuration=production

这可能是一个内存密集型构建。如果进程没有完成,并且您在控制台中收到 "Killed" 消息,请尝试使用 https://nodejs.org/api/cli.html#cli_max_old_space_size_size_in_megabytes[显式的 max-old-space-size 选项] 运行它,以鼓励更多的垃圾回收。例如,在内存为 4GB 的机器上,您可以将 max-old-space-size 限制为 3GB: + [source,sh]

NODE_OPTIONS=--max-old-space-size=3072 ng build --configuration=production

  1. 可选:如果安装了 -developer 包和必要的浏览器,则测试 eg2 Web 客户端代码: CHROME_BIN 应设置为 chrome 或 chromium 的路径,例如 /usr/bin/chromium:

[source,sh]

CHROME_BIN=/path/to/chrome npm run test MOZ_HEADLESS=1 ng e2e

[[install_opac_deps]] === 安装 OPAC 皮肤依赖项 ===

  1. 以下步骤在 OPAC 依赖项根目录中进行:

[source,sh]

cd $EVERGREEN_ROOT/Open-ILS/web/opac/deps

  1. 安装项目本地依赖项。npm 检查 'package.json' 文件中的依赖项,并从 Node 包网络获取它们。

[source,sh]

npm install # 获取 JS 和 CSS 依赖项

请注意,这里没有构建步骤。

  1. 可选:测试 OPAC JavaScript 代码:

[source,sh]

npm run test

== 配置和编译说明 ==

目前,我们仍将所有内容安装在 /openils/ 目录中。从 Evergreen 源目录,以 user Linux 账户身份执行以下命令来配置和构建 Evergreen:

[source, bash]

PATH=/openils/bin:$PATH ./configure --prefix=/openils --sysconfdir=/openils/conf make

这些说明假设您也已经在 /openils/ 下安装了 OpenSRF。 如果没有,请根据需要调整 PATH,以便 Evergreen 的 configure 脚本可以找到 osrf_config。

== 安装说明 ==

  1. 配置和编译 Evergreen 后,以 root Linux 账户身份执行以下命令来安装 Evergreen 并将示例配置文件复制到 /openils/conf。

[source, bash]

make install

== 更改 Evergreen 文件的所有权 ==

/openils/ 目录及其子目录中的所有文件必须由 opensrf 用户拥有。以 root Linux 账户身份执行以下命令来更改文件的所有权:

[source, bash]

chown -R opensrf:opensrf /openils

== 运行 ldconfig ==

在 Ubuntu 或 Debian 上,以 root 用户身份运行以下命令:

[source, bash]

ldconfig

== 开发者附加说明 ==

[注意] 如果您使用从 http://evergreen-ils.org/egdownloads 下载的官方发布 tarball,请跳过本节

直接使用 Git 仓库中的源代码而非官方发布 tarball 的开发者需要安装 Dojo Toolkit JavaScript 库集。适当版本的 Dojo 包含在 Evergreen 发布 tarball 中。开发者应通过以 opensrf Linux 账户身份执行以下命令来安装 Dojo 1.3.3 版本: [source, bash]

wget http://download.dojotoolkit.org/release-1.3.3/dojo-release-1.3.3.tar.gz tar -C /openils/var/web/js -xzf dojo-release-1.3.3.tar.gz cp -r /openils/var/web/js/dojo-release-1.3.3/* /openils/var/web/js/dojo/.

== 配置Apache Web服务器 ==

. 使用示例配置文件来为Evergreen目录、Web员工客户端、Web服务和管理接口配置Web服务器。以Linux的root用户执行以下命令: + [source,bash]

cp Open-ILS/examples/apache_24/eg_24.conf /etc/apache2/sites-available/eg.conf cp Open-ILS/examples/apache_24/eg_vhost_24.conf /etc/apache2/eg_vhost.conf cp Open-ILS/examples/apache_24/eg_startup /etc/apache2/

现在设置SSL

mkdir /etc/apache2/ssl cd /etc/apache2/ssl

. openssl命令为Apache服务器生成一个新的SSL密钥。对于生产服务器,您应该购买一个签名的SSL证书,但在测试和开发过程中,您可以使用自签名证书并接受浏览器中的警告。以Linux的root用户执行以下命令为Apache服务器创建SSL密钥: + [source,bash]

openssl req -new -x509 -days 365 -nodes -out server.crt -keyout server.key

. 以Linux的root用户身份编辑您复制的eg.conf文件。 a. 要从任何网络上的任何工作站启用对离线上传/执行接口的访问,请进行以下更改(注意,您必须对生产实例进行安全设置): * 将Require host 10.0.0.0/8替换为Require all granted . 更改Apache服务器的用户。

  • 以Linux的root用户身份,编辑 /etc/apache2/envvars。将export APACHE_RUN_USER=www-data更改为 export APACHE_RUN_USER=opensrf。 . 以Linux的root用户身份,为Evergreen配置适当的KeepAlive设置。 更高的值可以通过允许在同一TCP连接上发送多个请求来提高单个客户端的性能,但会增加使用所有可用Apache子进程和内存的风险。
  • 编辑/etc/apache2/apache2.conf。 a. 将KeepAliveTimeout更改为1。 b. 将MaxKeepAliveRequests更改为100。 . 以Linux的root用户身份,配置prefork模块以启动并保持足够的Apache服务器可用,以便快速响应客户端而不会耗尽内存。以下设置是向Web公开默认Evergreen目录的站点的良好起点:

./etc/apache2/mods-available/mpm_prefork.conf [source,bash]

StartServers 15 MinSpareServers 5 MaxSpareServers 15 MaxRequestWorkers 75 MaxConnectionsPerChild 500 ------------------------------------------------------------------------------ + . 以*root*用户身份,启用mpm_prefork模块: + [source,bash] ------------------------------------------------------------------------------ a2dismod mpm_event a2enmod mpm_prefork ------------------------------------------------------------------------------ + . 以Linux的*root*用户身份,启用Evergreen站点: + [source,bash] ------------------------------------------------------------------------------ a2dissite 000-default # 可选:禁用默认站点("It Works"页面) a2ensite eg.conf ------------------------------------------------------------------------------ + . 以Linux的*root*用户身份,允许Apache写入 锁定目录;这当前是必要的,因为Apache 正以`opensrf`用户身份运行: + [source,bash] ------------------------------------------------------------------------------ chown opensrf /var/lock/apache2 ------------------------------------------------------------------------------

在以下章节中了解更多关于其他Apache选项的信息:

  • xref:admin:apache_rewrite_tricks.adoc#apache_rewrite_tricks[Apache重写技巧]
  • xref:admin:apache_access_handler.adoc#apache_access_handler_perl_module[Apache访问处理程序Perl模块]

== 为Evergreen应用程序配置OpenSRF ==

在/openils/conf/中有许多OpenSRF配置文件示例,您可以将其用作Evergreen安装的模板。以Linux的opensrf用户执行以下命令:

[source, bash]

cp -b /openils/conf/opensrf_core.xml.example /openils/conf/opensrf_core.xml cp -b /openils/conf/opensrf.xml.example /openils/conf/opensrf.xml

当您安装OpenSRF时,您在两个单独的域上创建了四个Jabber用户,并相应地编辑了opensrf_core.xml文件。请参考OpenSRF README,并以Linux的opensrf用户身份,使用与安装和测试OpenSRF时相同的Jabber用户和域编辑Evergreen版本的opensrf_core.xml文件。

=== 可选:为OpenSRF+Redis配置Evergreen

如果使用OpenSRF的Redis变体,请修改/openils/conf/opensrf_core.xml 以使用Redis设置而不是Ejabberd设置。

文件的几个部分有2个配置块,一个用于Ejabberd, 一个用于Redis。例如:

[source,xml]

password
5222

对于每次出现这样的块,注释掉Ejabberd部分 并取消注释Redis部分。例如:

[source,xml]

456fc340-beba-4489-9070-0d6b49e9952b
6379

[注意] -b标志告诉cp命令创建目标文件的备份版本。目标文件的备份版本的文件名后附加了波浪号(~),因此如果您忘记了Jabber用户和域,可以从文件的备份版本中检索设置。

eg_db_config,在xref:#creating_the_evergreen_database[创建Evergreen数据库]中描述,会为您在opensrf.xml中设置数据库连接信息。

=== 为Evergreen应用程序配置操作触发器 === _操作触发器_为系统提供钩子,以便在发生给定事件时执行操作;例如,要生成提醒或逾期通知, 系统会处理checkout.due钩子,如果没有还书时间,则会触发潜在操作的事件。

要启用默认的钩子集,请以Linux的opensrf用户执行以下命令:

[source, bash]

cp -b /openils/conf/action_trigger_filters.json.example /openils/conf/action_trigger_filters.json

有关配置和运行操作触发器的更多信息,请参阅 xref:admin:actiontriggers_process.adoc#processing_action_triggers[通知/操作触发器]。

[[creating_the_evergreen_database]] == 创建Evergreen数据库 ==

=== 设置PostgreSQL服务器 ===

对于生产使用,大多数图书馆在专用机器上安装PostgreSQL数据库服务器。因此,默认情况下,Makefile.install先决条件安装程序不安装每个Evergreen系统所需的PostgreSQL数据库服务器。您可以使用以下命令在您选择的机器上安装Debian或Ubuntu所需的包,以Linux的root用户执行:

.安装PostgreSQL服务器包

每个操作系统构建目标都提供了每个操作系统所需的postgres服务器安装包。要安装Postgres服务器包,请使用make目标'postgres-server--'。根据您的操作系统和所需的PostgreSQL版本,选择下面最合适的命令。

以下第一个命令将安装PostgreSQL 10,这是最低支持版本,也是推荐用于Evergreen生产环境的版本:

[source, bash]

make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-10 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-10 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-10 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-10 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-10

[警告]

Evergreen对高于10版本的PostgreSQL服务器的支持仍处于实验阶段。不建议在生产环境中使用以下内容。只有在您愿意测试更新的PostgreSQL版本的性能和可能的错误时,才建议使用以下内容。

要安装PostgreSQL 11版本,请根据您的操作系统使用以下命令: [source, bash]

make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-11 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-11 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-11 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-11 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-11

要安装PostgreSQL 12版本，请根据您的操作系统使用以下命令：

[警告]

PostgreSQL 12+包含一个名为"JIT"（即时编译）的功能。 请勿开启Postgres的JIT功能。Evergreen的查询，尤其是用于搜索的复杂查询，是专门为非JIT执行而优化的，在某些情况下JIT已被证明是有害的。 建议对postgresql.conf进行的最小调整： jit_above_cost = -1

[source, bash]

make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-12 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-12 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-12 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-12 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-12

要安装PostgreSQL 13版本，请根据您的操作系统使用以下命令：

[警告]

PostgreSQL 12+包含一个名为"JIT"（即时编译）的功能。 请勿开启Postgres的JIT功能。Evergreen的查询，尤其是用于搜索的复杂查询，是专门为非JIT执行而优化的，在某些情况下JIT已被证明是有害的。 建议对postgresql.conf进行的最小调整： jit_above_cost = -1

[source, bash]

make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-13 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-13 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-13 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-13 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-13

要安装PostgreSQL 14版本，请根据您的操作系统使用以下命令：

[警告]

PostgreSQL 12+包含一个名为"JIT"（即时编译）的功能。 请勿开启Postgres的JIT功能。Evergreen的查询，尤其是用于搜索的复杂查询，是专门为非JIT执行而优化的，在某些情况下JIT已被证明是有害的。 建议对postgresql.conf进行的最小调整： jit_above_cost = -1

[source, bash]

make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-14 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-14 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-14 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-14 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-14

要安装PostgreSQL 15版本，请根据您的操作系统使用以下命令：

[警告]

PostgreSQL 12+包含一个名为"JIT"（即时编译）的功能。 请勿开启Postgres的JIT功能。Evergreen的查询，尤其是用于搜索的复杂查询，是专门为非JIT执行而优化的，在某些情况下JIT已被证明是有害的。 建议对postgresql.conf进行的最小调整： jit_above_cost = -1

[source, bash]

make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-15 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-15 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-15 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-15 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-15

要安装PostgreSQL 16版本，请根据您的操作系统使用以下命令：

[警告]

PostgreSQL 12+包含一个名为"JIT"（即时编译）的功能。 请勿开启Postgres的JIT功能。Evergreen的查询，尤其是用于搜索的复杂查询，是专门为非JIT执行而优化的，在某些情况下JIT已被证明是有害的。 建议对postgresql.conf进行的最小调整： jit_above_cost = -1

[source, bash]

make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-16 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-16 make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-16 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-16 make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-16

创建Evergreen PostgreSQL用户

您需要创建一个PostgreSQL超级用户来创建和访问数据库。以postgres Linux账户身份执行以下命令，创建一个名为evergreen的新PostgreSQL超级用户。当提示时，输入新用户的密码：

[source, bash]

createuser -s -P evergreen

启用与PostgreSQL数据库的连接

您的PostgreSQL数据库可能默认配置为阻止连接，例如，它可能拒绝通过TCP/IP或来自其他服务器的连接尝试。要启用来自localhost的TCP/IP连接，请检查您的pg_hba.conf文件，该文件在Debian和Ubuntu上位于/etc/postgresql/目录中。 一个简单的方法是通过密码认证启用来自localhost到所有数据库的TCP/IP连接，这适用于在单台服务器上测试安装Evergreen，确保文件在任何"host ... ident"条目之前包含以下条目：

host all all ::1/128 md5 host all all 127.0.0.1/32 md5

当您更改pg_hba.conf文件时，您需要重新加载PostgreSQL以使更改生效。有关配置PostgreSQL连接的更多信息，请参阅 http://www.postgresql.org/docs/devel/static/auth-pg-hba-conf.html

=== 创建Evergreen数据库和模式 ===

创建evergreen PostgreSQL账户后，您还需要创建数据库和模式，并配置您的配置文件以指向数据库服务器。以root Linux账户身份从Evergreen源目录内执行以下命令，将、、、和替换为您的PostgreSQL数据库的适当值（其中和是您刚刚创建的evergreen PostgreSQL账户的值），并将和替换为您想要为egadmin Evergreen管理员账户设置的值：

[source, bash]

perl Open-ILS/src/support-scripts/eg_db_config --update-config
--service all --create-database --create-schema --create-offline
--user --password --hostname --port
--database --admin-user --admin-pass

这将创建数据库和模式，并配置您的/openils/conf/opensrf.xml配置文件中的所有服务以指向该数据库。它还创建Evergreen cgi-bin管理脚本所需的配置文件，并将egadmin Evergreen管理员账户的用户名和密码设置为您请求的值。

您可以通过传递--help参数获取eg_db_config的完整选项列表。

=== 加载示例数据 ===

如果您在eg_db_config命令中添加--load-all-sample参数，一组权威记录和书目记录、索书号、副本、工作人员和普通用户以及交易将被加载到您的目标数据库中。这个示例数据集通常被称为_concerto_示例数据，可用于测试Evergreen功能，并为开发人员创建可以轻松重现的问题报告，他们可以使用自己的_concerto_示例数据副本。

如果您不介意多等一会儿，可以安装_enhanced_ concerto数据集。使用这个标志：--load-concerto-enhanced。这包括_concerto_中的所有数据。主要区别包括：

. 组织单位有友好的名称 . 采购数据 . 更多的计费场景 . 更多的架位位置和架位位置设置 . 权威数据 . 日语、西班牙语、法语和捷克语书目记录 . 元记录预约 . 馆藏统计类别 . 预订数据 . 预创建的OPAC轮播 . 期刊数据

=== 在远程服务器上创建数据库 ===

在Evergreen的生产实例中，您的PostgreSQL服务器应该安装在专用服务器上。

要在远程数据库服务器上创建数据库实例，只需在eg_db_config上使用--create-database标志。

== 启动Evergreen ==

  1. 作为Linux的root用户，启动memcached和ejabberd服务（如果它们尚未运行）：

[source, bash]

/etc/init.d/ejabberd start /etc/init.d/memcached start

  1. 作为Linux的opensrf用户，启动Evergreen。以下命令中的-l标志仅在需要强制Evergreen将主机名视为localhost时才需要；如果您使用perl -ENet::Domain 'print Net::Domain::hostfqdn() . "\n";'返回的真实机器主机名配置了opensrf.xml，则不应使用-l标志。

[source, bash]

osrf_control -l --start-all

** 如果收到错误消息bash: osrf_control: 未找到命令，则表示您的环境变量PATH中不包含/openils/bin目录；这应该已在opensrf Linux账户的.bashrc配置文件中设置。要手动设置PATH变量，请以opensrf Linux账户编辑配置文件~/.bashrc并添加以下行：

[source, bash]

export PATH=$PATH:/openils/bin

  1. 作为Linux的opensrf用户，生成Web工作人员客户端和目录所需的Web文件，并更新组织单位的邻近性（首次启动Evergreen时需要执行此操作，之后每次更改图书馆组织单位配置时也需要执行）：

[source, bash]

autogen.sh

  1. 作为Linux的root用户，重启Apache Web服务器：

[source, bash]

/etc/init.d/apache2 restart

如果在启动OpenSRF服务时Apache Web服务器正在运行，您可能无法成功登录OPAC或Web工作人员客户端，直到重启Apache Web服务器。

== 测试与Evergreen的连接 ==

安装并启动Evergreen后，通过srfsh测试与Evergreen的连接。作为Linux的opensrf用户，执行以下命令启动srfsh，并尝试使用您通过eg_db_config命令设置的egadmin Evergreen管理员用户名和密码登录Evergreen服务器：

[source, bash]

/openils/bin/srfsh srfsh% login

您应该看到类似以下的结果：

Received Data: "250bf1518c7527a03249858687714376"
------------------------------------
Request Completed Successfully
Request Time in seconds: 0.045286
------------------------------------

Received Data: {
   "ilsevent":0,
   "textcode":"SUCCESS",
   "desc":" ",
   "pid":21616,
   "stacktrace":"oils_auth.c:304",
   "payload":{
      "authtoken":"e5f9827cc0f93b503a1cc66bee6bdd1a",
      "authtime":420
   }

}

------------------------------------
Request Completed Successfully
Request Time in seconds: 1.336568
------------------------------------

如果这不起作用，就该进行一些故障排除了。

  • 作为Linux的opensrf用户，运行settings-tester.pl脚本，查看是否发现任何系统配置问题。该脚本位于Evergreen源代码树中的Open-ILS/src/support-scripts/settings-tester.pl。
  • 按照故障排除指南中的步骤进行操作。
  • 如果您已忠实地遵循此处列出的所有安装步骤，您可能已经非常接近一个正常工作的系统。收集您的配置文件和日志文件，并在对系统配置做出任何重大更改之前，联系Evergreen开发邮件列表寻求帮助。

== 获取帮助 ==

需要安装或使用Evergreen的帮助？加入http://evergreen-ils.org/communicate/mailing-lists/的邮件列表，或在Freenode IRC网络的#evergreen频道联系我们。

== 许可证 ==

本作品采用知识共享署名-相同方式共享3.0未本地化版本许可协议授权。要查看该许可证的副本，请访问http://creativecommons.org/licenses/by-sa/3.0/或致信Creative Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA。

相关项目
项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手，通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能，支持100+编程语言，与主流编辑器无缝集成，显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台，能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐，Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案，通过智能技术简化视频制作流程。无论是企业宣传还是个人分享，有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持，能够阅读和理解用户上传的文件内容，解析网页信息，并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题，Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术，为商家提供一键生成商品图和营销文案的服务，显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台，让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型，免费访问各种图像生成与AI训练工具，从Stable Diffusion等基础模型开始，轻松实现创新图像生成。体验前沿的AI技术，推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器，它将改变您观看视频的方式！SubCat结合了先进的人工智能技术，为您提供即时视频字幕翻译，无论是本地视频还是网络流媒体，让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台，利用前沿AI技术，为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图，再到文案生成，美间让创意设计更简单、更高效。

Project Cover

稿定AI

稿定设计 是一个多功能的在线设计和创意平台，提供广泛的设计工具和资源，以满足不同用户的需求。从专业的图形设计师到普通用户，无论是进行图片处理、智能抠图、H5页面制作还是视频剪辑，稿定设计都能提供简单、高效的解决方案。该平台以其用户友好的界面和强大的功能集合，帮助用户轻松实现创意设计。

使用协议隐私政策广告服务
投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号