這篇指南闡述了如何在 Linux 平台上安裝和配置 IBM® Rational® ClearQuest® V7.0。儘管 ClearQuest 7.0 為 Linux,同時也為 Microsoft® Windows® 提供了集成的解決方案,但是在 Linux 上部署和配置它似乎更困難。同樣,用戶必須更新到當前 ClearQuest 的版本,來訪問現存的資料庫。您也可以學到如何在 IBM® WebSphere® Application Server 而不是 ClearQuest Web 應用軟體上部署 ClearQuest Web 組件,並為連接到 ClearQuest 先前版本所創建或者配置得資料庫上獲取解決問題得提示。這篇文章為那些對 Windows 有一些類似經歷的讀者提供的。
開始
IBM® Rational® ClearQuest® V7.0 在 Linux® 上的安裝包與 Microsoft® Windows® 的版本稍有不同。在 Linux 的安裝包中沒有管理工具,比如 Maintenance Tool, User Administration, 以及 ClearQuest Designer。因此,要在 Linux 系統上配置 ClearQuest,為了便於管理安裝一個 Windows 平台是很有必要的。
為了 ClearQuest 後端的資料庫,我們在 Linux 安裝了一個 IBM® DB2® 資料庫,用在這篇文章的例子中。很重要的一點是 ClearQuest 7.0 包括一個訪問 DB2 伺服器的驅動器,而不是使用在先前釋放中強制性的 DB2 客戶端。
安裝在這些例子中使用到
這篇文章中使用的例子是基於這個安裝的:
- ClearQuest 7.0 的資料庫是在 Linux 系統上創建的,通過 Windows 中的 ClearQuest 7.0 管理工具配置的。緊接著的表格 1,展示了這個連接信息。
- 兩個現存的 DB2 資料庫已經在 Windows 中創建,並通過先前的 ClearQuest 早期2003.06.19版本進行了配置。那些連接信息也被列在表格 1中。
- IBM WebSphere Application Server 被安裝在同一個 Linux 機器中, ClearQuest 7.0 部署在這個機器上的以下地址中:
/opt/IBM/WebShphere
- 這個安裝包並沒有沒解壓到這個有兩個子目錄的地址 /images/CQ7Install/linux_x86 中:clearquest和common
- 先前存在的 Rational License 問題已經被解決。因此,在這篇文章的例子準備過程中,我們使用了遠程許可伺服器。
表格 1. 資料庫連接信息
平台 | 變數 | 值 |
Linux | 維護表資料庫名稱 | DB4CQSHR |
用戶資料庫名稱 | DB4CQUSR |
用戶帳戶(也叫 DB2 實例名稱) | db2inst2 |
IBM DB2 連接埠 | 50001 |
Microsoft Windows | 維護表資料庫名稱 | s_cqtm |
DB2 命令形式的用戶資料庫名稱 | ur_cqtm |
用戶帳戶 | 測試裝置 |
DB2 連接埠 | 50000 (默認的) |
在 Linux 上部署 ClearQuest 7.0
首先,利用命令提示在釋放區域安裝這個安裝包。
設定一個釋放區域
- 根據嚮導到這個地址: /images/CQ7Install/linux_x86/clearquest/install
- 發出這個命令:/site_prep
- 在 ClearQuest 許可主機的提示符下,鍵入這個許可伺服器地址。
- 在 Rational Web Platform 的 HTTP 埠提示符中,使用這個默認值:,80
- 使 Rational Web Platform 的 account name 設定為“nobody”。
- 使 Rational Web Platform 的 group name 設定為“nobody”。
- 在提示符引導下啟用電子郵件通告,選擇 No。
注意:
在這篇文章的步驟4,5以及6中設定的值是不相關的。只要簡單地接受所有默認值就可以繼續這些過程了。
安裝 ClearQuest 組件
- 導向到/images/CQ7Install/linux_x86/clearquest/install,併發布./install_release命令從而開始安裝。
- 在提示符引導下選擇安裝方法,選擇1: Local Install
- 鍵入1接受這個許可協議。
- 在提示符引導下選擇安裝操作或者模式,選擇2: Full-copy
- 為這篇文章中的例子具體指定安裝文件夾:/opt/rational
- 接受 Pathname 的默認值,到廣泛網路的釋放地址,它應該與這個釋放區域安裝過程中所設定的是一樣的。
- 在提示符的引導下選擇這個組件來安裝(請參見圖 1),選擇這些條目:1. ClearQuest和2. ClearQuest Server。沒有具體說明 3,ClearQuest Web Application,因為您將為這些功能配置 IBM® WebSphere® ApplicationServer。
圖 1. 選擇組件來安裝
- 當您完成前面的步驟之後,您將在條目1和2的旁邊看到星號(請參見圖 2),這表明那些條目是您所選擇的。選擇f: 完成選擇。
圖 2. 安裝預覽視圖
- 在提示符引導下具體說明 License Server 。
- 在提示符引導下啟用電子郵件通告,選擇No。
- 在提示符引導下,選擇Yes,從而繼續安裝過程。
- 為 ClearQuest 資料庫註冊表地址接受默認值。如果不存在,只需要接受默認值就可以創建。
- 直到安裝過程安裝,而且沒有錯誤。
修改環境變數
- 在運行 ClearQuest 之前,將列表 1中顯示的條目添加到/root/.bashrc文件中 Linux 登陸環境中是必不可少的。
列表 1. 修改這個系統環境
#ClearQuest export TZ=PRC export LD_ASSUME_KERNEL=2.4.19 export LD_LIBRARY_PATH=/opt/rational/clearquest/linux_x86/shlib export MOZILLA_FIVE_HOME=/nowhere . /opt/rational/clearquest/cq_setup.sh |
- 退出並重新登陸,使這些變數生效,然後發布 clearquest 命令到 Linux 上的 ClearQuest。
在 ClearQuest 客戶端上配置這個資料庫連接
- 在 ClearQuest 客戶端中,點擊 File > Database > Manage Connections,從而顯 ClearQuest Connection Management 面板 (圖 3)。
圖 3. ClearQuest Connection Management 面板
- 在 ClearQuest Connection Management面板中 (圖 3),點擊 AddDatabase Set 來啟動圖 4中顯示的 New ClearQuest Database Set 選項。
- 在 Name 區域鍵入這個連接名稱(在這個例子中是 DB4CQ),並且,從這個下拉菜單中,選擇 DB2 作為產品商。
- 然後點擊 Next。
圖 4. Database Set Name 和 Vendor 對話框
- 在 New ClearQuest Database Set 嚮導程序的下一個窗口中,具體說明了 Server 區域中伺服器名稱或者 IP 地址,訪問帳戶和密碼,實質上還有先前 Assumption 中提到的 DB2 連接埠選項。例如,如圖 5所示,我們使用了這些條目:
- Server:192.068.0.34(從下拉菜單中選擇的)
- Database:DB4CQSHR(從下拉菜單中選擇的)
- User Name: db2inst2
- Password: *******
- Connect Option: port=500001
- 然後點擊 Finish 來完成這個資料庫設定的創建。
圖 5. Database Set Properties 對話框
- 現在,通過加強顯示您剛才創建的資料庫設置來設定到用戶資料庫的連接(DB4CQ 在圖 6顯示的例子中),然後點擊 Add Connection。
圖 6. ClearQuest Connection Management 對話框顯示了創建的 Database Set
- 保留它顯示的 Schema Repository 名稱(它就是 Database Set 名稱),點擊 Next ,然後具體指名您的 User ID 來訪問用戶資料庫,它是在 ClearQuest User Administration 工具中定義的。
- 點擊 Finish(請參見圖 7)。
圖 7. 到模式存儲的新連接
- 接下來,從這個下拉菜單中選擇這個用戶資料庫,然後鍵入正確的密碼,登陸到這個註冊表(圖 8)。
圖 8. 連接到用戶資料庫
現在您已經準備好在 ClearQuest 中選擇的用戶資料庫中進行操作了。
在 WebSphere Application Server 上部署並配置 ClearQuest Web 客戶端
在 ClearQuest 包中,您可以利用包含的這個 Web 應用軟體,如圖 3中選項 3所指名的。然而,由於各種原因您可能寧願在 IBM WebSphere Application Server 上部署和配置(此後簡稱為 WebSphere),比如統一構架,可擴展性能等等。對於那個可選擇的情況,可按照以下這些步驟進行:
- 從這個主菜單中,在 Linux 上啟動 WebSphere Application Server Administration Console,然後登陸。
- 在左邊地址樹的 Applications 下面,點擊 Install New Application,如圖 9所示。
- 在中間面板的 Full path 區域,鍵入這個 EAR 文件名:
/opt/rational/clearquest/cqweb/cqwebws.ear - 點擊 Next 來繼續。
圖 9. 在 WebSphere Application Server 上安裝這個新的應用軟體
- 接受所有的默認設定(不需要任何其它動作),點擊步驟 3,Summary(請參見圖 10)。
- 然後點擊 Summary 頁面的Finish按鈕。
圖 10. 開始在 WebSphere Application Server 上安裝這個新應用軟體
- 接下來,點擊“Save directly to the master configuration”(請參見圖 11)。
圖 11. 將您的變更保存到主要配置中
- 在 WebSphere Application Server 被安裝的命令控制台中,根據導向到 Classes 地址:
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/localhostNode01Cell/ RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/classes - 修改這個命令屬性文件,從而具體說明列表 2顯示的屬性。
列表 2. 修改這個命令屬性文件
CQ_WEB_SERVER_NAME=localhost PROPERTIES_DIR=/opt/IBM/WebSphere/AppServer/profiles/AppSrv01 /installedApps/localhostNode01Cell/RationalClearQuestWeb.ear /CQWebModule.war/WEB-INF/classes UPLOAD_DIR=/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps /localhostNode01Cell/RationalClearQuestWeb.ear/CQWebModule.war /htdocs/cqattachments DOWNLOAD_DIR=/cqweb/htdocs/cqattachments CHTRPT_DOWNLOAD_DIR=/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps /localhostNode01Cell/RationalClearQuestWeb.ear/CQWebModule.war /htdocs/cqchtrpts CHTRPT_DOWNLOAD_URL=/cqweb/htdocs/cqchtrpts |
- 回到這個管理控制台。
- 在 WebSphere 管理控制台(圖 12)的Update global Web Server Plug-In Configuration 視圖上點擊 OK,從而重新生成這個插入配置。
圖 12. 更新這個 Web server 插件配置
- 現在,重新啟動 WebSphere Application Server,然後開始運行 Rational ClearQuest Web 應用軟體。
- 通過在您的瀏覽器中鍵入下面的 Web 地址,從而在 WebSphere 上驗證這個 Rational ClearQuest Web 應用軟體部署,與圖18顯示的有些相似:
http://localhost:9080/cqweb/login
圖 13. ClearQuest Web
連接到 ClearQuest 先前版本創建的 IBM DB2 資料庫中
當您想要將基於 Connection Set 的連接添加到由先前版本的 ClearQuest(例如,2003.06.19版本)創建和配置的 IBM® DB2® 資料庫時,那麼這個連接可能會失敗。原因是,在 ClearQuest 7.0版本之前 ClearQuest 中的這個資料庫連接是依賴於一個 DB2 客戶端的,這裡的資料庫信息被在一個本地機器上被分類,用作連接之用的。這並不是因為主機和用戶資料庫的 Repository Schema 中的伺服器名稱信息與他們相應的資料庫名稱相同。然而,ClearQuest 7.0 版本不再需要 DB2 客戶端,因為它可以在基於安裝在維護表中的連接信息直接訪問 DB2 資料庫,包括這個伺服器名稱。這樣,這個伺服器的名稱對這個連接來說就很有必要了。
因此,當您使用 ClearQuest 7.0版本時,可以利用 ClearQuest Maintenance Tool 和 ClearQuest Designer 來更新維護表和用戶資料庫的服務信息。這樣的更新將不會影響 ClearQuest 先前版本的用戶。
更新維護表
- 在 Windows 中啟用ClearQuest Maintenance Tool,為 ClearQuest 先前版本的資料庫創建一個到Repository Schema的連接,如圖 14所示。您將需要完成這些區域:
- Vendor
- Server
- Database
- User Name
- Password
- Connect Options(要麼有,要麼保留為空)
圖 14.在 ClearQuest Maintenance Tool 中創建一個新連接
- 當您完成創建新連接工作之後,注意這個連接的伺服器名稱已經從 9.181.112.59 更改為 s_cqtm,如圖 15所示。
圖 15. 更改的伺服器名稱
- 從這個菜單中,選擇 Schema Repository>Update >SelectedConnection。
- 將這個伺服器名稱由 s_cqtm 更改為資料庫所在的 IP 地址或者伺服器名稱(在這個例子中是: 9.181.112.59),如圖 15所示。
- 點擊Next。
圖 16. 從模式存儲中更新這個伺服器名稱
- 鍵入一個超級用戶名稱和密碼(例如 admin),如圖 17所示,然後繼續往下操作。
圖 17. 超級用戶登陸信息就可以更新
- 點擊 Done 來完成操作。
- 現在,驗證 Existing Connections 下面的伺服器信息是正確的(請看圖 18)。
圖 18. 正確的伺服器名稱
更新用戶資料庫
- 在 Window 中啟用 ClearQuest Designer,選擇您剛剛在 ClearQuest Maintenance Tool 中創建的連接(在這個例子中是 CQ2003DB)。
- 用正確的用戶帳號和密碼登陸。
- 從這個 ClearQuest Designer 菜單 中,選擇 Database > Update User Database Properties,選擇這個用戶資料庫(邏輯資料庫)來更新,然後點擊 Properties按鈕。
- 將 Server name由 ur_cqtm 更改為這個資料庫所在的 IP 地址或者伺服器名稱(圖 19中是 199.181.112.59)。
- 點擊Update。
圖 19. 更新用戶資料庫的伺服器名稱
您可以驗證這個伺服器信息是正確的,現在還可以從 ClearQuest 7.0 客戶端訪問這個資料庫。
(責任編輯:A6)