WebSphere Application Server 上配置 Rational ClearQuest 配接器

您可以提供 IBM® Rational® ClearQuest® 共用程式庫給「IBM Rational Publishing Engine 資料服務」應用程式使用,以便可以從 Rational Publishing Engine 來使用 Rational ClearQuest API。

開始之前

  • 您必須將 Rational ClearQuest 安裝在應用程式伺服器的相同電腦上。
  • 部署 Rational Publishing Engine「報告資料服務」應用程式和「報告資料服務配接器」。
  • 配置 Rational ClearQuest 共用程式庫之前,請先更正任何的防火牆警告或授權問題。

程序

  1. Rational ClearQuest 安裝架構中的共用程式庫路徑,新增至部署了「Rational Publishing Engine 資料服務」應用程式的 WebSphere® Application Server 節點中:
    1. WebSphere Application Server 中,按一下環境 > 共用程式庫
    2. 如果要指定範圍設定,請選取 Node=RationalPublishingEngineNode01, Server=RationalPublishingEngineServer 項目。 RationalPublishingEngineNode01 是節點的預設名稱,RationalPublishingEngineServer 是伺服器的預設名稱。
    3. 如果要建立共用程式庫參照,請按一下新建
    4. 設定名稱說明類別路徑的值。請確定您的類別路徑是參照正確位置中的檔案。
      表 1. 共用程式庫參照欄位
      說明
      名稱 ClearQuest CM API
      說明 ClearQuest 配接器的共用程式庫。
      類別路徑

      application_files\IBM\RationalSDLC\ClearQuest\cqjni.jar
      application_files\IBM\RationalSDLC\ClearQuest\stpcq.jar
      application_files\IBM\RationalSDLC\Common\stpcmmn.jar
      application_files\IBM\RationalSDLC\Common\stpwvcm.jar

      註: 所列出的預設值適用於 Rational ClearQuest 7.1。要使用的實際路徑,取決於所安裝的 Rational ClearQuest 版本及安裝位置。請確定您是參照其正確位置中的檔案。如果要檢視 Rational ClearQuest 安裝位置,請按一下開始 > 所有程式 > IBM Installation Manager > 檢視已安裝的套件,以便在 IBM Installation Manager 中檢查。
    5. 按一下確定儲存
  2. Rational ClearQuest 共用程式庫與「報告資料服務」應用程式設定檔產生關聯:
    1. 按一下伺服器 > Application Server
    2. 按一下部署了「資料服務」應用程式的伺服器。預設伺服器名稱是 RationalPublishingEngineServer
    3. 按一下伺服器基礎架構 > Java 和程序管理 > 類別載入器
    4. 如果要建立共用程式庫的類別載入器,請按一下新建 > 確定
    5. 如果要讓共用程式庫參照與類別載入器產生關聯,請按一下您在子步驟 2.d 中所建立的新類別載入器的超鏈結。
    6. 針對要產生關聯的每一個程式庫,按一下新增,選取程式庫,然後按一下確定
    7. 按一下共用程式庫參照
    8. 如果要與每一個程式庫產生關聯,請按一下新增,選取程式庫,然後按一下確定
    9. 按一下儲存
  3. Linux 圖示 如果您使用 Linux,請配置通用 JVM 引數:
    1. 按一下伺服器 > 伺服器類型 > WebSphere Application Server
    2. 按一下伺服器名稱。
    3. 在「伺服器基礎架構」區段中,展開 Java 和程序管理,然後按一下程序定義
    4. 按一下 Java 虛擬機器
    5. 在「通用 JVM 引數」欄位中輸入:Generic JVM arguments -Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib
    6. 按一下確定
  4. Linux 圖示 如果您使用 Linux,請配置 LD_LIBRARY_PATH 環境變數:
    1. 在「程序定義」頁面中,按一下環境項目,並按一下 LD_LIBRARY_PATH
    2. 輸入名稱,並輸入程式庫路徑。 範例:/opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
  5. 重新啟動「報告資料服務」應用程式。
  6. 驗證 IBM Rational ClearQuest 配接器和程式庫配置正確。 在瀏覽器中輸入 Rational ClearQuest 配接器的 URL。
    • 輸入 http://host:port/DataServices/ClearQuest。如果安裝正確,您會看到 Rational ClearQuest 連線清單,這和「Rational ClearQuest 維護工具」中顯示的清單相同。
    • 輸入 http://host:port/DataServices/ClearQuest/version。如果安裝正確,您會看到 Rational ClearQuest 使用者資料庫清單。
    • 輸入 http://host:port/DataServices/ClearQuest/version/database_name。如果安裝正確,您會看到查詢清單。

下一步

複製查詢 URL,以新增至範本或文件規格中。
註: 「報告資料服務」應用程式只支援含有靜態結果集的查詢。不支援動態查詢。

範例

利用 All Defects 查詢的 URL,您會看到一個結果集,其中含有查詢為 Rational ClearQuest 用戶端所傳回的命中數。每一個結果各是特定記錄類型的唯一 DBID。您可以繼續進行這項程序,直到傳回特定記錄的資料給您為止。請保留查詢 URL,以便在編寫 Rational Publishing Engine 報告時使用。

請移除包含問號和問號之後的引數:

之前:http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
之後:http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


意見