AnswerBook2 的有关资料

[weixin_38069146]

一、什么是AnserwerBook2?
   
    AnswerBook2 产品是 Sun 的联机文档系统。 它使用网络浏览器界面，让您查看和打印各种 Sun 信息， 包括基于 SGML 的AnswerBook(TM) 集合、Display PostScript(TM) AnswerBook 集合和手册页。

    AnswerBook2 产品提供了查找引擎，让您在整个文档库查找信息。您可以在中央文档服务器或者在本地服务器上安装 AnswerBook2 文档集合。

    在整个AnswerBook2文档中，AnswerBook1 一词指随同 Solaris(TM) 操作环境2.6版之前的版本一起提供的AnswerBook产品版本。

二、AnswerBook2 特性和功能

    使用基于网络浏览器界面，使您能够从任一平台（运行任一操作系统）查看联机文档，只要您的网络浏览器支持 HTML 3.2 即可

    让您从 AnswerBook2 文档复制信息，然后粘贴到其他地点，例如命令行，具体根据您的网络浏览器的功能而定

    提供查找引擎，以便在整个文档库中查找字和字短语

    使您能够直接从 AnswerBook2 界面，用接近打印质量输出结果的PostScript格式打印章节和手册

    在使用某一特定的文档服务器时， 让您定义要显示的文档集合（个人库）的子集

    容许您选择用于查看屏幕指令和帮助信息的语言

    提供命令行界面（CLI）和基于浏览器的界面（GUI），以便执行文档服务器管理功能

三、如何启动 AnswerBook2 查看程序

    您也可以从任一依从于 HTML 3.2 标准的 网络浏览器访问 AnswerBook2产品。 启动网络浏览器，并提供 正确的文档服务器 URL。例如，如果您的系统管理员在imaserver系统上安装了一个AnswerBook2文档服务器，则请您输入URL： http://imaserver:8888/

如果您可以访问 因特网，您也能够在下面的 URL 访问已发行的 Sun 文 档：http://docs.sun.com/


四、安装前的检查单

    支持多字节字符语言
SUNWciu8       Simplified Chinese (EUC) iconv modules for UTF-8
SUNWciu8x      Simplified Chinese (EUC) iconv modules for UTF-8 (64-bit)
                                简体汉语 iconv 模块，供UTF-8使用

SUNWhiu8       Traditional Chinese iconv modules for UTF-8
SUNWhiu8x      Traditional Chinese (EUC) iconv modules for UTF-8 (64-bit)
                                繁体汉语 iconv 模块，供UTF-8使用

SUNWjiu8       Japanese iconv modules for UTF-8
SUNWjiu8x      Japanese iconv modules for UTF-8 (64-bit)
                                日语 iconv 模块，供UTF-8使用

SUNWkiu8       Korean UTF-8 iconv modules for UTF-8
SUNWkiu8x      Korean (UTF- iconv modules for UTF-8 (64-bit)
                                韩语 iconv 模块，供UTF-8使用

SUNWuiu8       Iconv modules for UTF-8 Locale
SUNWuiu8x      Iconv Modules for UTF-8 Locale (64-bit)
                                普通 iconv 模块，供UTF-8使用

    您的系统若要作为文档服务器，它必须与下列系统配置中的一种相匹配：

    SPARCstation(TM) 2 (最低限，推荐使用SPARCstation 5) 系统，该系统运行Solaris 2.5.1 SPARC 平台编辑操作环境(或兼容的版本)

    运行 Solaris 2.5.1 Intel Platform Edition 操作环境 (或兼容版本) 的基于Intel的个人计算机系统


    此外，您的服务器系统必须拥有约34兆字节的磁盘空间供服务器软件使用和约600兆字节的磁盘空间供安装文档集合。

    /usr/lib/ab2/ ( 26.0 兆字节) -- 包含供产品界面使用的可执行文件、服务器处理文件、库文件以及图形和文档源文件

    /var/log/ab2/ (推荐使用5.0 兆字节 -- 随服务器的使用增长) -- 包含目录文件和记录文件 (如果记录功能起用的话)

    /etc/init.d/ab2mgr ( 0.01 兆字节) -- 服务器启动文件

    /opt/answerbooks/ (推荐使用可重新定位的600.0 兆字节) -- 包含文档集合文件。 实际容量取决于您所安装的集合量。

    要访问文档服务器 (通过网络浏览器和URL)，并没有具体的系统要求，尽管您必须要使用HTML 3.2-兼容的浏览器，例如 Netscape Navigator(TM) 或 Lynx。

四、软件在何处？

    AnswerBook2 服务器软件在各种不同地点都有，如Solaris 文档CD、其它Sun CD、或 直接从Sun网址获得。因此，您访问软件包时所需采取的步骤根据具体情况将会有所不同。在整个安装过程中， 软件位置 是那些指您将根据具体情况使用适当所需的地方。

五、安装软件AnswerBook2

    以超级用户登录到文档资料服务器。

    您可作为超级用户从桌面登录屏幕登录，或在命令行键入 su，然后键入系统的超级用户口令：

    将CD插入CD-ROM驱动器或转到软件所在地。

   若从CD安装，卷宗管理程序会自动装配 CD。

   若必要的话，将目录转到文档服务器软件包地点。

   键入本命令：


   # cd software-location


   其中 software-location 取决于您是从 CD 安装集合，还是从某个 web 站点获取的软件包。例如，Solaris 7 文档 CD 缺省的 software-location 是 /cdrom/sol_7_doc/Solaris_2.7_Doc/sparc/Product/。

   启动安装实用程序并选择 服务器软件包。

   例如，使用下列命令以启动 pkgadd 实用程序：

   # pkgadd -d。


  选择以下服务器软件包：

    SUNWab2r（0.03兆字节）--安装在根分区并提供配置和启动文件。 不要将本软件包安装在非默认的地点。

    SUNWab2s (1.40兆字节) --为执行文档处理提供共享文件。 不要将本软件包安装在非默认的地点。

    SUNWab2u (30.00兆字节) --为服务器和管理功能提供可执行及后端处理文件。 若要将本软件包安装在非默认的地点，则使用交互形式的 pkgadd 命令：


    # pkgadd -a none -d .



    响应超级用户在适当时作出提示。

    当您看到与如下相似的讯息时：


    本软件包内含有在安装过程中经超级用户
    准许后可以执行的脚本。
    您是否想继续安装[y,n,?]
    响应y.

    如需要，启动服务器。

    在完成SUNWab2u 的安装过程后，有段脚本试图在默认端口 8888启动服务器。请用下列方法之一来核实服务器已经启动：

    启动一个支持HTML 3.2的网络浏览器并键入以下 URL： http://localhost:8888/

    您应当看到至少有一个文档集合的"AnswerBook2 库"页（AnswerBook2 帮助集合），具体要看所安装的集合而定。

    用下列命令寻找服务器程序：


    # ps -eaf | grep dwhttpd

    如服务器未能启动，请用以下命令启动：


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

    安装过程结束后，您的服务器利用缺省配置信息进行启动。

    有关更改您服务器配置的信息，请参阅如下：

    要想更改标准的服务器配置参数，如端口号码等，请使用ab2admin 命令行界面或 AnswerBook2 管理页。

    若想在现存的 httpd 服务器，诸如 Sun WebServer 或 Netscape Server上运行 AnswerBook2 服务器，您必须安装标准的文档服务器软件，然后更改几个配置文件并创建连接，以将文档服务器作为 CGI 程序运行。 请参阅 将 AnswerBook2 服务器以CGI进程运行。


六、安装文档集合。

    以超级用户登录到文档服务器。

    您可作为超级用户从桌面登录屏幕登录，或在命令行键入 su，然后键入系统的超级用户口令：

    将 CD 插入 CD-ROM 驱动器或转到软件所在地。

    若从 CD 安装，卷宗管理程序会自动装配 CD。

    转到文档集合软件包地点。

    您可以从 software-location 安装集合，也可以从其他位置安装，如现有的文档集合或取自其它 CD 的集合。

   键入本命令：
   # cd software-location

    其中 software-location 取决于您是从 CD 上安装，还是从某个 web 站点上获取软件包。例如，Solaris 7 文档 CDsoftware-location 的缺省值为/cdrom/sol_7_doc/Solaris_2.7_Doc/common/Product/。

   使用安装实用程序并选择文档集合软件包进行安装。

   例如，使用pkgadd 实用程序：


   # pkgadd -d 。


   若要查看指定CD包含的文档集合明细列表，请参阅该CD的 README 文件。

   AnswerBook2 文档集合软件包应当包括安装后的脚本，该脚本将集合添加到服务器数据库并重新启动服务器。

    如果不是这种情况，或您安装的是 AnswerBook1 集合软件包，您需要或者使用 AnswerBook2 管理页的 "在列表中添加集合”功能，或者使用 ab2admin -o add_coll 命令将这些集合添加到文档服务器的数据库。

    如果系统上已安装有文档集合，您可以或者使用 AnswerBook2 管理页的 "查找本地安装的集合”功能，或者使用 ab2admin -o scan 命令找到它们，并把它们添加到文档服务器的数据库。此功能只对本地安装的软件包起作用。

    要为位于其它系统的文档集合提供服务，请使用“在列表中添加集合”功能或 ab2admin -o add_coll 命令并提供文件 ab_cardcatalog 或 collinfo 的完整的路径名。例如，如果文档服务器是 imaserver 且您想用它来服务位于其它位置系统上的文档集合，您可以用以下命令：
    imaserver# ab2admin -o add_coll -d  /net/elsewhere/books/SUNWdtad/collinfo

七、起动及停止文档服务器

    当您启动文档服务器正在运行的系统，服务器会自动起动 ( 通过 /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 管理页选择查看现有集合列表。此列表包括 AnswerBook1 集合及 AnswerBook2 集合。

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


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

九、删除 AnswerBook2 集合

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

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

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

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

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

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

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


十、配置文档服务器

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

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

表 2 - 用户可配置的服务器配置设定 标签
默认值和描述

服务器名称
默认：本地主机名 (例如：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中所示设置。 当您安装服务器软件时，系统将配置这些设置。


--------------------------------------------------------------------------------
表 3 - 固定的服务器配置设置 标签
默认值和描述

服务器配置路径
默认： /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]