修改核心配置檔

festival.xml 檔是 IBM® Rational® DOORS® Web Access 中的核心配置檔。請修改 f:brokerf:repository-mappingf:properties 項目,以符合您的分配管理系統、儲存庫及授權伺服器設定。

程序

  1. 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&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
    </f:endpoints>
  2. f:repository-mapping 項目定義儲存庫的 URN。
    1. name 屬性是在 Rational DOORS Web Access 登入頁面上所顯示的名稱。您可以變更這個屬性。預設值是 DOORS ERS Repository
    2. 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>
  3. 您必須變更檔案的 f:properties 區段。
    1. 如果沒有透過其他方法(例如 Windows 登錄)配置授權伺服器,則為必要:請輸入授權伺服器的位置。更新此行中的值:
      <f:properties>
        <f:property name="licence.server.location" value="19353@localhost"/>
      此位置會新增到您系統上保留的授權位置清單中。
    2. 選擇性的: 您可以將 Rational DOORS Web Access 設定成顯示介面中現行模組的 URL。如果要顯示 URL,請將下列一行中的 value="false" 變更成 value="true"
       <f:property name="display.redirector.urls" value="false"/>
    3. 選擇性的: 如果 Rational DOORS 資料庫使用公司 LDAP 來進行使用者鑑別,您必須新增下列一行,從「歡迎使用」畫面中移除變更密碼選項。請新增這一行:
       <f:property name="change.password.enabled" value="false"/>
    4. 必要性的: ForceHttpsForAuthenticationForOAuth 設成 false
       <f:property name="ForceHttpsForAuthenticationForOAuth" value="false" />
      註: 如果 Tomcat 已配置成使用 SSL,請將 ForceHttpsForAuthenticationForOAuth 設成 true
    5. 選擇性的: 為了防止遭受偽造跨網站要求 (CSRF) 安全攻擊,請將 disable.csrf.token 設為 false。請新增這一行:
       <f:property name="disable.csrf.token" value="false"/>
    6. 選擇性的: 如果只使用 IBM Rational DOORS 用戶端授權,若要改良效能,請將 use.doors.client.license.only 設為 true。在此情況下,應用程式就不會檢查是否具備 Rational DOORS Web Access 檢閱人員和編輯者授權。這項設定的預設值是 false,亦即,應用程式會檢查所有的授權類型。請新增這一行:
       <f:property name="use.doors.client.license.only" value="true"/>
    7. 選擇性的: 對於 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"/>
    8. rrtl.fail.on.error 內容會影響使用擷取、轉換並載入 (ETL) 處理程序的報告服務。從 Rational DOORS Web Access 接收資料時,如果發生錯誤,值 true 會導致「轉換層可呈報的 REST」輸出失敗。此失敗可使呼叫端應用程式更易於偵測和疑難排解任何的 ETL 問題。
       <f:property name="rrtl.fail.on.error" value="true" />
  4. 儲存並關閉檔案。

意見