保留 CM 伺服器配置

您必須保留 Change Management (CM) 伺服器的 MBean 配置,才能自訂 MBean 屬性,或是 升級或重新安裝 ClearQuest 7.1.x.y 或 8.0.x.y。若未保留此配置,您的所有自訂皆會遺失。

關於這項作業

若您的 ClearCase 及 ClearQuest 7.1.0.x 或 8.0.x.y 安裝包含 WAN 支援套件,即可安裝 CM 伺服器。 若要判別有無安裝 WAN 支援套件,可檢查 Rational 共用目錄下有無 CM 子目錄:
  • 在 Windows 上:%RATIONAL_INSTALL%\%RATIONAL_COMMON%\
  • 在 UNIX 系統及 Linux 上:$RATIONAL_INSTALL/$RATIONAL_COMMON/
其中的變數意義如下:
  • RATIONAL_INSTALL:Rational 軟體的安裝目錄
  • RATIONAL_COMMON:Rational 共用目錄
註: 升級或重新安裝 ClearQuest 7.1.x.y 之前,必須 先保留 CM 伺服器的 MBean 配置(安裝程式不會執行此作業)。 若升級或重新安裝前未執行此作業,所有自訂皆會遺失。

您也可以在修改任何 CM 伺服器的 MBean 屬性之前,先使用所安裝之 CM 伺服器元件隨附的 wsadmin Script 匯出 MBean 配置。 萬一新設定引發了非預期的結果,即可使用此備份將 MBean 值還原成已知良好的配置。

您必須在 CM 伺服器元件(含 WebSphere Application Server)執行時執行 wsadmin Script。 請注意,您可以在 Windows 上建立 AT 工作,以及在 UNIX 系統或 Linux 上建立 cron 工作,以定期自動執行擷取 CM 伺服器之 MBean 配置的程序。

下列是 CM 伺服器之 wsadmin 公用程式 Script 的預設位置:
  • 在 Windows 上:C:\Program Files\IBM\RationalSDLC\common\CM\scripts
  • 在 UNIX 系統及 Linux 上:/opt/rational/common/CM/scripts
註: 若只有安裝 ClearCase 或 ClearQuest,您必須遵循下一節「手動保留 MBean 配置設定的程序」中的指示,而不是使用本節中的 指示。

程序

匯出及匯入 MBean 配置設定的程序

  1. 在命令提示字元視窗中,將預設目錄設為 CM 伺服器之 wsadmin 公用程式 Script 的所在位置。例如:
    • 在 Windows 上: # cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
    • 在 UNIX 系統及 Linux 上:# cd /opt/rational/common/CM/scripts
  2. 使用您 Shell 適用的語法,設定 wsadmin 公用程式的路徑。 例如:
    • 在 Windows 上:# set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin"
    • 在 UNIX 系統及 Linux:# WAS_BIN=/opt/rational/common/eWAS/bin
  3. 指定 CM 伺服器設定檔名稱,以啟動 wsadmin 公用程式。 預設的 CM 伺服器設定檔名稱為 cmprofile。例如:
    • 在 Windows 上:# %WAS_BIN%\wsadmin -profileName cmprofile
    • 在 UNIX 系統及 Linux:# $WAS_BIN/wsadmin.sh -profileName cmprofile
  4. 將包含 exportToFile 及 importFile 指令的 JACL Script 載入 wsadmin 指令 Shell 中: wsadmin> source teamAdminUtils.jacl
  5. 將 MBean 配置匯出到位於 CM 伺服器安裝目錄結構之外的檔案中。
    註: 當您在 Windows 中從 wsadmin 指令 Shell 執行 JACL Script 時,您可以在指定要傳送給 JACL Script 的路徑中使用正斜線 '/'。 若選擇使用反斜線 '\',必須再加上一道反斜線逸出每個反斜線字元。 例如:
    • 在 Windows 上:wsadmin> exportToFile C:/temp/CmServer_backups/MBean.bck
    • 在 UNIX 系統及 Linux 上:wsadmin> exportToFile /tmp/CmServer_backups/MBean.bck
    您可以使用 importFile 指令還原預存的 MBean 配置。請在升級或重新安裝 CM 伺服器元件,或在變 更 MBean 配置之後,要回復成舊版配置時,才使用此指令。

手動保留 MBean 配置設定的程序

若只有安裝 ClearCase 或 ClearQuest,您必須遵循本節的指示。 若同時安裝了 ClearCase 及 ClearQuest,請使用上一節「匯出及匯入 MBean 配置設定的程序」中的指示。

  1. 在命令提示字元視窗中,將預設目錄設為下列位置來取代下列變數:
    • 若不使用預設的設定檔名稱,請置換 cmprofile
    • <computer-name>CMProfileNode01Cell, dfltCell,<computer-name>CMProfileNode01, 或 dfltNode 置換成 Cell 名稱或節點名稱
    例如:
    • 在 Windows 上: # cd "C:\Program Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\config\cells\ <computer-name>CMProfileNode01Cell\nodes\<computer-name>CMProfileNode01\servers\server1\stp"
    • 在 UNIX 系統及 Linux 上:# cd /opt/rational/common/CM/profiles/cmprofile/config/ cells/dfltCell/nodes/dfltNode/servers/server1/stp
  2. 將預設目錄下的所有 .dat 檔案複製到 CM 伺服器安裝目錄結構以外的暫存目錄。 例如:
    • 在 Windows 上:# copy *.dat C:\temp\CmServer_mbean_config_files
    • 在 UNIX 系統及 Linux 上: # cp *.dat /tmp/CmServer_mbean_config_files
  3. 升級 ClearCase 及 ClearQuest 之後,請確定 CM 伺服器未執行。請遵循啟動、停止及重新啟動主題中的指示停止 CM 伺服器元件。
  4. 開啟命令提示字元視窗。由 root 使用者將預設目錄設為步驟 6 中所述的位置。接著將步驟 7 中儲存在暫存目錄 下的 .dat 檔案複製到預設目錄。 例如:
    • 在 Windows 上:# copy C:\temp\CmServer_mbean_config_files\*.dat
    • 在 UNIX 系統及 Linux 上:# cp /tmp/CmServer_mbean_config_files/*.dat
    當 CM 伺服器元件啟動之後,即會使用從還原後之 .dat 檔案的資料起始設定 MBean 屬性。


意見