festival.xml 檔是 IBM®
Rational® DOORS® Web Access 中的核心配置檔。請修改 f:broker、f:repository-mapping 及 f:properties 項目,以符合您的分配管理系統、儲存庫及授權伺服器設定。
程序
- festival.xml 檔有三個說明分配管理系統位置的 f:broker 項目。請編輯這些項目,來指向您使用預設埠 (61616) 安裝分配管理系統之系統的 URL。 如果分配管理系統與 Rational DOORS Web Access 伺服器位於相同的系統上,您就不需編輯這些項目。
<!-- Brokers we know about -->
<f:endpoints>
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
</f:endpoints>
- f:repository-mapping 項目定義儲存庫的 URN。
- name 屬性是在 Rational DOORS Web Access 登入頁面上所顯示的名稱。您可以變更這個屬性。預設值是 DOORS ERS Repository。
- repositoryUrn 屬性必須符合您在識別資料庫統一資源名稱中所識別之 Rational DOORS 資料庫伺服器的統一資源名稱(URN)。您必須變更這個屬性。
<!-- Mapping from Repository IDs to the broker we use to reach the repository -->
<f:mappings>
<f:repository-mapping
.
.
name="DOORS ERS Repository"
repositoryUrn="urn:rational:ers-46dd5d7806b96973:" />
</f:mappings>
- 您必須變更檔案的 f:properties 區段。
- 如果沒有透過其他方法(例如 Windows 登錄)配置授權伺服器,則為必要:請輸入授權伺服器的位置。更新此行中的值:
<f:properties>
<f:property name="licence.server.location" value="19353@localhost"/>
此位置會新增到您系統上保留的授權位置清單中。
- 選擇性的: 您可以將 Rational DOORS Web Access 設定成顯示介面中現行模組的 URL。如果要顯示 URL,請將下列一行中的 value="false" 變更成 value="true":
<f:property name="display.redirector.urls" value="false"/>
- 選擇性的: 如果 Rational DOORS 資料庫使用公司 LDAP 來進行使用者鑑別,您必須新增下列一行,從「歡迎使用」畫面中移除變更密碼選項。請新增這一行:
<f:property name="change.password.enabled" value="false"/>
- 必要性的: 將 ForceHttpsForAuthenticationForOAuth 設成 false:
<f:property name="ForceHttpsForAuthenticationForOAuth" value="false" />
註: 如果 Tomcat 已配置成使用 SSL,請將 ForceHttpsForAuthenticationForOAuth 設成 true。
- 選擇性的: 為了防止遭受偽造跨網站要求 (CSRF) 安全攻擊,請將 disable.csrf.token 設為 false。請新增這一行:
<f:property name="disable.csrf.token" value="false"/>
- 選擇性的: 如果只使用 IBM Rational DOORS 用戶端授權,若要改良效能,請將 use.doors.client.license.only 設為 true。在此情況下,應用程式就不會檢查是否具備 Rational DOORS Web Access 檢閱人員和編輯者授權。這項設定的預設值是 false,亦即,應用程式會檢查所有的授權類型。請新增這一行:
<f:property name="use.doors.client.license.only" value="true"/>
- 選擇性的: 對於 OSLC 鏈結所報告的物件標題,如果要修改其字元數截斷限制,請在 festival.xml 檔中設定 dcterms.title.truncation.limit 的值。當外部 OSLC 鏈結參照 Rational DOORS 物件時,依預設,會將 OSLC 欄位 dcterms:title 截斷成 100 個字元。標題中的其餘字元則以省略符號 (...) 取代。您可以將此值設為 0,以完全移除截斷,或是視需要修改該值。此設定控制所有 OSLC 整合中所有物件標題的截斷限制。如果要將值設為零,請新增此行:
<f:property name="dcterms.title.truncation.limit" value="0"/>
- rrtl.fail.on.error 內容會影響使用擷取、轉換並載入 (ETL) 處理程序的報告服務。從 Rational DOORS Web Access 接收資料時,如果發生錯誤,值 true
會導致「轉換層可呈報的 REST」輸出失敗。此失敗可使呼叫端應用程式更易於偵測和疑難排解任何的 ETL 問題。
<f:property name="rrtl.fail.on.error" value="true" />
- 儲存並關閉檔案。