將「報告資料服務配接器」部署在 Apache Tomcat 上

您可以將「報告資料服務配接器」部署在 Apache Tomcat 伺服器上。

開始之前

您必須先安裝 Apache Tomcat,以及安裝 Rational® Publishing Engine 和「報告資料服務」應用程式,才能部署「報告資料服務配接器」。

如果您使用 IBM® Rational RequisitePro® 配接器,請配置 Apache Tomcat 引數:
  1. 新增 JVM 一般選項:DRJCB_IN_MTA_ONLY='RJCB' –Xquickstart
    • 如果 Apache Tomcat 是作為一項 Windows 服務來執行,請在 Java 選項欄位中新增這個參數。
    • 如果是從指令行執行 Apache Tomcat,在啟動 Apache Tomcat 之前,請先將這個選項設為環境參數:set JAVA_OPTS=%JAVA_OPTS% -DRJCB_IN_MTA_ONLY='RJCB'-Xquickstart -Xmx512m
      小心: -Xquickstart 選項必須包含連字號 (-),而不是短破折號 () 或長破折號 ()。 複製這個主題中的程式碼片段,可能會將連字號轉換成短破折號或長破折號。 當出現這個轉換時,會發生錯誤,造成 Apache Tomcat 無法啟動。
  2. 記憶體儲存區上限欄位中,輸入 512 MB。
    「Apache Tomcat 6 內容」視窗的 Java 標籤

關於這項作業

這項設定適用於 IBM Rational ClearQuest®IBM Rational RequisiteProIBM Rational ClearCase®。單一資料配接器可以提供多個 Rational Publishing Engine 用戶端的通訊介面。 基於效能考量,請勿將「報告資料服務配接器」安裝在與資料庫相同的伺服器上。在安裝「報告資料服務配接器」的電腦上,您也必須安裝資料庫的原生用戶端(Rational RequisitePro 大型用戶端、Rational ClearQuest Eclipse 用戶端及其他)。在已安裝「報告資料服務配接器」的電腦上,「報告資料服務配接器」會利用原生用戶端來與資料庫通訊。許多 Rational Publishing Engine 用戶端,即使是在不同的位置,都會利用 http://server:port/DataServices/Adapter/<data> 來連接到「報告資料服務配接器」。

程序

  1. 新增配接器檔案到 Apache Tomcat 資料服務目錄中。 這時會使用 Apache Tomcat 的預設目錄:
    1. 複製 %RPE_HOME%\web services\Data Services\product_name\eclipse\plugins 目錄的內容,將它們貼到 Apache Tomcat 資料服務目錄的 plugins 資料夾中。 依預設,這個目錄的位置是 %CATALINA_HOME%\DataServices\WEB-INF\eclipse\plugins
    2. 複製 %RPE_HOME%\web services\Data Services\product_name\eclipse\features 目錄的內容,將它們貼到 Apache Tomcat 資料服務目錄的 features 資料夾中。 依預設,這個目錄的位置是 %CATALINA_HOME%\DataServices\WEB-INF\eclipse\features
    請勿刪除目錄所包含的任何其他檔案。 每個配接器的外掛程式都必須與 Web 應用程式的外掛程式合併起來。
  2. 開啟 Apache Tomcat Manager
    • 如果您將 Apache Tomcat 當成 Windows 服務來執行,請開啟「控制台」,並在 Apache Tomcat 列中,按一下管理。然後按一下管理應用程式
    • 如果您沒有將 Apache Tomcat 當成 Windows 服務來執行, 請在瀏覽器中,以下列格式來開啟 Apache Tomcat Manager:http://server:port/manager/html

      範例:http://localhost:8080/manager/html

  3. 重新啟動應用程式伺服器。

下一步

  1. 驗證「報告資料服務配接器」部署正確。在瀏覽器中,輸入 http://server:port/DataServices.war_context_path。 如果部署正確,頁面會顯示每個已安裝的配接器的 XML 清單。
  2. 必要的話,請為您的產品配置「報告資料服務配接器」

意見