本章说明如何安装和使用 AnswerBook2TM 产品,以浏览、搜索及打印联机文档。包括以下信息:
AnswerBook2 产品为 Sun 的联机文档系统。它使用网页浏览器接口,允许查看和打印各种 SolarisTM 信息,包括基于 SGML 的AnswerBookTM文档集、Display PostScriptTMAnswerBook 文档集和手册页。
AnswerBook2 产品提供搜索引擎,以便在整个文档库中查找信息。可以将文档集安装至中央化文档服务器或本地的服务器。
在整个 AnswerBook2 文档中,术语 AnswerBook1 是指随 Solaris 操作环境 2.6 之前各版本提供的旧版 AnswerBook 产品。
如果网页浏览器支持 HTML 3.2 版,则使用基于网页浏览器的接口,从而让用户可以在任何平台(运行任何操作系统)上查看联机文档
根据网页浏览器的功能,可以从 AnswerBook2 文档中复制信息并将其粘贴到其它位置(如命令行)
提供在整个文档库中查找单字和词组的搜索接口
直接从 AnswerBook2 接口以接近印刷质量的 PostScript 格式打印章节及书籍
使用单一接口查看新旧 AnswerBook 文档
在使用特定文档服务器时,可以定义要显示的文档集的子集(个人库)
允许选择查看屏幕上的说明和帮助信息所使用的语言
使用客户-服务器体系结构,即允许将文档存储在单一位置(服务器)并从用户桌面(客户端)访问
提供命令行接口(CLI)和基于浏览器的接口(GUI),让用户执行各种管理操作
以下列表给出 AnswerBook2 软件本发行版所提供的新的或增强的特性。
AnswerBook2 格式的手册页(参考手册)
以 AnswerBook2 格式提供传统的 UNIX® 样式的手册页。 搜索接口允许选择仅对安装在文档服务器上基于 SGML 的手册页进行搜索。
对多媒体内容的支持
如果文档源包括音频或视频文件,AnswerBook2 系统允许按照已在自己的浏览器中定义的音频及视频支持访问。
能够直接从 Solaris 7 文档 CD 运行 AnswerBook2 服务器(仅对服务器管理员)
如果您有此 CD 并对该 CD 连接的系统具有根用户的访问权限,则可以使用 ab2cd正文直接从 Solaris 7 文档 CD 运行 AnswerBook2 服务器。关于该特性的详细信息,参见"从 Solaris 7 文档 CD 运行文档服务器"。
能够使用各种基于 CGI 的网页服务器(仅对服务器管理员)。
AnswerBook2 服务器可以通过 AnswerBook2 服务器软件包中包括的服务器作为 NSAPI 插件程序运行;也可以使用支持 CGI 的 httpd 服务器(例如 Netscape ServerTM 或 Sun WebServerTM)作为基于 CGI 的应用程序运行。关于改用基于 CGI 网页服务器的详细信息以及可能的限制,参见 "将 AnswerBook2 服务器作为 CGI 进程运行" 。
能够控制式样单错误的显示(仅对服务器管理员)。
当发生式样单错误时,若要控制是否向用户以红色显示"BUG",则开启或关闭 AnswerBook2 调试功能。请在启动文档服务器时进行此项设置。有关详细信息,参见 AnswerBook2 帮助中的启动和停止文档服务器。
AnswerBook2 产品由以下部分构成:
客户端网页浏览器 - Solaris 7 发行版包括 Netscape 浏览器;但是,可以使用任何符合 HTML 3.2 的浏览器来查看 Sun 的联机文档。
如果您只想查看联机文档并具有访问文档服务器 URL 的权限,则仅需该部件。所有其它部件是文档服务器系统(指安装文档集并运行网页服务器进行发送文档的机器)的构成部分。如果不能在本地访问文档服务器,则可以在 http://docs.sun.com查看所有发布的 Solaris 文档。
文档服务器 - 执行查询功能,并为客户端浏览器"服务"文档。包括各种为文档查看和打印提供共同的"视觉和感觉"的模板,并提供网页浏览器和命令行两种管理接口来执行数据库、口令验证及其它管理功能。
文档集 - 可以是新的(SGML)文档或旧的(Display PostScript)文档
本节列出部分关于 AnswerBook2 产品的一般问题及其解答。
AnswerBook2 产品使用基于标准的文档服务器,通过您喜欢使用的网页浏览器来发送联机文档。AnswerBook2 接口允许您浏览、搜索和打印各种 Solaris 信息,包括 AnswerBook1 文档集和手册页。
先前的 AnswerBook 产品(现称为 AnswerBook1)使用 Display PostScript 来显示主要为印刷形式发送开发的电子版本。而AnswerBook2 产品则通过网页浏览器来显示用 SGML 开发用于联机发送的文档并显示现有的 AnswerBook1 文档。
两种产品间的主要差异有:
网页浏览器接口 - 通过 AnswerBook2 产品,您可以在任何平台上使用任何符合 HTML 3.2 的浏览器来查看随 AnswerBook2 产品的联机文档。
信息源的灵活性 - AnswerBook2 服务器可以发送 AnswerBook1 (Display PostscriptTM) 文档或 AnswerBook2 (SGML)文档。
客户-服务器支持 - AnswerBook2 产品允许您将服务器和文档集安装在中心位置,而从其它系统进行查看。另外,它包括"遇挫绕过"机制, 文档管理员可以用此定义多个文档服务器,使文档间的链接总能工作。
跨平台 - 本发行版的 AnswerBook2 文档服务器必须在 Solaris 7 操作环境(SPARC或Intel)中运行。但是,AnswerBook2 客户可以在任何平台运行,而且,将来的版本可能提供附加平台上的服务器功能。
默认的搜索性能- AnswerBook2 产品使用"AND"作为其默认搜索行为,而不是"OR"(AnswerBook1产品中的默认搜索性能)。
是,除非您的 AnswerBook 是在 Solaris 操作环境 2.2 版之前创建的。要将 AnswerBook1 文档集添加到 AnswerBook2 服务器的数据库,文档管理员应使用 AnswerBook2 的 "添加文档集" 功能并指向包含 AnswerBook1ab_cardcatalog 文件的目录。
否。出于一致性的考虑, AnswerBook2 的 AnswerBook1 文档接口与 AnswerBook1 产品接口相似。因此,AnswerBook2 产品对 AnswerBook1 和 AnswerBook2 文档集提供以下不同功能:
不能显示或隐藏 AnswerBook1 目录列出的所有层;仅能对目录中的特定部分显示或隐藏。
AnswerBook1 内容页面不包括"其它主题"部分。要从一页浏览至另一页,可以使用下一个主题链接或返回到目录并选取该书的另一部分。
AnswerBook1 内容页面一次显示整个一章而不是较小的章节。
搜索结果图标不能很好地表示与 AnswerBook1 信息匹配的可能性;这些图标通常完全填满或者完全空白。
搜索到的术语不在 AnswerBook1 文本中突出显示。
某些 AnswerBook1 图形不能直接内联显示;它们以图标标识,单击图标时会显示该图形的 PostScript 图像。
用关键词搜索手册页仅包括服务器上基于 SGML 的 AnswerBook2 手册页,而不包括 AnswerBook1 的手册页。
AnswerBook1 的手册页使用与其它 AnswerBook1 文档相同的接口;它们没有特殊的手册页接口。
文档服务器软件和 Solaris 7 文档集在 Solaris 7 文档 CD 上。 图形 8-1 至图形 8-6列出了所有的特定文档集,并标识出那些只有硬拷贝(打印件)格式的文档。
要使用 AnswerBook2 系统查看联机文档,需要有支持 HTML 3.2 的浏览器(例如 HotJavaTM、Netscape NavigatorTM、或 LynxTM), 并具有访问文档服务器的权限(这里的服务器即标识一台安装了文档集并运行基于网页服务器进行文档发送的机器之 URL)。有关详细信息,请选择:
有关使用 AnswerBook2 产品或管理文档服务器的详细信息,请您在有了要访问的文档服务器后使用 AnswerBook2 的帮助。
下表列出为了获取 AnswerBook2 特定功能您所要做的工作和安装的软件。
表 8-1 何时安装何种软件如果要... | 则... |
---|---|
从桌面(任何平台,任何操作环境)查看联机文档。 | 启动网页浏览器并键入文档服务器的 URL(例如,http://imaserver:8888/)。参见"启动 AnswerBook2 浏览器"。 |
从桌面用适当的服务器 URL 自动启动网页浏览器。 | 如果您在运行 Solaris 7 操作环境,则指定一个文档服务器并从 CDE 的"帮助"菜单或者 OpenWindowsTM的 "程序"菜单中选取 AnswerBook2 选项。参见 "启动 AnswerBook2 浏览器"。 |
使系统(机器)能够发送(提供)文档。 | 用 Solaris 7 文档 CD 安装文档服务器软件。参见"安装文档服务器软件"。 |
将文档从 Solaris 7 文档 CD 或其它位置添加到文档服务器。 | 文档管理员是唯一受权执行该功能的用户。参见"在服务器上安装文档集"。 |
如果在运行 Solaris 2.6(或更新版本)操作环境并执行下面的一种操作,则系统会用文档服务器的URL启动网页浏览器:
从 CDE 前面板上的"帮助"菜单选取 AnswerBook2 图标。
从 OpenWindows 的"程序"菜单选取 AnswerBook2。
在命令行输入 answerbook2 命令。
系统通过搜索路径来确定所启动的网页浏览器,然后启动 Netscape NavigatorTM或查找到的第一个网页浏览器。若需了解系统如何确定文档服务器的 URL,参见"查找文档服务器"。
也可以从任何支持 HTML 3.2 的网页浏览器访问 AnswerBook2 产品。启动网络浏览器并输入适当的文档服务器 URL。例如,若系统管理员已经用默认端口号将 AnswerBook2 文档服务器安装在 imaserver 系统上,则您可以键入 URL:http://imaserver:8888/
一旦启动了 AnswerBook2 浏览器,请单击带下划线的文本(取决于浏览器所配置以显示其链接的方式)浏览整本书籍或章节。关于如何浏览 AnswerBook2 系统的详细信息,参见 AnswerBook2 的帮助。
当从 Solaris 操作环境启动 AnswerBook2 浏览器时,软件显示安装在默认文档服务器上的文档集列表。请依次使用以下机制以确定默认服务器:
如果已经定义环境变量 AB2_DEFAULTSERVER,则 AnswerBook2 浏览器使用按该变量定义的 URL 启动。
例如,可能在您的 .cshrc 文件中有如下语句:
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888/ |
如果您初始 AnswerBook2功能的机器是文档服务器,则 AnswerBook2 浏览器会使用如下 URL 启动:http://localhost:port
其中,port 是文档服务器运行的端口号,默认为 8888。
如果文档管理员已用 FNS(联合命名服务)注册 AnswerBook2 服务器,则 AnswerBook2 浏览器使用注册服务器的 URL。
如果没有可用的文档服务器但可以访问因特网,则可以在 http://docs.sun.com/ 访问 Sun 的主文档服务器。
本节说明在安装 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 7 文档集都在 Solaris 7 文档 CD上。如果将服务器产品这两部分安装在单一系统上,当完成安装过程并启动服务器时,即可为所有客户提供文档。详细信息,请参见"安装 AnswerBook2 服务器软件"。
将服务器和文档安装在不同系统上
可以将文档服务器软件安装在一个系统上,然后指向在另一系统上的文档集。如果在服务器系统上只有最小的可用磁盘空间,或者在另一系统已有文档集,则您可能希望选择这种方式。要做到这一点,需要将每一文档集手动地添加到服务器的数据库,而 搜索本地安装的文档集功能并不能找到这些文档集。参见"安装 AnswerBook2 服务器软件"以获取详细信息。
从 CD 运行服务器
如果在非联网环境(独立机)工作或者只是偶尔查看联机文档,则可以直接从 Solaris 7 文档 CD 运行 AnswerBook2 服务器。从 CD 运行的文档服务器一般较安装在系统上的文档服务器运行慢。如果希望其它用户能访问该文档服务器,请勿采用这种方法"从 Solaris 7 文档 CD 运行文档服务器"。
要安装文档服务器软件,可以使用 Solaris Web StartTM 实用程序中可用的点击接口,或者使用标准的安装实用程序,例如 pkgadd。
将Solaris 7 文档 CD 插入 CD-ROM 驱动器。
"卷宗管理器"会自动装配 CD。
如果您选择使用 Solaris Web Start 实用程序来安装产品, 则双击安装程序图标,遵循 Web Start 屏幕上的指示, 然后转到步骤 6。
Web Start 实用程序为您的安装预选了软件包的组合。 请遵循 Web Start 屏幕上的指示完成安装。
如果选择使用 pkgadd 实用程序或swmtool 实用程序,则以超级用户 的身分登录到文档服务器所在的机器。
例如,在命令行中输入:
% su - |
将目录更改到文档服务器软件包所在的位置。
例如,可以输入类似下面的命令,转到用于 SPARC 服务器的服务器软件包所在位置:
# cd cdrom/Solaris_2.7_Doc/sparc/Product/ |
此处cdrom 是指CD-ROM 设备的装配点,默认值为:/cdrom/sol_2_7_doc
启动安装实用程序并选择服务器软件包。
例如,使用如下命令以启动pkgadd 实用程序:
# pkgadd -d |
SUNWab2r(0.25 兆字节)- 安装在根分区并提供配置和启动文件。
SUNWab2s (1.00 兆字节)- 提供用于执行文档处理的共享文件。
SUNWab2u (26.00 兆字节)- 提供用于服务器和管理功能的可执行的后端处理文件。
如果需要,请启动服务器。
软件包的安装应导致服务器在默认端口 8888 启动。如果不启动,请使用下列命令将其启动:
# /usr/lib/ab2/bin/ab2admin -o start |
安装书集。
如果没有安装要服务的文档,文档服务器不能处理工作。 可以从 Solaris 7 文档 CD 或其它地点(如现有的文档集或 来自其它 CD 的文档集)安装文档集。有关安装文档集的详细信息,参见"在服务器上安装文档集"。
(可选用)更改配置文件并创建链接,将文档服务器作为 CGI 进程在现有的 httpd 服务器上运行。
如果系统中已经运行httpd 服务器,可以在此服务器上将文档服务器作为CGI 进程运行。但必须安装标准文档服务器软件,然后更改若干文件配置,创建链接,以便将文档服务器作为CGI 进程运行。详细信息,请参见 "将 AnswerBook2 服务器作为 CGI 进程运行" 。
(可选用)注册服务器。
如果想让其他用户通过联合命名服务(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。要安装文档集:
将 Solaris 7 文档 CD 插入 CD-ROM 驱动器。
"卷宗管理器"应自动装配 CD。
如果选择使用"Solaris Web Start"实用程序来安装产品,则在安装程序图标上双击,按照在"Web Start"屏幕上的说明并继续 步骤 6。
"Web Start"实用程序提供了要安装的预选软件包组合。按照在"Web Start"屏幕上的说明来继续进行。
如果选择使用 pkgadd 或者 swmtool 实用程序, 则作为超级用户登录到文档服务器所在机上。
例如,输入下列命令行:
% su - |
将目录更改到文档集软件包所在的位置。
例如:
# cd cdrom/Solaris_2.7_Doc/common/Product/ |
其中, cdrom 是光驱设备的装配点,默认为:/cdrom/sol_2_7_doc。
启动安装实用程序,并选取要安装的文档集软件包。
例如,用如下命令启动 pkgadd 实用程序:
# pkgadd -d |
若需要 Solaris 7 文档 CD 上包括的文档集详细清单,请参见该 CD 上的 README 文件。
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 ,也可以进行访问。
对 FNS 命令的熟悉程度
如果您熟悉标准的 FNS 命令(例如 fnbind),则可以使用这些命令来注册服务器。但为了简化注册过程,可以使用 /usr/lib/ab2/bin/ab2regsvr 即可完成注册。有关详细信息,参见"使用 ab2regsvr 命令注册服务器 "和"用标准 FNS 命令注册服务器"。
使用的命名服务
NIS+(网络信息服务新版)是用于 Solaris 2.6(及更新)操作环境的主命名服务。如果您的系统使用 NIS+ ,而且您有管理特权,则可以在登录到 NIS+ 主机或者 NIS+ 客户系统时注册服务器。
NIS(网络信息服务) 是 SunOS 4.x(Solaris 1.x)环境提供的标准命名服务。 如果系统使用 NIS ,则必须在 NIS 主机系统以 root(根) 登录进行文档服务器的注册。
AnswerBook2 产品也支持文件系统定义的命名系统(文件),在此系统中,所有的名称均以手动方式输入到数据文件。这些文件存储在目录 /var/fn/ 中。在这种情况下,要注册服务器必须具有系统的根用户访问权限,而且注册仅对注册的机器有效。其它机器看不见在文件系统机制下注册的服务器。
要注册服务器,请使用 ab2regsvr 命令。ab2regsvr 命令查看系统的配置并为服务器设置适当的命名空间。
要注册服务器,键入:
# /usr/lib/ab2/bin/ab2regsvr server_url |
其中,server_url 是到达该服务器的完整有效 URL(例如: http://imaserver.eng.sun.com:8888/)。
查看已注册的 AnswerBook2 服务器的 URL:
# /usr/lib/ab2/bin/ab2regsvr -l |
从列表中删除已注册的服务器:
# /usr/lib/ab2/bin/ab2regsvr -d |
更改当前注册的 AnswerBook2 服务器 URL:
# /usr/lib/ab2/bin/ab2regsvr -r server_url |
其中,server_url 是到达该服务器的新的 URL(例如:http://aserver.eng.sun.com:8888/)。这就以指定的 URL 替换任何现有的 URL。
有关 ab2regsvr 命令的详细信息,参见 ab2regsvr(1m)手册页。
如果希望用 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 文档。
不使用上述命名服务来查找文档服务器,用户可以使用环境变量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 浏览器。
确保以超级用户身份登录。
% su - |
将目录更改至(或启动并转至) CD-ROM 卷的最高层。
这应类似如下位置:
/cdrom/sol_2_7_doc/ |
该目录包含一个目录、README 文件、installer实用程序及 ab2cd 正文。使用 ab2cd正文直接从 CD 运行文档服务器。
键入如下命令:
# ./ab2cd |
用如下 URL 访问文档服务器:
http://server:8888/ |
其中,server 是 CD-ROM 驱动器所在机器的名称。
注意:从 CD 运行的文档服务器总是在端口 8888 运行。
(可选的) 如果文档集已经安装在服务器机器上,而您希望从 CD 运行的服务器软件能识别这些文档集,则使用如下命令:
# ab2cd -s |
该形式的命令会使 CD 驱动的服务器软件寻找安装在此系统上的其它文档集,并将其添加到自己的数据库。
要停止从 CD 运行服务器,请键入:
# /cdrom/sol_2_7_doc/ab2cd stop |
直接从 CD 运行文档服务器速度一般较慢。如果希望其它用户访问该文档服务器,请勿使用这种方法。
从 CD 运行服务器时,请牢记以下事项:
从 CD 运行 AnswerBook2 时,它总是在端口 8888 运行。如果系统中已有 AnswerBook2 服务器在默认端口(8888) 运行,ab2cd 正文将显示如下信息:
A document server is already running on this system as server:8888.
Please shut down the current server before running the ab2cd command.
请使用如下命令关闭当前服务器:
# /usr/lib/ab2/bin/ab2admin -o stop |
总是使用 ab2cd stop 来停止从 CD 运行的服务器,而不要使用 /etc/init.d/ab2mgr stop来停止基于 CD 的服务器。
ab2cd stop 命令可停止 AnswerBook2 服务器进程,并清除 /tmp/ab2/和 /tmp/ab2cd_config/ 目录中的所有文件。 /etc/init.d/ab2mgr stop 命令停止所有的服务器进程,但是并不清除 /tmp/ab2/ 和 /tmp/ab2cd_config/ 目录中的文件。
若要运行两个 AnswerBook2 服务器(一个在系统上,另一个从 CD),请牢记如下规则:
/etc/init.d/ab2mgr start 命令总是启动系统中的服务器。
ab2cd 命令总是从 CD 启动服务器。
总是使用 ab2cd stop 命令来停止从 CD 运行的服务器。
要停止两个服务器,首先使用 ab2cd stop 命令停止从 CD 运行的服务器, 然后使用 /etc/init.d/ab2mgr stop 或者 /usr/lib/ab2/bin/ab2admin -o stop停止在系统上运行的服务器。
默认情况下,AnswerBook2 文档服务器在 httpd 服务器(该服务器包括在SUNWab2u软件包中)之上作为 NSAPI 插件运行。因为 AnswerBook2 服务器符合标准的万维网协议,所以可以选择将文档服务器作为 CGI (通用网关接口)进程在系统上已安装的其它网页服务器(例如,Netscape Server 或 Sun Web Server)之上运行。
注意:如果改变不使用默认的 AnswerBook2 网页服务器,下述功能将不起作用:
/usr/lib/ab2/bin/ab2admin -o start
/usr/lib/ab2/bin/ab2admin -o stop
/etc/init.d/ab2mgr start
/etc/init.d/ab2mgr stop
从管理 GUI 执行 restart
因为不同网页服务器有不同的具体细节情况,在此只描述使用基于 CGI 的网页服务器而不是默认的(NSAPI 插件)服务器时需要遵循的一般步骤。 下面包括针对 Sun Web Server 和Netscape Server 给出具体示例。
如果 AnswerBook2 服务器在运行,请将其关闭。
使用如下命令之一:
# /usr/lib/ab2/bin/ab2admin -o stop # /etc/init.d/ab2mgr stop |
编辑网页服务器的配置文件并创建可用图标。
网页服务器的文档应解释具体细节,诸如到何处查找配置文件。/icons/ 条目应指向 /usr/lib/ab2/data/docs/icons/。
如果 /icons/ 已经被使用,将 /usr/lib/ab2/data/docs/icons/中的所有文件链接到现有的 /icons/ 目录。
将 AnswerBook2 的帮助文档链接到当前文档的根目录。
转到网页服务器的根目录,并创建指向 /usr/lib/ab2/data/docs/ 的软链接。
使服务器能够访问 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 |
编辑网页服务器的配置文件并将 /ab2/ 映射到调用 AnswerBook2 cgi。
网页服务器的文档应解释具体细节,诸如到何处查找配置文件。 需要将 /ab2/ 的条目改为 /usr/lib/ab2/bin/cgi/nph-dweb/ab2/。
编辑 AnswerBook2 的管理配置文件。
需要编辑 /usr/lib/ab2/bin/cgi/nph-dweb 文件并更改 servertype、 errorlog 和 accesslog 的条目。
默认情况下,Sun Web Server 的配置文件为 /etc/http/httpd.conf,文件存放于 /var/http/demo/。 如果您没有在默认位置()安装 SUNWab2u,所有以 /usr/lib/ab2/ 开始的路径应该是您安装文件的路径(例如,/usr2/lib/ab2/)。
编辑 /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。
转到 /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。
转到 /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。
编辑 /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。
编辑 /usr/lib/ab2/bin/cgi/nph-dweb 文件并更改下述条目:
setenv servertype sws setenv errorlog setenv accesslog /var/http/logs/http.elf.1 |
对本例而言,Netscape Server 的配置文件为 /ul/netscape/suitespot/httpd- threads1/config/obj.conf,文件位于 /ul/netscape/suitespot/docs/。 如果没有在默认位置()安装 SUNWab2u,所有以 /usr/lib/ab2/ 开始的路径应该是您安装文件的路径(例如,/usr2/lib/ab2/)。
编辑 /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 |
转到 /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。
转到 /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。
编辑 /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。
编辑 /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 |
表 8-4列出了 AnswerBook2 产品中一些已知的疑难问题,并提供处理这些问题的建议。
表 8-4 可能的服务器问题
对于以下问题 |
请考虑 |
并参见 |
||
---|---|---|---|---|
编辑 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg 文件并将主机名更改为主机名.域名。 例如,不使用:
而使用:
|
如果该问题仍然存在,请尝试关闭网页浏览器上的代理。 |
|||
如果文档服务器无反应,请重新启动。 |
有关停止和启动服务器的信息,参见 AnswerBook2 的帮助。 |
|||
有关安装软件的信息,参见"安装文档服务器软件"。 |
||||
请确认文档集模板文件(/usr/lib/ab2/dweb/data/config/ab2_collections.template)中不包含任何空的或重复的条目。 |
如果修改模板文件仍不能解决问题,则可能需要重新安装文档集或服务器软件。若需要安装软件的有关信息,参见"安装 AnswerBook2 服务器软件"。 |
|||
用户报告在一本文档(或多本文档)中看到红色文本和"BUG" |
文档的源文件包含 AnswerBook2 无法识别的标记,且服务器上的环境变量 AB2_DEBUG 被设置为"1"。 |
要关闭错误显示,请将环境变量 AB2_DEBUG 设置为 "0", 关闭服务器再重新启动。 请与文档提供者联系以修复标记问题。 |
||
文档服务器通过访问控制机制来识别可执行管理功能的用户。 服务器的文档管理员可以利用 AnswerBook2 管理工具添加或删除服务器的管理用户并更改他们的口令。 |
要为服务器添加或删除管理用户,参见 AnswerBook2 的帮助。如果需要访问另一服务器,请与该服务器的文档管理员联系。 |
|||
因为权限问题,某些功能不能从管理 GUI 执行。 请尝试从 ab2admin 命令行执行相同功能。 |
有关命令行选项的信息,参见 ab2admin(1m)手册页 。 |
|||
搜索本地安装的文档集功能未列出安装在本地装配点的文档集。 |
确认文档集安装所在的目录对其他用户赋予读取访问权。 |
|
||
用户在其库中看不到您已经添加的 AnswerBook1 文档集。 |
验证 /var/log/ab2/catalog/ab1_cardcatalog 中的信息是正确的。 |
这意味着 ab_cardcatalog 文件中的文档集数据有错。 |
||
当试图通过管理 GUI 添加文档集时,得到添加文档集失败的消息。 |
确认指向文档集的 collinfo 或 ab_cardcatalog 文件的路径是正确的。 |
|
||
当用 restart 命令重新启动文档服务器时失败,或者未产生预期结果 |
在某些情况下,restart 命令工作不正确。 |
请替而代之使用 stop 和 start 命令。 |
||
文档集看起来已被毁坏且需要重新安装 |
使用 ab2admin -o del_coll 功能或管理 GUI 中的 从列表中删除文档集,将这些文档集从文档服务器数据库中删除。 然后,在安装新的软件包之前,使用 pkgrm 将它们从服务器中删除。 |
有关删除文档集的详细信息,参见 AnswerBook2 的帮助。 |