IBM Performance Optimization Toolkit for Rational Performance Tester 6.1.2 版安裝手冊

歡迎使用 IBM(R) Performance Optimization Toolkit 6.1.2 for Rational(R) Performance Tester。本手冊包含安裝和設定工具箱的相關資訊。

您可以在工具箱版本注意事項中,找到有關限制和暫行解決方法的其他最新資訊。

IBM Performance Optimization Toolkit 需要安裝 Rational Performance Tester 產品。此工具箱提供下列特性:

內容


硬體先決條件

工具箱

安裝本工具箱之前,必須安裝下列硬體。這些數據假設您也在相同機器上安裝資料收集基礎架構:

資料收集基礎架構

如果要在未安裝工作台的機器上安裝資料收集基礎架構,下列是最小硬體需求:


軟體先決條件

工具箱

安裝工具箱的更新之前,必須先安裝下列軟體:

重要事項:安裝工具箱之前,請解除安裝所有 Rational Performance Analyst 和 Rational Performance Tester 測試版,並安裝上述適當的 Rational Software Development Platform 產品。

資料收集基礎架構

對您要收集資料的分散式應用程式,在所有涉及的主機上安裝資料收集基礎架構。在您已安裝工具箱的本端機器上,也建議您安裝資料收集基礎架構(有些情境也有需要)。

Linux 附註:資料收集基礎架構的 Hyades Data Collection Engine 功能是以 libstdc++-libc6.2-2.so.3 共用程式庫編譯的。請確定這個共用程式庫存在 /usr/lib 目錄下。如果不存在,您必須安裝作業系統安裝媒體所附的 RPM 套件 compat-libstdc++。

資料收集基礎架構已測試於下列平台:

Red Flag Advance Server 4.0 版尚未於 Intel IA32 上測試,但預期可以執行 。

一般而言,資料收集基礎架構可以搭配 JVM 1.4 版和更新的版本一起使用。下面所列的 JVM 版本 (java -fullversion),其資料收集已經過測試:


支援的資料收集情境的伺服器需求

工具箱會收集分散式應用程式的效能側寫資料,並傳送至工作台讓您檢視和分析收集的資料。您可以查詢 Tivoli Monitoring for Transaction Performance (TMTP)、IBM Tivoli Composite Application Manager for Response Time Tracking (ITCAM for RTT) 或 IBM Tivoli Composite Application Manager for WebSphere (ITCAM for WebSphere) 管理伺服器資料庫,來收集部署於正式作業環境的應用程式之過去的效能資料。利用 IBM Performance Optimization Toolkit for Rational Performance Tester,您也可以監督在開發或測試環境下的作用中應用程式,並即時收集資料。

在正式作業環境下,您可以在管理伺服器資料庫中,查詢下列系統管理軟體來收集資料:

如果是即時 Web 應用程式,資料收集基礎架構會從下列 Web 伺服器收集效能側寫資料:

如需安裝這些產品的完整指示,請參閱安裝手冊。下列安裝指示包含如何配置這些產品來搭配資料收集基礎架構一起使用的資訊。


在 Windows 上安裝、啟動及解除安裝工具箱

安裝工具箱

安裝工具箱之前,請檢查環境變數 TEMP 或 TMP 是否指向至少有 100 MB 可用空間的有效暫時目錄。這不包括在安裝產品所需的空間內。

您可從下列網站取得必要的 6.x.0 版工具箱,以及安裝指示:

若要將工具箱升級至 6.x.1 版,請執行下列動作:

  1. 啟動「Rational 產品更新程式」,做法是選取開始 > IBM Rational > Rational 產品更新程式
  2. 按一下尋找更新資料。此時會存取 Internet,以取得您已安裝之任何 Rational Software Development Platform 產品的可用更新資料。
  3. 更新資料標籤中,確定工具箱的更新資料為 6.0.1 版,且如果畫面上有顯示,請確定已選取所有基本產品。
  4. 按一下安裝更新資料。請閱讀畫面上所顯示的授權資訊。
  5. 更新程式會下載並安裝工具箱的更新資料以及其他 Rational 產品所需的任何更新資料,這可能會花費一些時間。
  6. 安裝完成後,按一下清除,以移除先前的版本,藉此釋放硬碟空間。請注意,這個步驟會阻止您回復工具箱的較早版本,或阻止您在未完全移除所有 Rational Software Development Platform 產品的情況下,完整地解除安裝工具箱。
您必須在此時安裝資料收集基礎架構。如需指示,請參閱安裝資料收集基礎架構
附註:

啟動工具箱

就您已安裝的 Rational Software Development Platform 產品而言 (Rational Performance Tester、Rational Application Developer 或 Rational Software Architect),工具箱是額外安裝的元件。若要使用工具,請照常啟動程式。例如,從開始功能表選取程式集 > IBM Rational > Rational Software Development Platform

安裝之後第一次啟動時,可能會開啟對話框,其中已指定預設的工作區目錄。如果要將工作儲存在其他位置,您可以變更工作區的名稱和位置。如果您想要固定使用這個工作區,請啟用請使用這個作為預設值,以後不要再問我勾選框。您可以在啟動產品之後,在視窗 > 喜好設定 > 工作台 > 啟動和關閉頁面中變更這個預設值。

工作台最初可能開啟一連串歡迎使用頁面,提供產品概觀,包括工具箱的概觀資訊、新增功能的資訊,以及基本產品的指導教學、範例和外部 Web 資源的鏈結。請花些時間來瀏覽這些選項。 另外,也請注意「說明」功能表所提供的資訊來源。您可以選取說明 > 歡迎使用,回到這些歡迎使用頁面。

解除安裝工具箱

附註:如果您已安裝了資料收集基礎架構,在解除安裝之前,請先解除安裝工具箱。如需指示,請參閱解除安裝資料收集基礎架構

若要解除安裝工具箱:

  1. 關閉所有 Rational Software Development Platform 程式,並停止資料收集基礎架構。
  2. 開啟「控制台」(在 Windows 開始功能表),再開啟新增/移除程式視窗。選取 Rational 分散式效能和問題分析工具,按一下變更/移除。逐步執行解除安裝精靈,以解除安裝產品。
  3. 任何外掛程式或特性目錄中的所有檔案都會自動刪除,包括這些目錄中的使用者資料和協力廠商外掛程式。含有工作的工作區目錄不會被刪除。其他一些目錄也會保留下來:
  4. 您也必須解除安裝其他的 Rational Software Development Platform 產品,才能完全移除所有工具箱檔案。請遵循這些產品之安裝手冊中的解除安裝指示。確定已移除 Platform 安裝目錄中的所有檔案和目錄。然後,即可重新安裝那些產品。

    附註:如果您在更新至 6.x.1 版時,沒有按清除按鈕,現在便可省略這些步驟。如果您沒有清除步驟, 則請執行下列動作:

    1. 從 Rational Software Development Platform 安裝目錄的 updater\eclipse 子目錄中,執行下列指令,以在回復模式中執行「Rational 產品更新程式」。
      rpu -enableRollback
    2. 回復標籤中,選取 6.0.1 工具箱更新,再按一下 回復更新。請注意,這可能會強制回復其他的 Rational Software Development Platform 產品,以確保相容性。您之後可以重新套用更新資料。
    3. 回復完成後,結束「Rational 產品更新程式」。
    4. 若要解除安裝工具箱,請遵循上述的步驟 1 到步驟 3

如果您試圖局部解除安裝一或多個必要特性,將出現類似下列的錯誤訊息:

選項無效:無法解除安裝 ide_required:沒有設定解除安裝的 root

如果要解決這個問題,請在解除安裝精靈中選取解除安裝產品勾選框。解除安裝畫面將重新起始設定,因此,您現在可以解除安裝整個工具箱,或取消選取您不要解除安裝的特性。

 


在 Linux 上安裝、啟動及解除安裝工具箱

安裝工具箱

安裝工具箱之前,請先檢查下列事項:

您可從下列網站取得必要的 6.x.0 版工具箱,以及安裝指示:

若要將工具箱升級至 6.x.1 版,請執行下列動作:

  1. 啟動「Rational 產品更新程式」,做法是前往安裝目錄下的 updater/eclipse 子目錄,然後執行下列指令: ./rpu.bin程式集IBM Rational 下的主功能表中,可能也有捷徑。
  2. 按一下尋找更新資料。此時會存取 Internet,以取得您已安裝之任何 Rational Software Development Platform 產品的可用更新資料。
  3. 更新資料標籤中,確定工具箱的更新資料為 6.0.1 版,且如果畫面上有顯示,請確定已選取所有基本產品。
  4. 按一下安裝更新資料。請閱讀畫面上所顯示的授權資訊。
  5. 更新程式會下載並安裝工具箱的更新資料以及其他 Rational 產品所需的任何更新資料,這可能會花費一些時間。
  6. 安裝完成後,按一下清除,以移除先前的版本,藉此釋放硬碟空間。請注意,這個步驟會阻止您回復工具箱的較早版本,或阻止您在未完全移除所有 Rational Software Development Platform 產品的情況下,完整地解除安裝工具箱。

您必須在此時安裝資料收集基礎架構。如需指示,請參閱安裝資料收集基礎架構

附註:

啟動工具箱

就您已安裝的 Rational Software Development Platform 程式而言(例如,Rational Performance Tester 或 Rational Application Developer),工具箱是額外安裝的元件。若要從指令行啟動 Software Development Platform,請跳至安裝目錄,執行指令:./rationalsdp.bin

此外,如果您使用 Gnome(Red Hat 的預設值),產品捷徑將位於主功能表的程式設計 > Rational Software Development Platform 下方。如果您使用 KDE(SuSE 的預設值),產品捷徑則是 IBM Rational > Rational Software Development Platform

安裝之後第一次啟動時,可能會開啟對話框,其中已指定預設的工作區目錄。如果要將工作儲存在其他位置,您可以變更工作區的名稱和位置。如果您想要固定使用這個工作區,請啟用請使用這個作為預設值,以後不要再問我勾選框。您可以在啟動產品之後,在視窗 > 喜好設定 > 工作台 > 啟動和關閉頁面中變更這個預設值。

工作台最初可能開啟一連串歡迎使用頁面,提供產品概觀和新增功能的資訊,以及指導教學、範例和外部 Web 資源的鏈結。請花些時間來瀏覽這些選項。 另外,也請注意「說明」功能表所提供的資訊來源。您可以選取說明 > 歡迎使用,回到這些歡迎使用頁面。

解除安裝工具箱

附註:如果您已安裝了資料收集基礎架構,在解除安裝之前,請先解除安裝工具箱。如需指示,請參閱解除安裝資料收集基礎架構

若要在 Linux 上解除安裝工具箱,請遵循下列步驟:

  1. 以 root 身分登入。
  2. 跳至安裝目錄的 rpa_prod/_uninst/ 子目錄。
  3. 輸入這個指令來解除安裝:./uninstall.bin。如果您使用檔案管理員,您可以按一下這個檔案來啟動解除安裝程式。
  4. 任何 plug-ins 或 features 目錄中的所有檔案或特性都會自動刪除,包括位於這些目錄中的使用者資料和協力廠商外掛程式。含有工作的工作區目錄不會被刪除。其他一些目錄也會保留下來:
  5. 您也必須解除安裝其他的 Rational Software Development Platform 產品,才能完全移除所有工具箱檔案。請遵循這些產品之安裝手冊中的解除安裝指示。確定已移除 Platform 安裝目錄中的所有檔案和目錄。然後,即可重新安裝那些產品。

    附註:如果您在更新至 6.x.1 版時,沒有按清除按鈕,現在便可省略這些步驟。如果您沒有清除步驟, 則請執行下列動作:

    1. 從 Rational Software Development Platform 安裝目錄的 updater/eclips 子目錄中,執行下列指令,以在回復模式中執行「Rational 產品更新程式」。
      rpu.bin -enableRollback
    2. 回復標籤中,選取 6.0.1 工具箱更新,再按一下 回復更新。請注意,這可能會強制回復其他的 Rational Software Development Platform 產品,以確保相容性。您之後可以重新套用更新資料。
    3. 回復完成後,結束「Rational 產品更新程式」。
    4. 若要解除安裝工具箱,請遵循上述的步驟 1 到步驟 4

如果您試圖局部解除安裝一或多個必要特性,將出現類似下列的錯誤訊息:

選項無效:無法解除安裝 ide_required:沒有設定解除安裝的 root

如果要暫時解決這個問題,請選取解除安裝產品勾選框。解除安裝畫面將重新起始設定,因此,您現在可以解除安裝整個工具箱,或取消選取您不要解除安裝的特性。

 


安裝、配置、啟動及解除安裝資料收集基礎架構

對您要收集效能資料的執行中應用程式(受到監督),任何涉及的機器上必須安裝資料收集基礎架構。接著,您必須配置這些機器上的應用程式伺服器,允許側寫應用程式。另外,若要透過效能測試或負載測試排程來收集資料,則您也必須在安裝工具箱前端系統的相同機器上,安裝資料收集基礎架構。

重要注意事項:

解除安裝現有的資料收集機制 (Agent Controller)

資料收集基礎架構和其他 Hyades 型資料收集基礎架構會發生衝突。如果您有舊版的 Agent Controller 或從 Hyades Data Collection Engine 衍生而來的任何軟體,請先將它停止、解除安裝,以及清除遺留的檔案,之後再安裝這個版本的 Agent Controller。解除安裝之後可能遺留下列檔案,且必須移除:

Windows:

%RASERVER_HOME%\*.*(Agent Controller 的安裝目錄)
%SystemRoot%\system32\piAgent.dll(Windows 的 system32 目錄)
%SystemRoot%\system32\LogAgent.dll
%SystemRoot%\system32\hcbnd.dll
%SystemRoot%\system32\hcclco.dll
%SystemRoot%\system32\hccldt.dll
%SystemRoot%\system32\hccls.dll
%SystemRoot%\system32\hcclserc.dll
%SystemRoot%\system32\hcclsert.dll
%SystemRoot%\system32\hcclsm.dll
%SystemRoot%\system32\hcjbnd.dll
%SystemRoot%\system32\hclaunch.dll
%SystemRoot%\system32\hcthread.dll
%SystemRoot%\system32\piAgent.dll
%SystemRoot%\system32\rac.dll
%SystemRoot%\system32\sysperf.dll

Linux、AIX、HP-UX、Solaris:

$RASERVER_HOME/*(Agent Controller 的安裝目錄)
/usr/lib/libpiAgent.so(HP-UX 上的副檔名為 .sl)
/usr/lib/libLogAgent.so
/usr/lib/libhcbnd.so
/usr/lib/libhcclco.so
/usr/lib/libhccldt.so
/usr/lib/libhccls.so
/usr/lib/libhcclserc.so
/usr/lib/libhcclsert.so
/usr/lib/libhcclsm.so
/usr/lib/libhcjbnd.so
/usr/lib/libhclaunch.so
/usr/lib/libhcthread.so

如需完整的解除安裝指示,請參閱已安裝的 Agent Controller 或其他 Hyades 型資料收集機制所提供的解除安裝指示。

在 Windows 或 Linux 上安裝資料收集基礎架構

附註:在 Windows Server 2003 機器上使用長路徑或內含空格的路徑來安裝資料收集基礎架構時,會發生已知的間歇性問題。請盡可能避免這種目錄。這不僅套用到目標安裝目錄中,也套用到您正在安裝的目錄中。

若要安裝資料收集基礎架構:

  1. 以 root 使用者 (Linux) 或 Administrator (Windows) 身分登入。
  2. 跳至存放安裝影像檔的暫時安裝目錄。
  3. Linux:輸入 ./setup.bin,顯示安裝視窗。Windows:按兩下 setup.exe

    附註 (Linux):如果安裝程式或其餘安裝部分無法啟動,您可能需要在相關檔案上設定執行權限。從您下載並解壓縮映像檔的暫時目錄中,請執行下列指令:

    chmod 755 setup.bin
    chmod 755 setup/lplinuxbin
    chmod 755 dci_linux/disk1/setup/setup.bin
  4. 從安裝視窗中,選取安裝 IBM Rational Data Collection Infrastructure 6.0 版
  5. 當歡迎使用頁面出現時,請按下一步
  6. 遵循指示閱讀授權合約。請按下一步
  7. 指定安裝基礎架構的目錄名稱。

    附註:如果安裝在與 Rational Software Development Platform 產品相同的機器上,例如 Rational Application Developer 或 Rational Performance Tester,則必須將資料收集基礎架構安裝在該產品原先安裝 Agent Controller 的相同位置。

    請按下一步

  8. 下一頁會顯示可用的特性;目前只有一個特性,依預設已選取。請按下一步
  9. 在下一頁,指定資料收集基礎架構應該使用的 Java 執行時期。資料收集基礎架構會使用這裡輸入的 JRE 來啟動 Java 應用程式。建議您指定 JRE 1.4.2 版。按下一步
  10. 選用的:在 WebSphere Application Server 頁面上,如果您使用 5.0 或 5.1 版,請指定伺服器在這台機器上的安裝位置。 您要收集資料的應用程式,就是在這個伺服器上執行。附註:如果使用 WebSphere Application Server 6.0 版,則這裡不需要任何指定,因為會自動偵測。請按下一步
  11. 在「主機清單」頁面上,指定哪些主機可以存取資料收集引擎。選項如下:

    下一步

  12. 在「安全性」頁面上,選擇停用啟用選項與 Rational Performance Tester 發生衝突,且不受支援(此為已知錯誤)。安全的選擇方案是使用上一頁所提供的「主機清單」選項。按下一步
  13. 檢視摘要頁面,按下一步。檔案傳送將開始進行,並安裝資料收集基礎架構。

    附註: 在這個安裝階段,如果發生錯誤,且您已從 Rational Application Developer 產品安裝 Agent Controller,請退出安裝,並解除安裝 Agent Controller(遵循 Rational Application Developer 安裝手冊的指示),再嘗試重新安裝資料收集基礎架構。

  14. 當安裝完成時,按一下完成
  15. 將開啟另一個安裝精靈來安裝 Tivoli 資料收集元件。請按下一步
  16. 遵循精靈的指示閱讀授權合約。請按下一步
  17. 複查安裝資訊摘要,按下一步。將開始傳送檔案,並安裝 Tivoli 資料收集元件。
  18. 當安裝完成時,按一下完成

下一步是配置應用程式伺服器來使用資料收集基礎架構

在 AIX、HP-UX 或 Solaris 上安裝資料收集基礎架構

若要安裝資料收集基礎架構:

  1. 以 root 使用者身分登入。
  2. 從安裝映像檔的目錄中,執行下列指令:
    /installDCIComponents.sh -console
  3. 安裝程序會提示您輸入下列資訊。 請輸入適當的資訊:
    1. 同意軟體授權。
    2. 資料收集基礎架構的安裝目錄。輸入目錄名稱,例如 ./rpa_dci
    3. 資料收集基礎架構應該使用的 Java 執行時期的路徑。資料收集基礎架構會使用這裡輸入的 JRE 來啟動 Java 應用程式。建議您指定 JRE 1.4.2 版。
    4. 選用的:WebSphere Application Server 5.0 版或 5.1 版的安裝路徑。 您要收集資料的應用程式,就是在這個伺服器上執行。附註:如果使用 WebSphere Application Server 6.0 版,則這裡不需要任何指定,因為會自動偵測。
    5. 哪些主機可以存取資料收集引擎。請輸入下列其中一項:
      • 任何 - 允許任何用戶端存取。
      • 本端 - 只允許本端主機可以存取。
      • 自訂 - 允許指定的用戶端清單可以存取。接著,您需要輸入用戶端名稱的清單,以逗點區隔。
    6. 安全性設定。輸入 FALSE。安全 = TRUE 選項與 Rational Performance Tester 發生衝突,且不受支援(此為已知錯誤)。安全的選擇方案是使用上一步驟中的 CUSTOM 選項。
  4. 輸入這項資訊之後,將開始安裝核心資料收集基礎架構。
  5. 安裝程序會提示您接受 Agent Controller 安裝的軟體授權。
  6. 接受 Agent Controller 元件的預設安裝位置(否則產品無法正常運作)。接著會開始安裝 Agent Controller 元件。
  7. 安裝程序會提示您接受 Tivoli ARM 資料收集引擎元件的軟體授權。
  8. 接受 Tivoli Arm 資料收集引擎元件的預設安裝位置(否則產品無法正常運作)。接著會開始安裝 Tivoli ARM 資料收集引擎元件。

主控台會顯示安裝期間發生的任何錯誤。 錯誤訊息將指出安裝錯誤日誌檔的名稱,讓您取得事件發生的詳細資訊。某個階段的錯誤會導致停止安裝,將不會安裝下一個元件。

重要注意事項:如果您在 HP-UX 上使用 WebSphere Application Server 6.x 版:安裝資料收集基礎架構後,請確定已設定 SHLIB_PATH。否則,系統不會收集交易資料,且 ARM 中會有 NoClassDef 錯誤報告。如果要設定 SHLIB_PATH,請執行下列指令:

export SHLIB_PATH=$(SHLIB_PATH):$tivoli_comp/app/instrument/5301/lib/$(interp):$tivoli_comp/bin/$(interp)/USRLIB

下一步是配置應用程式伺服器來使用資料收集基礎架構

配置應用程式伺服器來使用資料收集基礎架構

為了讓應用程式伺服器正確地將效能資料傳送至資料收集基礎架構,必須適當地配置應用程式伺服器並重新啟動,才能開始使用資料收集。

附註:

若要配置應用程式伺服器:

  1. 重要事項!請確定要配置的應用程式伺服器已經執行。
  2. 開啟指令行,跳至資料收集基礎架構安裝目錄下的 rpa_prod 目錄。
  3. 配置公用程式稱為 instrumentServer.sh(在 Windows 上是 instrumentServer.bat)。輸入指令名稱,不加任何引數,可以查看指令的詳細語法。
  4. 搭配所需的引數,輸入指令名稱來配置伺服器。 請參閱下列範例

停止並重新啟動伺服器後,變更才會生效。

依據您要側寫的應用程式的任何資料收集,對涉及的機器上的每一個伺服器重複這些配置步驟 (通常只有一個應用程式伺服器,但一台機器上也可能有多個應用程式伺服器)。

配置指令的語法和範例

若要查看 instrumentServer 指令的語法,請輸入指令,不加任何引數:

AIX、HP-UX、Linux、Solaris:

./instrumentServer.sh

Windows:

instrumentServer

範例:

在非 Windows 機器上,若要配置 IBM WebSphere Application Server 5.x 版伺服器,名稱為 server1,安裝目錄為 /opt/WebSphere/AppServer(無安裝性):

./instrumentServer.sh -install -type IBM -serverName server1 -serverHome /opt/WebSphere/AppServer -serverVersion 5

在非 Windows 機器上,若要配置 WebSphere Application Server 6.0 版伺服器, 名稱為 server2,安裝目錄為 /opt/WebSphere/AppServer,設定檔名稱為 profile1 且已啟用安全性:

./instrumentServer.sh -install -type IBM -serverName server2 -serverHome /opt/WebSphere/AppServer 
      -profileName default -user myUserId -password myPassword -serverVersion 6

在非 Windows 機器上,若要配置 BEA WebLogic 伺服器(特性如下所示):

./instrumentServer.sh -install -type BEA -serverName server1 -serverHome /opt/bea/weblogic81 
      -domain mydomain -domainPath /opt/bea/weblogic81/mydomain -javaHome /opt/bea/jdk141_02 
      -nodeManagedHost hostname.xyz.com -nodeManagedPort 7001 -adminServer my_server
      -startScript /opt/bea/weblogic81/mydomain/startManagedWeblogic.sh

在 Windows 機器上,若要配置 WebSphere Application Server 5.1 版伺服器, 名稱為 my_Server,安裝在 C:\Program Files\was-5.1,且已啟用安全性:

instrumentServer -install -type IBM -serverName my_Server -serverHome "C:\Program Files\was5.1" 
      -user myUserId -password myPassword -serverVersion 5

在 Windows 機器上,若要配置 BEA WebLogic 伺服器(特性如下所示):

instrumentServer -install -type BEA -serverName server1 -serverHome C:\bea\weblogic81 
      -domain mydomain -domainPath C:\bea\weblogic81\mydomain -javaHome C:\bea\jdk141_02 
      -nodeManagedHost localhost -nodeManagedPort 7001 -adminServer my_server
      -startScript C:\bea\weblogic81\mydomain\startManagedWeblogic.cmd

啟動和停止資料收集基礎架構

必須啟動資料收集基礎架構,才能從執行中的應用程式和測試中,收集效能資料。

啟動資料收集基礎架構會啟動 Agent Controller 元件;在啟動資料收集基礎架構之前,必須停止 Agent Controller 的其他實例,這點非常重要。因此,如果您在使用 Rational Performance Tester,您必須在啟動 Rational Performance Tester 之前,啟動本端機器上的資料收集基礎架構(否則會啟動 Agent Controller)。

在支援資料收集基礎架構的平台上,啟動和停止資料收集基礎架構的項目位於主要啟動功能表(例如,Windows 的開始功能表)。例如,在 Windows 上,請按一下開始 > 程式集 > IBM Rational > IBM Rational Software Development Platform > 啟動資料收集基礎架構停止資料收集基礎架構

如果要採用其他方法啟動資料收集基礎架構:

  1. 跳至資料收集基礎架構安裝目錄的 rpa_prod/rpa_comp 子目錄。
  2. 執行 ./start_DCI.bat/sh

在 WebSphere Application Server 上收集 Web 服務資料的附註: 請在啟動 WebSphere Application Server 之前,啟動資料收集基礎架構。否則,可能不會收集 Web 服務資料。如果啟動資料收集基礎架構之後,您無法重新啟動伺服器,您可以透過 JMX 或管理主控台來停用然後再啟用 ARM,以強制重新連接至 ARM 引擎。

若要停止資料收集基礎架構:

  1. 跳至資料收集基礎架構安裝目錄的 rpa_prod/rpa_comp 子目錄。
  2. 執行 ./stop_DCI.bat/sh

HP-UX 的疑難排解要訣:如果您在 HP-UX 上啟動資料收集基礎架構的 ARM 代理站元件時,遇到問題,則該機器可能有防止適當啟動 ARM 代理站的配置限制。請檢查下列核心配置參數,並確定它們至少與給定的值一樣大:

sema 1
semaem 16384
semmap 4098
semmni 4096
semmns 8192
semmnu 4092
semmsl 2048
semume 512
semvmx 32767

這些核心配置參數與系統上的號誌使用情況相關。如需修改 HP-UX 核心配置參數的相關詳細指令,請參閱 HP-UX 系統文件,或洽詢系統管理員。或者,如果您不想更新核心配置,您可以編輯 tapm_ep.cfg 檔,其位於「資料收集基礎架構」安裝目錄中。在這個檔案中,您可以找到兩個參數:

IPCAppToEngSize=500
IPCEngToAppSize=500

將這些設定變更為:

IPCAppToEngSize=50
IPCEngToAppSize=50

這個變更的負面影響是可能會降低資料收集的效能。

將更多主機新增至資料收集基礎架構

安裝(且可能也使用)資料收集基礎架構之後,您可以執行下列動作,將更多主機新增至存取清單:

  1. 在資料收集安裝目錄的 bin 子目錄中,執行 SetConfig 指令。
  2. 這樣會讀取您的現行設定,並提示您輸入新的設定。
  3. 當主機提示出現時,請輸入 CUSTOM。
  4. 接著,指定要新增的主機的逗點分隔清單。這份清單將新增至現行配置。

解除安裝資料收集基礎架構

附註:如果您解除安裝機器上的資料收集基礎架構,但此機器上也包含 Rational Software Development Platform 產品,例如 Rational Performance Tester、Rational Application Developer 或 Rational Software Architect,則會移除該產品已安裝的 Agent Controller 或資料收集元件。解除安裝此工具箱的資料收集基礎架構之後,如果您還要對該產品使用 Agent Controller 或資料收集,您必須透過該產品的安裝程序,重新安裝資料收集基礎架構。

同樣地,如果您解除安裝的 Rational Software Development Platform 產品已安裝 Agent Controller,例如 Rational Application Developer 或 Rational Performance Tester,則會移除並停用資料收集基礎架構的元件。您將必須重新安裝資料收集基礎架構。

解除配置應用程式伺服器

解除安裝資料收集基礎架構之前,您必須取消配置所有已配置的應用程式伺服器。若要取消配置伺服器:

  1. 開啟指令行,跳至資料收集基礎架構安裝目錄下的 rpa_prod 目錄。
  2. 配置公用程式(也用來取消配置伺服器)稱為 instrumentServer.sh(在 Windows 上是 instrumentServer.bat)。輸入指令名稱,不加任何引數,可以查看指令的詳細語法。
  3. 輸入指令名稱,加上 -uninstall 引數和您原來用於配置的其他所有引數。例如,在 Windows 上,若要解除安裝 IBM WebSphere Application Server 5.1 版伺服器實例,名稱為 my_Server,安裝在 C:\Program Files\was-5.1,且已啟用安全性:
    instrumentServer -uninstall -type IBM -serverName my_Server -serverHome "C:\Program Files\was5.1" 
          -user myUserId -password myPassword -serverVersion 5

    關於可能的原始配置引數的其他範例,請參閱配置範例附註:serverConfig.xml 檔案會列出所有已配置的伺服器。

    附註:如果您已解除安裝伺服器或移除伺服器實例,但並未取消配置,則 instrumentServer 公用程式仍然會認為伺服器實例存在,但無法連接來取消配置。這樣會導致無法執行資料收集基礎架構的解除安裝程序。 為了解決這個問題,請在 instrumentServer 指令加上 -force 引數。這樣會移除 serverConfig.xml 中相對應的指令行,不必連接遺失的伺服器來取消配置。以上述相同範例而言:

    instrumentServer -uninstall -force -type IBM -serverName my_Server -serverHome "C:\Program Files\was5.1" 
          -user myUserId -password myPassword -serverVersion 5
  4. 重新啟動伺服器。

對已配置進行資料收集的每一個伺服器,重複取消配置步驟。完成之後,serverConfig.xml 檔案會空白,並繼續解除安裝資料收集。

接下來,解除安裝資料收集基礎架構。

在 Windows 或 Linux 上解除安裝資料收集基礎架構

若要解除安裝資料收集基礎架構,請使用作業系統的安裝管理程式(例如,Windows 的新增/移除程式視窗)。尋找並移除 IBM Rational Data Collection Infrastructure 6.1 版程式。

萬一作業系統未提供這種安裝管理程式,若要解除安裝資料收集基礎架構:

  1. 停止資料收集基礎架構
  2. 跳至資料收集基礎架構安裝目錄的 dci_prod/_uninst 子目錄。
  3. 執行 ./uninstall.bin
  4. 遵循精靈的指示進行。

在 AIX、HP-UX 或 Solaris 上解除安裝資料收集基礎架構。

如果要解除安裝資料收集基礎架構:

  1. 在資料收集基礎架構目錄中,執行下列指令,停止資料收集基礎架構:
    rpa_prod/rpa_comp/rpa_boot_stop_unix.sh
  2. 依序執行下列指令,解除安裝每一個資料收集元件。每執行一個指令之後,請確認您要解除安裝元件,然後等待解除安裝完成。附註:對於下列任何指令,您可以使用 -silent 取代 -console, 採取無聲方式執行解除安裝。

    /dci_prod/_uninst/uninstall.bin -console
    /IBM_Agent_Controller/_uninst/uninstall.bin -console -W prod_id_uninstall.value=dci
    /tau_prod/_uninst/uninstall.bin -console
    /rpa_prod/tivoli_comp/_uninst/uninstall.bin -console

疑難排解

如果您在解除安裝資料收集基礎架構時遇到問題,請在試圖解除安裝之前,先確定代理程式是否已停止

如果在解除安裝資料收集基礎架構之後,不再啟動 WebSphere Application Server,則您可以執行下列步驟來修正此問題:

  1. 開啟 <was_install>/config/cells/<cell>/nodes/<node>/servers/<server>/ (<server> 可能是 server1,而 <cell><node> 則可能是機器名稱)中的 server.xml檔。

  2. 尋找下列行:genericJvmArgs="<some set of strings>"

  3. 以空字串取代該行:genericJvmArgs=""

您現在應該可以啟動應用程式伺服器了。


版權和注意事項