test

Solaris 7 （SPARC 平台版）安装库

安装文档服务器软件

本节说明在安装 AnswerBook2 服务器软件之前需要满足的要求以及应作的决定。

本节仅适于管理 AnswerBook2 服务器系统的人员。只查看联机文档的用户不必阅读本节。AnswerBook2 客户端无需特别的安装。

注意：

该产品没有客户级的访问控制。如果客户机可以访问文档服务器的 URL，即可以查看该服务器上的文档。

本节包含以下信息：

有关管理文档服务器的详细信息，请在安装文档服务器软件后从 AnswerBook2 接口使用联机帮助。

在安装服务器软件之前

在开始安装过程之前，请验证系统满足列在"硬件和软件要求"中的要求，并按照"安装选项"中所示确定要安装软件的地点。

硬件和软件要求

开始安装过程之前，请验证准备要安装 AnswerBook2 服务器软件的系统满足表 8-2和表 8-3列出的要求。

表 8-2 硬件和软件要求

组件 

要求 

文档服务器系统硬件 

SPARCstationTM2 计算机或更高（建议 SPARCstation 5计算机）

基于 Intel 的个人计算机 

操作环境 

Solaris 7（对于合适的 SPARC 或 x86） 

管理 GUI 和 AnswerBook2 客户端查看器 

任何支持 HTML 3.2 的浏览器，例如 Netscape Navigator、HotJava、或 Lynx 

表 8-3 磁盘空间要求表

目录路径 

说明 

空间 

/usr/lib/ab2/

包含可执行文件、服务器处理文件、库文件以及产品接口的图形和文档源文件。 

26.0 兆字节 

/var/log/ab2/

如果启用了记录功能，则包含目录文件和记录文件。 

5.0 兆字节（建议 - 按所用的服务器来增大） 

/etc/init.d/ab2mgr

服务器启动文件 

0.01 兆字节 

此外，需要为实际的书籍文件留出一定量的磁盘空间（建议 600 兆字节）。确切的空间量取决于具体的文档集。若需要 Solaris 7 文档 CD 上提供的文档集清单，参见该 CD 中的 README 文件。

安装选项

在安装 AnswerBook2 服务器软件之前，应该考虑以下几种选项：

安装 AnswerBook2 服务器软件

要安装文档服务器软件，可以使用 Solaris Web StartTM 实用程序中可用的点击接口，或者使用标准的安装实用程序，例如 pkgadd。

  1. 将Solaris 7 文档 CD 插入 CD-ROM 驱动器。

    "卷宗管理器"会自动装配 CD。

  2. 如果您选择使用 Solaris Web Start 实用程序来安装产品， 则双击安装程序图标，遵循 Web Start 屏幕上的指示， 然后转到步骤 6。

    Web Start 实用程序为您的安装预选了软件包的组合。 请遵循 Web Start 屏幕上的指示完成安装。

  3. 如果选择使用 pkgadd 实用程序或swmtool 实用程序，则以超级用户 的身分登录到文档服务器所在的机器。

    例如，在命令行中输入：


    % su -

  4. 将目录更改到文档服务器软件包所在的位置。

    例如，可以输入类似下面的命令，转到用于 SPARC 服务器的服务器软件包所在位置：


    # cd cdrom/Solaris_2.7_Doc/sparc/Product/

    此处cdrom 是指CD-ROM 设备的装配点，默认值为：/cdrom/sol_2_7_doc

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

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


    # pkgadd -d

    选择这些服务器软件包：

    • SUNWab2r（0.25 兆字节）- 安装在根分区并提供配置和启动文件。

    • SUNWab2s （1.00 兆字节）- 提供用于执行文档处理的共享文件。

    • SUNWab2u （26.00 兆字节）- 提供用于服务器和管理功能的可执行的后端处理文件。

  6. 如果需要，请启动服务器。

    软件包的安装应导致服务器在默认端口 8888 启动。如果不启动，请使用下列命令将其启动：


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

  7. 安装书集。

    如果没有安装要服务的文档，文档服务器不能处理工作。 可以从 Solaris 7 文档 CD 或其它地点（如现有的文档集或 来自其它 CD 的文档集）安装文档集。有关安装文档集的详细信息，参见"在服务器上安装文档集"。

  8. （可选用）更改配置文件并创建链接，将文档服务器作为 CGI 进程在现有的 httpd 服务器上运行。

    如果系统中已经运行httpd 服务器，可以在此服务器上将文档服务器作为CGI 进程运行。但必须安装标准文档服务器软件，然后更改若干文件配置，创建链接,以便将文档服务器作为CGI 进程运行。详细信息，请参见 "将 AnswerBook2 服务器作为 CGI 进程运行" 。

  9. （可选用）注册服务器。

    如果想让其他用户通过联合命名服务（FNS）自动发现您的文档服务器，则需要注册服务器。要注册服务器，请使用如下命令：


    # /usr/lib/ab2/bin/ab2regsvr server_url

    此处server_url 是到达此服务器完全合法的URL（例如：http://imaserver.eng.sun.com:8888/ ）。参见"注册服务器" 以获得详细信息。

在服务器上安装文档集

如果不为文档服务器安装要服务的文档，则服务器不能工作。可以从 Solaris 7 文档 CD 或者其它位置（例如现有的文档集或其它 CD 上提供的文档集）安装文档集。

要从 Solaris 7 文档 CD 安装文档集软件包，可使用 Solaris Web Start 实用程序中可用的点击接口，或者使用标准的安装实用程序，例如 pkgadd。要安装文档集：

  1. 将 Solaris 7 文档 CD 插入 CD-ROM 驱动器。

    "卷宗管理器"应自动装配 CD。

  2. 如果选择使用"Solaris Web Start"实用程序来安装产品，则在安装程序图标上双击，按照在"Web Start"屏幕上的说明并继续 步骤 6。

    "Web Start"实用程序提供了要安装的预选软件包组合。按照在"Web Start"屏幕上的说明来继续进行。

  3. 如果选择使用 pkgadd 或者 swmtool 实用程序， 则作为超级用户登录到文档服务器所在机上。

    例如，输入下列命令行：


    % su -

  4. 将目录更改到文档集软件包所在的位置。

    例如：


    # cd cdrom/Solaris_2.7_Doc/common/Product/

    其中， cdrom 是光驱设备的装配点，默认为：/cdrom/sol_2_7_doc。

  5. 启动安装实用程序，并选取要安装的文档集软件包。

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


    # pkgadd -d

    若需要 Solaris 7 文档 CD 上包括的文档集详细清单，请参见该 CD 上的 README 文件。

  6. Solaris 7 文档 CD 上的文档集包括一个安装后执行的正文，它将文档集添加到服务器数据库并重新启动服务器。

    如果从 Solaris 7 文档 CD 之外的任何其它位置安装文档集软件包，则可能需要使用管理 GUI 的 添加文档集至列表功能或者ab2admin -o add_coll 命令将这些文档集添 加到文档服务器的数据库。

    如果系统上已经安装了文档集，则可以使用管理 GUI 的 搜索本地安装的文档集 功能或者 ab2admin -o scan命令查找文档，并将其添加到文档服务器的数据库。该功能仅适用于本地安装的软件包。

    要浏览位于某些其它系统上的文档集，请使用 添加文档集到列表 功能或者 ab2admin -o add_coll 命令并给 ab_cardcatalog 或 collinfo 文件提供完整的路径名。例如，如果文档服务器为 imaserver，而您希望它为用户提供位于其它系统上的文档集，可使用如下命令： 


    # /usr/lib/ab2/bin/ab2admin -o \
add_coll -d /net/elsewhere/books/SUNWdtad/collinfo

注册服务器

为了使用户在不知道 URL 的情况下也能定位您的文档服务器，可以将服务器名称注册到 FNS 系统。对于那些未注册的文档服务器，如果用户知道它们的 URL ，也可以进行访问。

如何注册服务器取决于以下两项：

使用 ab2regsvr 命令注册服务器

要注册服务器，请使用 ab2regsvr 命令。ab2regsvr 命令查看系统的配置并为服务器设置适当的命名空间。

要注册服务器，键入：


# /usr/lib/ab2/bin/ab2regsvr server_url

其中，server_url 是到达该服务器的完整有效 URL（例如： http://imaserver.eng.sun.com:8888/）。

ab2regsvr 命令还提供了若干其它可能有用的选项：

有关 ab2regsvr 命令的详细信息，参见 ab2regsvr(1m)手册页。

用标准 FNS 命令注册服务器

如果希望用 FNS 命令来注册服务器，而且您的位置上已安装了 FNS，则请使用如下命令将指定的 URL 注册成为您所在组织(域)的文档服务器：


# fnbind -r thisorgunit/server/answerbook2 onc_answerbook2 \
    onc_addr_answerbook2 server_url

其中，server_url 是到达该服务器的完整有效 URL（例如：http://imaserver.eng.sun.com:8888/）。

要查明当前注册的服务器，请使用如下命令： 


% fnlookup -v thisorgunit/service/answerbook2

它返回与以下内容相似的已注册服务器列表：


Reference type: onc_answerbook2 
Address type: onc_addr_answerbook2   
  length: 19   
  data: 0x68 0x74 0x74 0x70 0x3a 0x2f 0x2f 0x61 0x6e 0x73 http://ans         
        0x77 0x65 0x72 0x73 0x3a 0x38 0x38 0x38 0x38      wers:8888

本例中，注册的服务器为 http://answers:8888/。

如果得到类似如下的反应，则没有用 FNS 注册的文档服务器：


Lookup of 'thisorgunit/service/answerbook2' failed: 
\ Name Not Found: 'answerbook2'

有关 FNS 的详细信息(包括如何安装)，参见 FNS 文档。

命名服务和 AnswerBook2 用户

不使用上述命名服务来查找文档服务器，用户可以使用环境变量AB2_DEFAULTSERVER 定义默认的 AnswerBook2 服务器。例如，用户可以在 .cshrc 文件中包含如下语句： 


setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888

如果用户未定义环境变量，则在从桌面启动 AnswerBook2 产品时，该产品检测其启动的系统当前是否在运行文档服务器。如果是，则用 URL: http://localhost:port 启动，其中 port 默认为 8888。

如果用户未定义环境变量，而且当前系统不是文档服务器，则当用户从桌面启动 AnswerBook2 时，系统执行 fnlookup thisorgunit/service/answerbook2 命令以查找可以访问的文档服务器。然后选取其中之一并以该服务器名称作为 URL 启动 AnswerBook2 浏览器。

从 Solaris 7 文档 CD 运行文档服务器

  1. 将 Solaris 7 文档 CD 插入 CD-ROM 驱动器。

  2. 确保以超级用户身份登录。


    % su -

  3. 将目录更改至（或启动并转至） CD-ROM 卷的最高层。

    这应类似如下位置：


    /cdrom/sol_2_7_doc/

    该目录包含一个目录、README 文件、installer实用程序及 ab2cd 正文。使用 ab2cd正文直接从 CD 运行文档服务器。

  4. 键入如下命令：


    # ./ab2cd

  5. 用如下 URL 访问文档服务器： 


    http://server:8888/

    其中，server 是 CD-ROM 驱动器所在机器的名称。

    注意:从 CD 运行的文档服务器总是在端口 8888 运行。

  6. (可选的) 如果文档集已经安装在服务器机器上，而您希望从 CD 运行的服务器软件能识别这些文档集，则使用如下命令： 


    # ab2cd -s

    该形式的命令会使 CD 驱动的服务器软件寻找安装在此系统上的其它文档集，并将其添加到自己的数据库。

  7. 要停止从 CD 运行服务器，请键入：


    # /cdrom/sol_2_7_doc/ab2cd stop
小心：小心：

直接从 CD 运行文档服务器速度一般较慢。如果希望其它用户访问该文档服务器，请勿使用这种方法。

从 CD 运行 AnswerBook2 服务器的重要注意事项

从 CD 运行服务器时，请牢记以下事项：

关于运行两个服务器的注意事项

若要运行两个 AnswerBook2 服务器（一个在系统上，另一个从 CD），请牢记如下规则：

将 AnswerBook2 服务器作为 CGI 进程运行

默认情况下，AnswerBook2 文档服务器在 httpd 服务器（该服务器包括在SUNWab2u软件包中）之上作为 NSAPI 插件运行。因为 AnswerBook2 服务器符合标准的万维网协议，所以可以选择将文档服务器作为 CGI （通用网关接口）进程在系统上已安装的其它网页服务器（例如，Netscape Server 或 Sun Web Server）之上运行。

注意:如果改变不使用默认的 AnswerBook2 网页服务器，下述功能将不起作用：

您将使用服务器中的启动和停止功能来代替。

更改为基于 CGI 的服务器

因为不同网页服务器有不同的具体细节情况，在此只描述使用基于 CGI 的网页服务器而不是默认的（NSAPI 插件）服务器时需要遵循的一般步骤。 下面包括针对 Sun Web Server 和Netscape Server 给出具体示例。

  1. 如果 AnswerBook2 服务器在运行，请将其关闭。

    使用如下命令之一：


    # /usr/lib/ab2/bin/ab2admin -o stop
# /etc/init.d/ab2mgr stop

  2. 编辑网页服务器的配置文件并创建可用图标。

    网页服务器的文档应解释具体细节，诸如到何处查找配置文件。/icons/ 条目应指向 /usr/lib/ab2/data/docs/icons/。

    如果 /icons/ 已经被使用，将 /usr/lib/ab2/data/docs/icons/中的所有文件链接到现有的 /icons/ 目录。

  3. 将 AnswerBook2 的帮助文档链接到当前文档的根目录。

    转到网页服务器的根目录，并创建指向 /usr/lib/ab2/data/docs/ 的软链接。

  4. 使服务器能够访问 AnswerBook2 的 cgi-bin 文件。

    转到网页服务器的 cgi-bin 目录并创建软链接至以下各项： 


    /usr/lib/ab2/bin/cgi/admin 
/usr/lib/ab2/bin/cgi/nph-dweb 
/usr/lib/ab2/bin/cgi/gettransbitmap 
/usr/lib/ab2/bin/cgi/getepsf 
/usr/lib/ab2/bin/cgi/getframe 
/usr/lib/ab2/bin/cgi/ab2srwrap

  5. 编辑网页服务器的配置文件并将 /ab2/ 映射到调用 AnswerBook2 cgi。

    网页服务器的文档应解释具体细节，诸如到何处查找配置文件。 需要将 /ab2/ 的条目改为 /usr/lib/ab2/bin/cgi/nph-dweb/ab2/。

  6. 编辑 AnswerBook2 的管理配置文件。

    需要编辑 /usr/lib/ab2/bin/cgi/nph-dweb 文件并更改 servertype、 errorlog 和 accesslog 的条目。

将 AnswerBook2 服务器作为 CGI 进程在 Sun WebServer 上运行

默认情况下，Sun Web Server 的配置文件为 /etc/http/httpd.conf，文件存放于 /var/http/demo/。 如果您没有在默认位置（）安装 SUNWab2u，所有以 /usr/lib/ab2/ 开始的路径应该是您安装文件的路径（例如，/usr2/lib/ab2/）。

  1. 编辑 /etc/http/httpd.conf 文件，并将如下语句加入文件的 server 部分：


    map /icons /usr/lib/ab2/data/docs/icons

    完成更改后，使用如下命令重新启动 SWS 服务器：


    # /etc/init.d/httpd start

    要验证更改，在网页浏览器中输入如下 URL，查看帮助图标：


    http://localhost:port/icons/ab2_help.gif

    其中，port 是文档服务器运行的端口号，默认为 8888。

  2. 转到 /var/http/demo/public/ 目录并建立如下软链接： 


    # ln -s /usr/lib/ab2/data/docs/Help Help

    要验证更改，在网页浏览器中输入如下 URL，查看帮助图标：


    http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif

    其中，port 是文档服务器运行的端口号，默认为 8888。

  3. 转到 /var/http/demo/cgi-bin/ 目录并创建如下软链接：


    # ln -s /usr/lib/ab2/bin/cgi/admin 
# ln -s /usr/lib/ab2/bin/cgi/nph-dweb 
# ln -s /usr/lib/ab2/bin/cgi/gettransbitmap 
# ln -s /usr/lib/ab2/bin/cgi/getepsf 
# ln -s /usr/lib/ab2/bin/cgi/getframe 
# ln -s /usr/lib/ab2/bin/cgi/ab2srwrap

    要验证更改，在网页浏览器中输入如下 URL，查看 AnswerBook2 库页： 


    http://localhost:port/cgi-bin/nph-dweb/ab2

    其中，port 是文档服务器运行的端口号，默认为 8888。

  4. 编辑 /etc/http/httpd.conf 文件，并将如下条目添加至文件的 host 部分：


    map /ab2 /var/http/demo/cgi-bin/nph-dweb/ab2 cgi

    用如下命令重新启动 SWS：


    # /etc/init.d/httpd start

    要验证更改，在网页浏览器中输入如下 URL，查看 AnswerBook2 库页：


    http://localhost:port/ab2

    其中，port 是文档服务器运行的端口号，默认为 8888。

  5. 编辑 /usr/lib/ab2/bin/cgi/nph-dweb 文件并更改下述条目：


    setenv servertype sws 
        setenv errorlog 
        setenv accesslog /var/http/logs/http.elf.1
将AnswerBook2 服务器作为 CGI 进程在 Netscape Server 上运行

对本例而言，Netscape Server 的配置文件为 /ul/netscape/suitespot/httpd- threads1/config/obj.conf，文件位于 /ul/netscape/suitespot/docs/。 如果没有在默认位置（）安装 SUNWab2u，所有以 /usr/lib/ab2/ 开始的路径应该是您安装文件的路径（例如，/usr2/lib/ab2/）。

  1. 编辑 /ul/netscape/suitespot/httpd-threads1/config/obj.conf 文件并添加如下语句： 


    NameTrans fn="pfx2dir" from="/icons" dir="/usr/lib/ab2/data/docs/icons"

    要验证更改，请重新启动 Netscape Server。然后在网页浏览器中输入如下 URL，查看帮助图标：


    http://localhost:port/icons/ab2_help.gif

  2. 转到 /ul/netscape/suitespot/docs/ 目录并创建如下软链接： 


    # ln -s /usr/lib/ab2/data/docs/Help  Help

    要验证更改，请在网页浏览器中输入如下 URL，查看帮助图标： 


    http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif

    其中，port 是文档服务器运行的端口号，默认为 8888。

  3. 转到 /ul/netscape/suitespot/cgi-bin/ 目录并创建下述软链接： 


    # ln -s /usr/lib/ab2/bin/cgi/admin
# ln -s /usr/lib/ab2/bin/cgi/nph-dweb
# ln -s /usr/lib/ab2/bin/cgi/gettransbitmap
# ln -s /usr/lib/ab2/bin/cgi/getepsf
# ln -s /usr/lib/ab2/bin/cgi/getframe
# ln -s /usr/lib/ab2/bin/cgi/ab2srwrap

    要验证更改，请在网页浏览器中输入如下 URL，查看 AnswerBook2 库页：


    http://localhost:port/cgi-bin/nph-dweb/ab2

    其中，port 是文档服务器运行的端口号，默认为 8888。

  4. 编辑 /ul/netscape/suitespot/httpd-threads1/config/obj.conf 文件并添加如下条目：


    NameTrans fn="pfx2dir " from="/ab2" 
dir="/ul/netscape/suitespot/cgi-bin/nph-dweb/ab2 " name="cgi"

    要验证更改，请重启 Netscape Server 并在网页浏览器中输入如下 URL 以查看 AnswerBook2 库页：


    http://localhost:port/ab2

    其中，port 是文档服务器运行的端口号，默认为 8888。

  5. 编辑 /usr/lib/ab2/bin/cgi/nph-dweb 文件并更改如下条目： 


    setenv servertype netscape 
       setenv errorlog /ul/netscape/suitespot/httpd- threads1/logs/errors 
       setenv accesslog /ul/netscape/suitespot/httpd-threads1/logs/access