您可以編輯配置檔並執行 Derby 檔,即可將 IBM® Rational® DOORS® 配置為 Tracked Resource Sets (TRS) 的提供者。
開始之前
如果要使用 TRS 和 LQE,
您必須使用 Rational DOORS 9.4.0.1 或更新版本的資料庫伺服器,
並且必須將伺服器配置成排除舊於 9.4.0.1 版的 Rational DOORS 用戶端。如果要排除這些用戶端,
請在資料庫內容的
登入原則標籤上,將用戶端最低版本設為 9.4.0.1。
關於這項作業
Rational DOORS 和 Derby 在出貨時,會隨附幾個 TRS 啟用的預設使用者和密碼。您必須編輯與這些使用者相關聯的配置參數,如下面程序中的說明。這項整合使用下列使用者:
- LQE 功能使用者。這個使用者會處理從整合 TRS 消費者應用程式到 Rational DOORS Web Access 的 LQE 要求。這個使用者必須存在於 Rational DOORS 資料庫中。您必須在 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 festival.xml 檔。這個檔案位於 dwa_install\server\festival\config 目錄中。
- 輸入 LQE 功能使用者和 TRS 使用者的內容值,如下表中的說明。請參閱本主題結尾處這些內容的範例。
表 1. TRS 和 LQE 的 Festival.xml 檔內容內容 |
說明/值 |
ForceHttpsForAuthenticationForOAuth |
將這個值設為 true。 |
functional.user.consumer.key |
與 LQE 功能使用者相關聯的消費者金鑰。Lifecycle Query Engine 會使用它來存取 DOORS Tracked Resource Set (TRS)。這個金鑰必須在 Rational DOORS 配置「本端金鑰」視窗中。預設值是 LQE 功能使用者金鑰。 |
functional.user.consumer.secret |
與 LQE 功能使用者相關聯的消費者密碼。Lifecycle Query Engine 會使用它來存取 DOORS Tracked Resource Set (TRS)。這個密碼必須在 Rational DOORS 配置「本端金鑰」視窗中。預設值是 qwert6。 |
functional.user.name |
LQE 功能使用者的使用者名稱。這個使用者名稱必須是有效的 Rational DOORS 使用者。預設值是 LQE 功能使用者。 |
functional.user.password |
LQE 功能使用者的密碼。預設值是 qwert6。 |
trs.db.user |
TRS 啟用的使用者名稱。為簡化作業過程,請使用預設使用者名稱 trs。 |
trs.db.password |
trs.db.user 的密碼。您必須在 Derby 內容檔中指定這個密碼。預設值是 dwaTrsPa11word。 |
trs.page.size |
在頁面上所包含的 TRS 資源數目。預設值是 250。 |
trs.enable |
將這個值設為 true。 |
- 在編輯器中開啟 derby.properties 檔。這個檔案位於 dwa_install/derby 目錄中。
- 請取代下表中參數的密碼值。
表 2. 適用於 TRS 的 Derby 內容檔參數參數 |
說明 |
derby.user.trs |
您在 festival.xml 檔中所指定之 trs.db.user 的密碼。預設值是 dwaTrsPa11word。 |
derby.user.admin |
Derby 資料庫管理者的密碼。目前這個使用者未提供適用於 Rational DOORS Web Access 的功能。預設值是 dwaTrsPa11word。 |
- 執行下列批次檔:dwa_install/derby.start.bat。
- 執行下列批次檔:dwa_install/derby/scripts/init_trs.bat。
- 啟用資料變更通知 (DCN) 參數來配置 Rational DOORS 資料庫伺服器,以便和 Rational DOORS Web Access 分配管理系統與 Rational DOORS Web Access 伺服器通訊。
- 使用下列認證來登入 Rational DOORS:
- 使用者名稱:LQE 功能使用者,或是您在 festival.xml 檔中所指定的功能使用者名稱。
- 密碼:qwert6,或是您在 festival.xml 檔中所指定的功能使用者密碼。
- 選取,並請注意視窗中包含您在 festival.xml 檔中所指定的消費者金鑰和密碼。
範例
下列從
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"/>
下一步
以 OSLC 夥伴關係來配置了 TRS 消費者應用程式的整合之後,您必須將 Rational DOORS 登錄為消費者應用程式中的 TRS 提供者。舉例來說,
參閱 IBM Rational Engineering Lifecycle
Management 資訊中心中的將應用程式登錄為 Lifecycle Query Engine 的 TRS 提供者。
由 TRS 消費者應用程式(如 Rational Engineering Lifecycle Management)
所使用的 Lifecycle Query Engine (LQE),會從多個生命週期工具來建置資料的主要索引(資料庫)。每一個 TRS 提供者工具會透過 Tracked Resource Set 來發佈其資料。LQE 可從每一種工具來收集資料或「編製索引」。小組可以 SPARQL 語言來撰寫索引資料的查詢(報告)。當您在 LQE 管理應用程式中新增 Rational DOORS 的資料來源時,
請務必設定下列值:
- 起始索引的執行緒數目:1
- 增量索引的執行緒數目:1
- 更新率:60
在
管理標籤 >
配置 >
進階內容上,設定下列 HTTP 逾時值。預設值是 60 秒。增加兩個值:
- 連線逾時值(下限):5 分鐘(300 秒)
- Socket 逾時值(下限):15 分鐘(900 秒)