安装和管理 AnswerBook2 服务器 - zh

第 4 章 解决 AnswerBook2 问题

本节解释如何用 AnswerBook2 产品解决已知问题并包括以下信息:

服务器错误

以下表格列出您在服务在线文档时可能会遇到的问题。

表 4-1 可能的服务器问题

现象... 

处理方法... 

参见... 

浏览器代理错误

编辑/usr/lib/ab2/dweb/data/config/dwhttpd.cfg 文件并变更主机名到 hostname

例如,不用以下行:


    set ServerHost imaserver ;#


而用此行:

设服务器宿主机 imaserver.eng.sun.com ;#
然后, 重新启动文档服务器。

如果错误仍存在,关闭网络浏览器上的代理。 

浏览器错误表示文档服务器没有响应

如果文档服务器不响应,则重新启动。 

有关停止和启动服务器的信息,请参阅"起动及停止文档服务器"

错误 404,文件未找到当试图访问文档服务器

服务器程序正在运行,可是服务器软件已被撤除。 重新安装服务器软件。

有关安装软件的信息,请参阅"安装AnswerBook2软件"

用户指示库页只显示浏览栏而不是文档集合

确认集合模板文件(/usr/lib/ ab2/dweb/data/config/ab2_collections.template)不包含任何空白或重复的条目。

如果修复模板文件不能改正问题,您需重新安装文档集合或服务器软件。有关安装软件的信息,请参阅"安装AnswerBook2软件"

在手册(或几个手册)中出现红色文字和 "BUG" 字样 

手册源包括为AnswerBook2 所不识的标注标签且服务器上的 AB2_DEBUG 环境变量设为"1"。 

关闭差错显示,将 AB2_DEBUG 标志设为"0", 停止服务器并启动服务器。 

联系此手册的提供者以修复标注。 

无法访问文档服务器的管理功能

AnswerBook2 文档服务器用访问控制机理识别谁能执行管理功能。AnswerBook2 管理工具让服务器机器的文档管理员能够为服务器添加和除去管理用户,并更改他们的口令。 

为服务器添加或除去管理用户,请参阅"控制管理访问"。如果您需要访问另一个服务器,请联系此服务器的文档管理员。

不能从AnswerBook2 管理页(浏览器界面)执行管理命令

由于权限问题,有些功能不能从 AnswerBook2 管理页正常工作。试着从ab2admin命令行界面执行同样的功能。

有关命令选项的信息,请参阅附录 A,ab2admin(1M) 手册页

本地安装的集合扫描功能不会在列出安装在本地装配点上的文档集合 

确认集合安装处的目录具有 访问,且是为其他用户所设。

 

您添加了一个AnswerBook1 集合,但用户在他们的库中无法看见 

这意味着在ab_cardcatalog 文件内的集合数据有误。确认在/var/log/ab2/catalog/ab1_cardcatalog 之中的信息正确。

 

当试图通过AnswerBook2管理页添加集合时,您看见信息无法添加集合

确认集合的collinfoab_cardcatalog 文件的路径是正确的。

 

重新启动命令重新启动文档服务器 失败或没有达到预期的结果

在某些情况下,重新启动命令未正常工作。改用停止启动命令。

更多信息,请参阅"起动及停止文档服务器"

文档集合被毁坏并需重新安装 

使用 ab2admin -o del_coll 功能或 从AnswerBook2管理页的清单中删除集合以从文档服务器数据库中除去这些集合。

然后,用 pkgrm在安装新软件包之前将其从服务器中除去。

有关除去集合的信息,请参阅"删除 AnswerBook2 集合"。有关添加集合的信息,请参阅"添加新集合"

AnswerBook2 错误信息

此节列出 AnswerBook2 的错误信息以及如何响应。

鉴别失败,请再次尝试。

含义:一个管理用户错误键入管理口令。

如何响应:重新键入口令。如果再次失败,确保您正尝试管理管理员及口令均有效的服务器。

无法找到要管理的本地 AnswerBook2 服务器。

含义:试图使用answerbook2_admin 正文或从 CDE 前面板调用AnswerBook2 管理页失败,由于此系统中没有文档服务器。

如何响应:转到文档服务器所在系统并用同样步骤或在您的浏览器中输入您要管理的文档服务器的URL 。

无法与替代服务器对话server_name

含义:试图联络某一特定替代服务器失败,这是由于服务器名或端口不存在或由于对位于您公司网络之外的服务器访问受阻。

如何响应:确认替代服务器的名称或端口是否正确。如果正确,则确认替代服务器是否位于您的公司防火墙范围内。如果您想添加的替代服务器位于您公司的防火墙之外,网络安全程序可能会阻止您将它作为替代服务器予以添加。

未找到 AnswerBook2 文档服务器。

含义:由于默认文档服务器未被定义,试图使用 answerbook2 正文或从 CDE 前面板调用客户查看器失败。

如何响应:客户查看器用以下方法找到一个默认文档服务器:

  1. 如果 AB2_DEFAULTSERVER 环境变量被定义, AnswerBook2查看器可用那个变量定义的 URL 调用。 例如,您在.cshrc文件中可能有以下行:


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

  2. 如果您初始化 AnswerBook2 功能的机器是一个 文档服务器,AnswerBook2 查看器试图访问 URL:http://localhost:8888

  3. 如果 AnswerBook2 服务器是以 FNS (联合命名服务)注册,则 AnswerBook2 查看器可使用已注册服务器的 URL。