建立和修改外部儲存庫連線

外部儲存庫連線是一個 Rational Team Concert™ 項目,其內容含有 Jazz™ Team Server 建立與外部儲存庫的連線時所需的資訊。您必須建立「ClearQuest® 閘道」的外部儲存庫連線。
開始之前

如果要建立、修改和刪除外部儲存庫連線,您必須被指派「開發人員用戶端存取授權」或「ClearQuest Connector 用戶端存取授權」。 此外,專案區域也必須配置成對您的使用者角色授與許可權。 如果要設定許可權,請開啟專案區域,按一下程序配置標籤,按一下專案配置 > 許可權,選取一個角色,然後在允許的動作清單中選取項目連接器

執行這項作業的原因和時機

您可以使用「ClearQuest Connector 設定精靈」,來建立外部儲存庫連線。 這個主題說明如何使用 Rational Team Concert Eclipse 用戶端,來建立外部儲存庫連線。 其中也說明如何停用或啟用外部儲存庫連線的送出同步化。 如果您使用「ClearQuest Connector 設定精靈」來建立外部儲存庫連線,您必須啟用它的送出同步化。 精靈所建立的外部儲存庫連線會停用送出同步化。

如果要建立外部儲存庫連線,請執行下列動作:

  1. 登入 Rational Team Concert 用戶端。
  2. 團隊構件視圖中,用滑鼠右鍵按一下儲存庫連線,選取管理 > 同步化規則。 在同步化規則視圖中,用滑鼠右鍵按一下外部儲存庫連線,然後選取新建 > 外部儲存庫連線
  3. 如果您登入多個 Jazz 儲存庫,請選取您想要建立外部儲存庫連線的 Jazz 儲存庫。 按下一步。 在「外部儲存庫連線」視窗的名稱欄位中,輸入連線的名稱。 在連線資訊欄位中,輸入「ClearQuest 閘道」的 URI。 例如:http://YOUR-CQ-GATEWAY-HOST:8081/cqconnector/gateway。 如果將管理「ClearQuest 閘道」的 Tomcat 伺服器配置成其服務要求需要使用者鑑別,請在「使用者 ID」和「密碼」欄位中輸入值。 否則,請將這些欄位保留空白。 您輸入的使用者 ID 和密碼必須符合 install-directory/gateway/tomcat/conf 目錄的 tomcat-users.xml 檔中所指定者。

    您可以在某專案區域中設定許可權,然後在專案區域欄位中選取這個專案區域,以限制外部儲存庫連線的存取權。 設好外部儲存庫連線的專案區域之後,便無法變更。 如果您需要將欄位設成另一個專案區域,或設成沒有專案區域,您可以先刪除外部儲存庫連線,再建立新的外部儲存庫連線。

    如果您需要暫時停止從 Jazz 伺服器到這個「ClearQuest 閘道」的同步化,請選取停用送出同步化。 當在 ClearQuest 使用者資料庫上執行維護作業時,您可以將送出同步化停用,讓它暫時無法使用。 如果要啟用送出同步化,請取消勾選停用送出同步化勾選框。按一下儲存來儲存外部儲存庫連線。

    外部儲存庫連線的預設埠號是 8444(Secure Socket Layer (SSL) 連線)和 8081(非 SSL 連線)。 如果要變更預設埠號,請編輯 /jazz/connectors/gateway/tomcat/conf 目錄中的 server.xml 檔。 如果要停用非 SSL 連線,將 Tomcat 伺服器配置成需要使用者鑑別,請執行下列步驟:

    1. 啟動和停止「ClearQuest 閘道」,以展開 cqconnector.war 檔。
    2. 編輯 install-directory/gateway/tomcat/conf 目錄中的 server.xml 檔,將這個元素註銷:
      <Connector port="8081" maxHttpHeaderSize="8192"
          maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
          enableLookups="false" redirectPort="8444" acceptCount="100"
          connectionTimeout="20000" disableUploadTimeout="true" />
    3. 編輯 install-directory/gateway/tomcat/webapps/cqconnector/gateway/WEB-INF 目錄中的 web.xml 檔,解除下列元素的註解:
      <security-constraint>
         <web-resource-collection>
            <web-resource-name>secure</web-resource-name>
            <url-pattern>/*</url-pattern>
         </web-resource-collection>
         <auth-constraint>
            <role-name>*</role-name>
         </auth-constraint>
         <user-data-constraint>
            <transport-guarantee>CONFIDENTIAL</transport-guarantee>
         </user-data-constraint>
      </security-constraint>
    4. 開啟 /jazz/connectors/gateway/tomcat/conf 目錄中的 tomcat-users.xml 檔。 預設使用者 ID 和密碼是 cqconnector。 請變更密碼。 選擇性地變更使用者 ID。
    5. 依預設,tomcat-users.xml 檔中的密碼會以明文方式儲存,不過您可以將密碼加密,並將 Tomcat 配置成可以辨識它。如果要如此做,請使用 repotools –convertTomcatUsers 指令。導覽至 JazzInstallDir/server/repotools 目錄。輸入指令,並指定 tomcat-users.xml 檔的路徑。例如:
      repotools –convertTomcatUsers tomcatUsersPath=install-directory/gateway/tomcat/conf/tomcat-users.xml

      轉換後的 tomcat-users.xml 檔會命名為 tomcat-users.xml.converted。請將它重新命名為 tomcat-users.xml。如果您需要變更密碼,則必須在未編碼的原始檔副本中變更它,然後再次執行 repotools –convertTomcatUsers。請將未編碼的原始檔保留在安全之處。

      在您執行指令之後,請按如下所示編輯 /jazz/connectors/gateway/tomcat/conf 目錄中的 server.xml 檔:

      註銷下列元素:

      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                   	resourceName="UserDatabase"/>

      解除註解下列元素:

      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                   	resourceName="UserDatabase"
                   	digest="SHA-1"
                   	digestEncoding="UTF-8"/>
結果
您建立的外部儲存庫連線會出現在同步化規則視圖的外部儲存庫連線節點之下。

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤