您可以編輯配置檔,並執行 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 伺服器和管理手冊》中的「維護資料庫完整性」。
程序
- 遵循啟動、停止和移除 Rational DOORS Web Access 中的說明,停止 Rational DOORS Web Access 所有元件。
- 建立 festival.xml 檔的備份副本,並在編輯器中開啟原始檔。這個檔案位於 dwa_install\server\festival\config 目錄中。
- 針對「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"/>
- 儲存並關閉 festival.xml 檔。
- 如果您在 festival.xml 檔中變更 trs.db.password 的預設值,請遵循下列步驟:
- 在編輯器中開啟 derby.properties 檔。檔案位於 dwa_install/derby 目錄。
- 取代 derby.user.trs 值。derby.properties 檔包含下列值:
- derby.user.trs
- 這是您在 festival.xml 檔中指定之 trs.db.user 的密碼。預設值是 dwaTrsPa11word。
- derby.user.admin
- 這是 Derby 資料庫管理者的密碼。目前該使用者未提供適用於 Rational
DOORS Web Access 的功能。預設值是 dwaTrsPa11word。
- 遵循啟動、停止和移除 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 秒)