如果您在要部署說明的伺服器上未安裝產品,您可以在 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 開發套件 (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
當指令行公用程式中的參考訊息為伺服器將在 number 毫秒內啟動時,表示 Apache Tomcat 正在執行中。
程序
如果要部署 help.war 檔,請執行下列動作:
- 在瀏覽器中,輸入下列 URL 來開啟 Tomcat Manager 應用程式:http://localhost:8080/manager/html
- 輸入使用者名稱和密碼。
- 在區段中,按一下選擇檔案。
- 選取 help.war 檔。
- 按一下部署。 系統會部署並啟動 help.war 檔,並將檔案加入「應用程式」區段中。
help.war 檔也會複製到 CATALINA_HOME/webapps 目錄。
- 驗證您可以將 help/index.jsp 新增到伺服器應用程式 URL 的尾端(其中 help 是 .war 檔的名稱),來存取說明系統。 例如:http://localhost:8080/help/index.jsp。
註: - 說明系統可能尚未包含說明內容。接下來,將說明文件安裝到說明系統。
- 如果說明系統與產品部署在同一部 Apache Tomcat 伺服器上,當產品應用程式啟動和停止時,說明系統也會隨之啟動和停止。
下一步
- 完成下列其中一項作業,在伺服器上安裝說明內容:
- 如果其他使用者要從自己電腦上已安裝的產品來存取這個說明內容,請提供說明系統的伺服器、埠及路徑給他們。請確定所提供的伺服器不是 localhost。
範例:
http://server.ibm.com:8080/help-name/index.jsp- 伺服器:server.ibm.com
- 埠:8080
- 路徑:/help-name