通过将本地安装的基于 Eclipse 的信息中心与 WebSphere ESB 文档插件配合使用,就可以脱机(即,不需要访问互联网)使用 WebSphere ESB 信息。或者,也可以使用 Adobe Acrobat Reader 来阅读 WebSphere ESB PDF 文档。
在开始之前
在 Web 上提供了 WebSphere ESB 文档插件和 PDF 文档。因此,为了下载这些文件,需要临时访问互联网。在下载想要的文件之后,无须继续与互联网保持连接就可以使用这些文档了。
执行此任务的目的和时间
如果想要脱机(即,不需要访问 Web)使用
WebSphere ESB 信息,则可以下载
WebSphere ESB 文档插件并在本地信息中心中使用它,或者,下载
WebSphere ESB PDF 文档,并使用 Adobe Acrobat Reader 的本地副本来阅读。
本主题描述如何使用随 WebSphere ESB 一起提供的“IBM Eclipse 帮助系统”。或者,您可以在另一个基于 Eclipse 的信息中心中使用 WebSphere ESB 文档插件,例如,将信息集成在您自己现有的信息中心中。
如果想要使用 WebSphere ESB PDF 文档,请参阅 WebSphere ESB PDF 文档。
完成此任务需要执行的步骤
- 安装“IBM Eclipse 帮助系统”。
有关安装“IBM Eclipse 帮助系统”的更多信息,请参阅安装软件包的 CD2 上的 IEHS 目录中提供的自述文件。
要安装“IBM Eclipse 帮助系统”,请完成下列子步骤:
- 将 CD2 插入驱动器中。
- 将安装软件包的内容解压缩到系统中,并保留目录结构。 例如,在 Windows 上,使用以下命令来将帮助系统解压缩到 C:\ibm_help 目录中:
unzip IBM-Help-Win32.zip -d C:\
iehs_install\ibm_help 目录中包含“IBM Eclipse 帮助系统”及其嵌入式的 JRE,其中 iehs_install 表示要将帮助系统安装软件包中的内容解压缩到的目录。
- 下载产品文档插件。
在 http://www.ibm.com/software/integration/wsesb/library/infocenter/ 这个 Web 页面中提供了 WebSphere ESB 文档插件,它是一个 ZIP 文件。
- 将文档 ZIP 文件下载到一个方便的位置。 下载该文件可能要花 20 分钟以上,这取决于您的连接速度。
- 将该 ZIP 文件的内容解压缩到 iehs_install\ibm_help\eclipse\plugins 目录中,并保留目录结构。
在 iehs_install\ibm_help\eclipse\plugins 目录中,您应该看到产品文档的许多插件目录,如下所示:- com.ibm.websphere.wesb.doc_6.0.1
- 这是主要的 WebSphere ESB 文档插件。此插件将导致 WebSphere ESB 条目出现在帮助系统导航中。
- com.ibm.websphere.nd.doc_6.0.2
- 这是 IBM WebSphere Application Server Network Deployment(已将它构建到 WebSphere ESB 中)的文档插件。
- com.ibm.websphere.wscc.doc
- 这是 IBM Web Services Client for C++ 的文档插件。
- com.ibm.websphere.xms.doc
- IBM Message Service Client for C/C++ 和 Message Service Client for .NET
如果您未看到这些目录,则检查您是否正确解压缩了 ZIP 文件的内容。
- 启动“IBM Eclipse 帮助系统”
可以通过运行 iehs_install\ibm_help 目录中的脚本文件来启动“IBM Eclipse 帮助系统”。
随帮助系统一起提供的脚本文件将使用嵌入式的 JRE 来启动帮助系统。如果不想使用嵌入式的
JRE,则必须安装 JRE V1.4.2 或更高版本,然后修改启动和停止脚本以使用该 JRE。
可以采用下面任何一种方式来启动“IBM Eclipse 帮助系统”:
- 独立方式
- 使用独立方式时,“IBM Eclipse 帮助系统”会自动启动 Web 浏览器来显示帮助内容。当采用独立方式运行时,只有该系统上的用户才能查看帮助内容。帮助内容和菜单显示在系统语言环境中。
- 信息中心方式
- 当使用信息中心方式时,“IBM Eclipse 帮助系统”将在用户定义的端口(缺省端口为 8888)上启动 Web 应用程序,而在与该系统建立了网络连接的任何 Web 浏览器上都可以查看帮助内容。帮助页面和菜单显示在用户的 Web 浏览器的语言环境中。
提供了样本脚本,以便在每种方式下启动和停止帮助系统。在“IBM Eclipse 帮助系统”启动之后,即使所有活动的 Web 浏览器都已关闭,它仍会继续运行。必须使用适当的停止脚本来显式停止“IBM Eclipse 帮助系统”。
可以使用一些选项来定制脚本文件,以便满足特殊需要。有关可用选项的更多信息,请参阅该帮助系统的自述文件。
选项 |
描述 |
独立方式 |
从 iehs_install\ibm_help 中,运行
IC_start.bat 或 IC_start.sh 文件。将出现帮助系统的命令行窗口。 要查看帮助内容,打开 Web 浏览器,然后输入 URL:http://servername:port/help,其中 servername 是安装了“IBM Eclipse 帮助系统”的系统的主机名或 IP 地址。
|
信息中心方式 |
- 从 iehs_install\ibm_help 中,运行
help_start.bat 或 help_start.sh 文件。将出现帮助系统的命令行窗口。
- 如果操作系统中已经设置了缺省浏览器,则帮助系统会自动打开 Web 浏览器并显示帮助内容。
|
- 验证产品文档是否按预期一样显示。
如果您已经正确地将文档 ZIP 文件解压缩,但是帮助系统仍然未采用期望的本地语言来显示或者未显示正确的帮助主题,则您可以进行多项检查以找出故障原因。例如,将 osgi.checkConfiguration=true 添加至 iehs_install\ibm_help\configuration\config.ini 配置文件。此设置将导致系统查找并配置新的本地语言包。
有关对“IBM Eclipse 帮助系统”的问题进行故障诊断的更多信息,请参阅随安装软件包一起提供的自述文件。
下一步做什么?
可以从 IBM 或第三方供应商下载其他文档插件,并将它们用于同一个帮助系统中,从而构建一个更全面的信息中心。