歡迎使用 IBM(R) Performance Optimization Toolkit 6.1.2 for Rational(R) Performance Tester。本手冊包含安裝和設定工具箱的相關資訊。
您可以在工具箱版本注意事項中,找到有關限制和暫行解決方法的其他最新資訊。
IBM Performance Optimization Toolkit 需要安裝 Rational Performance Tester 產品。此工具箱提供下列特性:
安裝本工具箱之前,必須安裝下列硬體。這些數據假設您也在相同機器上安裝資料收集基礎架構:
如果要在未安裝工作台的機器上安裝資料收集基礎架構,下列是最小硬體需求:
安裝工具箱的更新之前,必須先安裝下列軟體:
附註:如果您已安裝了其中一個產品的 6.x.0 版,請使用「Rational 產品更新程式」來更新至 6.x.1 版。
附註:如果您從頭安裝,只要安裝工具箱的工作台部分即可,而不要安裝資料收集基礎架構。如果您已安裝了 6.1 版工具箱的資料收集基礎架構,則必須先將它解除安裝,才能安裝 6.1.2 版資料收集基礎架構。
重要事項:安裝工具箱之前,請解除安裝所有 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 伺服器收集效能側寫資料:
如需安裝這些產品的完整指示,請參閱安裝手冊。下列安裝指示包含如何配置這些產品來搭配資料收集基礎架構一起使用的資訊。
安裝工具箱之前,請檢查環境變數 TEMP 或 TMP 是否指向至少有 100 MB 可用空間的有效暫時目錄。這不包括在安裝產品所需的空間內。
您可從下列網站取得必要的 6.x.0 版工具箱,以及安裝指示:
若要將工具箱升級至 6.x.1 版,請執行下列動作:
安裝期間發生錯誤 - 使用者取消安裝
當您試圖在此狀態下解除安裝工具箱時,可能會出現下列錯誤:
找不到適當的 JVM。請利用 -is:javahome <JAVA HOME DIR> 選項來重新執行程式。
為了解決這個問題,您必須重新執行安裝程式,完成先前取消的修正,再繼續解除安裝工具箱。
就您已安裝的 Rational Software Development Platform 產品而言 (Rational Performance Tester、Rational Application Developer 或 Rational Software Architect),工具箱是額外安裝的元件。若要使用工具,請照常啟動程式。例如,從開始功能表選取程式集 > IBM Rational > Rational Software Development Platform。
安裝之後第一次啟動時,可能會開啟對話框,其中已指定預設的工作區目錄。如果要將工作儲存在其他位置,您可以變更工作區的名稱和位置。如果您想要固定使用這個工作區,請啟用請使用這個作為預設值,以後不要再問我勾選框。您可以在啟動產品之後,在視窗 > 喜好設定 > 工作台 > 啟動和關閉頁面中變更這個預設值。
工作台最初可能開啟一連串歡迎使用頁面,提供產品概觀,包括工具箱的概觀資訊、新增功能的資訊,以及基本產品的指導教學、範例和外部 Web 資源的鏈結。請花些時間來瀏覽這些選項。 另外,也請注意「說明」功能表所提供的資訊來源。您可以選取說明 > 歡迎使用,回到這些歡迎使用頁面。
附註:如果您已安裝了資料收集基礎架構,在解除安裝之前,請先解除安裝工具箱。如需指示,請參閱解除安裝資料收集基礎架構。
若要解除安裝工具箱:
附註:如果您在更新至 6.x.1 版時,沒有按清除按鈕,現在便可省略這些步驟。如果您沒有清除步驟, 則請執行下列動作:
rpu -enableRollback
如果您試圖局部解除安裝一或多個必要特性,將出現類似下列的錯誤訊息:
選項無效:無法解除安裝 ide_required:沒有設定解除安裝的 root
如果要解決這個問題,請在解除安裝精靈中選取解除安裝產品勾選框。解除安裝畫面將重新起始設定,因此,您現在可以解除安裝整個工具箱,或取消選取您不要解除安裝的特性。
安裝工具箱之前,請先檢查下列事項:
您可從下列網站取得必要的 6.x.0 版工具箱,以及安裝指示:
若要將工具箱升級至 6.x.1 版,請執行下列動作:
您必須在此時安裝資料收集基礎架構。如需指示,請參閱安裝資料收集基礎架構。
如果您重新執行安裝程式來新增其他特性,且在完成之前選擇取消修正,您可能會收到下列錯誤:
安裝期間發生錯誤 - 使用者取消安裝
當您試圖解除安裝這個狀態的產品時,可能會出現下列錯誤:
找不到適當的 JVM。請利用 -is:javahome <JAVA HOME DIR> 選項來重新執行程式。
如果要解決這個問題,您必須重新執行安裝程式來完成先前取消的修正,再繼續解除安裝產品。
有兩個方法可以避免這個問題。第一個方法(建議)是從 Red Hat 將 RHEL 3 系統更新成 Quarterly Update 2 或更新版本。Update 2 包含針對失敗 POSIX 緒程式庫的修正程式。
或者,將安裝程式切換成在 LinuxThreads 下執行,只有在沒有使用 Update 2 時才建議您使用這個方法。LinuxThreads 不會顯示這個失敗,並且可以用來執行安裝程式。如果要為安裝程式啟用 LinuxThreads,您必須在打算於其中執行安裝程式的 Shell 中,設定兩個環境變數。
請執行下列兩個指令:
export RPM_FORCE_NPTL=1 export LD_ASSUME_KERNEL=2.4.19
如果要驗證是否已設定變數,請執行下列指令:
env | grep RPM_FORCE_NPTL env | grep LD_ASSUME_KERNEL
前述的兩個指令都會傳回變數,以及您在匯出指令中所輸入的值。然後請正常執行安裝。
就您已安裝的 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 上解除安裝工具箱,請遵循下列步驟:
附註:如果您在更新至 6.x.1 版時,沒有按清除按鈕,現在便可省略這些步驟。如果您沒有清除步驟, 則請執行下列動作:
rpu.bin -enableRollback
如果您試圖局部解除安裝一或多個必要特性,將出現類似下列的錯誤訊息:
選項無效:無法解除安裝 ide_required:沒有設定解除安裝的 root
如果要暫時解決這個問題,請選取解除安裝產品勾選框。解除安裝畫面將重新起始設定,因此,您現在可以解除安裝整個工具箱,或取消選取您不要解除安裝的特性。
對您要收集效能資料的執行中應用程式(受到監督),任何涉及的機器上必須安裝資料收集基礎架構。接著,您必須配置這些機器上的應用程式伺服器,允許側寫應用程式。另外,若要透過效能測試或負載測試排程來收集資料,則您也必須在安裝工具箱前端系統的相同機器上,安裝資料收集基礎架構。
重要注意事項:
Agent Controller 舊版隨附於舊版的 IBM 產品中,可能位於您從中收集資料的主機中。動態探索是資料收集「搜索」分散式應用程式所用主機的程序,會聯絡每個主機上的 Agent Controller。如果分散式應用程式所使用的其中一個主機有舊版的 Agent Controller,則會在該主機上停止動態探索,且在該主機的交易移動到所使用的下一個主機之前,不會繼續通過該主機。 如果要修正這個問題,請更新應用程式所使用之所有主機上的 Agent Controller 版本,做法是解除安裝 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.dllLinux、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 Server 2003 機器上使用長路徑或內含空格的路徑來安裝資料收集基礎架構時,會發生已知的間歇性問題。請盡可能避免這種目錄。這不僅套用到目標安裝目錄中,也套用到您正在安裝的目錄中。
若要安裝資料收集基礎架構:
附註 (Linux):如果安裝程式或其餘安裝部分無法啟動,您可能需要在相關檔案上設定執行權限。從您下載並解壓縮映像檔的暫時目錄中,請執行下列指令:
chmod 755 setup.bin chmod 755 setup/lplinuxbin chmod 755 dci_linux/disk1/setup/setup.bin
附註:如果安裝在與 Rational Software Development Platform 產品相同的機器上,例如 Rational Application Developer 或 Rational Performance Tester,則必須將資料收集基礎架構安裝在該產品原先安裝 Agent Controller 的相同位置。
請按下一步。
按下一步。
附註: 在這個安裝階段,如果發生錯誤,且您已從 Rational Application Developer 產品安裝 Agent Controller,請退出安裝,並解除安裝 Agent Controller(遵循 Rational Application Developer 安裝手冊的指示),再嘗試重新安裝資料收集基礎架構。
下一步是配置應用程式伺服器來使用資料收集基礎架構。
若要安裝資料收集基礎架構:
/installDCIComponents.sh -console
主控台會顯示安裝期間發生的任何錯誤。 錯誤訊息將指出安裝錯誤日誌檔的名稱,讓您取得事件發生的詳細資訊。某個階段的錯誤會導致停止安裝,將不會安裝下一個元件。
重要注意事項:如果您在 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
下一步是配置應用程式伺服器來使用資料收集基礎架構。
為了讓應用程式伺服器正確地將效能資料傳送至資料收集基礎架構,必須適當地配置應用程式伺服器並重新啟動,才能開始使用資料收集。
附註:
若要配置應用程式伺服器:
停止並重新啟動伺服器後,變更才會生效。
依據您要側寫的應用程式的任何資料收集,對涉及的機器上的每一個伺服器重複這些配置步驟 (通常只有一個應用程式伺服器,但一台機器上也可能有多個應用程式伺服器)。
若要查看 instrumentServer 指令的語法,請輸入指令,不加任何引數:
AIX、HP-UX、Linux、Solaris:
./instrumentServer.shWindows:
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 > 啟動資料收集基礎架構或停止資料收集基礎架構。
如果要採用其他方法啟動資料收集基礎架構:
在 WebSphere Application Server 上收集 Web 服務資料的附註: 請在啟動 WebSphere Application Server 之前,啟動資料收集基礎架構。否則,可能不會收集 Web 服務資料。如果啟動資料收集基礎架構之後,您無法重新啟動伺服器,您可以透過 JMX 或管理主控台來停用然後再啟用 ARM,以強制重新連接至 ARM 引擎。
若要停止資料收集基礎架構:
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
這個變更的負面影響是可能會降低資料收集的效能。
安裝(且可能也使用)資料收集基礎架構之後,您可以執行下列動作,將更多主機新增至存取清單:
附註:如果您解除安裝機器上的資料收集基礎架構,但此機器上也包含 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,則會移除並停用資料收集基礎架構的元件。您將必須重新安裝資料收集基礎架構。
解除安裝資料收集基礎架構之前,您必須取消配置所有已配置的應用程式伺服器。若要取消配置伺服器:
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
對已配置進行資料收集的每一個伺服器,重複取消配置步驟。完成之後,serverConfig.xml 檔案會空白,並繼續解除安裝資料收集。
接下來,解除安裝資料收集基礎架構。
若要解除安裝資料收集基礎架構,請使用作業系統的安裝管理程式(例如,Windows 的新增/移除程式視窗)。尋找並移除 IBM Rational Data Collection Infrastructure 6.1 版程式。
萬一作業系統未提供這種安裝管理程式,若要解除安裝資料收集基礎架構:
如果要解除安裝資料收集基礎架構:
rpa_prod/rpa_comp/rpa_boot_stop_unix.sh
依序執行下列指令,解除安裝每一個資料收集元件。每執行一個指令之後,請確認您要解除安裝元件,然後等待解除安裝完成。附註:對於下列任何指令,您可以使用 -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,則您可以執行下列步驟來修正此問題:
開啟 <was_install>/config/cells/<cell>/nodes/<node>/servers/<server>/ (<server> 可能是 server1,而 <cell> 和 <node> 則可能是機器名稱)中的 server.xml檔。
尋找下列行:genericJvmArgs="<some set of strings>"
以空字串取代該行:genericJvmArgs=""
您現在應該可以啟動應用程式伺服器了。