RTC ClearQuest Bridge 企業級安裝配置和使用簡介

轉自：http://www.ibm.com/developerworks/cn/rational/r-cn-rtccqbridgeent/index.html

簡介

Rational Team Concert（RTC）是一款適合多種開發模式，集需求管理，軟體開發，配置管理和構建為一體的多功能管理軟體。自動化的資料收集和報告降低了管理開銷並提供了高效管控軟體專案所需的實時洞察。

Rational ClearQuest（CQ）是一款經典的，已經被廣大客戶所接受的變更追蹤工具。目前已經被多家企業部署在企業環境中，用作專案流程管理，變更追蹤。由於其高度的可定製化，不少企業已經按照其自身發展的需要，定製了相關的流程管理規約。

隨著軟體開發的發展，開發團隊將會引進更先進的管理工具以提高團隊效率。而對於傳統的 CQ 使用者來說，由於 CQ 具有高度的可定製化，所以 CQ 使用者可能已經擁有龐大的已定製資料，在這個基礎上引進 RTC 的困難在於資料同步或者資料轉移的高風險和高消費。

Rational Team Concert ClearQuest Bridge（RTC CQ Bridge）將解決這個問題。

如何在企業中，基於既有 IBM Rational ClearQuest 環境，迅速的部署和使用這套基於 RTC-CQ Bridge 的解決方案，便是本文將要帶給您的內容。

為了陳述方便起見，本文使用瞭如表 1 所示的縮寫。

表 1. 縮寫及版本號表

RTC CQ Bridge 的安裝、部署企業級環境

在本節中我們將介紹如何在 WAS 上部署 RTC，如何使用 DB2 作為 RTC 的資料庫，以及如何配置 RTC CQ Bridge。首先我們來看部署拓撲結構。

RTC 與 CQ 整合的部署拓撲結構

對於已經部署了 CQ 7.1 的使用者來說，使用 RTC-CQ Bridge 也進一步保護了使用者的既有投資。在已有裝置的基礎上，使用者僅需要多一臺 RTC 伺服器，就可以體驗 RTC-CQ 互動的效果。圖 1 給出了 RTC 和 CQ 7.1 整合的部署拓撲結構。（在這裡我們要求 CQ 的版本必須是 7.1 以及以後的版本，而 RTC 的版本則必須是 2.0 或是以後的版本。）

我們可以看到，在原有的 CQ 7.1 伺服器的基礎上，我們新增了一臺 RTC 伺服器及其相關的資料庫伺服器。如果資源有限，RTC DB 伺服器和 CQ DB 伺服器可以合二為一。圖中顯示 CQ 7.1 以及 RTC 中的使用者都是使用統一的 LADP 來管理的。這樣非常方便使用者一體化管理。

部署拓撲結構圖有了，接下來的工作就是要講 RTC 部署到 WAS 上了。我們假設使用者已經正確的安裝了 CQ 7.1，關於 CQ 7.1 的相關資訊，請參見 CQ 7.1 資訊中心（參見參考資料）。

配置 DB2 資料庫（以 DB2 V9.5 為例）

在 DB2 資料庫伺服器上，為 RTC 建立一個資料庫。建立資料庫的時候，對於表空間，我們推薦使用 8K 以上的表空間。而因為 DB2 內建的 8K bufferpool 比較小，因為我們建議為這個資料庫新建一個大小至少為 1GB 的 bufferpool，以防止在多使用者使用過程中出現 bufferpool page 不足的情況。鑑於 DB2 V9.5 自身的特點（參見 http://www.ibm.com/developerworks/wikis/display/im/DB2+9.5+for+Linux+-+Supported+Environments），我們推薦在企業級應用時，將 DB2 V9.5 部署在 64 位作業系統上。可以對所建立資料庫的一些引數進行一些優化調整，使其能夠更好的適應企業環境下多使用者訪問時的需要，比如修改堆疊大小：db2 update db cfg for using APPLHEAPSZ 10000。

在建立了資料庫之後，開啟 Installation_path/JazzTeamServer/server/conf/jazz/ 中檔案 teamserver.properties，修改其中的 DB2 配置部分：

com.ibm.team.repository.db.jdbc.location=
//:
/:user=;password={password};
com.ibm.team.repository.db.jdbc.password=

然後開啟檔案 Installation_path/JazzTeamServer/server/conf/jazz/provision_profiles/license-profile.ini, 做如下修改：

url=file:///Installation_path/JazzTeamServer/server/license-update-site。

開啟檔案 Installation_path/JazzTeamServer/server/conf/jazz/provision_profiles/profile.ini，做如下修改：

url=file:///Installation_path/JazzTeamServer/server/update-site

最後，使用位於 Installation_path/JazzTeamServer/server 目錄下的 repotool.bat 工具，在資料中建立相關的表單以及資料。命令如下：

repotool.bat -createtables

將 RTC 部署到 WAS 上

在 RTC 釋出的時候，由於已經內建了 Tomcat 以及 Derby 資料庫，所以若想快速體驗，十分簡單，只需要直接執行 server.startup.bat/server.startup.sh 來初始化環境（包括應用在 TOMCAT 上的自動部署和 DERBY 資料庫的初始化），然後用瀏覽器訪問 https://:9443/jazz/web 就可以了。

在本節中，我們來看一下如何將 RTC 部署在 WAS 6.1 上。我們的場景配置如下，Websphere 6.1 Fixpack 23【注 1】@Windows 作為應用伺服器 ,DB2 9.5 作為資料庫伺服器，LDAP 作為使用者管理伺服器。

注 1：對於 Websphere 6.1，需要升級到 Fixpack 23 版本，對於 WAS 7.0, 我們同樣需要您將其升級到 7.0.0.3 版本。

引數設定

在 WAS 伺服器上部署 RTC 應用之前需要對伺服器的引數進行一些修改，

首先是 WAS 伺服器上 JVM 引數的修改，進入 Application servers > server1 > Process Definition> Java Virtual Machine，分別將 JAVA HEAP SIZE 的初始值和最大值設定為 100 和 1000，如圖 2 所示：

然後進入 Application servers > server1 > Process Definition > Java Virtual Machine > Custom Properties，新增以下個性化屬性。

JAZZ_HOME = file:///Installation_path /JazzTeamServer/server/conf/
java.awt.headless = true
org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin = true

如圖 3 所示。

其中，引數 JAZZ_HOME 的 Installation_path 表示 JazzTeamServer 的裝載路徑。下面也將使用這個表示方法。

最後配置 WAS 中的安全設定。

由於應用上安全設定的需要，我們需要在 WAS 的安全設定中，對 WAS 的預設安全性設定進行一些修改。進入到 Secure administration, applications, and infrastructure 中，選中”Enable administrative security”和“Enable application security”。同時取消”Java 2 security”。由於我們選擇用 LDAP 來管理 RTC 中的使用者驗證，因此我們選擇”Standalone LDAP registry”作為使用者域。點選”Configure”按鈕來配置 LDAP 伺服器的相關資訊。如圖 4 所示。

接下來，我們從右側選中”Web security” > General setting, 選中“Use available authentication data when an unprotected URI is accessed”，如圖 5 所示。

然後一步接一步按照預設的配置完成 RTC 的部署即可。

在啟動 RTC 應用之前，因為 RTC 中對於使用者的許可權分配是按照角色的，所以我們需要在 WAS 中將 LDAP 伺服器上的使用者引入，並且按照角色進行分組，對映。進入 Enterprise Application> jazz_war> Security role to user/group mapping，如圖 7 所示。

配置 RTC、RTC CQ Bridge

配置 RTC

在完成上述配置之後，我們可以在 WAS 中啟動 RTC 的應用。並在瀏覽器位址列中輸入 https://:9443/jazz/setup 來進行 RTC 的一些初始化配置。

★★這裡，對於驗證上面的配置，我們有一個小竅門分享給大家。鑑於我們剛才的配置過程中涉及到了資料庫端，應用本身的配置檔案，WAS 伺服器端的一系列配置。這時，如果某個步驟出現了一些差錯，那麼在初始化 RTC 的時候，就會遇到問題。為了更好的來驗證配置的正確性，我們建議在安裝 RTC 的時候，將預設的 Tomcat 裝上。這樣在 WAS 上部署好 RTC 之後，我們可以先暫時停掉 WAS 服務，以防止埠衝突。啟動 Tomcat, 然後訪問 https://:9443/jazz/ web。如果這時用預設的 ADMIN 使用者訪問 RTC 出現問題，那麼我們需要檢查我們的資料庫以及應用本身的配置檔案是否正確，如 teamserver.properties，license-profile.ini 以及 profile.ini。在確保資料庫和應用本身配置正確的情況下，我們停掉本地的 Tomcat 伺服器，啟動 WAS，這樣來進一步判斷我們在 WAS 上的配置是否正確。

配置步驟如下：

1. 通過 https://:9443/jazz/setup 進入到配置介面，選擇 Custom Setup。
2. 首先進行資料庫的配置。如果根據前面介紹的步驟已經正確修改了檔案 teamserver.properties 的內容，資料庫會自動配置成功。在配置完成之後選擇測試資料庫，如果給出的提示資訊說明連線成功，說明配置正確。否則則需重新配置。
3. 第三步是配置郵件通知系統。這裡跳過。
4. 第四步是配置使用者註冊資訊。由於我們使用的是 LDAP 使用者管理，所以現在 Step 1 裡選擇 LADP 選項。然後在 Step 2 裡面修改一下欄位的內容：
   • LDAP Registry Location: LADP 地址，形如 ldap://ip:port。
   • Base User DN: LDAP 相關資訊，根據不同的 LDAP 系統而不同。
   • User Property Name Mapping：同上。
   • Base Group DN：同上
   • Jazz to LDAP Group Mapping: Jazz 到 LDAP 使用者組對映。如果沒有做組對映，則使用預設值即可，否則應該根據預設值的格式修改組對映。
   • Group Name Property：LDAP 相關資訊，根據不同的 LDAP 系統而不同。
   • Group Member Property：同上
5. 配置完成之後需要測試，如果測試通過，即可到下一步，否則需重新配置。
6. 配置結束，點選下一步，可以繼續建立專案或者使用者，或者跳轉到別的介面進行操作。

匯入使用者。我們使用的是 LDAP 進行使用者管理，在進行了上面的配置之後，還需要講 LADP 裡面的使用者匯入到 RTC 裡面，方可進行使用。匯入步驟如下：

1. 通過 https://:9443/jazz/admin 進入到管理員介面，選擇“User Management”。
2. 選擇 Import Users，在彈出的對話方塊中查詢使用者，然後進行匯入。
3. 分配許可權。需要注意的是 RTC 的許可權分兩部分，一部分是儲存空間許可權，這種許可權分四類，JazzAdmins, JazzDWAdmins, JazzUsers, JazzGuests。在使用 LDAP 管理使用者時，使用者這部分許可權是在做使用者對映的時候分配的，詳細請參見本文部署 RTC 應用的 war 包部分。另外一部分是客戶端訪問許可權，這部分分五類，詳細請參見 RTC 2.0 資訊中心（參見參考資料）。

至此，RTC 配置結束。下面開始配置 RTC CQ Bridge。

配置 RTC CQ Bridge

在通過 https://:9443/jazz/setup 完成 RTC 的初始化配置之後，我們轉到 RTC 伺服器的 Admin 管理頁面，通過下面幾個簡單的配置，我們就可以連線 RTC 與 CQ 之間的橋架通。

在 Admin 檢視下，選擇 Configuration > Advanced Properties, 找到 CQ Bridge 這段，如圖 8 所示。

通過圖可以看到，總共有八項屬性。其中必須填寫的只有兩項。一個是 ClearQuest Web remote server，預設值是 localhost. 這個只有在本地也安裝了 CQWeb Server 才使用。通常情況下，這裡填寫所需連線的 CQWeb 伺服器地址。另外一個是 Enable CQ Bridge Webui：預設值是 False。如果選擇 False, 那麼就意味著在 RTC 的 Web 介面上看不到 CQ Record 這樣一個 Tab。如果選擇 True，那麼如圖 9 所示。關於其他屬性，請參見 RTC 2.0 資訊中心（參見參考資料）。

除此了上述配置之外，我們還需要在 com.ibm.team.repository.servlet.internal.ServletConfigurationService 屬性中，將 Host Name 一值配置為 RTC 伺服器的域名。如圖 10 所示

RTC CQ Bridge 在企業環境下的使用

前面介紹了 RTC CQ Bridge 的安裝和配置。本章將簡單介紹 RTC CQ Bridge 在企業環境下的使用。對於企業級使用者來說，CQ Bridge 主要涉及到 RTC Web 客戶端中的以下三個頁面

• CQ Records 頁：該頁面類似於 CQ Web 客戶端，實現了大部分 CQ Web 客戶端的功能，另外包含 CQ Bridge 的功能。負責需求管理和負責變更管理的人員將主要在此工作。如負責需求管理的人員在此建立需求，測試人員在此建立、維護變更等。
• Work Item 頁：該頁面為 RTC 的功能頁，使用者在此對所有的 work item 進行增刪改查的功能。與 CQ Bridge 相關的是，使用者在該頁面下，可以檢視 work item 與 CQ 記錄的連結資訊。
• Dashboard 頁：RTC Dashboard 中提供四種 CQ Bridge 相關的 CQ Viewlet，這些 Viewlet 為使用者提供了管理專案、查詢當前狀態的輕便檢視。對於管理人員來說，可以通過這些 Viewlet 來檢視當前的專案狀態，比如當前專案下還有多少需求沒有被實現或者有多少變更還處於未解決的狀態。對於開發人員來說，可以通過這些 Viewlet 來關注自己當前的工作狀態，比如可以檢視哪些分配給自己的 work item 已經與需求關聯起來，或者哪些分配給自己的變更還沒有被解決。

在軟體開發過程中，一般有這樣的流程，初期的需求管理，中間的專案管理，測試階段下的變更管理。下面我們結合這個簡單的流程介紹 RTC CQ Bridge 在企業環境下的使用。

開發初期—在 CQ Records 頁實現需求管理

在 RTC 2.0 版本中，經過適當的配置（請參見安裝、配置小節），RTC 的 Web 客戶端就有一個 CQ Records 頁，如圖 11 所示。

（圖 11 大圖）

RTC 在這個頁面下實現了大部分 CQ Web 7.1 的功能，包括建立記錄、查詢記錄、修改記錄等操作。對於企業級使用者來說，負責需求管理的人員將可以通過這個介面來實現需求的管理和維護。

一般來說需求只是籠統的概括希望實現的目標。真正開始開發時，需要有相應的方法或故事來實現這些目標。在 RTC 中，有一種 Story 型別的 work item 滿足這個要求。顯然，需求記錄應該與 Story 相關聯起來。如圖 11 所示，可以通過 CQ Records 頁下連結建立、顯示區來建立 CQ 記錄和 RTC 記錄之間的連結。

有兩種建立連結的方式，一是建立一個已有 RTC 工作專案與當前 CQ 記錄之間的連結；另一個是建立一個新的 RTC 工作專案並建立他與當前 CQ 記錄之間的連結。開啟一個已有的記錄。在連結建立、顯示區，點選向下的箭頭，會出現如圖 12 的結果。

建立連結之後，在 CQ Records 頁和 RTC 工作專案頁都有顯示。在 CQ Records 頁下記錄中的顯示如圖 13 所示。

開發過程中—通過 Dashboard 和 Work Item 實現專案管理

在開發初期，需求和相應的故事已經建立。接下來就是開發過程。一般來說，故事是比較概括的說明，應該建議一些子 Work item，即 task 來細化故事內容。然後可以將 task 具體分配到某個工作人員。同時，為了統一起見，這些 task 應該與相應的故事的需求連線起來。至於如何建立連結，請參見開發初期—在 CQ Records 頁實現需求管理。

開發人員只需要結合分配到自己的 Task 型別的 Workitem 來完成相應的工作。

前面我們看到，CQ Records 頁內會顯示連結內容。在 RTC 的工作專案中，有一個連結頁，連結資訊也會被顯示在其中。如圖 14 所示。

由於連結資訊是以超連結的形式顯示的，使用者可以通過它連線到相應的 CQ 記錄資訊。

工作專案中顯示的資訊只是一條記錄的連結資訊。

而 Dashboard 下 CQ Viewlet 則將這些資訊統計起來通過表的方式顯示，更方便也更全面。

RTC 2.0 中有四種 RTC CQ Bridge 相關的 Viewlet。圖 15 是建立這些 Viewlet 的介面。

通過 Viewlet 這樣一個統計輸出的方式，使用者可以對自己當前關心的資訊有一個概覽。作為開發人員，可以瞭解到當前自己的任務狀況；而作為專案管理人員則可以瞭解到整體專案的進展狀況。

測試階段—通過 CQ Records 頁實現變更管理

通過圖 11 可以看到，在測試階段，測試人員可以在 CQ Records 頁面下建立、修改、刪除 CQ 中的變更記錄，並且修改變更記錄的狀態。

測試人員提交了變更之後，管理人員或者開發人員應將其分配到某位開發人員。在 RTC 中，可以建立一個 task，將此 task 與變更連線起來，然後將此 task 分配給某位開發人員。這樣，該開發人員即可知道自己被分配了新工作並且可以通過 task 裡連線頁來檢視相應的變更資訊。關於建立連結以及連結顯示，請參見圖 12 和圖 14。

總結

本文著重介紹了 Rational Team Concert ClearQuest Bridge 的企業級安裝、部署和配置。希望讀者通過本文可以快速高效的將 Rational Team Concert ClearQuest Bridge 部署到自己的企業環境裡去。另外，本文也簡單介紹了 Rational Team Concert ClearQuest Bridge 在企業級環境中的使用，希望對讀者有所幫助

來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/14780914/viewspace-628277/，如需轉載，請註明出處，否則將追究法律責任。