將應用程式登錄為「生命週期查詢引擎」的 TRS 提供者

如果您使用 Rational® Engineering Lifecycle Manager,需要其他的配置步驟來將產品設定為 TRS 提供者,以提供「生命週期查詢引擎」存取其資料。如果您不是使用 Rational Engineering Lifecycle Manager,則不需要完成本節的步驟。

在您安裝及配置所有應用程式,並建立遠端伺服器上之各應用程式之間的夥伴關係之後,您必須將每個應用程式設定為「已追蹤資源集 (TRS)」提供者,以便「生命週期查詢引擎」在建立索引時能夠存取它們的資料。

必要條件:

指派 TRS 消費者內部授權

將「TRS 消費者內部授權」指派給 lqe_userjts_user 功能使用者。

  1. 開啟 JTS 管理主控台,位置如下:https://host_name:port/jts/admin
  2. 選取使用者 > 作用中使用者
  3. 按一下 lqe_user 鏈結。在 lqe_user 頁面上,移至用戶端存取授權區域,選取 TRS 消費者內部,然後按一下儲存
    選取主要 LQE 使用者的「TRS 消費者內部授權」
  4. 回到作用中使用者頁面。 按一下 jts_user 鏈結。 在 jts_user 頁面上,移至用戶端存取授權區域,然後選取 TRS 消費者內部
  5. 按一下儲存

針對 CLM 應用程式來配置 TRS

如果這些應用程式是部署在與 LQE 相同的 Jazz™ Team Server 上,則不需要建立入埠消費者。只有當 CCM、QM 和 RM 應用程式位在個別的 Jazz Team Server 時,才需要完成這些步驟。

  1. 建立 CCM 的「LQE 入埠消費者」金鑰。開啟 CCM 管理頁面:https://host_name:port/ccm/admin
  2. 應用程式頁面中,選取通訊 >消費者(入埠), 建立一個 LQE 的新 「OAuth 消費者」金鑰:
    • 名稱:LQE
    • 密碼:xyz
    • 授信:
    按一下登錄
  3. 移至授權金鑰清單,按一下鉛筆圖示來編輯 LQE 項目。
  4. 編輯消費者金鑰內容對話框中,按一下選取使用者... 鏈結。
  5. 在過濾器欄位中,輸入 lqe,從符合使用者清單中選取 lqe_user。 按一下新增和關閉,然後按一下完成
  6. 建立 QM 的「LQE 入埠消費者」金鑰。開啟 QM 管理頁面:https://host_name:port/qm/admin,然後再次完成步驟 7 到 10。
  7. 如果這是您的 RM 應用程式,請建立 DOORS® Next Generation 的「LQE 入埠消費者」金鑰。開啟 RM 管理頁面:https://host_name:port/rm/admin,然後再次完成步驟 7 到 10。
  8. 將應用程式登錄為 TRS 提供者,然後產生它的索引。開啟「生命週期查詢引擎」管理頁面:https://host_name:port/lqe/web
  9. 按一下管理 > 資料來源 > 新增資料來源
  10. 新增資料來源對話框中,選取 https://host_name:port/ccm/oslc/workitem/trs,然後新增 RTC 標籤。接受其餘預設值(如果您有大量要編製索引的資料,您可以增加執行緒數目,起始索引為 4),然後按一下完成
  11. 將 QM 登錄為 TRS 提供者,產生它的索引。在資料來源頁面中,按一下新增資料來源
  12. 新增資料來源對話框中,選取 https://host_name:port/qm/trs,然後新增 RQM 標籤。接受其餘預設值,然後按一下完成
  13. 將 RM 登錄為 TRS 提供者,產生它的索引。在資料來源頁面中,按一下新增資料來源
  14. 新增資料來源對話框中,選取 https://host_name:port/rm/trs,然後新增 DNG 標籤。接受其餘預設值,然後按一下完成

現在您的 Rational Team Concert™、Rational Quality Manager 和 Rational DOORS Next Generation 應用程式已編製索引,可供 Rational Engineering Lifecycle Manager 使用。請參閱「生命週期查詢引擎」說明文件,以取得持續編製索引之喜好設定的相關資訊:利用生命週期查詢引擎編製您的資料索引

將 DOORS 和 DOORS Web Access 配置成 TRS 提供者

Rational DOORS 和 Derby 隨附了若干可供啟用 TRS 的預設使用者和密碼。 您必須依照下列程序所說明來編輯與這些使用者相關聯的配置參數。 這項整合使用下列使用者:
  • LQE 功能使用者。 這個使用者會處理整合 TRS 消費者應用程式向 Rational DOORS Web Access 發出的 LQE 要求。 這個使用者必須在 Rational DOORS 資料庫中。您必須在 festival.xml 檔中指定這個使用者的參數。
  • trs.db.user。這是有權存取 TRS 資料庫資料的 Derby 資料庫使用者。 Rational DOORS Web Access 利用它來擷取資料庫中的資料。 您必須在 festival.xml 檔及 Derby 內容檔中指定這個使用者的密碼。
  • derby.user.admin。這是 Derby 資料庫管理者。 目前,這個使用者不提供 Rational DOORS Web Access 或 Derby 資料庫的功能。 您可以在 Derby 內容檔中,設定這個使用者的密碼。
  1. 開啟 [DWA_path]\server\festival\config\festival.xml
    1. 搜尋可配置的系統內容區段。
    2. oauth.domain 內容之下, 新增下表所列的內容,替換成您的 DOORS 管理 ID 和密碼,然後選取一個消費者金鑰和密碼。 這些內容的格式應該如下:
      <f:property name="functional.user.consumer.key" value="consumer_key" />
    表 1. TRS 和 LQE 的 Festival.xml 檔內容
    內容 說明/值
    ForceHttpsForAuthenticationForOAuth 將這個值設為 true
    oauth.domain 將這個值設為 https://server:port/dwa,其中 server 是伺服器網域名稱或 IP 位址。
    functional.user.consumer.key 與「LQE 功能使用者」相關聯的消費者金鑰。 「生命週期查詢引擎」利用它來存取「DOORS 已追蹤資源集 (TRS)」。 這個金鑰必須在 Rational DOORS 配置本端金鑰標籤上。 預設值是 LQE 功能使用者金鑰
    functional.user.consumer.secret 與「LQE 功能使用者」相關聯的消費者密碼。 「生命週期查詢引擎」利用它來存取「DOORS 已追蹤資源集 (TRS)」。 這個密碼必須在 Rational DOORS 配置本端金鑰標籤上。 預設值是 qwert6
    functional.user.name 「LQE 功能使用者」的使用者名稱。 這個使用者名稱必須是有效的 Rational DOORS 使用者。 預設值是 LQE 功能使用者
    functional.user.password 「LQE 功能使用者」的密碼。 預設值是 qwert6
    trs.db.user 啟用 TRS 的使用者名稱。 為了簡單,請使用預設使用者名稱 trs.db.user
    trs.db.password trs.db.user 的密碼。 您也必須在 Derby 內容檔中指定這個密碼。
    trs.page.size 要併入頁面中的 TRS 資源數目。預設值是 250
    trs.enable 將這個值設為 true
  2. 在編輯器中,開啟 derby.properties 檔。 這個檔案是在 dwa_install/derby 目錄中。
  3. 取代下表中各參數的密碼值。
    表 2. TRS 的 Derby 內容檔參數
    參數 說明
    derby.user.trs 您在 festival.xml 檔中指定的 trs.db.user 的密碼。預設值是 dwaTrsPa11word
    derby.user.admin Derby 資料庫管理者的密碼。 目前,這個使用者不提供 Rational DOORS Web Access 或 Derby 資料庫的功能。 預設值是 dwaTrsPa11word
  4. 執行下列批次檔:dwa_install/derby.start.bat
  5. 執行下列批次檔:dwa_install/derby/scripts/init_trs.bat
  6. 啟用「資料變更通知 (DCN)」參數,配置 Rational DOORS 資料庫伺服器來與 Rational DOORS Web Access 分配管理系統及 Rational DOORS Web Access 伺服器通訊。如需這個主題的相關資訊,請參閱:http://publib.boulder.ibm.com/infocenter/doorshlp/v9/index.jsp?topic=/com.ibm.rational.dwa.install.doc/topics/c_setupddbs.html
  7. 依照下列順序,重新啟動 DOORS Web Access 伺服器:
    1. 分配管理系統
    2. 交互作業能力
    3. 資料庫伺服器
    4. Web 應用程式伺服器
  8. 利用這些認證來登入 Rational DOORS:
    • 使用者名稱:LQE 功能使用者,或您在 festival.xml 檔中指定的功能使用者名稱。
    • 密碼:qwert6,或您在 festival.xml 檔中指定的功能使用者密碼。
  9. 檔案功能表中,選取 OSLC...本端金鑰,然後按一下新增
    • 名稱:LQE
    • 金鑰:xyz
    • 密碼:xyz
    按一下登錄,然後按確定
  10. 檔案功能表中,選取 OSLC...工作集
  11. 選取專案窗格中,尋找需求資料夾,然後在選取模組窗格中選取此資料夾包含的所有模組。按一下套用

配置 LQE 來使用 DOORS Web Access 作為資料來源

  1. 導覽至 https://hostname:port/lqe/web
  2. 在工具列功能表中,選取管理
  3. 資料來源頁面中,選取新增資料來源
  4. 新增資料來源對話框中, 選取「根服務文件 URL」選項,輸入 DOORS 根服務 URL,選取 TRS URL,輸入標籤,然後選取指定鑑別詳細資料
    • 根服務 URL:https://doorsserver:port/dwa/public/rootservices
    • 選取 https://doorsserver:port/dwa/rm/trs
    • 標籤:DOORS
    新增至 LQE 的 DOORS 之「資料來源」值的畫面擷取
  5. 輸入消費者金鑰和密碼。
    註: 消費者金鑰和密碼必須符合 DOORS Web Access Festival.XML 檔中的值。
    <f:property name="functional.user.consumer.key" value="xyz"/>
    <f:property name="functional.user.consumer.secret" value="xyz"/>
    消費者金鑰和密碼的畫面擷取
  6. 將第一次及增量編製索引的執行緒數目設為 1,然後按一下完成。 如果使用多個執行緒來編製索引,有時會發生錯誤。

配置 Rhapsody Design Manager 應用程式的 TRS

  1. 導覽至 https://hostname:port/jts/admin
    註: Design Manager 入埠消費者是在 Jazz Team Server 管理主控台中定義,而不是 Design Manager 主控台。
  2. 選取伺服器 > 消費者(入埠),輸入下列內容,然後按一下登錄
    • 名稱:LQE
    • 密碼:xyz
    • 授信:是
  3. 移至授權金鑰清單,按一下鉛筆圖示來編輯 LQE 項目。
  4. 編輯消費者金鑰內容對話框中,按一下選取使用者... 鏈結。
  5. 在過濾器欄位中,輸入 lqe,從符合使用者清單中選取 lqe_user。 按一下新增和關閉,然後按一下完成
  6. 導覽至 https://hostname:port/dm/web
  7. 以管理使用者的身分登入。
  8. 選取您的專案區域,然後從管理下拉功能表(齒輪圖示)中,選取管理專案內容。 選取預設 OSLC 環境定義,然後按一下選取,再按一下您的專案名稱,然後按確定,再按一下儲存
    選取您的「專案區域」,確定已指派預設 OSLC 環境定義。
  9. 將 Rhapsody® DM 登錄為 TRS 提供者,並產生它的索引。開啟「生命週期查詢引擎」管理頁面:https://lqe_host_name:port/lqe/web
  10. 按一下管理 > 資料來源 > 新增資料來源
  11. 新增資料來源對話框中,選取 http://rdm_host_name:9443/dm/trs,然後新增 RDM 標籤。 接受其餘預設值(如果您有大量要編製索引的資料,您可以增加執行緒數目,起始索引為 4),然後按一下完成

配置 Rational Engineering Lifecycle Manager 應用程式的 TRS

如果是新建安裝,就不會有任何資料可供編製索引。 您可以建立一個專案和產品範例,以便確認已順利建立索引。

  1. 開啟「生命週期查詢引擎」管理頁面:https://lqe_host_name:port/lqe/web
  2. 按一下管理 > 資料來源 > 新增資料來源
  3. 新增資料來源對話框中,選取 http://relm_host_name:port/productdef/resource/tracked_resource_set,然後新增 RELM 標籤。接受其餘預設值(如果您有大量要編製索引的資料,您可以增加執行緒數目,起始索引為 4),然後按一下完成
    資料來源清單,其中顯示已編製所有元件的索引。
  4. 如果要測試索引,請開啟 Rational Engineering Lifecycle Manager:https://relm_host_name:port/relm/web
  5. 選取一個專案範例。從查詢功能表中,選取共用查詢
  6. 展開「範例」節點,然後選取所有構件。 系統可能會提示您對所查詢的所有應用程式進行授權。 在您想要查詢的每個應用程式旁,按一下授權
    使用者授權畫面
  7. 查詢結果應該會顯示您建立的產品範例。

配置 Jazz Team Server 使用者的 TRS

  1. 開啟「生命週期查詢引擎」管理頁面:https://lqe_host_name:port/lqe/web
  2. 按一下管理 > 資料來源 > 新增資料來源
  3. 新增資料來源對話框中,選取 http://host_name:port/jts/trsUsers,然後新增使用者標籤。接受其餘預設值,然後按一下完成

意見