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

您可以編輯配置檔,並執行 Derby 批次檔, 來將 IBM® Rational® DOORS® Web Access 配置成追蹤資源集 (TRS) 的提供者。

關於這項作業

Rational DOORS 和 Derby 隨附了若干預設使用者和密碼, 用來啟用 TRS。如果您修改使用者名稱或密碼,您必須按照下列程序的說明,編輯那些使用者相關聯的配置參數。整合使用的使用者如下:
LQE 功能使用者
這個 Rational DOORS 標準使用者會處理整合 TRS 消費者應用程式傳給 Rational DOORS Web Access 的 Lifecycle Query Engine 要求。如果這個使用者的使用者名稱與密碼不同於預設值, 那些值必須符合 festival.xml 檔中的項目,如下列程序所述。
trs.db.user
這個 Derby 資料庫使用者可以存取 TRS 資料庫資料, 並供 Rational DOORS Web Access 用來擷取資料庫中的資料。如果您想使用預設使用者名稱和密碼以外的值, 您必須在 festival.xml 檔中建立其項目。如果您變更密碼,必須在 Derby 內容檔中輸入新密碼。
derby.user.admin
這個 Derby 資料庫管理者目前不提供適用於 Rational DOORS Web Access 的功能。您必須在 Derby 內容檔中設定這個使用者的密碼。
重要: 管理者必須採取行動來維護 Derby 資料庫的完整性,並防止資料庫毀損。如需相關資訊, 請參閱《Derby 伺服器和管理手冊》中的「維護資料庫完整性」。

程序

  1. 遵循啟動、停止和移除 Rational DOORS Web Access 中的說明, 停止 Rational DOORS Web Access 所有元件。
  2. 建立 festival.xml 檔的備份副本,並在編輯器中開啟原始檔。這個檔案位於 dwa_install\server\festival\config 目錄中。
  3. 針對「LQE 功能使用者」和 TRS 使用者,輸入下列內容值:
    ForceHttpsForAuthenticationForOAuth
    將這個值設為 true
    functional.user.consumer.key
    這個消費者金鑰與「LQE 功能使用者」相關聯。LQE 會使用這個金鑰來存取 Rational DOORS TRS。這個金鑰必須符合 Rational DOORS 配置之「本端金鑰」視窗中的消費者金鑰項目。預設值是 LQE Functional User Key。只有在您使用預設值以外的值時, 才需在 festival.xml 檔中提供這個內容。
    functional.user.consumer.secret
    這個消費者密碼與「LQE 功能使用者」相關聯。LQE 會使用這個金鑰來存取 Rational DOORS TRS。這個密碼必須符合 Rational DOORS 配置之「本端金鑰」視窗中的 OAuth 密碼項目。預設值是 qwert6。只有在您使用預設值以外的值時, 才需在 festival.xml 檔中提供這個內容。
    functional.user.name
    這個內容是「LQE 功能使用者」的使用者名稱。這個使用者必須是 Rational DOORS 標準使用者, 並且對於要在 LQE 中使用的所有 Rational DOORS 資料具備讀取權。這個值必須符合 Rational DOORS 配置之「本端金鑰」視窗中的消費者名稱項目。預設值是 LQE Functional User。只有在您使用預設值以外的值時, 才需在 festival.xml 檔中提供這個內容。
    functional.user.password
    這個內容是「LQE 功能使用者」的密碼。預設值是 qwert6。只有在您使用預設值以外的值時, 才需在 festival.xml 檔中提供這個內容。
    trs.db.user
    這個內容是用來啟用 TRS 的使用者名稱。預設使用者名稱是 trs。只有在您使用預設值以外的值時, 才需在 festival.xml 檔中提供這個內容。
    trs.db.password
    這個內容是 trs.db.user 的密碼。預設值是 dwaTrsPa11word。只有在您使用預設值以外的值時, 才需在 festival.xml 檔中提供這個內容。如果您使用預設值以外的值,必須按照這項程序的後續步驟,在 Derby 內容檔中輸入新密碼。
    trs.page.size
    這個內容指出一頁所包含的 TRS 數目。預設值是 250
    trs.enable
    將這個值設為 true
    以下擷取自 festival.xml 檔,顯示 TRS 相關內容的範例:
    <f:property name="ForceHttpsForAuthenticationForOAuth" value="true"/> 
    <f:property name="functional.user.consumer.key" value="LQE Functional User Key"/> 
    <f:property name="functional.user.consumer.secret" value=qwert6"/> 
    <f:property name="functional.user.name" value="LQE Functional User"/> 
    <f:property name="functional.user.password" value="qwert6"/> 
    <f:property name="trs.enable" value="true"/>
  4. 儲存並關閉 festival.xml 檔。
  5. 如果您在 festival.xml 檔中變更 trs.db.password 的預設值,請遵循下列步驟:
    1. 在編輯器中開啟 derby.properties 檔。檔案位於 dwa_install/derby 目錄。
    2. 取代 derby.user.trs 值。derby.properties 檔包含下列值:
      derby.user.trs
      這是您在 festival.xml 檔中指定之 trs.db.user 的密碼。預設值是 dwaTrsPa11word
      derby.user.admin
      這是 Derby 資料庫管理者的密碼。目前該使用者未提供適用於 Rational DOORS Web Access 的功能。預設值是 dwaTrsPa11word
  6. 遵循啟動、停止和移除 Rational DOORS Web Access 中的說明, 啟動 Rational DOORS Web Access 所有元件。

下一步

以 OSLC 夥伴關係來配置 TRS 消費者應用程式的整合之後,您必須將 Rational DOORS 登錄為消費者應用程式中的 TRS 提供者。如需該程序的範例,請參閱 IBM Rational Engineering Lifecycle Management 說明文件中的「將應用程式登錄為 Lifecycle Query Engine 的 TRS 提供者」。

TRS 消費者應用程式(如 Rational Engineering Lifecycle Management)所使用的 LQE, 會從多個生命週期工具來建置資料的主要索引或資料庫。每一個 TRS 提供者工具會透過 TRS 來發佈其資料。LQE 可從每一種工具收集資料或編製資料的索引。團隊可以用 SPARQL 語言, 撰寫索引資料的查詢(類似於報告)。當您在 LQE 管理應用程式中新增 Rational DOORS 的資料來源時, 請設定下列值:
  • 起始編製索引的執行緒數目:1
  • 增量編製索引的執行緒數目:1
  • 更新率:60
管理標籤中, 按一下配置 > 進階內容, 並設定下列 HTTP 逾時值。預設值是 60 秒。增加兩個值:
  • 連線逾時值(下限):5 分鐘(300 秒)
  • Socket 逾時值(下限):15 分鐘(900 秒)

意見