本节解释如何安装 AnswerBook2 服务器软件。
作为一个 AnswerBook2 客户,您若要查看在线文档,不需要安装;您需要知道文档服务器的URL,或者,如果您通过因特网访问,可以在以下URL查看所发布的 Sun 文档: http://docs.sun.com/
此产品没有客户级的访问控制。如果一个客户机可用URL访问文档服务器,它则可以在此服务器上查看文档。
本节包括以下信息:
AnswerBook2 服务器能在Solaris 2.5.1(或兼容版本的)操作环境中运行。但是,具体的操作环境版本在以下方面约束着安装工作:
支持多字节字符语言,如那些在许多亚洲地区使用的语言- Solaris 操作环境使用的实用程序(iconv)能将一个代码群转换成另一个代码群。如果您在Solaris 2.5.1 操作环境中运行,您可能需要安装或更新以下软件包:
SUNWciu8 - 简体汉语 iconv 模块,供UTF-8使用
SUNWhiu8 - 繁体汉语 iconv 模块,供UTF-8使用
SUNWjiu8 - 日语 iconv 模块,供UTF-8使用
SUNWkiu8 - 韩语 iconv 模块,供UTF-8使用
SUNWuiu8 - 普通 iconv 模块,供UTF-8使用
支持联合命名服务(FNS) - 如果您想登记您的AnswerBook2服务器以使用户能够"自动地"访问它,您需要在您系统上安装FNS。该实用程序不是核心Solaris 2.5.1操作环境的一部分,所以您可能需要安装 SUNWfns 软件包。
使用本检查单会简化您的安装过程。
您的系统若要作为文档服务器,它必须与下列系统配置中的一种相匹配:
SPARCstationTM 2 (最低限,推荐使用SPARCstation 5) 系统,该系统运行Solaris 2.5.1 SPARC 平台编辑操作环境(或兼容的版本)
基于Intel的个人计算机系统,该系统运行Solaris 2.5.1 Intel平台编辑操作环境(或兼容的版本)
此外,您的服务器系统必须拥有约34兆字节的磁盘空间供服务器软件使用和约600兆字节的磁盘空间供安装文档集合。
要访问文档服务器 (通过网络浏览器和URL),并没有具体的系统要求,尽管您必须要使用HTML 3.2-兼容的浏览器,例如 Netscape NavigatorTM 或 Lynx。
要读取联机文档,如果在您系统单位的某处已经安装了AnswerBook2服务器,您只需简单地起用HTML 3.2-兼容的浏览器并将URL输入到服务器(例如,http://imaserver:8888/)。 要查看已发行的Sun 文档,请使用URL:http://docs.sun.com/
为了使您的系统能够 "服务" 文档,需在系统上安装文档服务器软件和文档集合。您也可以选择在您的系统上安装服务器软件而在另一个系统上安装文档集合。 请参阅 "安装AnswerBook2软件" 和 "安装文件集合"。
AnswerBook2 服务器软件在各种不同地点都有,如Solaris 文档CD、其它Sun CD、或 直接从Sun网址获得。因此,您访问软件包时所需采取的步骤根据具体情况将会有所不同。在整个安装过程中, 软件位置 是那些指您将根据具体情况使用适当所需的地方。
通过默认,AnswerBook2 文档服务器可作为包括在 SUNWab2u 软件包内的httpd 服务器之外的NSAPI 插件程序运行。由于AnswerBook2服务器遵从标准网络协议,您可以在您系统中的一些其它网络服务器(例如,Netscape服务器或 Sun WebServerTM)之外,选择将文档服务器作为CGI(普通网关界面)程序。 请参阅 "将 AnswerBook2 服务器以CGI 进程运行"。
若想让其他用户无须知道URL即能够找到您的文档服务器,您可将您服务器的名字登记到FNS系统。只要用户知道适当的URL,他们仍能够访问未登记的文档服务器。请参阅"登记您的文档服务器"。
AnswerBook2软件包括在多种 Sun 的产品 CD 中,如 Solaris 7 文档 CD。 如果您拥有包含该软件的产品 CD 或已经从 Sun 网址下载 SUNWab2r、SUNWab2s、和 SUNWab2u 软件包,则转到 "安装AnswerBook2软件"。 否则您需要得到AnswerBook2 软件才能继续。
有些包含AnswerBook2 软件的产品CD支持指点和单击的安装实用程序(Solaris网络起始)。有关如何使用该实用程序的信息,请参阅CD 所附文档。
以超级用户登录到文档资料服务器。
将CD插入CD-ROM驱动器或转到软件所在地。
若从CD安装,卷宗管理程序会自动装配 CD。
若必要的话,将目录转到文档服务器软件包地点。
输入本命令:
# cd 软件地点 |
在此,软件地点 取决于您是否从 CD 安装或是否从网点获得软件包。例如,Solaris 7 文档 CD 的 软件地点 默认为/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 管理页。详细内容请参阅附录 A,ab2admin(1M) 手册页或第 3 章,管理一个 AnswerBook2 服务器。
若想在现存的 httpd 服务器,诸如 Sun WebServer 或 Netscape Server上运行 AnswerBook2 服务器,您必须安装标准的文档服务器软件,然后更改几个配置文件并创建连接,以将文档服务器作为 CGI 程序运行。请参阅"将 AnswerBook2 服务器以CGI 进程运行"。
安装文档集合。
如果您的服务器安装了文档集合,安装程序会查找它们并将其添加到服务器数据库。您可以从产品 CD 安装集合或更新服务器的数据库,令其识别安装在其它系统上的文档集合。请参阅"安装文件集合"。
(可选择)登记服务器。
如果您想让其它用户通过联合命名服务(FNS)自动找到您的文档服务器,您需要登记服务器。登记您的服务器,请用以下命令:
# /usr/lib/ab2/bin/ab2regsvr server_url |
在此,server_url对此服务器是一个完全限定的 URL(例如:http://imaserver.eng.sun.com:8888/)。更多信息,请参阅"登记您的文档服务器"。
有些包含AnswerBook2 软件的产品CD支持指点和单击的安装实用程序(Solaris网络起始)。有关如何使用该实用程序的信息,请参阅CD 所附文档。
如果您没有安装文档,您的文档服务器不能正常工作。
以超级用户登录到文档服务器。
您可作为 根 从桌面登录屏幕登录或在命令行键入su 然后输入您系统的 根 口令:
将CD插入CD-ROM驱动器或转到软件所在地。
若从CD安装,卷宗管理程序会自动装配CD。
转到文档集合软件包地点。
您可从 软件地点 或其它地点安装集合,如现存的文档集合或取自其它CD的集合。
键入本命令:
# cd 软件地点 |
其中 软件地点 取决于您是否从CD安装或是否从网点获得软件包。例如,Solaris 7 文档CD的 软件地点 默认为 /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 |
在不知道URL的情况下使用户能够定位您的文档服务器,您可使用FNS系统登记服务器名称。如果知道 URL,用户还是可以访问未登记的文档服务器。
您对 FNS 命令的熟悉程度
如果您熟悉标准 FNS 命令,例如fnbind,您可用这些命令登记服务器。可是,要简化登记过程,/usr/lib/ab2/bin/ab2regsvr 命令能为您登记您的服务器。更多信息,请参阅"使用ab2regsvr命令登记您的文档服务器"和"使用标准FNS命令登记您的服务器"。
正在使用什么命名服务
NIS+(网络信息服务+)是用于 Solaris 2.6 及兼容的操作环境下的主要命名服务。如您的系统是用 NIS+ 且您拥有管理特权,当您在 NIS+ 主或 NIS+ 用户系统登录时,您可以登记服务器。
NIS(网络信息服务)是 SunOSTM 4.x (Solaris 1.x) 环境提供的标准命名服务。如果您的系统使用 NIS,您必须以根用户在 NIS 主系统登记文档服务器。
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 命令的信息,请参阅附录 B,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 |
这返回一个已登记服务器的列表,类似如下:
引用类型:onc_answerbook2 地址类型: 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登记的:
'thisorgunit/service/answerbook2' 查找失败:\ 名称未找到:'answerbook2' |
若想获得更多有关 FNS的信息,包括怎样安装,请参阅 FNS 文档。
在 Solaris 2.6 或 Solaris 7 操作环境中,用户能用用环境变量AB2_DEFAULTSERVER 定义一个默认的 AnswerBook2 服务器。例如,用户可有以下命令行在.cshrc文件中:
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888 |
如果用户没有定义环境变量,当从桌面调用 AnswerBook2 产品时,产品会查看它被调用的系统是否正在运行一个文档服务器。如果是,它将用 URL:http://localhost:端口调用,在此端口默认值为8888。
如果用户没有定义环境变量且当前系统不是一个文档服务器,当用户从桌面调用 AnswerBook2,系统将执行一个fnlookup thisorgunit/service/answerbook2 命令以找到什么文档服务器可供使用。然后它将选择其中一个,并用服务器名称作为URL调用 AnswerBook2 浏览器。
通过默认,AnswerBook2 文档服务器以NSAPI插入运行于httpd 服务器顶部。该服务器被包括在SUNWab2u 软件包内。由于 AnswerBook2 服务器以标准网络协议编译,您可以选择在您系统已有的一些其它网络服务器(例如, Netscape 服务器 或 Sun WebServer) 之外,以CGI(公用网关界面)进程运行您的文档服务器。
在此层面上更改服务器特性要求有"专业"网络知识。除非您完全熟识您网络服务器的配置和特殊要求,否则您不要试图去完成此项任务。
请注意,如果您不使用默认的 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
从AnswerBook2管理页 重新启动
自动启动特性
您将需要用您服务器的起始及停止功能。
由于网络服务器技术日新月异,无法在此列出网络服务器的各种可能配置。因此,下列一般流程是如何进行的指导方针。在进行此流程前,您应当彻底熟识您的网络浏览器的配置和特殊要求。
此流程描述您使用基于CGI的网络服务器而不是默认(NSAPI插件)服务器所需的一般步骤。
当系统重新启动时停用 AnswerBook2 服务器的自动启动功能。
使用 AnswerBook2 管理页上的修改服务器配置页或使用如下命令:
# /usr/lib/ab2/bin/ab2admin -o autostart_no |
关闭默认文档服务器的管理访问控制。
请使用如下命令:
# /usr/lib/ab2/bin/ab2admin -o access_off |
关闭 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/ 目录。
完成此更改后,请重新启动您的服务器。
若想确认您的更改,请在您的网络浏览器中键入如下URL以见帮助图标 :
http://localhost:port/icons/ab2_help.gif |
其中 port 是您的文档服务器正在运行的端口号。
将AnswerBook2 帮助文档链接到当前文档根。
请转到您的网络服务器的文档根目录并创建一个符号(软)链接到 /usr/lib/ab2/data/docs/Help。
若想确认您的更改,请在您的网络浏览器中键入如下URL以见帮助图标 :
http://localhost:port/Help/C/Help/books/AB2ADMIN/figures/ab2_help.gif |
其中 port 是您的文档服务器正在运行的端口号。
使AnswerBook2 cgi 文件可用您的服务器。
请转到您的网络服务器的cgi-bin目录并创建一个符号链接到如下:
/usr/lib/ab2/bin/ab2bin/admin /usr/lib/ab2/bin/ab2bin/nph-dweb /usr/lib/ab2/bin/ab2bin/gettransbitmap /usr/lib/ab2/bin/ab2bin/getepsf /usr/lib/ab2/bin/ab2bin/getframe |
若想确认您的更改,请在您的网络浏览器中键入如下URL以见AnswerBook2 库页:
http://localhost:port/cgi-bin/nph-dweb/ab2 |
其中 port 是您的文档服务器正在运行的端口号。
编辑您的服务器配置文件并变换/ab2/以调用AnswerBook2 cgi。
您的网络服务器文档应解释具体细节,例如哪里可以找到配置文件。您需将条目从/ab2/ 更改为 /usr/lib/ab2/bin/ab2bin/nph-dweb/ab2/。
若想确认您的更改,请重新启动服务器并在您的网络浏览器中键入如下URL以见AnswerBook2 库页:
http://localhost:port/ab2 |
其中 port 是您的文档服务器正在运行的端口号。
若您想让用户访问文档服务器而无需在URL结尾处指明/ab2,则请编辑您的服务器配置文件并将 / 变换为 /ab2/。
您的网络服务器文档应解释具体细节,例如哪里可以找到配置文件。您需将条目从 / 变换为 /ab2/ 并将 远程 标志添加到变换程序中。
若想确认您的更改,请重新启动服务器并在您的网络浏览器中键入如下URL以见AnswerBook2 库页:
http://localhost:port |
其中 port 是您的文档服务器正在运行的端口号。
编辑AnswerBook2管理配置文件。
您需要编辑 /usr/lib/ab2/bin/ab2bin/nph-dweb 文件并为 servertype、errorlog、和 accesslog更改条目。
Setenv servertype server_typesetenv errorlog complete_path_to_error_logsetenv accesslog complete_path_to_access_log |
server_type 识别您正在运行的服务器,例如 sws。
complete_path_to_error_log 是通往您网络服务器的错误记录的路径。
complete_path_to_access_log 是通往您网络服务器的访问记录的路径。
为 AnswerBook2 管理界面设置访问权控制。
为了控制谁能在文档服务器上操作管理功能,请使用您文档服务器的有关访问权控制机以限制访问如下URL:/ab2/@Ab2Admin