= 安装 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 之前安装这些包。

首先安装最新版本的 OpenSRF (3.3.0 或更高版本)。您可以从 http://evergreen-ils.org/opensrf-downloads/ 下载 OpenSRF 发布版

以 root Linux 账户身份执行以下命令,使用 Makefile.install 先决条件安装程序安装先决条件,将下面的 <osname> 替换为 debian-bookworm、debian-bullseye、debian-buster、ubuntu-jammy 或 ubuntu-noble:

[source, bash]

make -f Open-ILS/src/extras/Makefile.install <osname>

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

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

[source, bash]

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

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

[source, bash]

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

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

[source, bash]

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

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

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

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

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

[source,sh]

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

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

[source,sh]

npm install # 获取 JS 依赖项

运行构建脚本。

[source,sh]

npm run build-prod

可选:如果安装了 <osname>-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 文件 ===

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

[source,sh]

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

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

[source,sh]

npm install # 获取 JS 依赖项

运行构建脚本。

[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

可选:如果安装了 <osname>-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 皮肤依赖项 ===

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

[source,sh]

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

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

[source,sh]

npm install # 获取 JS 和 CSS 依赖项

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

可选:测试 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。

== 安装说明 ==

配置和编译 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]

<IfModule mpm_prefork_module> StartServers 15 MinSpareServers 5 MaxSpareServers 15 MaxRequestWorkers 75 MaxConnectionsPerChild 500 </IfModule> ------------------------------------------------------------------------------ + . 以*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]

<passwd>password</passwd>
<port>5222</port>

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

[source,xml]

[注意] -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-<OSTYPE>-<POSTGRESVERSION>'。根据您的操作系统和所需的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源目录内执行以下命令，将<user>、<password>、<hostname>、<port>和<dbname>替换为您的PostgreSQL数据库的适当值（其中<user>和<password>是您刚刚创建的evergreen PostgreSQL账户的值），并将<admin-user>和<admin-pass>替换为您想要为egadmin Evergreen管理员账户设置的值：

[source, bash]

perl Open-ILS/src/support-scripts/eg_db_config --update-config
--service all --create-database --create-schema --create-offline
--user <user> --password <password> --hostname <hostname> --port <port>
--database <dbname> --admin-user <admin-user> --admin-pass <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 ==

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

[source, bash]

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

作为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

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

[source, bash]

autogen.sh

作为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 <admin-user> <admin-pass>

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

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。