如果未在要部署帮助的服务器上安装产品,可在 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 以打开 Apache Tomcat 应用程序: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