如果您未在要部署帮助的服务器上安装产品,那么可以使用 Apache Tomcat 作为要将帮助系统部署到的简单应用程序服务器解决方案。
开始之前
- 您要在其上配置帮助内容的服务器必须可供位于防火墙后的用户使用。
- 确保您在服务器上拥有可用的 help.war 文件。
- 如果您安装了要在服务器上配置帮助的产品,那么可能已经安装了 help.war 文件。
- 在 installation_directory/help 目录中查找 help.war 文件。
- 查找包含了产品缩写的文件版本,如 clmhelp.war 或 ramhelp.war。
- 在安装目录中搜索 *help.war。
- 如果您未在服务器上安装产品或者您的产品不包含 help.war 文件,请下载 help.war 文件的一个版本。
- 安装并配置 Apache Tomcat。
- 安装 Java™ 运行时环境 (JRE) 或 Java Development Kit (JDK)。您可以选择安装 IBM® Developer Kit 之一。
- 设置一个包含 JRE 或 JDK 的路径的环境变量:
- 如果您已安装了 JRE,请创建 JRE_HOME 环境变量并将值设置为您安装了 JRE 的目录的路径。示例:
- Windows:C:\Program
Files\Java70\jre
- Linux:/usr/local/java70/jre
- 如果您已安装了 JDK,请创建 JAVA_HOME 环境变量并将值设置为您安装了 JDK 的目录的路径。示例:
- Windows:C:\Program Files\Java70
- Linux:/usr/local/java70/
- 下载 Apache Tomcat 服务器应用程序。
- 抽取 Apache Tomcat 归档。
- 将抽取的文件夹移到永久位置。此位置名为 CATALINA_HOME。
示例:C:\apache-tomcat-version
- 创建一个 CATALINA_HOME 环境变量并将值设置为 CATALINA_HOME 目录。示例:C:\apache-tomcat-version
- 向 CATALINA_HOME/conf/tomcat-users.xml 文件中添加一个服务器管理员用户并保存更改。示例:
<role rolename="manager-gui"/>
<user username="admin" password="admin" roles="manager-gui"/>
- 打开 CATALINA_HOME/bin 目录并运行启动文件以启动 Apache Tomcat 服务器。
- Windows:startup.bat
- Linux:startup.sh
当参考消息在命令行实用程序中显示 Server
Startup in number ms 时,Apache Tomcat 便在运行。
过程
要部署 help.war,请完成以下步骤:
- 在浏览器中,输入以下 URL 以打开 Tomcat Manager 应用程序:http://localhost:8080/manager/html。
- 输入用户名和密码。
- 在部分中,单击选择文件。
- 选择 help.war 文件。
- 单击部署。 help.war 文件已部署和启动,并显示在“应用程序”部分中。
help.war 文件还已复制到 CATALINA_HOME/webapps 目录。
- 通过向服务器应用程序 URL 的末尾添加 help/index.jsp 来验证您是否可以访问帮助系统,其中 help 是您的 .war 文件的名称。示例:http://localhost:8080/help/index.jsp。
注: - 帮助系统可能尚不包含帮助内容。您接下来可能需要将文档安装到帮助系统中。
- 如果您的帮助系统与产品部署在同一 Apache Tomcat 服务器上,那么帮助系统会在产品应用程序启动和停止时启动和停止。
下一步做什么
- 在服务器上安装文档:
- 为贵组织中的用户提供要在用户的首选项中输入的信息中心 URL。确保您提供的服务器不是 localhost。
示例:http://server.ibm.com:8080/help/index.jsp