第 3 章 管理一个 AnswerBook2 服务器

管理 AnswerBook2 软件包括执行下面的功能，每一项功能又包括具体任务：

• "管理文档服务器"

• "起动及停止文档服务器"

• "打开或关上文档源调试"

• "控制管理访问"

• "操作文档集合"

• "查看文档服务器配置"

• "操作其它的文档服务器"

• "操作服务器报告"

• "通用管理页浏览功能"

管理文档服务器

AnswerBook2 软件提供一个网络浏览器界面 (AnswerBook2 管理页) 和一个命令行界面 (ab2admin)，您能用于管理文档服务器。大部分功能在任一界面中均可用。

如果文挡服务器从CD-ROM 运行，则管理功能均不能用。

如要访问主要的 AnswerBook2 管理页，请从 AnswerBook2 浏览器的选项页选择 AnswerBook2 管理，或访问URL： http://server:port/ab2/@Ab2Admin，其中server 是您服务器的名称，而 port 是服务器运行所在的端口 。 管理页中的所有页，在其横跨屏幕顶端的位置都包括通用页浏览功能。

如要访问命令行界面，请使用/usr/lib/ab2/bin/ab2admin 命令。有关命令行界面的详细信息，请参阅附录 A，ab2admin(1M) 手册页。

只有授权管理用户能够访问管理功能。若想了解更多信息，请参阅 "控制管理访问"。

起动及停止文档服务器

当您启动文档服务器正在运行的系统，服务器会自动起动 ( 通过 /etc/init.d/ab2mgr 正文)。 如有必要，您也可以手动启动、停止和重新启动文档服务器。例如，您安装一个新的文档集合后，必须重新启动文档服务器。

如要执行这些功能，请以 根用户 在文档服务器机器上登录，并使用 ab2admin 命令行界面。

• 如要起动文档服务器，请使用下面的命令：

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

• 如要停止文档服务器，请使用下面的命令：

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

• 如要重新启动文档服务器，请使用下面的命令：

  # /usr/lib/ab2/bin/ab2admin -o restart

  如果重新启动服务器没有达到预期效果，停止并起动服务器。

• 如要在调试启用时起动文档服务器，请使用下面形式的启动命令：

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

• 如要防止服务器在系统重新启动时自动起动，请使用本命令：

  # /usr/lib/ab2/bin/ab2admin -o autostart_no

打开或关上文档源调试

AnswerBook2 服务器有调试选项，当被启用时，会将书源中未能识别的标注在查看器中显示为红色字样"BUG"。如果书不能如预期显示，此功将能帮助识别问题。

如要打开调试，请以 根用户 登录文档服务器系统并设置环境变量 AB2_DEBUG 为1。例如：

% su -# 
setenv AB2_DEBUG 1

如要关闭调制，请以 根用户 登录文档服务器系统并设置环境变量 AB2_DEBUG 为0。例如：

% su - 
# setenv AB2_DEBUG 0

在您变更调试参数后，您 必须 重新启动文档服务器。如要重新启动文档服务器，请键入：

# /usr/lib/ab2/bin/ab2admin -o restart

如要在启动服务器时控制调试，请使用下面形式的启动命令：

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

控制管理访问

管理用户是为执行文档管理功能特殊定义的一个用户。AnswerBook2 产品用口令确认是否允许某一特定管理员在服务器上执行管理功能。

设置初始管理访问

AnswerBook2 软件带有为执行管理功能所开启的访问控制，但是未定义默认管理员。当您第一次试图访问 AnswerBook2 管理功能时，软件将告诉您访问控制已开启，但没有定义用户。此时您可以进行下列两项操作中的其中一项：

• 关闭访问控制。

  如要关闭访问控制，请以 根用户 登录文档服务器并键入如下：

  # /usr/lib/ab2/bin/ab2admin -o auth_off

  ---

  小心：

  如果您关闭访问控制，任何能够访问您的文档服务器的用户均可修改您的文档服务器。

  ---

• 定义一个管理用户和口令。

  如要定义一个管理用户，请以 根用户 登录文档服务器并键入如下：

  # /usr/lib/ab2/bin/ab2admin -o add_admin -u admin-id

  其中 admin-id 是管理此文档服务器的登录ID。 admin-id 不一定要与用户的系统登录ID相匹配；它只是用于在一个特定服务器上执行与文档有关的管理功能的ID。

  此软件提示您为此用户输入一个口令，然后重新输入加以确认。

为AnswerBook2 管理员添加访问

如要添加一个管理用户，请从 AnswerBook2 管理页选择添加管理员。如要添加管理用户：

1. 请在管理员ID字段中键入管理员的登录 ID。

   admin-id 不一定要与用户的系统登录ID相匹配；它只是用于在一个特定服务器上执行与文档有关的管理功能的ID。

2. 为管理员键入一个口令。

   此口令存储在一个 AnswerBook2 口令数据库中。不一定要与用户的系统口令相匹配。

您需要键入口令两次加以确认。

您也可用下面的命令执行此功能：

% /usr/lib/ab2/bin/ab2admin -o add_admin -u admin-id [-m server_name] [-p server_port]

更改管理员口令

如要更改管理员口令，请从 AnswerBook2 管理页选择更改口令。如要修改口令：

1. 请从管理员ID弹出式列表选择管理用户。

2. 在旧口令字段内键入管理员现有口令。

3. 在新口令字段内键入管理员的新口令。

4. 在重新键入新口令字段内第二次键入管理员的新口令。

5. 单击更改口令以应用此更改。

当您单击更改口令， AnswerBook2 软件检查，看新口令与重新输入新口令字段中输入的数据是否相符。如果是，新口令则被存储在数据库中。如果不相符，软件显示错误。

您也可以用下面的命令执行此功能：

% /usr/lib/ab2/bin/ab2admin -o change_password -u admin-id [-m server_name] [-p server_port]

删除管理员访问

如要从管理用户列表中删除一个用户，请从 AnswerBook2 管理页选择删除管理员。如要删除管理员：

1. 请单击您要从管理员列表删除的管理员登录ID旁的选择框。

   这是管理员的ID，不一定是系统或用户 ID。

2. 单击删除管理员。

   ---

   注意：

   这不影响用户访问 AnswerBook2 文档的能力。它仅删除执行管理功能的能力。

   ---

您也可用下面的命令执行此功能：

% /usr/lib/ab2/bin/ab2admin -o del_admin -u admin-id [-m server_name] [-p server_port]

操作文档集合

AnswerBook2 集合 是一个逻辑书组。例如，您可有一个包括所有 Solaris^TM 面向开发者的书的集合。此集合可能是一个 AnswerBook2 (SGML) 集合或一个 AnswerBook1 (显示 PostScript^TM) 集合。

列出集合

如要查看安装在您服务器上所有集合的列表，请从 AnswerBook2 管理页选择查看现有集合列表。此列表包括 AnswerBook1 集合及 AnswerBook2 集合。

您也可用下面的命令执行此功能：

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

添加新集合

如要向服务器的数据库添加一个新集合，请从 AnswerBook2 管理页选择向列表添加集合。此功能假定集合以已安装软件包存在于您的服务器系统或服务器可以访问的其它系统上。如果集合还未被安装，先用pkgadd 添加集合，然后使用该功能。对于新的集合（例如那些位于 Solaris 2.6 文档 CD上的集合），如果您在服务器上运行 pkgadd 命令，新的集合将会被自动添加到服务器清单。

执行下面的步骤以安装集合：

1. 在集合路径字段中键入一个有效的集合文件路径。

   例如， /opt/answerbooks/english/solaris_2.7/SUNWaman/collinfo。路径必须指向一个包括 AnswerBook2 集合的 collinfo 文件或AnswerBook1集合的 ab_cardcatalog 文件的目录。

2. 单击添加集合。

您也可用下面的命令执行此功能：

% /usr/lib/ab2/bin/ab2admin -o add_coll -d path_to_collection

安装集合后，您 必须 重新启动文档服务器。如要重新启动文档服务器，请在 管理页的状态页中单击重新启动或在命令行键入如下：

# /usr/lib/ab2/bin/ab2admin -o restart

添加现有集合

AnswerBook2 服务器能够扫描您的当前系统以找到本地安装的 AnswerBook1和 AnswerBook2 集合并将它们添加到服务器的数据库中。如要让服务器执行此功能，请从 AnswerBook2 管理页，为本地安装的集合选择扫描。此功能创建并显示在本地系统中找到的所有有效集合的列表。

如要添加集合到服务器的数据库：

1. 请单击您想添加集合旁的选择框。

   旁边没有选择框的集合已经在数据库中。

2. 当您选择了所有您需要的集合，单击添加选定的集合。

如果列表中未能包括安装在本地安装点上的文档集合，确认集合所安装的目录对于 其它用户 有读 访问局限。

您也可用下面的命令执行此功能：

% /usr/lib/ab2/bin/ab2admin -o scan

命令行扫描功能添加它所找到的所有集合；它不允许您选择添加哪些集合。

在您安装了一个集合后，您 必须 重新启动文档服务器。如要重新启动文档服务器，请在 AnswerBook2 管理状态页中单击重新启动或在命令行键入如下：

# /usr/lib/ab2/bin/ab2admin -o restart

删除 AnswerBook2 集合

如要从服务器的数据库删除 AnswerBook2 或 AnswerBook1 集合，请从 AnswerBook2 管理页选择从列表中删除集合。如要删除集合：

1. 请选择您要从集合列表中删除的集合的标题旁的选择框。(如要撤销已选项，请再次单击选择框。)

2. 在您选择了所有您想删除的集合后，单击删除集合。

您也可以用下面的命令执行此功能：

% /usr/lib/ab2/bin/ab2admin -o del_coll -t collection_title

这些功能不会从系统中删除集合包；它们只从服务器数据库中删除集合的条目。如要从系统中删除软件包，请使用 pkgrm 实用程序。

在您删除了一个集合后，您 必须 重新启动文档服务器。如要重新启动文档服务器，请在 AnswerBook2 管理状态页中单击重新启动或在命令行键入如下：

# /usr/lib/ab2/bin/ab2admin -o restart

配置文档服务器

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

查看文档服务器配置

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

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

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

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

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

更改文档服务器配置

当您安装 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 管理页的查看配置设置页上：

• 最大线程

• 最大服务器请求

• 服务器配置路径

• 服务器用户

• 插件文件

• Mime 文件

• Doc 根

• 记录目录

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

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

• -o access_on

• -o access_off

• -o error_off

• -o error_on

• -o modify_server_name

• -o modify_server_port

操作其它的文档服务器

当用户在一个书中单击一个链接，AnswerBook2 产品可以跟随此链接到另一个 AnswerBook2 服务器。如被链接的书存在于当前服务器上，则链接转到该服务器。可是，如果未能在当前服务器上找到书， AnswerBook2 服务器"降转"到任意已定义的替换服务器上。您能使用此功能将文档分配在各个不同的服务器，或创建一个文档备份。

识别替换文档服务器

如要查看哪些替换服务器已被定义，请从 AnswerBook2 管理页选择查看替换服务器列表。这将显示一个当前被识别为"降转"服务器的服务器列表。如果用户在书中单击一个链接，而此书并不在当前服务器上，则 AnswerBook2 产品会检查此列表中的服务器，以找到链接目标。 AnswerBook2 服务器具有一个预定义的 http://docs.sun.com/的替换服务器，这是 Sun 的主文档服务器并含有已发行的 Sun 文档。

对于每一个为当前服务器定义的服务器，此页显示服务器名称、端口号和一个到此服务器上所安装的集合列表的链接。当您单击显示集合列表，您被提示为替换服务器输入管理 ID及口令(如果为替换服务器定义了管理访问控制的话)。换句话讲，没有管理访问您也能添加一个替换服务器，但只有当您拥有管理访问时才能查看替换服务器上的集合列表。

您也可用下面的命令执行此功能：

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

添加替换文档服务器

为使您的当前服务器能够访问位于另一个服务器上的书(出于跟随书之间的链接的目的)，请从 AnswerBook2 管理页选择添加服务器。

1. 在 AnswerBook2 服务器名称字段中键入替换服务器的名称。

2. 在服务器端口号字段中键入替换服务器的 AnswerBook2 端口号。如果您不能肯定您的端口号，请试用 8888 (AnswerBook2 默认端口号)。

3. 单击添加服务器。

   ---

   注意：

   如果您正试图添加的服务器位于您公司的网络之外，则您可能无法添加。这通常是个"防火墙" 问题。

   ---

您也可以用下面的命令执行此功能:

% /usr/lib/ab2/bin/ab2admin -o add_server -M add_server_name -P add_server_port  [
-m server_name] [-p server_port]

删除附加的文档服务器

如要从您的替换服务器列表中删除一个服务器，请从 AnswerBook2 管理页选择删除替换服务器。

1. 从服务器列表选择服务器。

2. 单击删除服务器。

这样就为本地文档服务器从替换服务器列表中删除了服务器。这不会停止被删除的服务器执行文档服务器功能。

您也可以用下面的命令执行此功能：

% /usr/lib/ab2/bin/ab2admin -o del_server -M del_server_name -P del_server_port  [
-m server_name] [-p server_port]

修改替换服务器顺序

当向您的服务器可用的服务器列表添加一个替换服务器时，此替换服务器被添加到服务器顺序底部。此顺序决定您的服务器访问替换服务器以遵循文档链接的顺序。如果用户从库中请求一个给定文档而此文档无法从默认服务器中得到，则服务器以已定义的顺序搜查替换服务器列表，以找到该文档。

如要更改您系统可用服务器的顺序，请从 AnswerBook2 管理页选择修改服务器顺序。

1. 从服务器列表中选择一个服务器。

2. 单击在列表中向上移动或在列表中向下移动。

3. 单击移动。

没有用来执行此功能的命令行选项。

操作服务器报告

AnswerBook2 服务器软件对显示服务器错误及访问的记录进行维护。此外，它提供一份摘要报告，此报告显示文档集合被访问的频繁程度及发生的错误数量。

书访问摘要报告

如要查看在服务器上访问书摘要，请从 AnswerBook2 管理页选择查看书访问摘要。此书访问报告总结服务器上每一个书被访问的频繁程度。对于服务器上每一个书，其显示如下：

• 书名-如库页所显示的书名

• 书短名称-如配置文件所识别的书短名称

• 集合名称-为书所属的集合短名称，正如 collinfo 文件所识别的

• 命中-书被访问次数

• 错误-与书相关联的错误次数

访问记录文件

如要打开或关闭访问记录，请从 AnswerBook2 管理页选择修改服务器配置。

• 如要将有关谁在访问文档服务器信息的信息写入访问记录文件，请单击开旁边的按钮，然后单击应用。文件的默认位置为 /var/log/ab2/logs/access-8888.log。

• 如要停止将信息写入访问记录文件，请单击关旁边的按钮，然后单击应用。

您也可以用下面的命令执行这些功能：

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

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

更改记录功能之后，您 必须 停止并起动文档服务器。以 根用户 登录服务器并键入下面的命令：

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

查看访问记录

如要查看访问记录文件，请从 AnswerBook2 管理页选择查看记录文件，然后单击查看访问记录文件。访问记录文件是一个列出每一个对此文档服务器所进行的访问的文本文件。访问记录的每一行与下面的类似：

129.146.83.55 - - [04/Nov/1996:15:07:05 -0800] "GET /icons/ab2_curr_home.gif HTTP/1.0" 200 1938

其中：

• 第一组数字是用户的 IP (因特网协议)地址。例如，129.146.83.55。

• 方括弧内的信息是访问的日期和时间。例如， [04/Nov/1996:15:07:05 -0800] 。

• 双引号间的信息告诉您发生了什么访问。这通常识别一个URL或文件名，以及用于响应访问请求的协议。例如， "GET /icons/ab2_curr_home.gif HTTP/1.0" 告诉您访问是去用HTTP 1.0协议索取文件 /icons/ab2_curr_home.gif 。

• 倒数第二个数字指明访问是成功 (200) 还是没成功(任何其它)。

• 最后一个数字指示任何返回给请求者的信息的大小（以千字节为单位）。例如，1938 指示检索到的 .gif 文件的大小。

您也可以用下面的命令执行此功能：

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

错误记录文件

如要打开或关闭错误记录，请从 AnswerBook2 管理页选择修改服务器配置。

• 如要将有关文档服务器上所发生的任何错误的信息写入错误记录文件，请单击开旁的按钮，单击应用。文件的默认位置为 /var/log/ab2/logs/errors-8888.log。

• 如要停止将信息写入错误记录文件，请单击 关 旁的按钮，然后单击应用。

您也可以用下面的命令执行这些功能：

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

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

更改记录功能之后，您 必须 停止并起动文档服务器。以 根用户 登录服务器并键入下面的命令：

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

查看错误记录

如要查看错误记录文件，请从 AnswerBook2 管理页选择查看记录文件，然后单击查看错误记录文件。错误记录文件列出发生在文档服务器上的每一个错误。您能用此信息决定服务器问题或非正常现象的起因。这些错误通常识别服务器和与错误相关的端口，以及一些描述错误的文本。

您也可以用下面的命令执行此功能：

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

旋转记录文件

您可以将当前访问或错误记录保存在一个文件，并将起动记录信息保存在一个空文件。

• 如要旋转错误文件，请从 AnswerBook2 管理页选择旋转错误记录。

• 如要旋转访问记录，请从 AnswerBook2 管理页选择旋转访问记录文件。

当旋转访问(错误)记录文件页出现：

1. 在保存记录文件字段中键入要保存的文件名。

   默认值是 current_date。current_log_file_name.log，其中current_date的形式为YearYearYearYear_MonthMonth_DayDay_HourHour 且 current_log_file_name 默认为 access-8888.log 或 error-8888.log (例如，1997_02_26_14.access-8888.log)。

   注意，记录文件位置字段向您显示文件保存的位置。您不能在此页中更改该信息。

2. 单击应用。

更改记录功能之后，您 必须 停止并起动文档服务器。以根用户 登录服务器并键入下面的命令：

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

您也可以用下面的命令执行这些功能：

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

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

通用管理页浏览功能

在 AnswerBook2 产品中每页的顶部，有一组通用浏览功能。下表描述的是您从管理页选择这些功能时所发生的现象。

在许多管理页上，单击 图标就可以带您来到主要的 AnswerBook2 管理页。