這個主題說明將 ClearQuest® Synchronizer 從舊版升級至現行版本所需要的步驟。
程序
- 停用外部儲存庫連線的送出同步化。在 Eclipse IDE 的 Rational Team Concert™ 用戶端中,顯示「同步化規則」視圖。展開「外部儲存庫連線」節點。按兩下外部儲存庫連線,將它打開。選取停用自動送出同步化。按一下確定。
- 停用 Jazz™ Team Server 的送出同步化。在 Web 用戶端的管理頁面中,按一下進階內容。捲到項目交互作業元件。對於 com.ibm.team.interop.service.internal.InteropService,按一下編輯。對於啟用送出同步化,在下拉清單中,選取 false。按一下儲存。
- 停止 ClearQuest Gateway。
- 停止 Jazz Team Server。
- 升級伺服器。請參閱從第 2 版升級(兩步驟程序)或升級至 4.0 版。
- 啟動伺服器,驗證下列各項:
- 您可以利用 ClearQuest Connector 所用的 Jazz 使用者帳戶登入,且可以連接到專案區域。
- 外部儲存庫連線存在。請參閱「同步化規則」視圖。
- 同步化規則存在。請參閱「同步化規則」視圖。
- 您先前所建立並與 ClearQuest 記錄同步化的工作項目存在。
- Jazz Team Server 仍設為停用送出同步化。
- 安裝 ClearQuest Synchronizer 的新版本。請參閱使用 IBM Installation Manager 來安裝 Rational Team Concert 的 ClearQuest Synchronizer。
註: 如果是從 3.X 版升級,您可以使用 Installation Manager 中的「更新」選項。如果是從 2.X 版升級,您必須選擇「安裝」選項,然後解除安裝 2.X 版
(請參閱
步驟 17)。從 3.0 版開始,預設安裝目錄的名稱是 ClearQuest Synchronizer,而不是 ClearQuest Connector。
- 導覽至 install-directory/ClearQuest Synchronizer/gateway 目錄,然後啟動 ClearQuest Gateway。
- 停止 ClearQuest Gateway。 啟動和停止 ClearQuest Gateway 會建立 install-directory/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector 目錄。
- 如果是從 2.X 版升級,請將任何已修改的使用者可配置檔案,從 ClearQuest Connector 2.0.0.2x 安裝目錄複製到 ClearQuest Synchronizer 安裝目錄。具體地說,請複製下列檔案:
- cqconnector.properties,從 install-directory/ClearQuestConnector/gateway 到 install-directory/ClearQuestSynchronizer/gateway。
- log4j.properties,從 install-directory/ClearQuestConnector/gateway 到 install-directory/ClearQuestSynchronizer/gateway。
- tomcat-users.xml,從 install-directory/ClearQuestConnector/gateway/tomcat/conf 到 install-directory/ClearQuestSynchronizer/gateway/tomcat/conf。
- web.xml,從 install-directory/ClearQuestConnector/gateway/tomcat/webapps/cqconnector/WEB-INF 到 install-directory/ClearQuestSynchronizer/gateway/tomcat/webapps/cqconnector/WEB-INF。
如果是從 3.X 版升級,且在 Installation Manager 中選擇「更新」選項,則您修改的配置檔會儲存在備份目錄中。請將已修改的配置檔從備份目錄複製到新的安裝目錄。
註: 4.0 版以前使用的 server.xml 檔與 4.0 不相容。
因此,您無法將它從 install-directory/ClearQuestConnector/gateway/tomcat/conf
或從備份目錄複製到 install-directory/ClearQuestSynchronizer/gateway/tomcat/conf。
請改以在新的安裝目錄中編輯 4.0 server.xml 檔
(install-directory/ClearQuestSynchronizer/gateway/tomcat/conf),使它包含您對舊版本所做的任何變更。
- 選用。將 JazzInterop 套件的最新版本套用於您的 ClearQuest 綱目,然後升級含有新綱目版本的 ClearQuest 使用者資料庫。如需詳細資料,請參閱升級含有 JazzInterop 套件新版本的使用者資料庫。
- 啟動 ClearQuest Gateway。
- 移至狀態頁面,檢查 Gateway 的狀態,位置如下:http://host-name.example.com:8081/cqconnector/gateway。
頁面應該會顯示 Gateway 正在接受所有要求。
- 啟用外部儲存庫連線的送出同步化。
- 啟用伺服器的送出同步化。
- 執行下列步驟,驗證同步化有效:
- 在 ClearQuest 使用者資料庫中,建立一些記錄。驗證對應的工作項目已建立在 Rational Team Concert 專案區域中。
- 在專案區域中,建立一些工作項目。驗證在 ClearQuest 使用者資料庫中,會建立對應的記錄。
- 編輯一些舊版中已同步化的工作項目。驗證變更會延伸到對應的 ClearQuest 記錄。
- 編輯一些舊版中已同步化的 ClearQuest 記錄。驗證變更會延伸到對應的工作項目。
- 如果是從 2.X 版升級,或在 Installation Manager 中未選擇「更新」選項,請解除安裝舊版的 ClearQuest Connector。 解除安裝作業應該會在 install-directory/ClearQuestConnector 目錄中,建立一個名稱為 backup-config-timestamp 的目錄。
驗證這個目錄含有下列目錄和檔案:
- gateway/cqconnector.properties
- gateway/log4j.properties
- gateway/tomcat/conf(目錄包含若干檔案和一個 Catalina 目錄)
- gateway/tomcat/webapps/cqconnector/WEB-INF/web.xml