設定環境變數來側寫伺服器
側寫伺服器可讓您分析執行 Web 應用程式時的效能、執行緒作業及記憶體用量。 在某些情況下,您必須先在目標主機電腦上設定環境變數,才能在側寫模式下啟動伺服器。 您必須在啟動伺服器進行側寫之前設定環境變數。在執行 z/OS® 的電腦上,您也需要對 Rational® Agent Controller 使用的目錄設定權限。
決定您是否必須手動設定側寫的環境變數
在某些情況下,您不需要於側寫時在目標電腦上手動設定環境變數;工作台會自動為您設定。
不過,在某些情況下,您必須手動設定環境變數。下列因素決定是否需要手動設定環境變數,以及要設定哪些環境變數:
- 伺服器的目標電腦是否為安裝工作台的同一部電腦(本端伺服器),或伺服器是否位於不同電腦(遠端伺服器)。
- 使用者 ID 對 WebSphere® Application Server(本端伺服器)的 /java/jre/bin/ 目錄是否具有寫入權。
- 已安裝的 Rational Agent Controller 版本(遠端伺服器)。
下表顯示自動設定或必須手動設定環境變數的情況。
| 環境變數 | 本端伺服器 | 遠端伺服器 |
|---|---|---|
|
由工作台自動設定。 | 如果遠端伺服器使用 Rational Agent Controller 8.3 版或更新版本,則自動設定。否則,手動設定。 註:
![]() 比方說,如果您將 XML 工具箱安裝在 /usr/lpp/ixm/IBM/xml4c-5_7,則 LIBPATH 環境變數必須包含路徑:LIBPATH=/usr/lpp/ixm/IBM/xml4c-5_7/lib。 |
| TPTP_AC_HOME | 由工作台自動設定。 | 如果遠端伺服器使用 Rational Agent Controller 8.3 版或更新版本,則自動設定。否則,手動設定。 |
| PROBEKIT_HOME(只有在您使用「探測插入項目」監視器選項時才需要。) | 由工作台自動設定。 | 手動設定。 |
| JAVA_PROFILER_HOME | 由工作台自動設定 | 如果遠端伺服器位於使用 Rational Agent Controller 8.3 版或更新版本的 Windows 或 Linux 作業系統上,則自動設定。否則,手動設定。 |
手動設定本端伺服器的側寫環境變數
如果伺服器和工作台在同一部機器上執行,請完成下列步驟:
- 在 IBM® Rational Software Delivery Platform 的安裝目錄下尋找下列外掛程式資料夾註: 當相同的外掛程式有多個版本時,一律挑選具有最新版本號碼和時間戳記的外掛程式。
表 2. 用於定義在本端伺服器進行側寫的環境變數的外掛程式路徑. 使用外掛程式路徑來決定環境變數。 說明 外掛程式路徑 <Agent Controller 起始目錄> - <install_dir>\IBMIMShared\plugins\org.eclipse.tptp.platform.ac.win_<XXXX>\agent_controller

- <install_dir>/IBMIMShared/plugins/org.eclipse.tptp.platform.ac.linux_<XXXX>/agent_controller

<Probekit 起始目錄> - <install_dir>\IBMIMShared\plugins\org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>\os\win32\x86

- <install_dir>/IBMIMShared/plugins/org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>/os/linux/x86

- 啟動工作台和應用程式伺服器之前,設定下列環境變數。開啟命令提示字元並輸入下列指令,將 <Agent Controller 起始目錄> 和選用的 <Probekit 起始目錄> 更換為您在先前步驟中決定的外掛程式路徑:
set TPTP_AC_HOME=<Agent Controller 起始目錄> set PROBEKIT_HOME=<Probekit 起始目錄> set PATH=%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%;%PATH%
export TPTP_AC_HOME=<Agent Controller 起始目錄> export PROBEKIT_HOME=<Probekit 起始目錄> export LD_LIBRARY_PATH=$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME:$LD_LIBRARY_PATH
手動設定在遠端伺服器進行側寫的環境變數
如果應用程式伺服器和工作台在不同電腦上執行,請完成下列步驟:
註: 如果您側寫遠端應用程式伺服器,您必須將 Rational Agent Controller 安裝在應用程式伺服器所在的同一部機器上。
請確認應用程式伺服器的啟動處理程序可取用下列環境變數設定。
在遠端應用程式伺服器所在的電腦上,在啟動工作台和應用程式伺服器之前,手動設定任何環境變數。您可以在目標系統上手動設定下列環境變數,請將 <AC 安裝目錄> 更換成 Rational Agent Controller 的安裝目錄。此外,如果您使用探測插入項目監視器選項,請指定 PROBEKIT_HOME 環境變數:
set TPTP_AC_HOME=<AC 安裝目錄>
set JAVA_PROFILER_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.tptp.javaprofiler
set PROBEKIT_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.hyades.probekit
set PATH=%JAVA_PROFILER_HOME%;%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%\lib;%PATH%

export TPTP_AC_HOME=<AC 安裝目錄>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LD_LIBRARY_PATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LD_LIBRARY_PATH
export TPTP_AC_HOME=<AC 安裝目錄>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
export TPTP_AC_HOME=<AC 安裝目錄/RACzOS64 或 31 位元>
export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler
export XERCESC_HOME=<XML 工具箱安裝目錄>/xml4c-5_7/lib
export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit
export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$XERCESC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
其中 <XML 工具箱安裝目錄> 通常是 /usr/lpp/ixm/IBM。
註: 如果您已在安裝 Rational Agent Controller 時啟用安全,請輸入下列指令:
- extattr +ap <Rational Agent Controller 目錄>/lib/*
- extattr +ap <Rational Agent Controller 目錄>/plugins/org.eclipse.tptp.javaprofiler/*
- extattr +ap <XML 工具箱安裝目錄>/xml4c-5_7/lib/*
啟動工作台
設定必要的環境變數之後,請從命令提示字元啟動 IBM Rational Software
Delivery Platform 工作台,讓工作台處理程序可以取用環境變數。例如,執行下列指令:
C:\Program Files\IBM\SDP>eclipse
/opt/IBM/SDP>./eclipse
註: 使用 WebSphere Application Server 進行側寫時,您可以在伺服器安裝的 /bin 資料夾下的 setupCmdLine.bat (Windows) 或 setupCmdLine.sh (Linux) 檔案中,新增環境變數設定。
設定在 z/OS 上進行側寫的檔案許可權

- <Rational Agent Controller 安裝目錄>/lib/*
- <Rational Agent Controller 安裝目錄>/plugins/org.eclipse.tptp.javaprofiler/*
- <XML 工具箱安裝目錄>/xml4c-5_7/lib*
註: 這些目錄路徑中的所有目錄也需要讀取和執行權限。
比方說,如果 <Rational Agent Controller 安裝目錄> 是 /opt/IBM/RAC,則您在 /opt、/opt/IBM、/opt/IBM/RAC 及 /opt/IBM/RAC/lib/ 目錄上都需要讀取和執行權限。
如果要執行指令 umask 022 來給予這些目錄上的正確權限,請執行下列動作:
- 在 UNIX 系統服務 Shell 中,切換至 <Rational Agent Controller 安裝目錄>/RACzOS31bit/bin 目錄。
- 執行下列指令:umask 022
- 啟動 Agent Controller:./ACStart.sh。