外部儲存庫連線是一個 Rational Team Concert™ 項目,其內容含有 Jazz™ Team Server 建立與外部儲存庫的連線時所需的資訊。您必須建立「ClearQuest® 閘道」的外部儲存庫連線。
開始之前
如果要建立、修改和刪除外部儲存庫連線,您必須被指派「開發人員用戶端存取授權」或「ClearQuest Connector 用戶端存取授權」。
此外,專案區域也必須配置成對您的使用者角色授與許可權。
如果要設定許可權,請開啟專案區域,按一下程序配置標籤,按一下,選取一個角色,然後在允許的動作清單中選取項目連接器。
執行這項作業的原因和時機
您可以使用「ClearQuest Connector 設定精靈」,來建立外部儲存庫連線。
這個主題說明如何使用 Rational Team Concert Eclipse 用戶端,來建立外部儲存庫連線。
其中也說明如何停用或啟用外部儲存庫連線的送出同步化。
如果您使用「ClearQuest Connector 設定精靈」來建立外部儲存庫連線,您必須啟用它的送出同步化。
精靈所建立的外部儲存庫連線會停用送出同步化。
如果要建立外部儲存庫連線,請執行下列動作:
- 登入 Rational Team Concert 用戶端。
- 在團隊構件視圖中,用滑鼠右鍵按一下儲存庫連線,選取。
在同步化規則視圖中,用滑鼠右鍵按一下外部儲存庫連線,然後選取。
- 如果您登入多個 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 伺服器配置成需要使用者鑑別,請執行下列步驟:
- 啟動和停止「ClearQuest 閘道」,以展開 cqconnector.war 檔。
- 編輯 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" />
- 編輯 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>
- 開啟 /jazz/connectors/gateway/tomcat/conf 目錄中的 tomcat-users.xml 檔。
預設使用者 ID 和密碼是 cqconnector。
請變更密碼。
選擇性地變更使用者 ID。
- 依預設,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"/>
結果
您建立的外部儲存庫連線會出現在
同步化規則視圖的
外部儲存庫連線節點之下。