安装和管理 AnswerBook2 服务器 - zh

配置文档服务器

如要查看当前服务器配置,请从 AnswerBook2 管理页选择查看当前配置。更改这些设置,请从 AnswerBook2 管理页选择修改服务器配置。

查看文档服务器配置

查看当前配置页列出显示在 表 3-1表 3-2中的设置。这些设置存储在server_config_path/dwhttpd.cfg 文件中(默认为 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg)。


注意:

如果您正在运行一个基于 CGI的服务器,而不是默认的基于NSAPI的服务器,在 AnswerBook2 管理页界面中只有一些服务器配置是可见的。若想获得更多信息,请参阅 "以CGI进程运行服务器时的配置问题"


表 3-1 用户可配置的服务器配置设定

标签 

默认值和描述 

服务器名称 

默认:本地主机名 (例如:imaserver)。这是客户用于访问此服务器的文档名称。为加快响应时间,请输入一个完全限定的名称(例如:imaserver.eng.sun.com)。如果您期望您域外的用户访问此文档服务器,您必须输入完全限定的名称。

服务器端口 

默认: 8888。这是通信端口号。尽管推荐您使用默认值,您仍可选择任何未使用过的端口号。

最大线程 

默认: 32。这是服务器可执行的最大并行AnswerBook1查找数。如果您有许多AnswerBook1 集合,且用户经常查询它们,您可能想增大此数。可是,如您增大此数,服务器响应会减慢。

最大服务器请求 

默认: 1024。这告诉服务器执行"管家"操作并可在特定数量的http 请求后自行启动。

访问文件 

默认:/var/log/ab2/logs/access-8888.log。这是一个完整的访问记录路径名,此访问记录包含本地服务器的每一访问的有关信息。

错误文件 

默认: /var/log/ab2/logs/error-8888.log。 这是一个完整的错误记录路径名,此错误记录包含所有发生的错误信息。

管理访问控制 

默认: 。 这告诉您是否控制谁能在此服务器上访问管理功能。当您第一次安装一个文档服务器,尽管管理访问控制已打开,但未定义默认用户名和口令。有关设置初始管理访问的信息,请参阅"设置初始管理访问"

 重新启动后自动起动AnswerBook2

默认: 。 这确定在您重新启动系统时是否自动起动AnswerBook2 服务器软件。


注意:

文档管理员不应手动更改 表 3-2中所示设置。当您安装服务器软件时,系统将配置这些设置。


表 3-2 固定的服务器配置设置

标签 

默认值和描述 

服务器配置路径 

默认: /usr/lib/ab2/dweb/data/config

这是服务器配置文件存储位置的路径名。 

服务器用户 

默认: 守护程序

这是服务器进程的拥有者。更改此变量值将会对此服务器的运行和集合访问造成严重问题。 

插件文件 

默认: /usr/lib/ab2/dweb/data/config/nsapi.cfg

这是一个定义所有服务器插件的文件的完整路径名。 

Mime 文件 

默认 /usr/lib/ab2/dweb/data/config/mime.types

这是一个定义所有 MIME 信息的文件的完整路径名。 

Doc 根 

默认: /usr/lib/ab2/data/docs

这是此服务器文档文件所存储位置的路径名。 

记录目录 

默认: /var/log/ab2/logs

这是此服务器记录文件所存储位置的路径名。 

AnswerBook1 集合数据库 

默认: /var/log/ab2/catalog/ab1_cardcatalog

此文件识别已安装在此服务器上的AnswerBook1集合。 

AnswerBook2 集合数据库 

默认: /usr/lib/ab2/dweb/data/config/ab2_collections.template

此文件识别已安装在此服务器上的AnswerBook2集合。 

您也可以用下面的命令查看当前服务器配置:


% /usr/lib/ab2/bin/ab2admin -o view_config [-m server_name] [-p server_port]

更改文档服务器配置

当您安装 AnswerBook2 服务器软件,某些变量会被设置成默认值。用修改服务器配置页中的字段来更改这些值。您能更改下表所列的服务器的设置:

表 3-3 修改服务器配置

服务器名称 

当您安装文档服务器,AnswerBook2 自动将此变量设为当前主机名(例如,cats)。如果您期望您域外的用户访问此文档服务器,您必须更改为完整的有效名称。(例如, cats.house.pets.com)。

服务器端口号 

如要为AnswerBook2服务器使用不同于8888的端口,请在此字段输入端口号。如要使用低于1024的端口号,您需执行一些额外步骤。若想了解更多信息,请参阅 "使用低于1024的端口号"

最大线程 

这是服务器可执行的最大并行AnswerBook1查找数。如果您有许多AnswerBook1 集合,且用户经常查询它们,您可能想增大此数。可是,如您增大此数,服务器响应会减慢。 

最大服务器请求 

这告诉服务器执行"管家"操作并自行启动频繁程度。此数指示向服务器提出的http 请求数。

访问记录文件 

单击适当的项目以打开或关闭访问记录。如果您预期许多用户将访问您的文档服务器,您可能要周期性地保存并重新启动此记录文件。有关旋转访问记录文件的更多信息,请参阅 "旋转记录文件"

错误记录文件 

单击适当的项目以打开或关闭访问记录。如果您经历许多服务器错误,您可能要周期性地保存并重新启动此记录文件。有关旋转访问错误记录文件的更多信息,请参阅 "旋转记录文件"

管理访问控制 

单击适当的项目以打开或关闭管理访问控制。当访问控制打开时,只有已被定义管理访问的用户才能为此服务器执行管理功能。 

系统重新启动后自动起动 AnswerBook2 服务器 

单击适当项目,打开或关闭此功能。 

这些功能也可以通过管理命令行界面(ab2admin)得到。 有关命令行界面的详细信息,请参阅 附录 A,ab2admin(1M) 手册页。 您也可以编辑 server_config_path/dwhttpd.cfg 文件(默认为 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg) 以更改这些值。


注意:

如果您更改这些值中的任意一个,您必须停止和起动文档服务器。以 根用户 在服务器登录并键入下面的命令:


# /usr/lib/ab2/bin/ab2admin -o stop# 
/usr/lib/ab2/bin/ab2admin -o start

使用低于1024的端口号

低于1024的端口号是为系统保留使用的。如要为AnswerBook2服务器选用其中之一(例如,端口号80),请执行下面的步骤:

  1. 使用 AnswerBook2 管理页中的修改配置设置功能或编辑 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg 文件,并将服务器的端口号更改为 80

  2. 编辑 /usr/lib/ab2/dweb/data/config/nsapi.cfg 文件,并将服务器的端口号更改为 80

    您应当有类似于下面的一行:


    set ServerPort 80
  3. 编辑 /etc/init.d/ab2mgr 文件并将下面一行从 守护程序 更改为 根用户


    su daemon -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

    为:


    su root -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

    这运许父 dwhttpd 进程以 根用户运行,则可用端口80。注意,子 dwhttpd 进程还是以 守护程序运行。

以CGI进程运行服务器时的配置问题

由于AnswerBook2服务器遵循标准万维网协议,您能在现有的服务器上以CGI进程运行AnswerBook2服务器,而不是默认的NSAPI服务器。有关如何配置您的服务器以实现这种运行方式,请参阅 "将 AnswerBook2 服务器以CGI 进程运行"

如果您以CGI进程运行服务器,下面的配置设置将不会显示在 AnswerBook2 管理页的查看配置设置页上:

修改服务器配置页上提供的唯一选项将是打开或关闭访问控制。其它所有功能将不被显示。

ab2admin 命令的下面选项将不会工作: